Requirements

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.

Before installing MUDE Music Player, ensure your system meets the following requirements.

​

VS Code version

MUDE requires VS Code version 1.91.0 or higher. To check your VS Code version:

1. Open VS Code
2. Go to Help → About (or Code → About Visual Studio Code on macOS)
3. Check the version number displayed

If you need to update VS Code, download the latest version from code.visualstudio.com.

​

MPV media player

MPV is a free, open-source media player that MUDE uses to play audio. It must be installed on your system and available in your PATH.

​

Why MPV?

• Lightweight: MPV is fast and efficient
• Cross-platform: Works on macOS, Linux, and Windows
• Audio-focused: Perfect for background music playback
• Reliable: Stable and well-maintained

See the MPV setup guide for detailed installation instructions.

​

System requirements

​

Operating system

MUDE supports:

• macOS: 10.12 Sierra or later
• Linux: Most modern distributions (Ubuntu, Fedora, Arch, etc.)
• Windows: 10 or later

​

Hardware

• RAM: 2GB minimum (4GB+ recommended)
• Disk space: ~100MB for MUDE and dependencies
• Network: Internet connection required for streaming music from YouTube Music

​

Package managers (optional)

While not required, having a package manager installed makes it easier to install MPV:

• macOS: Homebrew
• Linux: Your distribution’s package manager (apt, dnf, pacman, etc.)
• Windows: Chocolatey

​

Dependencies

MUDE automatically installs and manages the following Node.js dependencies:

• node-mpv (2.0.0-beta.2): Node.js wrapper for MPV
• youtube-dl-exec (^3.0.13): YouTube audio extraction
• ytmusic-api (^5.3.1): YouTube Music API integration

You don’t need to install these manually - they’re bundled with the extension.

​

Network requirements

​

Required access

MUDE needs network access to:

• YouTube Music: For searching and streaming music
• YouTube: For audio streaming via youtube-dl

​

Firewall considerations

If you’re behind a corporate firewall, ensure outbound HTTPS connections to the following domains are allowed:

• music.youtube.com
• youtube.com
• ytimg.com

​

Limitations

​

Known limitations

• No offline playback: MUDE streams music from YouTube Music and requires an internet connection
• No video support: MUDE is audio-only and doesn’t display video content
• YouTube Music only: Currently, MUDE only supports YouTube Music as a source

​

Performance considerations

• Streaming music uses bandwidth (typically 128-256 kbps for audio)
• MPV uses minimal CPU and RAM when playing audio
• MUDE stores minimal data locally (playlists and preferences only)

​

Troubleshooting

​

Extension activation fails

If MUDE fails to activate, check:

1. VS Code version: Make sure you’re running 1.91.0 or higher
2. MPV installation: Verify MPV is installed and in your PATH
3. Extension logs: Check the Output panel (View → Output) and select “MUDE” from the dropdown

​

”Failed to find MPV on your system”

This error means MUDE can’t detect MPV. To fix:

1. Install MPV using the MPV setup guide
2. Ensure MPV is in your system PATH
3. Restart VS Code
4. If the issue persists, restart your computer

​

Next steps

Once you’ve verified your system meets these requirements:

1. Install MPV if you haven’t already
2. Install MUDE from the VS Code marketplace
3. Get started with playing music