Features/Constraints
- Watches Plex log file for activity and submits to Kitsu
- Supports kitsu, thetvdb and hama agents. (Use kitsu for best results)
- thetvdb and hama agents require tvdb/anidb mappings for the media to exist in Kitsu's database
- Must run on same machine as Plex Media Server
Run it
Running with Node.js
- Install PostgreSQL
- Create a database
- Install current Node.js
- Run
npm install - Set env vars and run
npm start
Running with Docker
Env vars
| Var | Default Value | Description | Node | Docker |
|---|---|---|---|---|
PLEX_HOST |
http://localhost:32400 |
Plex Media Server host | Optional | Optional (Docker for Mac/Windows users should set this to http://host.docker.internal:<plex port>) |
PLEX_LOGS |
none | Location of your Plex Media Server log files (instructions) Common locations:
|
Required | Required |
PORT |
8929 |
Port for web server to listen on | Optional | Optional |
DATABASE_URL |
postgres://postgres@localhost:5432/kitsu-plex-scrobbler |
Connection URL for your PostgreSQL database | Optional | Ignored |
POSTGRES_PORT |
5434 |
Port for included PostgreSQL database to listen on | Ignored | Optional |
Setting env vars for a command
- Unix/Bash-like Shell:
VAR1="value 1" docker-compose up - Windows PowerShell:
$env:VAR1 = "value 1"; docker-compose up
Use it
- After starting the scrobbler, navigate to
http://localhost:<PORT>in your browser - Login with your Plex account credentials. Important: The owner of the Plex server must be the first to login
- Configure settings (These will only apply when watching via your Plex account)
- Choose which libraries you want to scrobble for your Plex account
- Connect your Kitsu account
- Watch something on Plex and your Kitsu library will be updated
Screenshots
Acknowledgements
Thanks to
- @xiprox for mocking up the design
- Arcanemagus/plex-api for guiding me through the dark