mpv Blu-ray Menu Not Working: How to Fix It

If the Blu-ray movie plays in mpv but its menu never appears, cannot be clicked, or does not respond to navigation keys, the problem may not be a broken input binding or video setting. mpv is primarily a media player, not a full Blu-ray navigation environment, and its Blu-ray support is generally better suited to opening titles and playlists directly than presenting interactive disc menus. The fastest path to a solution is to determine whether playback itself is failing, the disc structure is being addressed incorrectly, or the missing feature is an interactive menu that mpv does not provide.

This guide focuses specifically on Blu-ray menus in mpv on Windows, Linux, and macOS. It explains how to run a clean test, open a BDMV structure correctly, select playlist titles, inspect logs, distinguish Java-based menus from ordinary video, and recognize encrypted-disc limitations. It also identifies unrelated settings you should avoid changing when the underlying issue is simply menu support.

1. Confirm the Symptom With a Minimal Clean mpv Command

Begin by separating three symptoms that can look similar: mpv cannot open the Blu-ray at all, mpv opens the wrong title, or mpv plays a title but does not display an interactive menu. Each outcome points to a different cause.

1.1 Test Without Your Normal Configuration

Run mpv from a terminal with --no-config. This temporarily bypasses your mpv configuration, profiles, scripts loaded through the normal configuration directory, and custom input settings. It does not delete or modify any files.

For a mounted disc or copied Blu-ray structure, use the Blu-ray protocol and identify the Blu-ray root with --bluray-device:

mpv --no-config --bluray-device="/path/to/bluray-root" bd://

The root should be the directory containing the BDMV directory, not an individual .m2ts file. On Windows, quote paths containing spaces:

mpv.exe --no-config --bluray-device="D:\" bd://

For a Blu-ray backup stored in a folder, the command may resemble:

mpv.exe --no-config --bluray-device="C:\Media\Example Disc" bd://

On Linux or macOS, it may resemble:

mpv --no-config --bluray-device="/media/user/EXAMPLE_DISC" bd://

If the default title starts playing with video and audio, basic Blu-ray title playback is working. If you expected a menu but instead received the main feature or another title, stop changing GPU, subtitle, HDR, or audio settings. Those settings cannot add a Blu-ray navigation interface.

1.2 Understand What a Successful Test Proves

A successful clean test proves that mpv can read the disc structure and decode at least one selected title. It does not prove that mpv supports the disc's interactive menu. Blu-ray menus can depend on navigation commands, graphics overlays, button states, event handling, and, in some releases, Blu-ray Disc Java applications.

If the title plays under --no-config but fails under your normal launch command, your configuration or wrapper is involved. If the same title plays in both cases but no interactive menu appears, the likely limitation is menu support rather than a damaged configuration.

2. Check the Blu-ray Address and Select Titles Directly

When the mpv Blu-ray menu is not working, direct title selection is usually the practical workaround. A Blu-ray can contain the main feature, episodes, extras, trailers, alternate cuts, and short menu-related clips. These are organized through playlists rather than as one ordinary video file.

2.1 Use the BDMV Root Instead of Guessing a Stream File

Point --bluray-device to the directory above BDMV. A typical structure looks like this:

Disc Root/
  BDMV/
    PLAYLIST/
    STREAM/
    CLIPINF/
  CERTIFICATE/

Opening a file from BDMV/STREAM can play video, but it bypasses playlist logic. A feature may span multiple stream files, use branching, or reference clips in a specific sequence. Directly opening one .m2ts file can therefore produce an incomplete movie, missing chapters, or the wrong segment.

Success means mpv recognizes the Blu-ray source and begins a coherent title. If mpv reports that the Blu-ray path cannot be opened, verify the folder level and spelling before changing playback options.

2.2 Identify Available Titles

Use terminal output to inspect the source:

mpv --no-config --msg-level=bd=trace --bluray-device="/path/to/bluray-root" bd://

Depending on the build and library output, the log may reveal detected titles or playlist information. You can then try explicit title numbers:

mpv --no-config --bluray-device="/path/to/bluray-root" bd://0

mpv --no-config --bluray-device="/path/to/bluray-root" bd://1

Title numbering and ordering are disc-specific. Do not assume that title 0 is always the main movie. Compare duration, chapters, audio languages, and subtitle tracks. For an episodic disc, several similarly sized titles may each represent one episode.

Success means you can reliably launch the wanted feature without entering a menu. Once the correct title is known, save that command in a shortcut, shell script, or launcher. Stop testing unrelated rendering options at that point.

2.3 Open a Playlist When Appropriate

Blu-ray playlist files are stored under BDMV/PLAYLIST and normally use the .mpls extension. If direct playlist opening works with your mpv build and Blu-ray libraries, it can be useful for identifying a feature. However, the Blu-ray protocol is generally preferable because it supplies the disc context needed to resolve associated clips.

A playlist should be selected based on confirmed duration and content, not merely the largest file number. Some discs contain multiple playlists for alternate cuts, languages, branching paths, or other authoring purposes.

3. Review Settings That Can Affect Blu-ray Playback

