TV Movie Tracker App

A personal web app to track TV shows and movies you’re watching, built with Astro and Svelte.
Data is stored in a GitHub Gist as a Markdown file—so you can view and edit your tracker directly in Obsidian or any Markdown editor.

Features

• Add, edit, and delete TV shows and movies
• Track status (Watching, Paused, Completed, Plan to Watch)
• Record genre, last watched episode, rating, and notes
• Filter by status with tabs
• Data is stored in a Markdown file on your GitHub Gist
• View and edit your tracker in Obsidian or any Markdown editor
• Export your list as JSON or Markdown for backup

Getting Started

1. Clone the Repo

git clone https://github.com/leifjerami/tv-movie-tracker.git
cd tv-movie-tracker

2. Install Dependencies

bun install

3. Set Up Your GitHub Gist

1. Go to gist.github.com ↗ and create a new Secret Gist.
2. Name the file ‎tv-movie-tracker.md and start with this content:

# TV & Movie Tracker

4. Create a GitHub Personal Access Token

1. Go to GitHub Tokens ↗.
2. Click Generate new token (classic).
3. Give it a name and select the gist scope.
4. Copy the token (starts with ‎ghp_...).

5. Configure the App

• In ‎src/lib/gistApi.js, set your Gist ID and filename:

const GIST_ID = 'your_gist_id_here';
const GIST_FILENAME = 'tv-movie-tracker.md';

6. Run the App

bun dev

File Structure

tv-movie-tracker/
├── src/
│   ├── components/
│   │   └── Tracker.svelte
│   ├── lib/
│   │   └── gistApi.js
│   └── pages/
│       └── index.astro
├── package.json
├── astro.config.mjs
├── README.md
└── ...

Data Format

Your tracker data is stored in Markdown, e.g.:

# TV & Movie Tracker

## My Show (TV Show)
- **Status:** Watching
- **Genre:** KDrama
- **Last Watched (EP):** 5
- **Rate:** 8/10
- **Notes:** Fun!

## My Movie (Movie)
- **Status:** Completed
- **Genre:** Sci-Fi
- **Rate:** 9/10

Backups

• Use the Export as JSON or Export as Markdown buttons in the app to back up your data at any time.
• You can also view and edit your tracker directly in Obsidian or any Markdown editor.

Deployment

You can deploy this app to any static host, such as:

• GitHub Pages (for static builds)
• Netlify
• Vercel

License

MIT

Enjoy tracking your TV shows and movies!