Installation

Installation

OdysseySearch is a single Python script with four dependencies. Requires Python 3.10+.

Step by step

git clone https://github.com/NikolisSec/OdysseySearch.git
cd OdysseySearch
pip install -r requirements.txt

That installs:

Package	Why it's there
requests	talking to the trackers and to Real-Debrid
cryptography	encrypting your token before it touches disk
textual	the terminal interface (TUI)
beautifulsoup4	pulling magnets out of tracker detail pages

Add your Real-Debrid token

Get one at https://real-debrid.com/apitoken, then:

python odyssey.py token <your-token>

or press t inside the interface and paste it there.

The token is encrypted with PBKDF2 (600,000 iterations) + Fernet before it's written to ~/.odyssey/settings.db. It never appears in the repo, the shell history, or this wiki.

Common setup problems

Problem	Fix
python not found / old version	install Python 3.10+ and check python --version
pip install permission errors	add --user or use a venv
ModuleNotFoundError: textual	make sure pip install -r requirements.txt ran inside the repo folder
RD says "bad token"	paste the token again with python odyssey.py token — it must be exact

Updating

git pull

OdysseySearch stores all its data outside the repo (~/.odyssey), so git pull never touches your token, history, or blacklist.