Boombox Controller Remastered

Play YouTube and SoundCloud links (videos or whole playlists) or your own music files on the boombox. Everyone with the mod hears the same song at the same time.

An unofficial continuation of Boombox Controller by Koder-Teh (MIT), which is no longer maintained. The download, audio and network code was rewritten from scratch.

It replaces the original and uses the same plugin ID on purpose: if both are installed, BepInEx loads only this one. Uninstall the original Boombox Controller and BoomboxSyncFix anyway to keep your profile clean. Your old config and local music folder keep working.

What's new in 2.0

• YouTube works again: yt-dlp updates itself daily and uses Deno for YouTube's JavaScript checks.
• Every format (Opus, M4A, MP3, FLAC...) is converted to OGG before the game loads it.
• Downloads run in the background: no more freezes or lobby timeouts.
• Real sync: the host waits until everyone finished downloading, starts together and corrects drift.
• Playlists with auto-advance, several boomboxes at once, commands no longer spam the public chat.

Commands

Open the chat with / while holding or looking at a boombox.

Multiplayer

• The host must have the mod. Without it, the mod still works but only you hear your music.
• Everybody must use the same version of this mod.
• Players without the mod just hear the vanilla boombox.
• Only links and metadata are sent over the network; every player downloads the audio on their own PC.
• Local files are never uploaded: others hear them only if they have the identical file.

First launch: external tools

On the first start the mod downloads these tools (~150 MB) into BepInEx/plugins/<this mod>/bin, in the background, from their official GitHub releases, verifying SHA-256 checksums when published:

• yt-dlp — downloads the audio (self-updates once a day)
• FFmpeg (yt-dlp build) — converts the audio
• Deno — JavaScript runtime needed by yt-dlp for YouTube

Nothing is installed outside your mod profile. You can disable automatic downloads in the config (AutoDownloadTools, DownloadDeno) and place the files yourself.

Files and config

• Config: Lethal Company/BoomboxController/boombox_controller.cfg
• Local music: Lethal Company/BoomboxController/other/local (mp3, ogg, wav, m4a, flac, opus)
• Only YouTube and SoundCloud are allowed by default (AllowedDomains), checked on your own PC for every track.

Troubleshooting

Please report issues with your full BepInEx/LogOutput.log.

Credits

Original mod and idea: Koder-Teh. This package is not affiliated with or endorsed by the original author. Licensed under MIT; the original copyright notice is kept in LICENSE.

2.0.0

Complete rewrite of the download, audio and network layers.

• YouTube: yt-dlp is now always the latest release (daily yt-dlp -U), with deno as JS runtime, optional browser cookies and SHA-256 verified downloads. Fixes HTTP 403 / anti-bot failures.

• Audio: every source (Opus/WebM, AAC/M4A, MP3, FLAC...) is transcoded by ffmpeg to OGG Vorbis (or WAV PCM16) before Unity loads it. Clips stay compressed in RAM, are reference counted and destroyed explicitly.

• Performance: downloads, conversions, hashing and cache cleanup run in background tasks; only AudioClip/AudioSource work happens on the main thread through a dispatcher. No more freezes or lobby timeouts.

• Multiplayer: new host-authoritative sync over Netcode named messages. Only metadata is sent; every player downloads locally; the host waits for all modded players (or a timeout), starts a shared timeline and re-syncs it; drift above 0.3 s is corrected. Late joiners catch up automatically. Failed downloads fall back silently to a vanilla song.

• Playlists with auto-advance and prefetch of the next track; /bskip, /btrack, /bqueue, /bstop, /bcache.

• Local tracks are shared by content hash only (never uploaded) with an in-game warning.

• Disk cache in <plugin>/Cache with size/age limits.

• Patches are Postfix/validated Prefix with vanilla fallback; the hover tooltip no longer replaces the vanilla method.

• Multiple boomboxes are supported independently.

• Commands are no longer echoed to the public chat.

• 1.2.2

  • Another blocked link has been added.
  • Checking for characters in playlist names and song uploads from your computer.

• 1.2.1

  • Now, when you turn on the boombox, random music will play. If the /btrack command is not used.
  • Fixed a bug related to the /btrack command.
  • Uploading a playlist from YouTube has been converted to an asynchronous stream.
  • Uploading songs from the computer was converted to an asynchronous stream.

• 1.2.0

  • Allows to upload songs from your computer.

• 1.1.9

  • Automatically switch the track to the next one when playing the playlist.
  • Added weight for the boombox 0.
  • Added a character to the list of characters with automatic replacement.

• 1.1.8

  • Added the radius of the commands at the boombox (Setting in the configuration).
  • Added support for shortened link from youtube: "music.youtube.com".

• 1.1.7

  • Rewrote the logic of logReport.txt file recording.
  • Banned the use of my mod with another mod: "BoomboxSyncFix".
  • Added support for shortened link from youtube: "youtu.be".
  • Fixed an error that came out after sending a command without arguments.

• 1.1.6

  • Code refactoring has been done.
  • Rewrote the method of sending messages to chat. For compatibility.
  • Added toggle to enable and disable visual boombox elements.
  • Added a check for broken zip files. Automatically re-downloads them.
  • Fixed a bug with the config for music.

• 1.1.5

  • Revamped the chat command system (for compatibility with the LethalExpansion mod).
  • Allows boombox to continue playing music after switching slots (inside your inventory).
  • Optimized the code a bit.

• 1.1.4

  • Optimized the code a bit.

• 1.1.3

  • Added bindings to change the volume buttons.
  • Memorizing the volume number after quitting the game.

• 1.1.2

  • Changing the color of the boombox.
  • Adding a picture to the back of the boombox.

• 1.1.1

  • Fixed an issue with uploading videos to boombox when invalid characters were present in the title.

• 1.1.0

  • Fixed the bug that the track was not uploaded via SoundCloud.
  • Fixed a bug with displaying the name of the playing track.
  • Prohibited entering links with search_query value (example link: https://www.youtube.com/results?search_query=test).
  • Added automatic deletion of downloaded music when you quit the game.

• 1.0.9

  • Fixed a bug with displaying the name of the playing track.
  • Fixed a bug when single tracks were not working after playlist.

• 1.0.8

  • The track uploading has been optimised.
  • Added support for YouTube playlists.
  • Added command to switch tracks (for playlists).

• 1.0.7

  • Added track position change in the boombox.
  • I cleaned the code a little bit :)

• 1.0.6

  • Improved synchronization of songs via SoundCloud.
  • Added protection so that you can't write to the chat. When the /bplay command is being processed

• 1.0.5

  • Fixed a bug where when entering the correct link from YouTube, the message "invalid link" was displayed.

• 1.0.4

  • Added support for SoundCloud links.
  • Added protection from invalid links.
  • Rewrote downloading additional libraries into multithreading.
  • Added Russian language. You can change the language in the mod's configuration.

• 1.0.3

  • Updated additional libraries for security reasons.
  • Added protection if additional libraries are not loaded

• 1.0.2

  • Fixed an issue where the track download confirmation text was not displayed in chat.

• 1.0.1

  • Update README.md.

• 1.0.0

  • Hello, there is nothing new here yet.