No mpv option can turn unsupported full menu navigation into a supported feature. Nevertheless, configuration can prevent a valid title from playing or make it appear that navigation has failed. Check only settings tied to the observed symptom.

3.1 Configuration Files and Profiles

If --no-config works but normal mpv does not, inspect mpv.conf and any active profiles. Temporarily comment out suspicious lines one at a time. Relevant options include protocol restrictions, track selection, video output, hardware decoding, scripts, and profiles triggered by path or protocol.

Use this command to see whether a named profile exists and what it contains:

mpv --show-profile=profile_name

If you launch mpv through a frontend, file manager, or custom script, compare its complete command line with the successful terminal command. A frontend may add options that are not present in your clean test.

Success means normal playback matches the --no-config result after one conflicting option is disabled. Preserve the rest of your configuration rather than deleting the entire configuration directory.

3.2 Input Bindings and Menu Expectations

Custom entries in input.conf can replace arrow keys, Enter, Escape, mouse buttons, or chapter controls. That matters if you are interacting with an mpv script or controlling playback, but restoring those bindings does not create native Blu-ray menu navigation.

Test standard playback controls after launching a title directly. If seeking, pausing, and chapter changes work, mpv is receiving input. An unresponsive on-screen Blu-ray button is a separate navigation limitation.

3.3 Audio, Video, and Subtitle Tracks

A title can start with an unexpected track selection, especially on discs with commentary, descriptive audio, forced subtitles, or multiple languages. Use mpv's track list or cycle commands to inspect available tracks. Terminal output commonly prints detected video, audio, and subtitle streams when a title opens.

You can avoid forcing a stale track ID by testing with automatic selection:

mpv --no-config --aid=auto --sid=auto --bluray-device="/path/to/bluray-root" bd://TITLE

If the picture plays but there is no sound, inspect the audio track and audio-device output before blaming the menu. If audio and video work but graphical menu buttons do not exist, track settings are not the cause.

3.4 Hardware Decoding, HDR, and Output Drivers

Hardware decoding can cause a black screen, corrupted picture, or decoder failure on some systems. It does not control whether Blu-ray menus are available. If a selected title has audio but no visible video, compare automatic hardware decoding with software decoding:

mpv --no-config --hwdec=auto --bluray-device="/path/to/bluray-root" bd://TITLE

mpv --no-config --hwdec=no --bluray-device="/path/to/bluray-root" bd://TITLE

If --hwdec=no restores the picture, investigate the GPU driver and mpv hardware-decoding backend. Be aware that high-bitrate 4K content may require substantial CPU performance in software mode. HDR tone mapping, shaders, and video output settings can change image appearance, but they do not enable disc menus.

3.5 Scripts, yt-dlp, Streams, and Screenshots

yt-dlp is used for supported online media URLs and is not involved in local Blu-ray menu navigation. Network stream options also do not repair a mounted disc's menu. Screenshot settings affect image capture, not disc playback. Disable a script only when the clean test works and the normal configuration produces an error, crash, unexpected key behavior, or altered source handling.

This distinction prevents a common troubleshooting mistake: changing every advanced option simply because it appears in an mpv configuration. Follow the evidence from the clean test instead.

4. Check the Operating System and Media Source

If mpv cannot open any title, inspect access to the source before adjusting codecs or render settings. A readable BDMV structure is a prerequisite for both title discovery and playback.

4.1 Permissions, Mounting, and File Paths

Confirm that your user account can list and read files inside BDMV/PLAYLIST, BDMV/CLIPINF, and BDMV/STREAM. On Linux, verify the disc or image is mounted and accessible to the user running mpv. On macOS, check whether the terminal or launcher has permission to access removable volumes or protected folders. On Windows, confirm the drive letter and quote paths containing spaces.

Shell quoting is especially important. A path split at a space can make mpv interpret the remaining words as additional files. Use ordinary straight quotation marks around the entire path. Success means mpv reaches the disc structure without a file-not-found or access-denied message.

4.2 libbluray Availability

mpv relies on supporting libraries for Blu-ray structure handling. The exact packaging varies by operating system and mpv distribution. Use a reputable mpv package maintained for your platform, and inspect its terminal output for Blu-ray protocol or library errors.

A missing or unusable Blu-ray library can prevent bd:// from opening even when ordinary files play normally. Obtain packages only from the official mpv guidance, your operating system's trusted package repositories, or a well-established distributor. Avoid random codec packs and unverified binary downloads.

4.3 Encrypted Disc Limitations

Commercial Blu-ray discs may use access-control or encryption systems. mpv and libbluray do not automatically provide all keys, licensed components, or authorization needed for every protected disc. A disc that is visible in the file manager but produces encryption-related errors is not necessarily damaged.

This article does not recommend bypassing DRM. Use playback software and hardware authorized for the disc and permitted in your jurisdiction. If an unencrypted Blu-ray folder plays while a protected physical disc does not, stop changing mpv's subtitle, shader, hardware-decoding, or audio options. The failure is at the media-access layer.

4.4 Java-Based Blu-ray Menus

Many advanced Blu-ray menus and interactive features are implemented with BD-J, the Blu-ray Disc Java platform. They may include animated interfaces, pop-up menus, games, network features, and dynamic branching. Playing a movie title does not mean the player implements the Java application that presents those controls.

