Information for:
About SoundSource's Debugging Window

The Debugging Window

SoundSource includes a dedicated Debugging window, which provides access to logging controls, unsupported Hidden Settings and a Factory Reset button for restoring the application’s original settings.

SoundSource’s Debugging window

To access SoundSource’s Debugging window, hold down the Option key on your keyboard when the Help menu is open. The Contact Rogue Amoeba… command will change to Quit and Relaunch for Debugging.

Access SoundSource’s Debugging window

Select that command and SoundSource will quit and relaunch directly to its Debugging window.

Logging & Debugging

In the course of troubleshooting, Rogue Amoeba’s Support team may request debugging logs. These can be enabled from the Logging & Debugging section. For more details, see this article on collecting logs.

SoundSource’s Hidden Settings

The Debugging window contains a section dedicated to special hidden settings, which provide some secondary functions that are not intended for everyday use. These settings are intentionally not included in the app’s main interface, as they are useful only in rare or edge cases.

Hidden settings are unsupported

These hidden settings are intended to assist customers use the product, but circumstances change over time. Please be aware that they may be changed or removed in future versions of the software.

SoundSource’s Hidden Settings include:

Aggressive Super Volume Keys
When enabled, SoundSource works to apply its “Super Volume Keys” functionality earlier, so that it works when running “Dell Display and Peripheral Manager”, as well as any other software that would otherwise break it.
Alternate Bluetooth auto-switching
Setting for Bluetooth devices like Sony WH-1000XM4 that demonstrate undesirable auto-switching behavior.
Bypass processing for device
When enabled, SoundSource will not apply processing to any audio played to the selected device. This functionality is automatically used for disabling processing for virtual devices like BoomAudio, but it can be used manually by users who don’t want SoundSource’s audio processing to impact a specific device.
Check for test releases
Receive prompts to access testing versions of SoundSource to try the latest enhancements and bug fixes early.
Debug Audio Units
This setting is intended for plugin developers to force plugins to load in-process, simplifying the debugging process.
Force software volume control
When this setting is enabled for an audio device, SoundSource will add software volume control for the device. This is useful for certain devices which inaccurately report the presence of non-existent volume controls. If a device reports that it does not offer volume control, we automatically apply a software volume control, and omit that device from this menu.
Short trial mode
When active, SoundSource’s trial restrictions will take effect after just 30 seconds. This is intended for internal testing of the trial limitations and can be ignored.
Show blocked third-party Audio Units
By default, SoundSource blocks a small list of Audio Unit plugins which do not work properly inside it. It is possible to turn this off, though it is not recommended.
Show legacy menu bar icon
SoundSource 5’s icon is designed to resemble the system’s volume icon, to serve as a replacement. For users that prefer to use both, the legacy icon can help to differentiate between the two.

Starting Fresh

Clicking the Factory Reset button in the Start Fresh section of the Debugging window will restore SoundSource’s default settings, making the app behave as if it is being launched for the first time. Use this function with caution, as it will revert all custom settings.


← Back to SoundSource Support Center