Skip to content


Subversion checkout URL

You can clone with
Download ZIP
An amqp listener that connects to a queue and forwards messages to the message bus
CoffeeScript JavaScript
Branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


A hook that listens to an amqp queue and forwards messages to the message bus.

Scenario: You have a ruby/java/whatever front end app and want to decouple long running tasks, so you push messages into your amqp queue. Your backend processing is written in node.js, so you create a hook to do your backend work, and then connect amqp to your bus.


This is a very early version. Future versions will hopefully support the mapping of event names and acknowledging messages. Right now I just needed it to work.

AmqpListener Icon

Build Status


Thanks a ton to @michaelklishin for helping me with amqp.


npm install -g



This starts a hook and reads the local config.json. It opens an amqp connection and listens to incoming messages


amqp-listener::add [in] Adds a queue listener. Make sure the tuple connection,queueName is added only once, otherwise all bets are off.

connection : "amqp[s]://[user:password@]hostname[:port][/vhost]",
queueName : "my-queue",

amqp-listener::error [out]

data: the data causing the error
error: The actual error

amqp-listener::received [out] Message will be sent for each received event unless that event has been name mapped.

queue: The queue name.
message: The message received.
contentType: The content type. The message is never pre processed.

deliveryMode: Passed verbatim from the delivery info. deliveryTag: Passed verbatim from the delivery info. redelivered: true if this message has been redelivered. exchange : The exchange this came from, or "" for the default exchange. routingKey : Passed verbatim from the delivery info. consumerTag : Passed verbatim from the delivery info. Schema support

The package config contains experimental schema definitions. The definition is also exported as hook. Signatures will be served from a signature server (more to come).


AmqpListener = require("").AmqpListener
hook = new AmqpListener(name: 'amqp-listener')


var AmqpListener = require("").AmqpListener;
var hook = new AmqpListener({ name: 'amqp-listener' });

Advertising :)

Check out

Follow us on Twitter at

  • @getscottyapp
  • @martin_sunset

and like us on Facebook please. Every mention is welcome and we follow back.


Listened to lots of M.I.A. and Soundgarden while writing this.

Release Notes


  • Move the .on code around a bit
  • Made use of @ instead of self.


  • First version

Internal Stuff

  • npm run-script watch

Publish new version

  • Change version in package.json
  • git tag -a v0.0.2 -m 'version 0.0.2'
  • git push --tags
  • npm publish

Contributing to

  • Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
  • Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
  • Fork the project
  • Start a feature/bugfix branch
  • Commit and push until you are happy with your contribution
  • Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
  • Please try not to mess with the package.json, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.


Copyright (c) 2011 Martin Wawrusch. See LICENSE for further details.

Something went wrong with that request. Please try again.