MPV setup

Install and configure MPV for MUDE Music Player

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:

macOS

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.

Linux

1. Install using package manager

   Install MPV using your distribution’s package manager:

   Ubuntu/Debian

   sudo apt-get 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.

Windows

1. Install using Chocolatey

   The easiest way to install MPV on Windows is using Chocolatey:

   choco install mpv
   

   Make sure you run this command in an elevated (administrator) command prompt or PowerShell window.

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 Chocolatey, you can:

1. Download MPV from the official website
2. Extract the archive to a location on your system
3. Add the MPV directory to your system PATH environment variable

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.