Rust Download Manager

• A "usable" download manager. Emphasis on usable.
• Resume support on most connections like other download managers.
• Efficient as Fuck.
• Written in rust so it must be cool. Emphasis on must.
• Linux only.

HoW To uSe

RDM — Rust Download Manager

Usage: rdm [OPTIONS] [URL]
       rdm <COMMAND>

Commands:
  download  Download a single URL [aliases: d]
  sync      Mirror a remote directory listing into a local directory
  queue     Manage the download queue [aliases: q]
  config    Show the effective configuration
  help      Print this message or the help of the given subcommand(s)

Arguments:
  [URL]  URL to download (shorthand for `rdm download <URL>`)

Options:
  -o, --output <PATH>     Output file or directory [default: download_dir from config]
  -c, --connections <N>   Connections per file [default: connections from config]
      --allow-private     Allow scanning private, loopback and link-local addresses [aliases: --ap]
  -q, --quiet             Suppress progress output
  -p, --parallel <N>      Files to download concurrently if <URL> is a directory listing [default: queue_parallel from config]
  -h, --help              Print help
  -V, --version           Print version

Defaults for -c/-p and the download directory come from config.toml.
Run `rdm config` to see the values currently in effect.

-p applies only when <URL> is a directory listing, which is expanded into
the queue and downloaded concurrently.

sync and queue have options of their own — see `rdm sync --help` and
`rdm queue --help`.

If you have set up the path variable like a normal person then you can reproduce the above wall of text by typing 'rdm', assuming the variable is rdm.

-o, -c, --allow-private and -q work on every download path: bare rdm <URL>, rdm download, rdm sync and rdm queue add. --ap is a shorthand for --allow-private.

Sync

rdm sync <URL> [-o dir] [-c N] [-p N] [-d] [-e flac,mkv]

  -p, --parallel <N>   Files to download concurrently [default: queue_parallel from config]
  -d, --delete         Delete local files that no longer exist on the remote
  -e, --ext <EXT>      Only sync these extensions (repeatable or comma separated)

-o sets the output path only for a sync, not a filename. -e takes a comma separated list or repeated flags, with or without leading dots, and is case insensitive: -e flac,mkv and -e .flac -e .MKV do the same thing.

Queue

rdm queue add <URL> [-o name] [-c N]     Add to queue                [a]
rdm queue list                           Show queue                  [ls, l]
rdm queue start [-p N]                   Start processing            [run, s]
rdm queue stop                           Stop after current download
rdm queue skip                           Skip the download(s) in flight  [next, n]
rdm queue remove <ID>                    Remove one item             [rm]
rdm queue retry [ID|failed|skipped]      Requeue items               [r]
rdm queue clear [pending|done]            Clear queue (all by default)   [c]

-p on queue start defaults to queue_parallel from the config.

Directory-looking URLs are scraped: rdm <URL> on a listing enqueues everything it finds and starts downloading, and rdm queue add <URL> enqueues without starting.

Hoster Section

• mega - click to view
• gofile - click to view
• dropbox - click to view
• onedrive - click to view
• gdrive - click to view
• pixeldrain - click to view

Example Config File

# Parallel connections per file
connections = 12

# Default download directory
download_dir = "~/Downloads"

# Max Retries?
max_retries = 69

# multi-file download at once
queue_parallel = 5

# MEGA: chunk workers per file
mega_workers = 6

# MEGA: verify the MAC after downloading. Costs a full reread of the file.
# Turning this off means silent corruption stays silent.
mega_verify_mac = true

# MEGA: when quota-blocked, resume early if your public IP changes
mega_resume_on_ip_change = true

# GoFile: how many files to download at once (max 10)
gofile_workers = 5

# GoFile: your account token
gofile_token = ""

# OneDrive: how many files to download at once (max 15)
onedrive_workers = 5

# Google Drive: how many files to download at once (max 15)
# Drive's quota is per key per second, so a big number buys 403s
gdrive_workers = 5

# Google Drive: API key. Optional — a folder still lists without one, but only
# the API pages a listing to the end and gives every file a size.
# RDM_GDRIVE_API_KEY overrides this for a single run.
gdrive_api_key = ""

# Google Drive: what a Doc, Sheet, Slide deck or Drawing is exported as.
# An extension (pdf, docx, xlsx, csv, png, ...) or "office"
gdrive_doc_format = "pdf"

# pixeldrain: how many files of a list to download at once (max 10)
pixeldrain_workers = 4

# pixeldrain: API key. Optional — it buys speed, not access: anonymous
# transfers are capped and an account's are not.
# RDM_PIXELDRAIN_API_KEY overrides this for a single run.
pixeldrain_api_key = ""

Everything in the config is optional as they have their own defaults.

Environment

All optional, there are other hoster specific env variables which can find in the relevant hoster sections.

Variable	Effect
RDM_MAX_FILE_BYTES	Size ceiling for one streaming download. Default 64 GiB, 0 removes it
RDM_ALLOW_PRIVATE	Same as --allow-private
RDM_ALLOW_PROXY	Let HTTP_PROXY / HTTPS_PROXY / ALL_PROXY apply to RDM's requests

• RDM_ALLOW_PRIVATE and RDM_ALLOW_PROXY are off unless set to 1, true, yes or on. Setting either to nothing, or to false, leaves the protection on.
• RDM_MAX_FILE_BYTES only bites when a server refuses to say how big a file is.

Release

Zack encourages you to build from source. As some random internet person once said, "Always build from source" NixOS users get a flake for easy installation :)

Build From Source

git clone https://github.com/MasterZack69/rdm
cd rdm
cargo build --release

Credits

• MasterZack69 - Of course I am getting the Credits
• Claude Opus 4.6 - Wrote the code, fixed the bugs
• GPT 5.2 - Asked “what if it races?” one too many times
• Claude Opus 4.7 - Here to do everything better
• Claude Opus 5 - Clap Migration, Queue System and Hosters
• DeepSeek V4 Flash - Clippy error fixer

Prior art

• MegaBasterd
• gofile-downloader
• onedrive-downloader
• goodls
• gdown
• pixeldrain-downloader