The Polyglot journal
Subtitles not showing on Mac? Check the track first
A subtitle file can be correct and still remain invisible. Follow the track from your export to the player, and use a tiny separate test file to narrow down the failure.

Start with the player, then inspect the file
If subtitles do not appear on your Mac, first confirm that the player has loaded the subtitle file and selected its track. Then seek to a time when a cue should be visible. Only after those checks should you change the file. Rewriting a correct transcript will not fix a track that the player never opened.
This workflow is for a video and subtitle file you own or have permission to use. Keep the original video and subtitle export unchanged, and work with copies. Note the exact video edit, subtitle filename and player. If you are troubleshooting a streaming service as a viewer, you may only be able to select available tracks or report the problem; you cannot attach a creator-side file through a control the service does not provide.
Check what you actually delivered
An SRT or VTT export is a separate timed-text file, often called a sidecar. It does not change the pixels in the video. Sending only the MP4 leaves that separate file behind. Sending both files gives the recipient the materials, but the destination still needs a way to load the subtitle track.
Distinguish three situations: a separate subtitle file beside the movie, a selectable track packaged inside the movie, and words permanently rendered into the video image. This article diagnoses the first two. If you expected permanent visible text from an SRT export, use the linked open-versus-closed caption guide to decide the delivery method before changing your subtitle wording.
Load the intended file and select its track
For an external SRT, use a player that documents support for external subtitle files. VideoLAN documents SubRip support in VLC, alongside subtitle-track selection and a disabled state. Open the matching video, explicitly load your exported subtitle file through the player’s subtitle-file control, and select that track. Menu wording varies across desktop versions; do not assume a Windows preferences path is a Mac instruction.
Explicit loading is a useful first test because it avoids relying on automatic filename matching. If there are several tracks, choose the intended language and revision. A same-language track embedded in the movie can be different from the sidecar you just exported. Seek to a cue whose wording you recognize so you can identify the file actually on screen.
If the track is listed but nothing appears during an active cue, inspect the player’s subtitle visibility and text-display preferences. Restore a readable size and contrast if custom settings made text hard to see. Change one setting at a time and record the result; resetting every preference at once makes it harder to learn which condition caused the problem.
Read QuickTime’s caption option narrowly
Apple’s QuickTime Player guide describes selecting a subtitle language from a movie that contains subtitles. It also says the separate Show Closed Captioning option is available only for captions embedded in CEA-608 format. That option is not an instruction to attach a loose SRT sitting beside your movie.
If no subtitle option appears, do not conclude that your transcript is empty or corrupt. First establish whether QuickTime has a supported track to display. For the external-file diagnostic, use a player with documented sidecar support. You do not need to recreate the transcription just to test whether the exported text and timing are usable elsewhere.
Inspect one cue and the real file extension
Check the full filename, including its extension. A file named gallery-v4.en.srt.txt may look like an SRT at a glance while still being treated as a text document. Open a copy as plain text and look for numbered entries, start and end timestamps, subtitle text, and blank lines between entries. A rich-text document or an HTML error page does not become SRT by renaming its extension.
Locate a cue with a known interval, such as 00:00:10,000 to 00:00:13,000, and play the matching video through that interval. Text is not expected before the first cue or between cues. If the file begins at one hour while the video lasts two minutes, track loading and timing are different questions. Compare the export with the source project before applying any correction.
If subtitles appear but arrive early or late, move to the linked synchronization guide. If they appear with broken accents or replacement characters, use the encoding guide. Keep those repairs separate from visibility diagnosis so you do not change timing or wording to solve the wrong failure.
Use a separate two-cue diagnostic
If the result is still unclear, create a new plain UTF-8 file named subtitle-display-test.srt containing the original sample below. Use it only with a local video longer than eight seconds that you are authorized to play. Load it explicitly, select its track, and play from the start. These invented messages test display; they are not captions for the recording and must never replace the real track or be published with it.
If both messages appear at their stated intervals, the player can display this basic SRT under the current settings. Reload the original subtitle file, select it, and compare its cue range, structure and encoding. Success with this small sample does not prove that the complete original file or every subtitle format is valid.
If the sample also stays invisible, return to loading, track selection and player support. If the original works in this local player but fails at the final destination, investigate the destination’s upload and playback path. This comparison narrows the problem; it does not certify the subtitle text or translation.
1
00:00:02,000 --> 00:00:04,000
First display check.
2
00:00:06,000 --> 00:00:08,000
Second display check.A web upload is another attachment step
Uploading the video alone does not demonstrate that your reviewed sidecar reached the website. In YouTube’s documented creator workflow, choose the video and subtitle language, upload the caption file, and use the option for a file with timing when the file already contains timestamps. Complete the save or publishing steps shown for that workflow, then inspect the viewer-facing result.
YouTube documents basic SRT in plain UTF-8 and says SRT style markup is not recognized. A file that loads in a flexible local player may still need to meet the destination’s specific requirements. Check the accepted format before converting, and use an actual export or conversion rather than changing .srt to .vtt in the filename.
On the final watch page, enable captions and choose the intended language. Check a recognizable revised line, not only the existence of a CC control: another automatic or older track may be available. If the intended track is absent, inspect the creator-side upload status and selected video before retranscribing anything. Keep private media out of public troubleshooting uploads.
Export again only when the file needs correction
Polyglot can import SRT and WebVTT files, let you review their timed text, and export a separate subtitle file. Use that workflow when the actual file needs editing or a supported format conversion. Preserve the original and give the corrected export a clear revision name. Polyglot does not attach the export to another player, publish it to a hosting platform, or burn it into the video.
After any repair, reopen the exported file rather than relying on the editor preview. Verify that the first and last cues are present and that no cue was unintentionally removed, reordered or retimed. Then repeat the attachment and selection checks with that exact export. A successful export and a visible destination track are separate acceptance steps.
Confirm the recipient can see the final revision
Deliver the matching video and subtitle file with their edit and language identified, or confirm the selected hosted track on the final video page. Test the first cue, a middle cue and the last cue, then review the full playback for missing passages. Check windowed and full-screen viewing and the device or browser your audience will actually use.
Record the video revision, subtitle revision, player or destination, selected language and any remaining failure. Keep the small diagnostic file out of the delivery folder. When subtitles are visible but meaning, readability or important sound information is still unresolved, continue those reviews before publishing. Visibility is the first gate, not the whole caption-quality check.
Sources & further reading
Apple: show subtitles or embedded closed captions in QuickTime Player
VideoLAN: external subtitle formats and track selection in VLC
YouTube: add a timed subtitle file to a video
YouTube: supported subtitle files and UTF-8 SRT requirements
Published by Polyglot using an AI-assisted editorial workflow. How we prepare and update our guides.
Keep exploring.
Try it on your Mac.
Find the right tools for your words and video, with processing on your Mac.
Download nowApple Silicon · macOS 14.4 or later