Watch

TUI tool to interact with Trakt.tv

Python 97.4%
Just 2.6%

Find a file

Repository files (latest commit first)
Filename	Latest commit message	Latest commit date
Marvin8 e08f12a593 All checks were successful / pr-review (push) Has been skipped Details / pr-review (release) Has been skipped Details / gitleaks (push) Successful in 17s Details / gitleaks (release) Successful in 27s Details / pytest-betas (push) Successful in 1m20s Details / pytest-betas (release) Successful in 1m33s Details / checks (push) Successful in 2m41s Details / publish (push) Has been skipped Details / checks (release) Successful in 2m57s Details / deploy-docs (release) Has been skipped Details / publish (release) Successful in 29s Details / deploy-docs (push) Successful in 1m19s Details 🔧 bump: version 0.6.1 → 0.6.2		2026-08-07 14:29:51 +10:00
.forgejo/workflows	🚚 update all codeberg.org references to forge.marvin8.zone	2026-08-07 13:59:41 +10:00
docs	📝 fix Codeberg→Forgejo labels caught by WuMing	2026-08-07 14:08:22 +10:00
Icon	Feat: Renamed project to "Kokopelli"	2026-03-13 13:58:36 +10:00
src/kokopelli	♻️ extract helpers to reduce _ensure_initial_credentials complexity	2026-07-11 09:49:40 +10:00
tests	🐛 always prompt for credentials in --configure, show stored value as default	2026-07-11 08:35:07 +10:00
.editorconfig	Proof of concept.	2025-03-28 09:51:23 +10:00
.gitignore	Feat: Replaced some of the generic typing with TypedDict	2026-03-13 11:39:06 +10:00
.gitleaks.toml	🔧 Remove .secrets.baseline and add gitleaks path allowlist	2026-06-04 19:12:16 +10:00
.pre-commit-config.yaml	🚚 update all codeberg.org references to forge.marvin8.zone	2026-08-07 13:59:41 +10:00
.python-version	🔧 Add git-cliff dev dep and remove stale Release-Notes bumpversion entry	2026-06-05 07:47:27 +10:00
CHANGELOG.md	🔧 update changelog for 0.6.2	2026-08-07 14:29:45 +10:00
CLAUDE.md	📝 move superpowers path rule to global CLAUDE.md	2026-07-11 11:12:57 +10:00
IMPROVEMENTS.md	✨ wire recommendations pagination into TUI	2026-07-10 19:34:23 +10:00
IMPROVEMENTS_detail.md	📝 Add IMPROVEMENTS_detail.md sidecar to preserve metric data	2026-06-04 18:13:16 +10:00
justfile	🔧 extract reset-release-notes recipe from fediverse-post	2026-08-07 14:22:39 +10:00
LICENSE.md	Added movie collections.	2025-04-06 08:04:12 +10:00
mkdocs.yml	🚚 update all codeberg.org references to forge.marvin8.zone	2026-08-07 13:59:41 +10:00
mypy.ini	Added movie collections.	2025-04-06 08:04:12 +10:00
noxfile.py	⬆️ bump deps	2026-07-10 17:36:32 +10:00
pylock.toml	🔒 add click>=8.3.3 constraint for PYSEC-2026-2132	2026-08-07 14:04:13 +10:00
pyproject.toml	🔧 bump: version 0.6.1 → 0.6.2	2026-08-07 14:29:51 +10:00
README.md	📝 add documentation URL to pyproject.toml, README, and CLAUDE.md	2026-07-11 06:49:34 +10:00
Release-Notes.md	🔧 bump: version 0.6.1 → 0.6.2	2026-08-07 14:29:51 +10:00
Release-Notes.md.template	📝 fix Codeberg→Forgejo labels caught by WuMing	2026-08-07 14:08:22 +10:00
ruff.toml	Many Changes:	2025-07-29 19:25:38 +10:00
uv.lock	🔧 bump: version 0.6.1 → 0.6.2	2026-08-07 14:29:51 +10:00

README.md

kokopelli

A terminal UI for browsing and acting on Trakt.tv recommendations. Rate, hide, or mark items as seen — all from the keyboard.

Kokopelli is a fertility deity and trickster figure venerated across the American Southwest by Hopi, Zuni, and other Pueblo peoples. Depicted as a humpbacked flute player, he travels from village to village bringing seeds, songs, and stories — things people didn't know they needed until he arrived. The name felt right for a tool whose purpose is to surface films and shows worth your time.

Documentation

https://kokopelli.marvin8.zone

Installation

uv tool install kokopelli

Configuration

kokopelli --configure

Credentials are stored at $XDG_CONFIG_HOME/kokopelli/credentials.toml (defaults to ~/.config/kokopelli/credentials.toml).

Usage

kokopelli

Key	Action
`m` / `s`	Switch between Movies and TV Shows
`Enter`	Show details
`h`	Hide item
`r`	Rate item
`w`	Mark as watched
`I`	Open TMDB page in browser
`q`	Quit

License

AGPL-3.0