Plex Auto-Watched connects to your Plex server and automatically marks new episodes as watched the moment they're added to your library — for every show on your list.
Requires Plex Pass for webhook support
Set up takes a few minutes. After that, every new episode on your list is handled automatically.
Authenticate using your existing Plex account via OAuth. No account creation or passwords to manage.
Search your Plex libraries and add the shows you want automatically marked as watched when new episodes arrive.
Add this app's URL as a webhook in your Plex server settings. From then on, every matching new episode is marked instantly.
When Plex fires a "new episode" event, this app checks your watchlist and calls the Plex API to mark it as watched on your behalf.
Plex fires a webhook when a new episode is added. This app catches it and marks the episode watched — no polling, no delay, no manual steps.
Multiple Plex users on the same server can each maintain their own independent watchlist. Adding a show for yourself has no effect on anyone else.
Every auto-marked episode is logged with a timestamp and source. Filter by show or date range to see exactly what was marked and when.
A full audit trail of every action — shows added, removed, episodes auto-watched, and searches performed.
Want to catch up on a show instantly? Mark all existing episodes as watched with one click from the watchlist page.
Sign in with your existing Plex account — no separate credentials. Your Plex token is stored securely and never exposed in the UI.
If you share your Plex server with family or friends, everyone can log in with their own Plex account and maintain a completely separate auto-watch list. When a new episode arrives, each user who has that show in their list gets it marked — using their own account, so their Plex watch status stays accurate.
This app runs alongside your Plex server and communicates with it via the Plex API.
An existing Plex server that you have admin access to. Any self-hosted Plex installation works.
Plex webhooks — the mechanism this app relies on — are a Plex Pass exclusive feature. The server owner needs Plex Pass; individual users do not.
The app is a Node.js server. It runs on the same machine as your Plex server or anywhere else on your network reachable by Plex.
Recommended for keeping the app running in the background and auto-starting after reboots. Install globally with npm install -g pm2.
Full setup instructions are in the README. Here's the short version.
Clone the repository and run npm install to pull in dependencies.
.envCopy env.example to .env and fill in your PLEX_SERVER_URL, PLEX_CLIENT_ID, and a random SESSION_SECRET.
Run npm run build then npm start (or npm run pm2:start to run as a background service).
In Plex Settings → Webhooks, add http://your-server:3000/api/webhook/event. This URL must be reachable by your Plex server.
Sign in with your Plex account, search your libraries, and add the shows you want auto-marked. You're done.
Sign in with your Plex account to get started.
Sign In with Plex