Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/mayur1377/MUDE-music-in-vscode/llms.txt

Use this file to discover all available pages before exploring further.

MPV is a free, open-source media player that MUDE uses to play audio. You must have MPV installed on your system before using MUDE Music Player.
MUDE will not work without MPV installed and available in your system PATH.

​
Installation

Choose your operating system below for installation instructions:
1

Install using Homebrew

The easiest way to install MPV on macOS is using Homebrew:
brew install mpv
2

Verify installation

Check that MPV is installed correctly:
mpv --version
You should see MPV version information displayed.
3

Restart VS Code

After installing MPV, restart VS Code to ensure MUDE can detect it.

​
Alternative installation methods

If you don’t have Homebrew, you can download MPV directly from the official website.

​
Verifying MUDE can detect MPV

After installing MPV and restarting VS Code:
  1. Open VS Code
  2. MUDE should activate automatically
  3. If MPV is not detected, you’ll see an error message: “Failed to find MPV on your system!”
If you see this error message, make sure MPV is installed and available in your system PATH. You may need to restart your computer for PATH changes to take effect.

​
Troubleshooting

​
MPV not found after installation

If MUDE can’t find MPV after installation:
  1. Restart VS Code - This is often all that’s needed
  2. Check PATH - Open a new terminal and run mpv --version to verify MPV is in your PATH
  3. Restart your computer - Some PATH changes require a full system restart
  4. Manual PATH configuration - If MPV still isn’t found, you may need to manually add it to your system PATH

​
Permission issues (Linux/macOS)

If you encounter permission errors, make sure the MPV binary has execute permissions: 
which mpv  # Find MPV location
ls -l $(which mpv)  # Check permissions

​
Configuration

MUDE uses MPV with the following configuration:
  • Audio-only mode: MPV runs in audio-only mode (no video window)
  • Auto-restart: MPV automatically restarts if it crashes
These settings are configured automatically by MUDE and don’t require manual configuration.

​
Learn more

For more information about MPV, visit the official MPV documentation.

Build docs developers (and LLMs) love

Get started for freeTalk to us