@nqbt/node

Node-focused helpers for nqbt.

Installation

npm install @nqbt/node

Launch qBittorrent

Use launchQBittorrent to directly open qBittorrent application.

import { launchQBittorrent } from '@nqbt/node';

const result = await launchQBittorrent();

console.log(result.command, result.pid);

API

interface LaunchQBittorrentOptions {
  executablePath?: string;
  args?: string[];
  cwd?: string;
  env?: NodeJS.ProcessEnv;
}

interface LaunchQBittorrentResult {
  platform: NodeJS.Platform;
  command: string;
  args: string[];
  pid?: number;
  attempts: string[];
}

Platform behavior

• macOS: uses open -a qBittorrent by default.
• Windows: tries qbittorrent.exe, then qbittorrent, then default install paths under Program Files.
• Linux: tries qbittorrent.

To bypass auto detection, pass executablePath manually.

await launchQBittorrent({
  executablePath: '/Applications/qBittorrent.app/Contents/MacOS/qBittorrent',
  args: ['--profile=/tmp/qb']
});

License

MIT License © 2025 XLor