Seenit! - Episode Tracker

Your personal series companion that lives in your browser
Keep track of your favorite TV shows with a beautiful, intuitive interface

Features • Installation • Development • Tech Stack • License

---

Features

Core Functionality

• Series Tracking - Add and track multiple TV series with complete metadata
• Progress Monitoring - Visual progress bars for seasons and episodes
• Episode Management - Mark episodes as watched/unwatched with a single click
• Favorites System - Star your favorite series for quick access
• Smart Search - Search for new series to track
• Filter & Sort - Filter series by title or genre

Data Management

• 100% Local Storage - All data stored locally using Chrome Storage API
• Export/Import - Backup and restore your tracking data
• Auto-Refresh - Keep series metadata up to date

---

Installation

Install from Store

  

Install Manually

For Chrome

1. Download the latest release or build from source
2. Open Chrome and navigate to chrome://extensions
3. Enable "Developer mode" (toggle in top-right)
4. Click "Load unpacked"
5. Select the dist_chrome folder

For Firefox

1. Download the latest release or build from source
2. Open Firefox and navigate to about:debugging#/runtime/this-firefox
3. Click "Load Temporary Add-on"
4. Select any file in the dist_firefox folder (e.g., manifest.json)

---

Development

Prerequisites

• Node.js >= 24
• npm

Setup

# Clone the repository
git clone https://github.com/farengeyt451/seenit-extension.git
cd seenit-extension

# Install dependencies
npm install
# or
yarn install

Development Mode

# Start development for Chrome (with hot reload)
npm run dev:chrome

# Start development for Firefox (with hot reload)
npm run dev:firefox

Build for Production

# Build for Chrome
npm run build:chrome

# Build for Firefox
npm run build:firefox

Output will be in dist_chrome or dist_firefox folders.

---

Tech Stack

Core Technologies

• React 19
• TypeScript 5.9
• Vite 7.3
• Tailwind CSS 4.1

State Management & Data

• Zustand 5.0
• Immer 11.1
• Zod 4.2
• Chrome Storage API

UI Components

• Headless UI 2.2
• Heroicons 2.2
• React Rewards 2.1

Utilities

• Luxon 3.7
• Axios 1.13
• @uidotdev/usehooks
• clsx 2.1

Development Tools

• @crxjs/vite-plugin
• ESLint 9
• Prettier 3.7
• Nodemon 3.1

---

Project Structure

seenit-extension/
├── public/               # Static assets (icons)
├── src/
│   ├── components/       # React components
│   │   ├── ui/           # Reusable UI components
│   │   ├── episodes-tracker/
│   │   ├── search/
│   │   └── ...
│   ├── store/            # Zustand stores
│   │   ├── useSeriesStore.ts
│   │   ├── useThemeStore.ts
│   │   └── ...
│   ├── hooks/            # Custom React hooks
│   ├── utils/            # Utility functions
│   ├── types/            # TypeScript types
│   ├── enums/            # Enums and constants
│   └── pages/
│       ├── popup/        # Main extension popup
│       └── background/   # Background script (optional)
├── manifest.json         # Extension manifest
├── vite.config.*.ts      # Vite configurations
└── package.json

---

License

This project is Source-Available under a Non-Commercial Proprietary License.

You are allowed to:

• ✅ View the source code
• ✅ Modify it for personal, non-commercial use only

You are NOT allowed to:

• 🚫 Sell, license, redistribute, or publish this software or any modified versions
• 🚫 Use any part of this software for commercial purposes
• 🚫 Re-upload to any browser extension store without explicit written permission
• 🚫 Reverse engineer premium features or server components

All rights not explicitly granted are reserved by the author.

For commercial permissions or business inquiries, contact: [email protected]

For more details, see the LICENSE file.

---

Acknowledgments

• Built with the Vite Web Extension Boilerplate by Jonathan Braat
• Series metadata powered by THETVDB API
• Icons by Heroicons

---

Report Bug • Request Feature