Skip to content

About

Separate GD/Song output for OBS

Resources

Stars

6 stars

Watchers

0 watching

Forks

Repository files navigation

OBS Jukebox

Separate GD/Song output for OBS. Also keeps sound effects. No driver/audio cable installation.

image

Installation

  1. Go to Releases on this repository's GitHub page.
  2. Download the setup for your platform (the .exe on Windows, the .zip on macOS).
  3. Run it. On Windows, tick Install Jukebox 3.8.0 if you don't have Jukebox yet, and Add GD Sounds to my existing OBS scenes if you want setup to add the source. Both are off by default.
  4. It will ask you to close OBS and GD if they are running.

OBS Jukebox Windows setup

  1. Install Node IDs from Geode's mod list in GD if you don't have it. OBS Jukebox doesn't load without it, and setup doesn't install it.

Done! Change OBS/Game volume in pause menu. Other options in geode mod menu.

If you didn't let setup add it (and always on macOS), add GD Sounds in OBS once after installation.

image

Usage

In Jukebox, check 'Game' for your in-game audio (not heard in OBS' output) and 'OBS' for the OBS output (not heard in game) Toggle between Game/OBS volume control in pause menu. image

Update the mod and the OBS plugin together. This version of each only works with the other, and OBS's source properties say which one to update.

Updates

From 1.2.4 on, OBS Jukebox checks for a new version once per launch on Windows and macOS, and installs the mod and the OBS plugin together. Updates install while GD and OBS are closed, and never close OBS. Choose how it asks under Settings > Updates. On Linux, download new versions from the releases page.

Speedhack and pitch shifting

When another mod pitch shifts the game's audio with FMOD's pitch shifter, OBS applies the same shifters in the same order: on each music channel, on the music group and on sound effects. A replacement OBS song follows them too. To keep it at its normal pitch, turn off Pitch shift the OBS song in the mod's settings.

This mod utilizes Stephan M. Bernsee's smbPitchShift algorithm, the same algorithm used by FMOD, the audio middleware used in Geometry Dash, to ensure maximum parity.

Compatibility

Requires Geode 5.11.2 or newer in the 5.x series, Geometry Dash 2.2081, and Jukebox 3.8.0.

Windows x64 and macOS 13+ (Apple Silicon) are (somewhat) supported. Linux support through Proton is experimental.

Run OBS as your normal user, not as administrator. OBS only follows packets signed with a key that the mod writes where only your account can read it. A program already running as you can read that key too, and an OBS running as administrator would then open files for it that only an administrator can read.

AI-Generated code disclosure

There is code generated by LLMs in this repository. I understand if you do not want to use it for that reason.

Do understand that this is a tool that exists to fix a problem, and not any sort of artistic expression. It was created because someone asked for this tool to exist, and now it does. It (seemingly) works fine, though no code, written by LLMs or humans, is bug and issue free, but I suspect that LLM generated code is scrutinized to a higher degree than that of handwritten code.

Regardless, do keep this in mind when using it, though I did actually try not to make this mod slop. If you believe it is, that's okay.

About

Separate GD/Song output for OBS

Resources

Stars

6 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages