Command Line Reference

Command line reference

Every odyssey.py subcommand, listed honestly and without fluff.

Global

python odyssey.py                    # opens the interface (TUI) — same as `ui`
python odyssey.py ui                 # the interface, explicitly

Search

python odyssey.py search "ubuntu 24.04" --sort smart --min-seeds 5 -n 10
python odyssey.py search "frieren" --cached            # only ⚡ instant results
python odyssey.py search "frieren" --download 0        # grab the top hit through RD

Flag	Meaning
--sort	smart (default) / seeds / size / name
--min-seeds N	drop results under N seeders
-n N	number of results to show
--cached	only results already in RD's cache
--download N	download result index N immediately

Download

python odyssey.py download "magnet:?xt=urn:btih:..."   # direct magnet

Takes a magnet link and runs the whole RD pipeline on it.

Account & cloud

python odyssey.py status            # RD account, traffic, plan
python odyssey.py rd --delete 2     # remove RD cloud item by index

status is the quick way to check quota before a big download.

Local database

python odyssey.py history            # everything you searched
python odyssey.py history --clear    # wipe it
python odyssey.py downloads          # recently grabbed files
python odyssey.py blacklist          # results you hid
python odyssey.py blacklist --wipe   # un-hide everything. your call.

Preferences

python odyssey.py prefs --sort smart --dl-dir "D:\videos"

Persistent options are saved to ~/.odyssey and used on every launch.

Token

python odyssey.py token <your-token>

Sets or replaces the encrypted RD token. The interface's t key does the same.