Skip to content

README.md

Latest commit

 

History

History
139 lines (92 loc) · 3.31 KB

README.md

File metadata and controls

139 lines (92 loc) · 3.31 KB

OneDL

OneDL Logo

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.

✨ Features

  • ✅ 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

🛠️ Installation

1. Install Python

Make sure Python 3.10 or newer is installed:

python3 --version

If it's not installed, download it from python.org or install it using your system’s package manager.

2. Install Required Package

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 where pip refers to Python 2.

3. Download the Script

Download OneDL.py directly from GitHub:

curl -o OneDL.py https://raw.githubusercontent.com/ellite/OneDL/refs/heads/main/OneDL.py
curl -o ~/.onedl.conf https://raw.githubusercontent.com/ellite/OneDL/refs/heads/main/.onedl.conf
chmod +x OneDL.py

4. Make It Globally Accessible (Optional)

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

🔄 Update

curl -o OneDL.py https://raw.githubusercontent.com/ellite/OneDL/refs/heads/main/OneDL.py

🚀 Usage

  1. Run the script:

    onedl

  2. Choose how to provide your links:

    • Load from a file
    • Paste manually
    • Use a debrid service

  3. 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

  4. Select specific files (if applicable), and OneDL will download them to your current folder.

🔐 API Configuration

OneDL uses a configuration file to store your API keys securely. This file is named .onedl.conf and is usually located in your home directory.

  1. Open the configuration file
nano ~/.onedl.conf
  1. Paste your API keys inside the quotes for the services you want to use:
{
  "REAL_DEBRID_API_TOKEN": "",
  "ALLDEBRID_API_TOKEN": "",
  "PREMIUMIZE_API_TOKEN": "",
  "TORBOX_API_TOKEN": "",
  "DEBRID_LINK_API_TOKEN": ""
}

Tokens are optional — just set the ones you have access to.

Screenshot Screenshot

📄 License

AGPLv3