GenAI - Building a Custom, Lightweight TV Show Tracker
The Problem With so many streaming services and network schedules, keeping track of when new television serials drop is exhausting. Relying on heavy, ad-filled tracking websites or bloated third-party apps often feels like overkill just to answer one simple question: "Is the new episode out yet?"
The Solution To solve this, I built a lightweight, standalone Windows desktop application designed to do one thing perfectly: track television release schedules silently and visually, without requiring accounts, subscriptions, or background bloatware.
- Visual Watchlist Grid: On launch, the app reads a simple, user-managed text file of followed shows and generates a clean, responsive grid of official cover art. Each poster features a badge indicating the current season.
- Instant Episode Intel: Hovering over any show’s poster reveals a quick tooltip with the release date of its most recent episode. Clicking the poster opens a detailed view where users can select any season from a dropdown to see a full list of episode titles, numbers, and airdates.
- The "Upcoming" Radar: A dedicated, permanent sidebar on the right aggregates the absolute next upcoming episode across the entire watchlist. It sorts them chronologically so the soonest releases are always at the top. It features a toggle to switch between a dense "Compact" view and a more spaced-out "Relaxed" view.
- Smart Archiving: Not currently watching a show, but want to know when it returns next year? The app features an "Archive" system. Archiving a show hides it from the main grid to reduce clutter, but keeps it active in the database. If an archived show suddenly announces a new episode, it still pops up in the Upcoming sidebar.
- On-the-Fly Management: Users can add new shows, permanently remove them, or send them to the archive directly from the UI. The app instantly updates the underlying local text files, ensuring the data is strictly saved to the user's hard drive.
Under the Hood (The Tech Stack)
- Language & UI: Written in Python using the PyQt/PySide6 framework for a native, responsive Windows desktop interface (complete with custom dark/high-contrast styling).
- Data Source: Powered by the free, authenticationless TVMaze API, utilizing asynchronous threading to fetch metadata and cover art without freezing the UI.
- Deployment: Compiled via PyInstaller into a single, portable
.exefile with a custom retro-TV desktop icon. It runs completely on-demand, consuming zero system resources when closed.