Skip to content

Provide a built-in UI for loading and customizing external subtitles #18360

Description

@lazydeveloper10

Expected behavior of the wanted feature

mpv already supports external subtitle files and various subtitle
customization options through command-line options and input commands.

However, there is no convenient built-in UI for users to load a local
subtitle file and configure its appearance and synchronization.

I would like mpv to provide an optional built-in subtitle management UI
that allows users to:

  • Load/add an external subtitle file during playback.
  • Remove or switch between loaded subtitle tracks.
  • Adjust subtitle delay/offset.
  • Adjust subtitle font size.
  • Change subtitle text colour.
  • Adjust subtitle position.
  • Configure outline/background styling where supported.
  • Access these controls directly from the player UI.

For example, during playback a user should be able to open the subtitle
menu, select "Add Subtitle", choose an .srt/.ass/.vtt file, and then
adjust its synchronization and appearance without having to know mpv
command-line options or input bindings.

This would be particularly useful for applications embedding mpv, where
exposing every subtitle option through the host application's UI can be
difficult.

The requested feature is primarily a user-facing UI for functionality
that mpv already exposes through its subtitle options, rather than
adding a new subtitle rendering backend.

Alternative behavior of the wanted feature

Alternatively, provide a standardized built-in subtitle settings API/UI
that embedding applications can invoke, allowing them to expose external
subtitle loading, subtitle delay, font size, colour, and positioning
without implementing their own subtitle-management interface.

Log File

No response

Sample Files

No response

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions