michaelx / media-tracker

Self-hosted open source media-tracker for tv shows and movies. (React, Redux)

media-tracker

Self-hosted open source media-tracker for tv shows and movies.

Status 🚧

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

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.

Demo

Video demonstration on YouTube.

Screenshots

Discover screen

Season screen

More screenshots.

Usage and development

The project is split into client and server. Latter is a simple JSON Server at the moment.

Clone the repository and change into the client folder. Install dependencies:

npm install

Repeat 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!

Afterwards open two separate terminal windows and run npm start in the client folder as well as the server folder.

The client (frontend) will run at http://localhost:3000 (opens automatically), and the server (backend) will run on port 3001.

Code guidelines

Used style guides (enforced with ESLint):

• JavaScript: airbnb-base

Available scripts

This project was bootstrapped with Create React App, so all its scripts are available in the client folder:

npm start
npm test
npm run build
npm run eject # be careful :)

In addition I added:

npm run lint

Docker

You can also run it with Docker:

1. Add your TMDb API key as described above. (In the future you’ll be able to do this through the docker-compose.yml)
2. In the root folder run: docker-compose up -d
3. It will be available on http://localhost

Author

Michael Xander

• https://michaelxander.com
• https://twitter.com/michaxndr

media-tracker's Issues

Evaluation of a multi-user approach

Maybe I'm alone with this point of view, but a multi-user system (with native authentication) would provide a huge benefit and a great advantage in relation to other, similar projects (like devfake/flox).

What do you think about it?

lists not synced to TMDB account.

Followed the steps and entered API to ./media-tracker/client/src/config.js, then start server and client. Everything works perfect on web browser, but my watched shows don't sync back to TMBD.

Season 0 (Specials) do not appear

Season 0 or Specials don't not appear in media-tracker, but do in website:

https://www.themoviedb.org/tv/253-star-trek/season/0
http://localhost:3000/view/tv/253

Docker

Any plans to dockerize this great project?

Disable automatic launching of web browser when starting client

Each time I run npm start on client folder, it launches my default web browser. Request patch to be able to configure this.

seasons and episodes not loaded for certain tv shows

Example tv show where all 3 seasons are not loaded. Same with episodes.
https://www.themoviedb.org/tv/131982-inside

Connect locally to it
http://localhost:3000/view/tv/131982

and only 1 episode from season 1 is loaded

Enhancement request: Indexers and Custom Entries

Hi! I'm interested on this :)I'd like to know if there is a way to add indexers to find books/movies... or if you can add more or maybe include custom entries (create a book that you can't find in the search)?

search by author or publisher or ISBN for books :)

Thank you and congrats for the project :)

How to add the API key to config.js

How to I add the TMDb API key to ./client/src/config.js?