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.

MUDE provides comprehensive playback controls integrated directly into your VS Code status bar, allowing you to control your music without leaving your editor.

​
Available controls

All playback controls are accessible through both the status bar and command palette:

​
Play/pause

Toggle between play and pause states with a single click. 
// Toggle pause implementation
const state = await player.getProperty('pause');
if (state) {
  await player.resume();
} else {
  await player.pause();
}
When music is playing, the control shows a pause icon $(debug-pause) with tooltip “Pause”.
If no media is loaded, attempting to toggle pause will display an information message: “No media is currently playing”.

​
Seek controls

Quickly navigate through the current track with seek forward and backward buttons.
Skip ahead by 10 seconds.
await player.seek(10);
  • Icon: $(chevron-right)
  • Tooltip: “+10s”
  • Command: MudePlayer.seekForward
Seek controls are particularly useful for replaying parts of a song or skipping intros.

​
Track navigation

Navigate through your playlist with next and previous track controls.
Play the next track in the recommendations queue.
// Play next recommendation
if (currentRecommendationIndex < recommendations.length) {
const nextRecommendation = recommendations[currentRecommendationIndex];
updateRecommendationIndex(currentRecommendationIndex + 1);
await processTrack(context, ytmusicurl, nextRecommendation.title, ytmusicurl);
}
  • Icon: $(triangle-right)
  • Tooltip: Shows “Up next: [Track Name]” when available
  • Command: MudePlayer.playNext
Track navigation buttons display smart tooltips showing the actual track name that will play next or previous.

​
Command reference

All playback controls are registered as VS Code commands:
CommandTitleCategoryDescription
MudePlayer.togglePauseToggle PauseMUDEPlay or pause the current track
MudePlayer.seekForward+10 secMUDESkip forward 10 seconds
MudePlayer.seekBackword-10 secMUDESkip backward 10 seconds
MudePlayer.playNextPlay Next TrackMUDEPlay the next track
MudePlayer.playPreviousPlay Previous TrackMUDEPlay the previous track
You can assign custom keybindings to any of these commands through VS Code’s keyboard shortcuts settings (File > Preferences > Keyboard Shortcuts).

​
Control visibility

Playback controls automatically show and hide based on the player state:

​
Playing state

When music is playing, all controls are visible: 
// Controls shown during playback
- Play Previous button
- Seek Backward button (-10s)
- Pause button
- Seek Forward button (+10s)
- Play Next button
- Timestamp display

​
Stopped state

When no music is playing, controls are hidden to reduce clutter: 
// Only visible when stopped
- Logo button (🎧) - Click to search for music
- Track name label (if previously played)
The control visibility is managed automatically by the player state machine. You don’t need to manually show or hide controls.

​
MPV player integration

MUDE uses the MPV media player under the hood for high-quality audio playback: 
import { player } from './player';

// Player events
player.on('started', async () => {
  // Update UI when playback starts
  togglePauseButton.text = '$(debug-pause)';
});

player.on('stopped', async () => {
  // Handle track completion
  // Automatically play next track if available
});

player.on('timeposition', async (timePosition: number) => {
  // Update timestamp display
  const time = new Date(timePosition * 1000).toISOString();
  timestampButton.text = time.substring(14, 19); // MM:SS format
});
The timestamp display automatically adjusts format based on duration: MM:SS for tracks under 1 hour, HH:MM:SS for longer content.

​
Error handling

Playback controls gracefully handle errors:
  • No media loaded: Shows information message instead of crashing
  • End of playlist: Prompts user to search for more music
  • Download failures: Displays error in status bar with clear messaging
If you encounter persistent playback issues, try searching for a new track to reset the player state.

Build docs developers (and LLMs) love

Get started for freeTalk to us