naria2

Convenient BitTorrent Client based on the aria2 JSON RPC Interface and aria2c CLI application with Web UI.

• Download aria2 according to your platform
• Convenient BitTorrent downloading API
• Event bus used for watching progress, state change
• Vite plugin which helps you develop aria2 client application
• Web UI for aria2c (more features is working in progress)

Cross-platform aria2c

It is used in the same way as aria2c.

$ npm i -g naria2c

$ naria2c --version
naria2c/0.0.23
--------------
...

$ naria2c --help

You can also launch a Web UI to manage aria2 using the --ui option. This feature is provided by this package, not the original aria2.

$ naria2c --ui
...
10/29 21:22:46 [NOTICE] WebUI is listening on the http://127.0.0.1:6801?port=6800&secret=123456
...

Installation

Browser

npm i naria2

Using WebSocket:

import { createClient } from 'naria2'

const client = await createClient(
  new WebSocket('ws://localhost:6800/jsonrpc')
)

Using HTTP:

import { createClient } from 'naria2'
import { createHTTP } from 'naria2/transport'

const client = await createClient(
  createHTTP('http://localhost:6800/jsonrpc')
)

Node.js standalone

If you want to use naria2 in the Node.js standalone, you can install @naria2/node. It has included a prebuilt aria2 binary according to your architecture, so that there is no need to install a aria2 on your own.

npm i naria2 @naria2/node

You can use the createChildProcess API to spawn an aria2 child process, and connect to it in WebScoket under the hood.

import { createClient } from 'naria2'
import { createChildProcess } from '@naria2/node'

const client = await createClient(createChildProcess())

Warning

You should close the client on your own, otherwise the aria2 process may not be killed even if your program finished or crashed.

See my blog post (in Chinese) or The Death of a Node.js Process (in English) on how to handle the exit of a Node.js process.

Usage

import { createClient } from 'naria2'

// Initialize a client
const client = await createClient(
  new WebSocket('ws://localhost:6800/jsonrpc')
)

// Start downloading a magnet
const torrent = await client.downloadUri('...')

// Watch metadata progress
await torrent.watch((torrent) => {
  console.log(`Downloading [MEATADATA]`)
})
// Watch torrent progress
await torrent.watchFollowedBy((torrent) => {
  console.log(`Downloading ${torrent.name}`)
})

// Shutdown client
await client.shutdown()

Due to the implementation of aria2, the downloading progress of a magnet uri includes two steps:

1. Download the torrent metadata which contains only a special file named [METADATA];
2. Download the torrent content itself.

So that, in the above code, you should first wait for downloading metadata, and then wait for downloading the followed by task which is the torrent content itself.

You can find an example using Node.js here.

Credits

• aria2: A lightweight multi-protocol & multi-source, cross platform download utility operated in command-line
• @hydrati made maria2
• Motrix: Build aria2 binaries for different platforms

License

MIT License © 2023 XLor