muhammedtalha04/pockettune

PocketTune is a Minecraft mod that adds a music speaker block players can place in the world, along with a portable version they can carry in their inventory. It plays YouTube videos and playlists, resolving the links with a tool called yt-dlp and playing the audio through a media player called mpv, so no browser tab, API key, or paid subscription is needed. The speaker supports spatial audio, meaning the sound gets quieter or changes based on distance and walls between the player and the speaker, along with a shared, synchronized playback queue so everyone nearby hears the same song at the same point. It includes a media player style interface with drag and drop queue management, cover art, artist and duration info, shuffle, repeat, and seeking. The mod also correctly pauses music while in menus like the options screen and resumes only during actual gameplay, and playback is not interrupted by opening an inventory or crafting screen. To use it, a player needs Minecraft 1.21.4 with the NeoForge mod loader, plus the yt-dlp and mpv tools installed and available on their system path. After placing the mod's jar file in the mods folder, players place a speaker block, right-click it, and paste in a supported YouTube link through the in-game interface. A dedicated server running the mod needs yt-dlp but does not need mpv, since only listening clients play the actual audio. For developers, the project includes one-command setup scripts for Windows, macOS, and Linux that check for and help install required tools like Java 21, yt-dlp, and mpv, plus a build command using Gradle. The README also notes the repository was set up with AI coding assistants like Claude Code and Cursor in mind, including dedicated instruction files for them. PocketTune is released under the Apache License 2.0, which allows free use, modification, and redistribution as long as the license and attribution notice are kept.