PlexSubSetter

Stop going episode by episode to set subtitles in Plex! PlexSubSetter lets you search, download, and manage subtitles for entire seasons, shows, or your whole movie library at once. This will allow you to set the subtitles easily.

Table of Contents

• Why I Built This
• What It Does
• Installation
• Quick Start
• How to Use
• Troubleshooting

Why I Built This

I got tired of going through TV shows episode by episode in Plex, manually setting subtitles for each one that was missing. PlexSubSetter makes it easy to:

• Find missing subtitles across entire seasons or libraries
• Batch download for multiple episodes/movies at once
• Set subtitles automatically without clicking through every item
• Manage subtitles easily - see what's there, delete what you don't want

Whether you're missing subtitles on a few episodes or want to add them to your entire library, this tool does it all in a few clicks instead of hours of manual work.

What It Does

Main Features

• Batch Subtitle Downloads - Select multiple episodes, seasons, or movies and download subtitles for all of them at once
• Smart Filtering - Quickly see which items are missing subtitles vs. which already have them
• Multiple Providers - Searches OpenSubtitles, Podnapisi, and other subtitle sources automatically
• Preview Before Download - See what subtitles are available before downloading
• Manage Existing Subtitles - View, activate, or delete subtitle streams
• Multi-Language Support - Download subtitles in any language
• Web-Based UI - Runs in your browser with a dark-themed modern interface

Installation

Prerequisites

• Python 3.8 or higher
• Plex Media Server
• Plex account

Install Dependencies

pip install -r requirements.txt

Required packages:

• plexapi>=4.15.0 - Plex API client
• flask>=3.0 - Web framework
• subliminal>=2.1.0 - Subtitle search and download
• babelfish>=0.6.0 - Language handling

Quick Start

Windows:

run.bat

or

python app.py

Linux/Mac:

./run.sh

or

python3 app.py

The app starts a local web server on http://localhost:5000 and opens your browser automatically.

How to Use

First Time Setup

1. Run python app.py - your browser opens automatically
2. Click "Sign in with Plex" - a new tab opens for Plex authentication
3. Authorize the app on Plex.tv
4. Choose your Plex server from the list (it picks the best connection automatically)
5. Select a library (Movies, TV Shows, etc.)

Finding and Downloading Subtitles

For entire seasons or shows:

1. Click the arrow to expand a show
2. Check the box next to season(s) or individual episodes
3. Click "Search Available" to see what subtitles are available
4. Click "Download Selected Subtitles" to download them all at once

For movies:

1. Use the Missing button to see only movies without subtitles
2. Click "Select All" to select everything, or check individual movies
3. Click "Search Available" then "Download Selected Subtitles"

Quick search: Type in the search box at the top to filter by title

How Subtitles Are Stored

You can choose how PlexSubSetter saves downloaded subtitles:

• plex (default): Subtitles are stored in Plex's database. Requires Plex Pass and subtitle agents to be enabled in Plex settings. This keeps subtitles attached to the media item in Plex.

• file: Subtitles are saved as separate .srt files next to your video files (e.g., Movie.mkv + Movie.en.srt). Works without Plex Pass but requires the app to have access to your media file locations.

Other Useful Features

• List Current - See what subtitle streams are already on selected items
• Dry Run - Preview which items have subtitles available without downloading
• Delete - Remove subtitle streams you don't want
• Settings - Change language, providers, and other options
• All/Missing/Has Subs buttons - Quickly filter your library by subtitle status
• Reload Library - Refresh the view after making changes in Plex

Troubleshooting

App won't start

• Ensure Python 3.8+ is installed: python --version
• Install dependencies: pip install -r requirements.txt
• Check logs in logs/ directory
• Make sure port 5000 is available

Can't find subtitles

• Verify internet connection
• Check that subtitle providers are accessible
• Try increasing search_timeout in settings
• Ensure correct language code is selected

Connection issues

• Try different server connections (local vs remote)
• Check firewall settings
• Verify Plex server is running
• Check Plex token validity

Subtitle indicators not updating

• Click "Reload Library" to refresh
• Check that items have been reloaded from server
• Verify subtitle streams are actually present in Plex