A personal film and TV show tracking system that lets you log, rate, and comment on everything you watch.

• 📺 Watch Tracking: Record films, TV series, and shows you've watched

• ⭐ Rating System: Rate content on a customizable scale

• 💭 Personal Notes: Add comments and thoughts for each entry

• 📊 Organized Library: Keep your entire viewing history in one place

• Python 3.8+
• PostgreSQL (or your preferred database)
• pip or uv for package management

git clone https://github.com/wns444/filmography
cd filmography
pip install -r requirements.txt  # or use uv/pipenv/poetry

cp .env.example .env
# Edit .env with your database credentials

# Initialize database migrations
alembic upgrade head

# Development server
uvicorn app.main:app --reload

Once running, access:

• API Documentation: http://localhost:8000/docs (Swagger UI)

• Alternative Docs: http://localhost:8000/redoc (ReDoc)

• Check existing issues or create a new one

• Ensure your database is running and accessible

• Verify all environment variables are set correctly

Enjoy tracking your film journey! 🎬