amqpcat
Version, currently 1.1.114 versions
- 1.1.1latestOct 1, 2026
- 1.1.0Feb 6, 2026
- 1.0.2not indexedFeb 11, 2026
- 1.0.1not indexedFeb 11, 2026
- 1.0.0not indexedFeb 11, 2026
- 0.2.5not indexedFeb 11, 2026
- 0.2.4not indexedFeb 11, 2026
- 0.2.3not indexedFeb 11, 2026
- 0.2.2not indexedFeb 11, 2026
- 0.2.1not indexedFeb 11, 2026
- 0.2.0not indexedFeb 11, 2026
- 0.1.2not indexedFeb 11, 2026
- 0.1.1not indexedFeb 11, 2026
- 0.1.0not indexedFeb 11, 2026
github.com/cloudamqp/amqpcat
CLI tool for publishing to and consuming from AMQP servers
Installation
# Add this to your shard.yml
dependencies:
amqpcat:
github: cloudamqp/amqpcat
version: ~> 1.1.1Then run:
shards installshard.yml
- Crystal
1.0.0- License
- MIT
- Author
- Carl Hörberg
- Target
amqpcatfrom src/cli.cr
Dependencies
Runtime Dependencies
- amqp-client*github: cloudamqp/amqp-client.cr
README
amqpcat
netcat for AMQP. CLI tool to publish to and consume from AMQP servers.
Installation
Using snap:
snap install amqpcat
Using Homebrew in OS X:
brew install cloudamqp/cloudamqp/amqpcat
Using Docker/Podman:
docker run -it cloudamqp/amqpcat
From source:
brew install crystal # os x
snap install crystal # linux/ubuntu
git clone https://github.com/cloudamqp/amqpcat.git
cd amqpcat
shards build --release --production
There are more Crystal installation alternatives.
Usage
Usage: amqpcat [arguments]
-P, --producer Producer mode, reading from STDIN, each line is a new message
-C, --consumer Consume mode, message bodies are written to STDOUT
-u URI, --uri=URI URI to AMQP servera
-d DIR, --dir=DIR Directory to dump messages info when consuming
-e EXCHANGE, --exchange=EXCHANGE Exchange
-r ROUTINGKEY, --routing-key=KEY Routing key when publishing
-q QUEUE, --queue=QUEUE Queue to consume from
-f FORMAT, --format=FORMAT Format string (default "%s\n")
%e: Exchange name
%r: Routing key
%s: Body, as string
\n: Newline
\t: Tab
-v, --version Display version
-h, --help Show this help message
Examples
Send messages to a queue named test:
echo Hello World | amqpcat --producer --uri=$CLOUDAMQP_URL --queue test
Consume from the queue named test:
amqpcat --consumer --uri=$CLOUDAMQP_URL --queue test
Consume from the queue named files, dumping each message into a given
directory, instead of STDOUT, deriving the filename from the message
properties, or timestamp if no properties are set:
amqpcat --consumer --uri=$CLOUDAMQP_URL --queue files --dir /tmp/miaow/
With a temporary queue, consume messages sent to the exchange amq.topic with the routing key 'hello.world':
amqpcat --consumer --uri=$CLOUDAMQP_URL --exchange amq.topic --routing-key hello.world
Consume from the queue named test, format the output as CSV and pipe to file:
amqpcat --consumer --uri=$CLOUDAMQP_URL --queue test --format "%e,%r,"%s"\n | tee messages.csv
Publish messages from syslog to the exchange 'syslog' topic with the hostname as routing key
tail -f /var/log/syslog | amqpcat --producer --uri=$CLOUDAMQP_URL --exchange syslog --routing-key $HOSTNAME
Consume, parse and extract data from json messages:
amqpcat --consumer --queue json | jq .property
Development
amqpcat is built with Crystal
Contributing
- Fork it (https://github.com/cloudamqp/amqpcat/fork)
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create a new Pull Request
Contributors
- Carl Hörberg - creator and maintainer
Documentation
Built from the current release. The first visit to a release nobody has asked for starts its build.
Links
This release
- Version
1.1.1- Tagged
- Oct 1, 2026
- Commit
44222be04969- Crystal
1.0.0- Indexed
- yes
Dependents
No indexed shard depends on this one yet.
Repository
github.com/cloudamqp/amqpcat
Metadata
- Created
- Aug 12, 2026
- Updated
- Nov 19, 2026
- Synced
- Nov 19, 2026
- Versions
- 14