Quickstart

Get up and running with MUDE in minutes

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:

macOS

brew install mpv

Linux

Ubuntu/Debian

sudo apt-get install mpv

Windows

choco install mpv

Or download from mpv.io

Verify MPV is installed: mpv --version

If 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):

Command	Description
MUDE: Search Music	Search and play music from YouTube Music
MUDE: Toggle Pause	Play or pause the current track
MUDE: +10 sec	Seek forward 10 seconds
MUDE: -10 sec	Seek backward 10 seconds
MUDE: Play Next Track	Skip to the next recommended track
MUDE: Play Previous Track	Go 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:

• Troubleshooting guide: /guides/troubleshooting
• GitHub issues: Report a bug or request a feature
• Check requirements: Verify your system meets all requirements

Enjoy coding with music! 🎧