OneDL is a universal downloader for the command line — a single tool to download content via torrents, hosters, MEGA folders, and direct HTTP(S) links with support for Real-Debrid, AllDebrid, Premiumize.me and TorBox.
Whether you're pasting a magnet link or unlocking hoster URLs, OneDL handles everything from resolving links to downloading files with a clean, interactive terminal interface.
- ✅ Supports magnet links, hoster URLs, MEGA folders, Torrent files, NZB files, and direct HTTP(S) links
- ✅ Integrates with:
- ✅ Automatically finds the best debrid service for your link
- ✅ Lets you select specific files from torrents, NZBs, and containers
- ✅ Shows real-time download progress with speeds
- ✅ Works entirely from your terminal — no GUI needed
Make sure Python 3 is installed:
python3 --version
If it's not installed, download it from python.org or install it using your system’s package manager.
The only required external Python packages are requests
and bencodepy
. Install them with:
pip install requests bencodepy
Use
pip3
if you're on a system wherepip
refers to Python 2.
Download OneDL.py
directly from GitHub:
curl -o OneDL.py https://raw.githubusercontent.com/ellite/OneDL/refs/heads/main/OneDL.py
chmod +x OneDL.py
To make onedl
available from any folder, create a hard link:
sudo ln OneDL.py /usr/local/bin/onedl
Now you can simply run:
onedl
-
Run the script:
onedl
-
Choose how to provide your links:
- Load from a file
- Paste manually
- Use a debrid service
-
If using a debrid service:
- Select Real-Debrid, AllDebrid, Premiumize.me, Torbox, or "Find best option"
- Paste your magnet, hoster, or HTTP(S) URL when prompted, or upload a .torrent or .nzb file
-
Select specific files (if applicable), and OneDL will download them to your current folder.
At the top of the OneDL.py
script, configure your API tokens:
REAL_DEBRID_API_TOKEN = "your_real_debrid_token"
ALLDEBRID_API_TOKEN = "your_alldebrid_token"
PREMIUMIZE_API_TOKEN = "your_premiumize_token"
TORBOX_API_TOKEN = "your_torbox_token"
Tokens are optional — just set the ones you have access to.
AGPLv3