JDownloader-RemoteCli 0.1.9

JDownloader Remote CLI (jdr)

A human-first command-line interface for My.JDownloader (remote control for JDownloader), built with .NET 10 and Spectre.Console.Cli.

• Default output is human-friendly (tables / concise lines).
• Use --json for stable machine-readable output.

Installation

dotnet tool install -g JDownloader-RemoteCli

Upgrade:

dotnet tool update -g JDownloader-RemoteCli

Quick Start

# 1) Login (stores encrypted auth material in a local profile)
echo "YOUR_PASSWORD" | jdr auth login --email you@example.com --password-stdin

# 2) Pick a device (or set a default in your profile)
jdr device list
jdr device use --device "Your JDownloader Device Name"

# 3) Inspect current state
jdr downloads status
jdr grabber packages list
jdr grabber links list

# 4) Scriptable output
jdr grabber links list --json

Commands

Run jdr --help or jdr <group> --help for full details.

Global Options (Selected)

Environment variables that influence defaults include: JD2_PROFILE, JD2_DEVICE, JD2_OUTPUT, JD2_TIMEOUT, JD2_CONFIG, JD2_KEYFILE.

Docs

Common workflow guides:

• Authentication: docs/Common_UseCases/01_Authentication.md
• Profiles & config: docs/Common_UseCases/02_Profiles_And_Config.md
• Devices: docs/Common_UseCases/03_Devices.md
• Grabber + downloads: docs/Common_UseCases/04_Grabber_And_Downloads.md
• Scripting & automation: docs/Common_UseCases/05_Scripting_And_Automation.md
• Generated CLI reference: docs/clidoc/index.md

Building from Source

git clone https://github.com/JKamsker/JDownloader-RemoteCli.git
cd JDownloader-RemoteCli
dotnet test -c Release
dotnet run --project src/JDownloader.Cli -- doctor

Dev: formatting + hooks

This repo uses dotnet format. To enable the committed pre-commit hook:

git config core.hooksPath .githooks

The hook only formats staged C# files, then runs the shared C# guideline check (scripts/check-csharp-guidelines.sh) to warn above 300 lines, fail above 500 lines, reject non-generated partial type declarations, and reject Foo.Bar.cs-style filename sharding next to Foo.cs unless explicitly excluded. The repo pins the required .NET SDK via global.json, and CI runs the same C# check.