Skip to content
pit711Public

About

Toggle Windows per-device audio enhancements off/on - a tiny, transparent PowerShell GUI (no install, scanner-friendly, MIT).

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Reinklang

Reinklang  ·  v0.1

A tiny, transparent Windows GUI to turn the per-device "Audio Enhancements" (audio effects) on or off — quickly, reliably, and without installing anything.

Windows applies optional signal processing (Loudness Equalization, Bass Boost, Virtual Surround, room/spatial effects, and OEM effects from Realtek/Dolby/etc.) to playback devices. These effects alter the output signal. When you need the unaltered signal — measurements, recording, calibration, critical listening — they have to be off. The built-in Windows dialog only toggles them one device at a time and the option is buried; this tool lists every playback endpoint and switches them in one place.

Runs on Windows 10 and 11. No installer, no compiled binary — just PowerShell.

Features

  • Lists every playback (render) endpoint with its current enhancement state.
  • Turn enhancements off (or back on) for the selected devices, with read-back verification of every change.
  • Undo — every change writes a restore point first, so you can revert the last change (repeatedly) and get back to the exact previous state.
  • Privilege-level bar showing whether you run as Standard, Administrator, or SYSTEM, what each level can do, and a one-click request for admin rights (UAC).
  • Optional audio-service restart so the change takes effect immediately.
  • Marks the default playback and default communication device.
  • Auto-highlight specific devices by name (see auto-select.txt).
  • Timestamped log plus a developer debug report (system info, full device dump, last errors) for troubleshooting.
  • Portable: runs from any folder or USB stick (drive-letter independent).

Requirements

  • Windows 10 or 11, Windows PowerShell 5.1 (built in).
  • Local administrator rights to write the setting and restart the audio service (the tool requests elevation via UAC automatically).

Quick start

  1. Double-click start.bat and confirm the UAC prompt.
  2. Tick the devices you want to change (active devices are pre-selected).
  3. Click "Markierte: Verbesserungen ABSCHALTEN" to turn enhancements off.
  4. Leave "Audiodienst neu starten" checked so the change applies at once (audio stops for a moment).

The Verbesserungen column then reads Aus (green) for each device. If anything looks wrong, click "Änderungen rückgängig machen" to revert.

Privilege levels

The bar at the top shows the current level and its capabilities:

Level Read Write Restart audio service
Standard (restricted) ✓ only if the endpoint ACL allows it ✗
Administrator (via UAC) ✓ ✓ ✓
SYSTEM (deployment context) ✓ ✓ ✓

SYSTEM is the level used for unattended rollout via GPO / Intune / SCCM, where the registry value is written without any interactive user.

Undo

Before each change the tool snapshots the exact prior state of the affected devices (value present / absent and its number) into a JSON restore point under restore/. Änderungen rückgängig machen applies the most recent restore point and verifies it — including correctly removing a value that was originally not set, rather than forcing it to 0. Multiple changes can be undone one after another.

Auto-highlighting devices

Copy auto-select.example.txt to auto-select.txt and add device-name substrings (one per line, case-insensitive). Matching devices are sorted to the top, shown in bold with a ★, and pre-checked. auto-select.txt is git-ignored so your local list stays private.

How it works

Per render endpoint, Windows stores the flag in the registry at

HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\MMDevices\Audio\Render\{GUID}\FxProperties
    value  {1da5d803-d492-4edd-8c23-e0c0ffee7f0e},5   (REG_DWORD)
        1 = enhancements OFF
        0 / absent = ON

(PKEY_AudioEndpoint_Disable_SysFx.) The tool sets this value, reads it back to verify, and optionally restarts AudioEndpointBuilder so the audio engine reloads the endpoint.

Safety / scanner-friendly

  • No compiled/packed .exe — runs via the signed Windows powershell.exe.
  • Full source is plain text (*.ps1).
  • No obfuscation, no -EncodedCommand, no network access.
  • Elevation via the standard Windows UAC prompt.
  • Verified clean on VirusTotal.

Files

File Purpose
start.bat Launcher — just double-click (self-elevating via UAC)
AudioEnhancementsManager.ps1 GUI
AudioEnhancements.Core.ps1 Core logic (read / write / verify / undo / default device)
reinklang.ico / logo.png App icon and logo
auto-select.example.txt Template for the optional auto-highlight list
_selftest.ps1 Smoke test of the core read/write logic
_test_undo_integration.ps1 Integration tests for the undo logic
_test_undo_e2e.ps1 End-to-end test of the change → undo cycle
LIESMICH.txt German quick start

Running the tests

powershell -NoProfile -ExecutionPolicy Bypass -File _test_undo_integration.ps1
powershell -NoProfile -ExecutionPolicy Bypass -File _test_undo_e2e.ps1

The tests operate on one playback device and restore its original state when finished.

Note on encoding

The two German .ps1 files and the text files are saved as UTF-8 with BOM so Windows PowerShell 5.1 renders the umlauts correctly. Keep the BOM when editing.

License

MIT — see LICENSE.

About

Toggle Windows per-device audio enhancements off/on - a tiny, transparent PowerShell GUI (no install, scanner-friendly, MIT).

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages