Self-hosted open source media-tracker for tv shows and movies.
The project is work in progress, right now you can:
- Search tv shows and movies
- Explore trending tv shows and movies
- Explore seasons of a tv show
- Explore related (similar, recommended) media of a tv show or movie
- Track/untrack tv shows and movies
- Mark/unmark tv shows and movies as watched
- Mark/unmark individual seasons of tv shows as watched
- Mark/unmark individual episodes of tv shows as watched
- See all your tracked (to do) tv shows and movies on one page
- See all your watched (done) tv shows and movies on one page
Includes the Specials season, also called Season 0 or Season 00.
It comes with convenient features like the automatic selection of the latest season watched. However, I don’t consider this version as feature complete. In the long run, it should also cover other media like books and maybe games.
Styling is currently based on Semantic UI React, so that it can be easily picked-up by the community. There’s no theme, or much design optimization done at the moment, because it wasn’t a priority.
As it’s work in progress, there are no tests and error handling yet. Use at your own risk.
Video demonstration on YouTube.
Discover screen
Season screen
The project is split into client and server. Latter is a simple JSON Server at the moment.
This project now uses Vite instead of Create React App / react-scripts. CRA is now deprecated for new apps, and react-scripts 5.0.1 hasn’t been updated in years.
Vite 7 requires Node 20.19+ / 22.12+.
Clone the repository and change into the client folder. Install dependencies:
npm installRepeat for the server folder.
The project uses the TMDb API and requires an API key. After creating an account on TMDb, you can request an API key under Profile > Settings > API. Please add your key in ./client/src/config.js!
If deprecation warnings like caniuse-lite is outdated appear, periodically update the database in the client:
cd client
npx update-browserslist-db@latestAfterwards open two separate terminal windows and run npm start in the server folder, then npm run dev in the client folder.
The client (frontend) will run at http://localhost:5173, and the server (backend) will run on port 3001.
Some titles (especially recently announced or pre-production works like Avatar: Seven Havens) don't have a cover as of January 2026.
This happens because the project relies on The Movie Database (TMDb) API. If a show hasn't released an official marketing poster yet, TMDb often has no image to serve.
Other websites like IMDb show a frame grab or screenshot from the movie, until the official artwork is released.
Used style guides (enforced with ESLint):
JavaScript: airbnb-base
npm start
npm test
npm run build
npm run eject # be careful :)In addition I added:
npm run lintYou can also run it with Docker:
- Add your TMDb API key as described above. (In the future you’ll be able to do this through the docker-compose.yml)
- In the root folder run:
docker-compose up -d - It will be available on
http://localhost
Michael Xander