Boombox Controller Remastered

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.1

• Search by name: /bplay never gonna give you up or /bsearch.
• /badd appends to the queue; /bpacks and /bpack play music packs from your modpack in perfect sync.
• Volume normalization against earrape, and vote-to-skip for groups.
• Music relayed through walkie-talkies, commands in the ship terminal, beat-reactive boombox.
• Brazilian Portuguese translation, optional LethalCompanyInputUtils and LethalConfig support.

Commands

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

|Command|What it does|

|-|-|

|/bplay |Play a YouTube/SoundCloud video, playlist, or the first YouTube result for a search|

|/bsearch |Search YouTube by name|

|/badd |Add to the end of the queue|

|/bpacks, /bpack |List / play music packs from other mods|

|/blocal \[n\|all]|List or play files from your local music folder|

|/btime 1:30|Seek|

|/bskip, /btrack |Next track / jump to track n (may need a vote, see below)|

|/bqueue|Show the queue|

|/bstop|Stop and go back to vanilla music|

|/bvolume 0-100|Your own volume (also Page Up / Page Down)|

|/bcache \[clear]|Show or clear the downloaded songs cache|

|/bhelp|Help|

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.
• Music packs installed through a modpack (BoomboxMusic folders) are identical for everyone, so they always play in sync.
• With 3 or more players, skipping someone else's track needs a majority vote (RequireVoteToSkip). For public lobbies, also enable OnlyHostCanControl.
• Ship terminal: type command box help.

First launch: external tools

On the first start the mod downloads these tools (\~150 MB) into BepInEx/plugins//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.

Optional mods

• LethalCompanyInputUtils: volume keys in Settings > Controls.
• LethalConfig: edit the options in game.

Files and config

• Config: Lethal Company/BoomboxController/boombox\_controller.cfg (language: Languages = en, ru or pt)
• 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

|Problem|Fix|

|-|-|

|HTTP 403 / Forbidden|Delete bin.yt-dlp-last-update and restart to force a yt-dlp update|

|"Sign in to confirm you're not a bot"|Set CookiesFromBrowser = chrome (or firefox/edge) in the config|

|Only I hear the music|The host needs the mod; everyone needs the same version|

|Antivirus flags yt-dlp.exe / deno.exe|Known false positive; allow the bin folder|

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

Credits

Original mod and idea: Koder-Teh. This package is not affiliated with or en