Plugin: Emby Subtitle Manager - manage external subtitles from Emby Web

[Ireina 0]

Hi everyone,

I made a small Emby Server plugin called Emby Subtitle Manager.

This was originally built for my own subtitle management workflow. I wanted a simple way to manage external subtitle files from Emby Web without manually accessing the server filesystem. In my case, some series with many episode files can make manual subtitle organization inconvenient. I also prefer not to change the original media folder structure when adding subtitles. If anyone has a similar need, you are welcome to try it and share feedback.

It adds a Subtitle Manager page to Emby Web where administrators can browse media items, view existing subtitle streams, upload external subtitle files, and delete external subtitles recognized by Emby.

Uploaded subtitles are saved to the video's internal Emby metadata directory. After an upload or deletion, the plugin refreshes media metadata so Emby can detect the updated subtitle streams.

This is not a subtitle provider plugin. It does not search or download subtitles from online services. It is focused on managing local external subtitle files from Emby Web.

GitHub:
https://github.com/Kectai/Emby.SubtitleManager

Latest release:
https://github.com/Kectai/Emby.SubtitleManager/releases/latest

Features

- Media library browsing: browse movies, series, seasons, folders, and extras videos in a hierarchical tree.
- Media search: search media items by name and display matching results in a tree view.
- Subtitle viewing: view the language, path, external subtitle flag, and forced subtitle flag for selected videos.
- Subtitle upload: upload external subtitle files for selected videos, with language and forced subtitle options.
- Subtitle deletion: delete external subtitle files recognized by the selected video.
- Metadata refresh: refresh Emby media metadata after subtitle uploads or deletions.

Installation

1. Download Emby.SubtitleManager.dll from the latest release.
2. Stop Emby Server, or make sure the old DLL is not locked when updating.
3. Copy the DLL to your Emby Server plugins folder.
4. Start or restart Emby Server.
5. Open Subtitle Manager from the Emby Web main menu.

Usage

1. Sign in to Emby Web and open Subtitle Manager.
2. Select a media library.
3. Click Load Media List, or enter a keyword and search.
4. Select a movie, episode, or extras video from the media tree.
5. View existing subtitles, or choose a subtitle file and upload it.
6. Use the delete button to remove external subtitles.

Screenshots

Screenshot: Subtitle Manager plugin page

License

MIT License.

Development note

This project was built with heavy AI assistance and then manually tested/reviewed. The source code is public.