bangumi-tracker

name	bangumi-tracker
description	Manage Bangumi collections and track watch progress via OAuth. Use when user wants to track anime/book/game/music progress, manage wish/doing/collect lists, or access personal Bangumi data.
compatibility	Requires Python 3.9+, Bangumi account, and browser for OAuth flow.
metadata	{"author":"MountLynx","version":"1.1","api_version":"v0"}

Bangumi Tracker

Manage your Bangumi collections and track watch/read progress.

First Time Setup

Step 1: Create OAuth App

1. Visit https://bgm.tv/dev/app/create
2. Fill in:
   • App Name: bangumi-tracker
   • Homepage URL: http://localhost:17321
   • Callback URL: http://localhost:17321/callback
3. Get your Client ID and Client Secret

Step 2: Configure

python bangumi_tracker.py config --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET

Step 3: Authenticate

python bangumi_tracker.py auth

Opens browser for OAuth authorization.

Quick Commands

# Check status
python bangumi_tracker.py status

# List collections
python bangumi_tracker.py collections
python bangumi_tracker.py collections --type anime --status doing

# Add/update
python bangumi_tracker.py collect 428477 doing

# Remove from collection
python bangumi_tracker.py uncollect 428477

# Get progress
python bangumi_tracker.py progress 428477

# User info
python bangumi_tracker.py me

# === Character Collection ===
# Collect/uncollect character
python bangumi_tracker.py collect-character 42084 collect
python bangumi_tracker.py collect-character 42084 uncollect

# List collected characters
python bangumi_tracker.py my-characters

# === Person Collection ===
# Collect/uncollect person
python bangumi_tracker.py collect-person 12345 collect
python bangumi_tracker.py collect-person 12345 uncollect

# List collected persons
python bangumi_tracker.py my-persons

# === Episode Progress ===
# Get episode collection status
python bangumi_tracker.py episodes 428477

# Mark episode as watched/unwatched
python bangumi_tracker.py watch 123456 watched
python bangumi_tracker.py watch 123456 unwatched

Security

• Windows: Credentials stored in Windows Credential Manager
• Other platforms: Credentials stored in ~/.bangumi/
• Tokens auto-refresh when expired

More Info

• Command Reference
• API Documentation