Skip to content

methodhandle/SpotifyControl

Repository files navigation

SpotifyControl - Music Overlay for Minecraft

SpotifyControl is a lightweight client-side Fabric mod that brings your Spotify music experience directly into Minecraft. This mod allows you to see what's currently playing on Spotify and control playback without leaving the game!

IF YOU WANT MORE FEATURES/VERSION SUPPORT ETC. JOIN THE DISCORD !

https://discord.gg/k7XJBPfWeD

Features

  • Real-time Music HUD :D: See the artist and song title of what's currently playing in a sleek, non-intrusive HUD overlay
  • Playback Controls!: Control Spotify playback directly from Minecraft using keybindings
  • Fully Customizable: Position the HUD anywhere on your screen with presets or exact coordinates
  • Cross-Platform: Works on both Windows and Linux (And Mac soon maybe :D )

How to Use

Installation

  1. Install Fabric for Minecraft 1.21.4 (or compatible version)
  2. Download the SpotifyControl mod JAR and place it in your mods folder
  3. Install dependencies:
    • Windows: No additional setup required
    • Linux: Install playerctl using your package manager!

Keybindings

SpotifyControl comes with the following default keybindings:

  • J: Play/Pause
  • K: Next Track
  • H: Previous Track
  • U: Toggle HUD Visibility

You can change these in the Minecraft controls settings.

Commands

The mod offers several commands to customize your experience:

Position Commands

  • /spotify hud preset topleft - Set position to top-left corner
  • /spotify hud preset topcenter - Set position to top-center
  • /spotify hud preset topright - Set position to top-right corner
  • /spotify hud preset middleleft - Set position to middle-left
  • /spotify hud preset middlecenter - Set position to middle-center
  • /spotify hud preset middleright - Set position to middle-right
  • /spotify hud preset bottomleft - Set position to bottom-left
  • /spotify hud preset bottomcenter - Set position to bottom-center
  • /spotify hud preset bottomright - Set position to bottom-right
  • /spotify hud position <x> <y> - Set a custom position

Appearance Commands

  • /spotify hud toggle - Show/hide the HUD
  • /spotify hud margin <pixels> - Set margin from screen edges
  • /spotify hud color background <hexcolor> - Change background color (supports formats like #80000000, 80000000, etc.)
  • /spotify hud color text <hexcolor> - Change text color

Text Scrolling Commands

  • /spotify hud scroll enable - Enable text scrolling for long titles
  • /spotify hud scroll disable - Disable text scrolling
  • /spotify hud scroll maxwidth <pixels> - Set maximum width before scrolling (50-500)
  • /spotify hud scroll speed <pixels> - Set scroll speed (1-10 pixels per update)
  • /spotify hud scroll delay <milliseconds> - Set delay between scroll updates (10-1000ms)

Not Playing Commands

  • /spotify hud notplaying show - Show the HUD even when nothing is playing
  • /spotify hud notplaying hide - Hide the HUD when nothing is playing

Technical Details

The mod automatically detects your operating system and uses the appropriate method to interact with Spotify:

  • On Windows, it uses the Windows Media API
  • On Linux, it relies on the playerctl command-line tool

The HUD will automatically hide when:

  • No music is playing
  • The F3 debug screen is open
  • You manually hide it with the toggle keybind or command

Troubleshooting

  • On Linux: Make sure playerctl is installed
  • HUD not showing: Ensure Spotify is running and music is playing, or use /spotify hud notplaying show to see the HUD regardless
  • Text cutting off: Enable scrolling with /spotify hud scroll enable for long song titles
  • Controls not working: Check if any other applications might be intercepting the media commands

Compatibility

SpotifyControl is designed to be minimally invasive and should be compatible with most other mods. As it only adds a small HUD element and doesn't modify any game mechanics, it shouldn't conflict with other mods.

This mod is client-side only and does not need to be installed on servers.

Privacy & Permissions

SpotifyControl only reads the currently playing track information from Spotify and sends media control commands. It does not access your Spotify account, playlists, or any other personal information.

Enjoy your Minecraft adventures with your favorite music, all in one seamless experience!

About

Control your Spotify from in-game :)

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages