A minimal terminal-based tracker for Anime, Manga, TV Shows, and Movies.
██████╗██╗ ██╗██╗██████╗ ██████╗
██╔════╝██║ ██║██║██╔══██╗██╔═══██╗
██║ ███████║██║██████╔╝██║ ██║
██║ ██╔══██║██║██╔══██╗██║ ██║
╚██████╗██║ ██║██║██║ ██║╚██████╔╝
╚═════╝╚═╝ ╚═╝╚═╝╚═╝ ╚═╝ ╚═════╝
- Track anime, manga, TV shows, and movies in separate lists
- Auto-fetches metadata (title, total episodes/chapters) via Jikan and TMDB
- Smart auto-status:
Planning → Watching/Readingon first progress,→ Completedwhen total is reached - Status priority system — higher statuses (
Watching,On-Hold) are never auto-downgraded - Per-session auto-save after every add, update, or delete
refreshcommand to back-fill missing totals- Arrow key navigation and command history (via
readline)
- Python 3.7+
requestslibrary
pip install requests
git clone [https://github.com/toriqul728/chiro-cli](https://github.com/toriqul728/chiro-cli)
cd chiro-cli
chmod +x chiro.py
ln -s chiro.py chiro
Get a free API key at themoviedb.org, then add it to chiro by running python3 chiro_live.py tv or python3 chiro_live.py movie.
The configuration file is created automatically on your first run. Anime and manga tracking work completely out of the box without an API key.
python3 chiro.py <category>
Categories: anime, manga, tv, movie
| Command | Description |
|---|---|
list |
Show all entries sorted alphabetically |
add |
Search and add a new entry |
update |
Update progress, status, or rating for an entry |
delete |
Remove an entry |
refresh |
Re-fetch totals for entries with unknown (?) counts |
clear |
Clear the terminal |
exit |
Save and quit |
Planning → Watching / Reading → On-Hold → Dropped → Completed
Status is auto-managed based on progress but will never be downgraded automatically. The only forced override is Completed when progress hits the total volume.
All configuration files and lists are saved locally within the main project root directory:
chiro-cli/
├── config.json # API keys
├── anime_list.json
├── manga_list.json
├── tv_list.json
└── movie_list.json
- TV totals reflect the full series episode count across all seasons (sourced from TMDB). If you prefer to track season-by-season, update the total manually via the
updatecommand. - Anime and manga data is sourced from MyAnimeList via the Jikan API. Results are based on the closest title match.
MIT