MediaTracker ·

Self hosted platform for tracking movies, tv shows, video games, books and audiobooks, highly inspired by flox

Demo

mediatracker.app
Username: demo
Password: demo

API Documentation

https://bonukai.github.io/MediaTracker/

Installation

Building from source

git clone https://github.com/bonukai/MediaTracker.git
cd MediaTracker
npm install
npm run build
npm run start

From npm

npm install -g mediatracker
mediatracker

Database file, logs and assets will be saved in $HOME/.mediatracker

With docker

Version Tags

| Tag | Description | | -------- | --------------- | | latest | stable releases | | unstable | pre-releases |

docker volume create assets
docker run \
    -d \
    --name mediatracker \
    -p 7481:7481 \
    -v /home/YOUR_HOME_DIRECTORY/.config/mediatracker/data:/storage \
    -v assets:/assets \
    -e TMDB_LANG=en \
    -e AUDIBLE_LANG=us \
    -e TZ=Europe/London \
    bonukai/mediatracker:latest

With docker-compose

version: "3"
services:
  mediatracker:
    container_name: mediatracker
    ports:
      - 7481:7481
    volumes:
      - /home/YOUR_HOME_DIRECTORY/.config/mediatracker/data:/storage
      - assetsVolume:/assets
    environment:
      SERVER_LANG: en
      TMDB_LANG: en
      AUDIBLE_LANG: us
      TZ: Europe/London
    image: bonukai/mediatracker:latest

volumes:
  assetsVolume: null

Parameters

| Parameter | Function | | ----------- | ----------------------- | | -p 7481 | Port web API | | -v /storage | Directory with database | | -v /assets | Posters directory | | -v /logs | Logs directory |

Environment variables

| Name | Description | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | TMDB_LANG | ISO 639-1 country code, one of: om, ab, aa, af, sq, am, ar, hy, as, ay, az, ba, eu, bn, dz, bh, bi, br, bg, my, be, km, ca, zh, co, hr, cs, da, nl, en, eo, et, fo, fj, fi, fr, fy, gl, ka, de, el, kl, gn, gu, ha, he, hi, hu, is, id, ia, ie, ik, iu, ga, it, ja, jw, kn, ks, kk, rw, ky, rn, ko, ku, lo, la, lv, ln, lt, mk, mg, ms, ml, mt, mi, mr, mo, mn, na, ne, no, oc, or, ps, fa, pl, pt, pa, qu, rm, ro, ru, sm, sg, sa, gd, sr, sh, st, tn, sn, sd, si, ss, sk, sl, so, es, su, sw, sv, tl, tg, ta, tt, te, th, bo, ti, to, ts, tr, tk, tw, ug, uk, ur, uz, vi, vo, cy, wo, xh, yi, yo, za, zu | | AUDIBLE_LANG | ISO 639-1 country code, one of: au, ca, de, es, fr, in, it, jp, gb, us | | SERVER_LANG | ISO 639-1 country code, one of: da, de, en, es, fr, ko, pt | | DATABASE_CLIENT | Database client: better-sqlite3 or pg | | DATABASE_PATH | Only for sqlite, path to database | | DATABASE_URL | Connection string | | DATABASE_HOST | Database host | | DATABASE_PORT | Database port | | DATABASE_USER | Database user | | DATABASE_PASSWORD | Database password | | DATABASE_DATABASE | Database name | | IGDB_CLIENT_ID | IGDB API key, needed for game lookup | | IGDB_CLIENT_SECRET | IGDB secret | | PUID | UserID | | PGID | GroupID | | TZ | Timezone, for example Europe/London, see full list | | ASSETS_PATH | Directory for posters and backdrops, defaults to '$HOME/.mediatracker/img' | | LOGS_PATH | Directory for logs, defaults to '$HOME/.mediatracker/logs' | | HOSTNAME | IP address that the server will listen on | | PORT | Port that the server will listen on |

Heroku

Building docker image

docker build --tag mediatracker:latest https://github.com/bonukai/MediaTracker.git
docker run -p 7481:7481 mediatracker

Features

• notifications
• calendar
• multiple users
• REST API
• watchlist
• docker image
• import from Trakt
• import from goodreads

Import

| Service | Imported data | | -------------------------------------- | ---------------------------------------------- | | Trakt | Watchlist, watched history, ratings | | goodreads | Read, Currently Reading, Want to Read, ratings |

Metadata providers

| Provider | Media type | Localization | | ------------------------------------------------------------------------------ | -------------- | :----------: | | TMDB | movie, tv show | ✓ | | IGDB* | video game | ✗ | | Audible API | audiobooks | ✓ | | Open Library | books | ✗ |

* IGDB has a limit of 4 requests per second. Because of that IGDB API key is not provided with MediaTracker, it can be acquired here and set in http://localhost:7481/#/settings/configuration

Notification platforms

• gotify
• ntfy
• Pushbullet
• Discord
• Pushover
• Pushsafer

Integrations

• Jellyfin - Plugin, minimum MediaTracker version: 0.1.0
• Plex - Generate Application token in your MediaTracker instance, and add a webhook in plex [your MediaTracker url]/api/plex?token=[MediaTracker Application Token]
• Kodi - Plugin, minimum MediaTracker version: 0.1.0

Contributors

• URBANsUNITED (German translation)

Similar projects

• https://github.com/devfake/flox
• https://github.com/leepeuker/movary
• https://github.com/IgnisDa/ryot
• https://github.com/krateng/maloja