real-debrid-downloader/README.md

Multi Debrid Downloader

Desktop downloader for Real-Debrid, Mega-Debrid, BestDebrid, and AllDebrid with fast queue management, automatic extraction, and robust error handling.

Why this tool?

• Familiar download-manager workflow: collect links, start, pause, resume, and finish cleanly.
• Multiple debrid providers in one app, including automatic fallback.
• Built for stability with large queues: session persistence, reconnect handling, resume support, and integrity verification.

Core features

Queue and download engine

• Package-based queue with file status, progress, ETA, speed, and retry counters.
• Start, pause, stop, and cancel for both single items and full packages.
• Duplicate handling when adding links: keep, skip, or overwrite.
• Session recovery after restart, including optional auto-resume.

Debrid and link handling

• Supported providers: realdebrid, megadebrid, bestdebrid, alldebrid.
• Configurable provider order: primary + secondary + tertiary.
• Optional automatic fallback to alternative providers on failures.
• .dlc import via file picker and drag-and-drop.

Extraction, cleanup, and quality

• Auto-extract with separate target directory and conflict strategies.
• Hybrid extraction, optional removal of link artifacts and sample files.
• Post-download integrity checks (CRC32, MD5, SHA1) with auto-retry on failures.
• Completed-item cleanup policy: never, immediate, on_start, package_done.

Convenience and automation

• Clipboard watcher for automatic link detection.
• Minimize-to-tray with tray menu controls.
• Speed limits globally or per download.
• Bandwidth schedules for time-based speed profiles.
• Built-in update checks via GitHub Releases.

Installation

Option A: prebuilt releases (recommended)

1. Download a release from the GitHub Releases page.
2. Run the installer or portable build.
3. Add your debrid tokens in Settings.

Releases: https://github.com/Sucukdeluxe/real-debrid-downloader/releases

Option B: build from source

Requirements:

• Node.js 20+ (recommended 22+)
• npm
• Windows 10/11 (for packaging and regular desktop use)
• Optional: 7-Zip/UnRAR for specific archive formats

npm install
npm run dev

NPM scripts

Command	Description
npm run dev	Starts main process, renderer, and Electron in dev mode
npm run build	Builds main and renderer bundles
npm run start	Starts the app locally in production mode
npm test	Runs Vitest unit tests
npm run self-check	Runs integrated end-to-end self-checks
npm run release:win	Creates Windows installer and portable build

Typical workflow

1. Add provider tokens in Settings.
2. Paste/import links or .dlc containers.
3. Optionally set package names, target folders, extraction, and cleanup rules.
4. Start the queue and monitor progress in the Downloads tab.
5. Review integrity results and summary after completion.

Project structure

• src/main - Electron main process, queue/download/provider logic
• src/preload - secure IPC bridge between main and renderer
• src/renderer - React UI
• src/shared - shared types and IPC contracts
• tests - unit tests and self-check tests

Data and logs

The app stores runtime files in Electron's userData directory, including:

• rd_downloader_config.json
• rd_session_state.json
• rd_downloader.log

Troubleshooting

• Download does not start: verify token and selected provider in Settings.
• Extraction fails: check archive passwords and extraction tool availability.
• Very slow downloads: check active speed limit and bandwidth schedules.
• Unexpected interruptions: enable reconnect and fallback providers.

Changelog

Release history is available in CHANGELOG.md and on GitHub Releases.

License

MIT - see LICENSE.