Usage and Keyboard Shortcuts

Usage & keyboard shortcuts

The interface is textual-based: navigate with arrow keys and type in the search box.

Launch

python odyssey.py       # opens the interface
python odyssey.py ui    # same thing, but louder

The workflow that works

1. Press / and type your search (arrow keys browse previous searches).
2. Skim the results — each shows title, source(s), size, seeders, and a ⚡ if it's already cached on RD.
3. Press c to show only cached results when you want speed.
4. Press Enter to download the focused row — or Space a bunch and press d to queue them.
5. Watch the progress bar, enjoy the file.

Full key map

Key	Action
/	focus the search box (↑/↓ browse history)
Enter	download this torrent
Space	mark / unmark for the queue
Esc	clear all marks
d	start downloading the marked queue
o	cycle sort order: smart → seeds → size → name
f	filter by source tracker
c	toggle ⚡ cached-only mode
C	clear all filters
x	hide this result forever (blacklist)
m	copy the magnet link
t	set / replace the RD token
r	refresh the current search
s	show RD account / cloud status
?	toggle the help overlay
q	quit

Search syntax

• Plain text works: Mr. Robot 1080p
• min:N in the query filters by seed count: Mr. Robot 1080p min:20 → only non-spam 1080p results with 20+ seeders.
• Combine with f (source) and c (cached-only) to narrow fast.

Downloads

• Files land in ~/Downloads/Odyssey/ by default.
• Change the destination permanently:

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

• If a download dies with a 403 mid-flight, the RD link expired — run it again. The tool refuses to save the error page as your movie (we removed that bug).