maria2

maria2

Modern & Simple RPC Library for aria2.

Introduce

maria2 can control aria2c by its RPC interface.

Features

• Simple.
• Better TypeScript IDE Support.
• Browser and Node.js Support.

Example

• Install this package

pnpm i maria2

• If you are using Node.js, you have to install peer dependencies.

# For Node.js <16.7.0
pnpm i uuid

# For Node.js *
pnpm i ws

# For Node.js <18.0.0
pnpm i cross-fetch

• Start aria2 with rpc, example

aria2c --enable-rpc=true --rpc-listen-all=true --rpc-allow-origin-all=true --rpc-listen-port=6800

• Connect by WebSocket

import { open, aria2 } from 'maria2'

const conn = await open(
  new WebSocket('ws://localhost:6800/jsonrpc')

  // import { createWebSocket } from 'maria2'
  // createWebSocket('ws://localhost:6800/jsonrpc')
)

const version = await aria2.getVersion(conn)

• Connect by HTTP

import { open, createHTTP, aria2 } from 'maria2'

const conn = await open(
  createHTTP('http://localhost:6800/jsonrpc')
)

const version = await aria2.getVersion(conn)

• Multicall

import { open, system } from 'maria2'

const conn = await open(
  new WebSocket('ws://localhost:6800/jsonrpc')
)

const [result0, result1] = await system.multicall({
  methodName: 'aria2.getVersion',
  params: []
}, {
  methodName: 'aria2.getGlobalStat',
  params: []
})

Thanks to

• XLor (@yjl9903)
• L0serj3rry (@Cnotech)

License

MIT License © 2023 Hydration