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.

Get MUDE up and running in just a few minutes. This guide will take you from installation to playing your first song.

​
Prerequisites

Before you begin, make sure you have:
  • VS Code 1.91.0 or higher - Check your version with code --version
  • MPV media player - Required for audio playback

​
Step 1: Install MPV

MUDE uses MPV for audio playback. Install it based on your operating system: 
brew install mpv
Verify MPV is installed: mpv --versionIf you get a “command not found” error, MPV is not in your PATH. See the installation guide for troubleshooting.

​
Step 2: Install MUDE extension

1

Open VS Code extensions

Press Ctrl+Shift+X (Windows/Linux) or Cmd+Shift+X (macOS) to open the Extensions view.
2

Search for MUDE

Type “MUDE” in the search bar and find “MUDE music player” by mayur1377.
3

Install the extension

Click the Install button.
4

Reload VS Code

The extension will activate automatically. You should see a 🎧 icon in your status bar.
If you don’t see the 🎧 icon, reload VS Code with Ctrl+Shift+P → “Developer: Reload Window”

​
Step 3: Play your first song

1

Open the music search

Click the 🎧 icon in the status bar, or:
  • Press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (macOS)
  • Type “MUDE: Search Music”
  • Press Enter
2

Search for a song

Type the name of a song, artist, or album you want to play. MUDE will search YouTube Music and show you results.
3

Select a track

Use the arrow keys to browse results, then press Enter to select a track. MUDE will:
  1. Download the audio
  2. Start playback
  3. Load automatic recommendations
4

Control playback

Once playing, you’ll see controls in your status bar:
  • ◀ - Previous track
  • ◀◀ - Seek backward 10 seconds
  • ⏸/▶ - Play/Pause
  • ▶▶ - Seek forward 10 seconds
  • ▶ - Next track

​
Available commands

MUDE provides these commands accessible via the Command Palette (Ctrl+Shift+P or Cmd+Shift+P):
CommandDescription
MUDE: Search MusicSearch and play music from YouTube Music
MUDE: Toggle PausePlay or pause the current track
MUDE: +10 secSeek forward 10 seconds
MUDE: -10 secSeek backward 10 seconds
MUDE: Play Next TrackSkip to the next recommended track
MUDE: Play Previous TrackGo back to the previous track
Set up keyboard shortcuts for your most-used commands:
  1. Open Keyboard Shortcuts (Ctrl+K Ctrl+S or Cmd+K Cmd+S)
  2. Search for “MUDE”
  3. Click the + icon to add a shortcut
Suggested shortcuts:
  • Ctrl+Shift+M (or Cmd+Shift+M) for Search Music
  • Ctrl+Shift+P (or Cmd+Shift+P) for Toggle Pause

​
What’s next?

Learn the features

Discover MUDE’s automatic playlists, recommendations, and advanced controls

Configure MPV

Optimize your MPV setup for the best audio experience

Basic usage guide

Learn tips and workflows for daily use

Troubleshooting

Fix common issues and get help

​
How automatic playlists work

When you play a song, MUDE automatically:
  1. Fetches recommendations from YouTube Music’s “Up Next” section
  2. Builds a queue of similar tracks
  3. Plays continuously - when a track ends, the next one starts automatically
  4. Updates the status bar with upcoming track information
You can navigate through the recommendation queue using the Previous/Next buttons or commands.

​
Persistent playback

MUDE remembers your playback state across VS Code sessions:
  • Last played track is restored when you reopen VS Code
  • Recommendation queue persists between windows
  • Playback position is maintained when switching windows
Playback starts paused when VS Code restarts. Click Play to resume.

​
Getting help

Having issues? Here’s where to get help: Enjoy coding with music! 🎧

Build docs developers (and LLMs) love

Get started for freeTalk to us