MyJDownloader API for JavaScript (ESM) Client

The MyJDownloader API for JavaScript (ESM) Client library is a modern, pragmatic implementation that provides a complete and secure interface for communicating with the remote My.JDownloader API. It acts as a reliable API base for building modern clients (e.g., web dashboards, CLI tools, or automation scripts). It allows users to manage and automate all JDownloader functionalities (such as adding links, managing downloads, and controlling devices) via JavaScript code.

Rationale

I found the official MyJDownloader documentation incomplete, imprecise, outdated, and unreliable, making development based solely on it highly impractical.

"The API changes regularly, changes in this document will happen every so often" - MyJDownloader Developers

This project was initiated by porting the proven and reliable logic from the My.Jdownloader-API-Python-Library to ensure stability and correctness in the JavaScript environment.

Features

• Standard ES Modules: Import directly in Node.js (v18+) or modern browsers.

• Zero Dependencies: Relies on native crypto.subtle and fetch API.

• Security: Handles the mandatory API security procedure using AES128CBC encryption and HMAC-SHA256 for message integrity.

• Async/Await: Fully asynchronous architecture.

• Direct Connection: Support for local IP connection with automatic fallback to Relay.

Installation

npm install

Usage

import { MyJDApi } from './dist/jdapi.esm.js';

(async () => {
    // 1. Initialize the API client
    const api = new MyJDApi();

    // 2. Set the application key (optional, but recommended)
    api.setAppKey("My_New_JD_CLient_0.1");

    // 3. Connect using username and password
    await api.connect("email@example.com", "password");

    // Successful connection auto updates the device list
    // await JD.updateDevices();

    // Retrieve device list from the cache
    // const devices = api.listDevices();

    // 3. Get a specific device by name or get the first device in the list
    const deviceName = localStorage.getItem('device') || null;
    const device = api.getDevice(deviceName);

    // 4. Query the packages list from the download queue
    const queryParams = {
        "bytesLoaded" : true,
        "bytesTotal" : true,
        "comment" : false,
        "enabled" : true,
        "eta" : true,
        "priority" : false,
        "finished" : true,
        "running" : true,
        "speed" : true,
        "status" : true,
        "childCount" : true,
        "hosts" : true,
        "saveTo" : true,
        "maxResults" : -1,
        "startAt" : 0,
    };

    const packages = await device.downloads.queryPackages([queryParams]);

    console.log(`Successfully retrieved ${packages.length} packages from device:`, device.name);
    // console.log(packages); // Uncomment to see package details
})();

Development

• Build: Minify and bundle using esbuild.

npm run build

• Docs: Generate JSDoc documentation.

npm run doc

Credits

This library is a direct port of the Python library created by mmarquezs. Original Repo: My.Jdownloader-API-Python-Library