If full BD-J behavior is required, use a player that explicitly supports the relevant Blu-ray menu and Java features. This is the correct stopping point when mpv plays titles successfully but cannot reproduce the authored interactive experience.

5. Use Logs to Separate Playback Failures From Menu Limitations

mpv's terminal output is more useful than changing options at random. Record one clean failure, identify the first meaningful error, and modify only the component implicated by that message.

5.1 Create a Focused Log

Run a clean command with a log file:

mpv --no-config --log-file=mpv-bluray.log --msg-level=all=v --bluray-device="/path/to/bluray-root" bd://

Reproduce the problem once, close mpv, and search the log for terms such as error, failed, bluray, bd, playlist, decrypt, permission, or video. The first relevant failure is often more informative than later decoder errors caused by the initial problem.

• A path or permission error points to mounting, quoting, or filesystem access.
• A Blu-ray library error points to the build or supporting library.
• An encryption error points to protected-media access, not the GPU.
• A decoder or video-output error matters only after a title has been opened.
• Normal title playback with no menu error usually indicates a feature expectation mismatch.

5.2 Use the Stats Overlay and Track Information Appropriately

The stats overlay can confirm decoder, frame rate, dropped frames, video output, and hardware-decoding behavior while a title plays. It is useful for diagnosing high-bitrate playback or a GPU issue, but it does not report whether an interactive Blu-ray menu is supported.

Likewise, the track list helps identify the correct audio and subtitles. If the desired movie, audio language, and subtitle stream are available, the main playback path is functioning. At that stage, a missing authored menu should be handled through direct title selection or another player.

6. Run a Clean Temporary Test Before Making Permanent Changes

Use a controlled sequence so that each result answers one question. Do not combine driver updates, configuration edits, script removal, and track changes in a single attempt.

1. Confirm that the directory above BDMV is readable.
2. Run mpv --no-config with --bluray-device and bd://.
3. If a title plays, test explicit title numbers and identify the wanted feature.
4. If playback fails, save a verbose log and classify the first relevant error.
5. If video is black but audio works, compare --hwdec=auto and --hwdec=no.
6. If the clean command works, reintroduce your normal configuration in small groups.
7. If titles work but full menus do not, use direct title playback or a menu-capable player.

After every change, repeat the same source and command. Success should be observable: the source opens, the intended title begins, the expected tracks appear, or the picture returns. Once that specific result is achieved, stop changing settings. Additional changes make the working state harder to understand and reproduce.

7. Quick Fix Checklist

• Launch mpv from a terminal so you can read errors.
• Use --no-config before editing any permanent files.
• Point --bluray-device to the folder containing BDMV.
• Quote Windows, Linux, and macOS paths containing spaces.
• Use bd://TITLE to test titles directly.
• Do not expect an individual .m2ts file to preserve playlist logic.
• Check track selection if video plays with missing audio or subtitles.
• Test --hwdec=no only for black, corrupted, or failed video.
• Ignore yt-dlp, stream, and screenshot settings for local Blu-ray navigation.
• Use a verbose log to identify library, permission, or encryption errors.
• Do not delete the entire mpv configuration before isolating one option.
• Use authorized software for protected discs.
• Choose a player with explicit Blu-ray menu and BD-J support when full menus are essential.

8. Frequently Asked Questions

8.1 Why Does mpv Play the Movie but Not Show the Blu-ray Menu?

Movie playback and interactive menu navigation are different capabilities. mpv may read a Blu-ray playlist and decode its audio and video without implementing the complete authored menu environment. If direct title playback works, your decoder, output driver, and basic Blu-ray access are probably functioning.

8.2 What Is the Correct Syntax for a BDMV Folder?

Use --bluray-device with the directory containing the BDMV folder, then open the Blu-ray protocol. For example:

mpv --no-config --bluray-device="/path/to/disc-root" bd://

To test a specific title, append its number, such as bd://1. Exact available titles depend on the disc.

8.3 Can I Play Blu-ray Playlist Titles Without a Menu?

Yes. Direct title selection is usually the most practical mpv workflow for Blu-ray content. Test title numbers, compare durations and track lists, and save the working command. This is also useful for episodic discs and bonus features.

8.4 Will Installing Java Make the Menu Work in mpv?

Not necessarily. A system Java installation alone does not make mpv a complete BD-J navigation environment. The player must explicitly integrate and expose the required Blu-ray menu behavior. Do not install random Java packages or codec bundles solely to troubleshoot this symptom.

8.5 Why Does an Unencrypted BDMV Backup Work but the Physical Disc Does Not?

The physical disc may use access controls or encryption that are absent from the readable folder. Check the log for media-access or encryption messages. If those appear, changing hardware decoding, subtitles, shaders, or audio output will not solve the problem.

8.6 When Should I Use Another Player?

Use another player when you require the complete disc experience, including animated menus, clickable buttons, pop-up navigation, BD-J applications, or seamless access to extras through the authored interface. If mpv successfully plays the correct title directly, there is no need to destabilize a working configuration in pursuit of menu functionality it does not provide.