Plaxt

Plaxt

Docker app from Jadehawk's Repository

Overview

This Tools provides a way to keep your watched history synced FROM Plex Server To Trakt.tv (IT will not do history prior to tool Installation) it uses WebHooks to Accomplish this so a PLEX PASS Subscription is needed to use WebHooks.

Trakt.tv has a build in tool for the same thingbut requires Trakt.tv VIP Subscription to use it.

GoPlaxt is free and doesn't require Trakt.tv VIP subscription.

Original Dev has stop development after Trakt.tv added it to the VIP subscription, However the dev (XandarStrike) has stated he will continue to merge PR's to the project but will not answer if any issues arrise.

This is the SELFHOSTED version of the same tool that dev (XandarStrike) offers freely on his server at https://plaxt.astandke.com/

Requirements:

Make Note of CLIENT ID and CLIENT SECRET this are REQUIRED.

Notice I will not be doing any more development on this project as Trakt now has official support for Plex Webhooks. I'm using em, you should too.

Plaxt

CircleCI Docker Cloud Build

Plex provides webhook integration for all Plex Pass subscribers, and users of their servers. A webhook is a request that the Plex application sends to third party services when a user takes an action, such as watching a movie or episode.

You can ask Plex to send these webhooks to this tool, which will then log those plays in your Trakt account.

Deploying For Yourself

Goplaxt is designed to be run in Docker. You can host it right on your Plex server!

To run it yourself, first create an API application through Trakt here. Set the Allowed Hostnames to be the URI you will hit to access Plaxt, plus /authorize. So if you're exposing your server at http://10.20.30.40:8000, you'll set it to http://10.20.30.40:8000/authorize. Bare IP addresses and ports are totally fine, but keep in mind your Plaxt instance must be accessible to all the Plex servers you intend to play media from.

Once you have that, creating your container is a snap:

docker create \
  --name=plaxt \
  --restart always \
  -v <path to configs>:/app/keystore \
  -e TRAKT_ID=<trakt_id> \
  -e TRAKT_SECRET=<trakt_secret> \
  -e ALLOWED_HOSTNAMES=<your public hostname(s) comma or space seperated> \
  -p 8000:8000 \
  xanderstrike/goplaxt:latest

If you are using a Raspberry Pi or other ARM based device, simply use xanderstrike/goplaxt:latest-arm7.

Then go ahead and start it with:

docker start plaxt

Alternatively you can use docker-compose:

version: "3.4" # This will probably also work with version 2
services:
  plaxt:
    container_name: plaxt
    environment:
    - TRAKT_ID=<trakt_id>
    - TRAKT_SECRET=<trakt_secret>
    - ALLOWED_HOSTNAMES=<your public hostname(s) comma or space seperated>
    image: xanderstrike/goplaxt
    ports:
    - 8000:8000
    restart: unless-stopped
    volumes:
    - <path to configs>:/app/keystore

Contributing

This repository is now a public archive but I encourage forking!

Security PSA

You should know that by using the instance I host, I perminantly retain your Plex username, and an API key that allows me to add plays to your Trakt account (but not your username). Also, I log the title and year of films you watch and the title, season, and episode of shows you watch. These logs are temporary and are rotated every 24 hours with older logs perminantly deleted.

I promise to Do No Harm with this information. It will never leave my server, and I won't look at it unless I'm troubleshooting bugs. Frankly, I couldn't care less. However, I believe it's important to disclose my access to your information. If you are not comfortable sharing I encourage you to host the application on your own hardware.

I have never been served with any government requests for data.

License

MIT

Install Plaxt on Unraid in a few clicks.

Find Plaxt in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for Plaxt Review the template variables and paths Click Install

Download Statistics

2,196,568
Total Downloads
865
This Month
725
Avg / Month

Total Downloads Over Time

Loading chart...

Related apps

Details

Repository
xanderstrike/goplaxt
Last Updated2024-11-13
First Seen2022-05-19

Runtime arguments

Web UI
http://[IP]:[PORT:8000]
Network
bridge
Shell
sh
Privileged
false

Template configuration

Web UI Port:Porttcp

Web UI Port

Target
8000
Value
8000
Client ID (From Trakt .tv API App)Variable

Client ID (From Trakt .tv API App)

Target
TRAKT_ID
Client SECRET (From Trakt .tv API App)Variable

Client SECRET (From Trakt .tv API App)

Target
TRAKT_SECRET
Time ZoneVariable

Container Variable: TZ

Target
TZ
Host Path for /keystorePathrw

Usually : /mnt/user/appdata/plaxt

Target
/app/keystore
PUIDVariable

Container Variable: PUID

Default
99
Value
99
PGIDVariable

Container Variable: PGID

Default
100
Value
100