aMule EC Protocol - Node.js Implementation

This project provides a Node.js implementation of the aMule External Connections (EC) Protocol based on the aMule EC Protocol HOWTO.

Tested with aMule 3.0.1, and with master builds past it for the commands that only exist there. Older cores, back to 2.3.3, keep working: a command the daemon may not know is gated on the capability it advertises at connect time and is never sent otherwise, and the rest degrade to the older reply.

Features

• Communicate with aMule via EC protocol
• Send commands and receive status or transfer info

Installation

git clone https://github.com/got3nks/amule-ec-node.git
cd amule-ec-node
npm install

Example Usage

npm start

See examples/test.js for usage.

Options

const client = new AmuleClient(host, port, password, {
  requestTimeout: 30000, // per-request timeout in ms, 0 disables it
  autoReconnect: true    // reconnect when the connection drops
});

With autoReconnect: false, a dropped connection rejects pending requests and stops. Use it when your code rebuilds the client itself.

close() is final. It also stops a reconnect that is already running. To connect again, create a new client.

License

MIT