Skip to content

A webhook for Plex that marks your watched TV shows automatically on TVTime.com

Notifications You must be signed in to change notification settings

SpaceK33z/plex-tvtime-webhook

Repository files navigation

Plex TVTime Webhook

TVTime is an awesome app to monitor the TV shows you're watching. Unfortunately I have to keep it in sync manually after I've watched a TV show on Plex, which feels kinda cumbersome.

TVTime has a scrobbler that seems to do this, but it hasn't gotten any updates, is very difficult to install and requires you to set Plex logging to DEBUG level, which causes a lot of data. Also plugins are deprecated.

My solution works on a relatively new feature from Plex, using webhooks.

Note: if you manually mark an episode or season as watched from within Plex, it won't be synced. This is a limitation from using the webhooks.

Installation

Make sure you have Node.js 8.0+ and npm or Yarn installed. Lower versions of Node.js might also work but are not guaranteed.

Run npm install --production or yarn --production to install the dependencies. The flag --production will prevent it from installing all the development deps, so the total install is only 5MB. Really small for a Node.js server, right ;).

Copy .env.example to .env and fill out the PORT and PLEX_USER. You don't need to touch the other variables.

Run ./register.js in this repository. Do what the command tells you.

Run the webserver with node index.js and make sure you have some way to keep it running. For Linux users with systemd you can look at plex-tvtime-webhook.service

Make sure you know Plex can access the IP and port where the webserver runs.

Warning beforehand: yes, the node_modules size is 79MB. Blablab nodejs is crap yep you can stop. It would be very easy to trim this down, but I made this very quickly and don't have the time for it yet.

This step is for the simple and avanced routes. Add a webhook in Plex, you can learn how to do it here.

The webhook URL you should be using is http://[your-ip]:[your-port]. Make sure the port is accessible.

Now you are done! To test, you can start playing a TV show from Plex, scroll to the end, wait a few seconds and in TVTime the episode should be marked as watched!

Tip: if nothing happens, try restarting Plex Media Server. I've debugged for almost two hours until I restarted PMS out of spite and suddenly my webhook was added properly.

Debugging

If you have already restarted PMS and the webhook still doesn't work, you should try to send a fake Plex webhook request.

Copy/paste the code from manual-test.sh in your terminal and fill in [your-plex-url] and [your-plex-account]. This should succeed!

About

A webhook for Plex that marks your watched TV shows automatically on TVTime.com

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published