How to Get and Display MKV Captions in Plex on Synology

Subtitles embedded in MKV files typically display automatically on Plex for Synology because the server extracts them during scanning. If captions do not appear, verify that the subtitle stream is properly attached using mkvpropedit, ensure Plex metadata settings allow external subtitles, and check client-side playback controls to confirm the correct track is selected.

Verify Subtitle Attachment with mkvpropedit

The most common reason subtitles fail to show is that they are not correctly embedded or tagged within the container. While many ripping tools attach subtitles automatically, errors can occur, especially with complex Blu-Ray rips containing multiple audio and subtitle tracks. You need to inspect the file structure to ensure the subtitle stream exists and is marked as default if necessary. On your Synology NAS, you can use command-line tools to verify this. If you have SSH access enabled, connect to your device and navigate to the directory containing your MKV file. Use the mkvmerge or mkvpropedit utilities, which are often included in the Media Server package or available via Entware. To list all streams in an MKV file, run:

mkvmerge --info your_movie.mkv

Look for a line indicating "subtitle" or "text" tracks. If no subtitle track appears, it was not embedded. If multiple subtitle tracks exist, note their IDs. You may need to set one as the default stream so Plex selects it immediately. To set a specific subtitle track (e.g., track ID 2) as default, use:

mkvpropedit your_movie.mkv -s 2 --set flag-default=1

This command modifies the header without re-encoding the video, preserving quality and saving significant processing time. After running this, refresh your Plex library so the server re-reads the file metadata. Removing Title MKV Files with JMkvpropedit discusses similar manipulation techniques for MKV headers, which can be useful if you need to clean up unnecessary metadata alongside subtitle adjustments.

Plex Library Settings and Metadata Agents

Plex handles subtitle attachment differently depending on whether the subtitles are embedded in the file or stored externally. For embedded subtitles, Plex generally detects them automatically during the scan process. There is no manual toggle labeled "Automatically attach" in the modern Plex Web interface; this functionality is inherent to the server's scanning engine. However, you must ensure that your library settings permit the use of these internal streams. Navigate to your library in Plex Web, click the three dots next to your movie or TV show library, and select Manage > Edit. Under the Advanced tab, ensure that "Show advanced options" is checked. Look for settings related to media management. Crucially, verify that the media agent assigned to your library supports the formats you are using. For movies, the standard Plex Movie Agent usually handles embedded subtitles well. If you are using external subtitle files (like .srt files alongside the .mkv), Plex requires specific naming conventions or manual linking. Ensure that your external subtitle files share the exact same filename as the video file. For example, if your video is movie.mkv, the subtitle should be movie.srt. Plex will then automatically associate them during scanning. Check the "Scan my library periodically" setting to ensure Plex is actively monitoring changes. If you recently modified the MKV file using mkvpropedit, you might need to manually trigger a scan by going to Settings > Libraries > Refresh Library. This forces Plex to re-parse the file and recognize any new or corrected subtitle streams.

Client-Side Playback Controls

Even when subtitles are correctly embedded and detected by the server, they may not appear on the client device due to user preferences or selection issues. On Apple TV OS 18.1 or Plex Mac 1.105.2.269-12a32491, the playback interface allows users to manually select subtitle tracks. When playing a video, open the playback menu (usually by clicking the screen or pressing a button on your remote). Look for the speech bubble icon or the "Audio & Subtitles" option. Here, you will see a list of available subtitle tracks. If the list is empty, it confirms that Plex did not detect any subtitles, pointing back to a server-side or file-structure issue. If multiple tracks are listed, ensure that the correct language is selected. Sometimes, a track may be present but disabled globally in your account settings. Check your Plex account settings under Playback to see if there are global overrides for subtitles. Additionally, ensure that your client app is updated to the latest version, such as Plex Apple TV 8.41 (9404), as older versions may have bugs with specific subtitle codecs like ASS or SRT embedded in MKVs. FFmpeg 7: Unable to Add Multiple Subtitle Streams in MKV (No Longer Possible?) highlights potential complexities with multiple subtitle streams, which can sometimes confuse Plex if not handled correctly during the remuxing or tagging phase.

Troubleshooting Common Issues

If subtitles still do not display after verifying attachment and settings, consider the codec compatibility. Some advanced subtitle formats, such as PGS (Picture Graphic System) used in Blu-Rays, require more processing power to render than simple text-based SRT files. Your Synology DS418play with Intel Celeron J3355 has hardware acceleration capabilities, but ensure that transcoding is not interfering unnecessarily. Set your Plex Direct or streaming quality to "Original" for local network playback. This avoids transcoding the subtitle stream entirely, ensuring the client receives the raw data from the MKV container. If you must transcode, verify that your Plex server configuration allows for subtitle burning or overlaying, although native rendering is preferred for speed and accuracy. Finally, check the Plex logs for errors related to subtitle parsing. Navigate to Settings > Server > Troubleshooting > View Logs. Search for "subtitle" or "mkv" to identify any warnings about unsupported codecs or missing dependencies. This diagnostic step provides concrete evidence of where the failure occurs, allowing you to address the root cause rather than guessing.

Frequently Asked Questions

Why does Plex show subtitles in the library but not during playback?

This usually indicates that the subtitle track is selected but hidden by the client interface settings. Check the playback menu to ensure the subtitle track is actively chosen and not set to "Off." Also, verify that the subtitle format is supported by your specific client device.

Can I burn subtitles into the MKV video permanently?

Yes, you can use tools like FFmpeg or Handbrake to hardcode subtitles into the video stream. However, this increases file size and reduces flexibility, as you cannot turn them off later. It is generally recommended to keep subtitles separate unless the player does not support embedded subtitles.

Does DSM version affect Plex subtitle handling?

The DSM version itself does not directly control how Plex parses subtitles, but it affects the underlying system libraries and permissions. Ensuring your Synology DSM is up to date guarantees that the necessary codecs and system calls required by the Plex Media Server are available and functioning correctly.

What should I do if only some episodes have subtitles?

Inconsistent subtitle presence often results from incomplete ripping processes or missing source files for specific episodes. Verify each file individually using mkvmerge --info to confirm the subtitle stream exists. Re-ripping or adding the missing subtitle file to the directory usually resolves the issue.

Is it better to use external SRT files or embedded subtitles?

Embedded subtitles are generally preferred for portability and ease of management, as they travel with the video file. External SRT files are easier to edit and update without re-encoding the video. Plex supports both, provided the filenames match exactly for external files.