myEq began with a practical problem: desk speakers that sounded boomy. Room measurements revealed problems at specific frequencies, but macOS had no built-in system-wide equalizer to apply targeted corrections across all audio playback. The idea was to build a small app that could improve the sound of the whole system, with precise frequency adjustments and quick access from the menu bar.
All code in this project was generated using GPT-6 Astra.
A native macOS menu bar equalizer for your system's mixed stereo output. Shape your sound with eight parametric bands, save presets, and keep playback running when the editor is closed.
Apple Silicon · macOS 27+ · MIT licensed
Version 0.5.9 (build 24) makes the menu bar icon reflect the engine state: full opacity while equalizing, slightly reduced while starting or reconnecting, and dimmed whenever the EQ is not processing audio. The 0.5.8 session-recovery fix and adaptive browser audio buffering from 0.5.7 are retained. See icon verification.
Equalizer window
Menu bar
Both previews are rendered from source with synthetic display data; native window/popover chrome is not shown.
- Eight bands with bell, low/high shelf, and low/high cut filters; edit frequency, gain, and width numerically, with faders, or on the response graph.
- Saved presets, automatic preamp, and stereo-linked sample-peak protection.
- Independent segmented LED L/R output meters with slowly falling peak markers and matching dBFS readings, updated at 30 Hz.
- A subtle segmented LED post-EQ spectrum behind the frequency response, with one bar per spectrum sample, a remembered on/off toggle, and Reduce Motion support.
- Menu bar access to output selection, presets, bypass, launch at login, and the editor.
- Visual processing pauses when the editor is closed, hidden, minimized, or fully covered; audio processing continues.
- Local audio processing through an output-only virtual device and shared memory. No audio recording, microphone capture, or network audio transport.
myEq processes the default system mix. It does not provide per-app controls; applications explicitly routed to another device remain outside that mix.
| Requirement | Current support |
|---|---|
| Mac | Apple Silicon (arm64) |
| macOS | 27 or later |
| Build tools | Full Xcode 27 or later, with its command-line tools selected; Python 3 |
| Installation | Administrator access for the virtual output driver and background helpers |
| Dependencies | Apple system frameworks; no external package dependencies |
This is an early source release. The build produces an ad-hoc-signed, non-notarized installer for local development; it is not a Developer ID distribution. Automated checks and some live checks have passed, but the full device, recovery, performance, and latency matrix is still incomplete. See verification results and remaining hardware checks.
Clone and build the repository:
git clone https://github.com/tcholewa/myEq.git
cd myEq
bash scripts/build-installer.sh
python3 scripts/verify-installer.py
open dist/myEq.pkgQuit myEq and audio playback apps before installing. The installer reloads Core Audio only for a fresh installation or changed driver/bridge, interrupting all sound, including calls and recordings. When verified driver/bridge identities are unchanged, the installer keeps Core Audio running. However, replacing the driver files can still unload the virtual output; this occurred during the tested 0.4.3 upgrade and required a manual audio-service reload. After a reload, reopen playback apps so they reconnect; if audio apps remain stuck, save your work and restart your Mac.
Open /Applications/myEq.app and allow its background helper in System Settings → General → Login Items & Extensions if prompted. Select your physical output in myEq, then enable EQ.
Always install the app, driver, and helpers from the same package. Build artifacts are under build/artifacts.noindex; dist/myEq.pkg is the installer. For setup details, troubleshooting, rollback, and removal, see installation guide.
- Choose your physical speakers or headphones using Output in myEq, then enable EQ. myEq redirects the default media and system-sound mix through its virtual output, named myEq: {physical output name} in macOS (for example, myEq: ADAM Audio D3V). The name follows output changes and returns to myEq when no session is attached.
- Start with Flat, or Botaniq1 for the seven reference bands. The eighth band is initially disabled. Edit numeric fields, faders, or graph points; save personal presets with Save preset. The editor starts with no band selected; clicking outside a band clears its highlight and field focus. Double-click a gain fader or width dial to reset it; exact values remain directly editable. The preset’s … menu contains rename, update, restore, and delete actions.
- Closing or hiding the window keeps audio processing active. EQ is designed to keep playing through screen lock while the same login session owns the console; actual system sleep or user switching suspends it. Temporary helper interruptions reconnect automatically with bounded retries. The menu bar icon itself reflects the engine state: full opacity while equalizing, slightly reduced while reconnecting, and dimmed whenever the EQ is not processing audio. The menu bar opens a compact graphite panel with status, power and output controls, and a Your sound preset selector with a static response preview. Open equalizer uses the same subdued styling as the surrounding controls. Options contains launch at login and Background Items; see the menu design specification. ⌘⇧E opens the editor from the panel; ⌘E toggles EQ and ⌘0 selects Flat in the editor.
- Selecting a physical output in macOS bypasses EQ. If the current destination disconnects, myEq follows an available physical fallback and resumes when supported. It does not automatically switch back when the disconnected device returns.
Volume and mute follow the physical device where supported. Fixed-volume hardware remains fixed-volume; myEq never forces the hardware to full volume or applies the same attenuation twice. Quit eqMac before using myEq to avoid competing virtual-output routing.
The independent L/R output meters refresh at 30 Hz, retain short transients, and measure after EQ and peak protection. Each horizontal meter has 45 LED cells, grading from dark teal on the left to pale sage toward the level tip, with amber/red warning colors near the maximum. Bars fall at 24 dB/second. White peak markers and their matching dBFS readings hold for one second, then fall together at 6 dB/second. Native layers avoid repeated SwiftUI layout. When the editor is hidden, minimized, closed, or fully occluded, visual polling, DSP peak measurement, and the editor’s response calculations stop. Opening only the menu refreshes its cached 128-point response preview and does not enable live metering. When both surfaces are hidden, all visual calculations stop. Audio buffering accounts for the virtual output and hardware block sizes plus observed producer bursts, keeping a two-block reserve. The reserve can grow during a session and resets when the session restarts. The adaptive contribution is capped at 8192 frames (170.7 ms at 48 kHz); existing configured requirements are preserved. This can affect video synchronization when a source delivers large bursts. On enable or output selection, myEq requests at least 512 hardware frames where supported and attempts to match the virtual device. This device-wide setting can affect other audio apps and adds latency. Larger existing hardware buffers are preserved; myEq conditionally restores its changes when the session ends. Automatic reconnects do not repeatedly enforce the setting.
Spectrum in the frequency-response header toggles the live background and remembers your choice. Filled sage bars show actual output after preamp, EQ, and peak protection. The analyzer combines left/right power so opposite-phase audio remains visible. Each of the 64 logarithmic frequency samples drives one bar, independently of the eight EQ control points. Bars rise immediately and fall at 24 dB/s; pale peak markers hold for one second, then fall at 6 dB/s, matching the stereo meters. The fixed −90–0 dBFS spectrum scale is separate from the graph's EQ-gain axis. Normal updates run at 30 Hz; macOS Reduce Motion uses 10 Hz. Hiding the editor or switching Spectrum off stops capture, FFT analysis, and animation. The menu preview stays static. Samples remain in bounded process memory and are never recorded or sent elsewhere.
Built-in/wired, USB/HDMI, and Bluetooth stereo routes are supported by the implementation. Bluetooth microphone use suspends EQ until stereo playback returns. AirPlay, other virtual devices, aggregates/multi-output, and surround are excluded. The virtual device follows the physical nominal sample rate from 32–192 kHz; unsupported formats remain bypassed. Implementation support is not a claim that every device has been tested; hardware coverage is listed in verification.
Start with CONTRIBUTING.md for the development workflow, checks, and issue reporting. Open myEq.xcodeproj for editor work. The packaged app's --preview mode opens the editor without enabling audio or saving settings; --diagnose prints output-device information.
- Installation and troubleshooting: setup, driver loading, recovery, and removal.
- Architecture: signal path, driver, transport, DSP, and recovery.
- Verification: automated results, live evidence, and outstanding checks.
- Security reporting: how to report a vulnerability privately.
- Maintainer release guide: GitHub setup and release preparation.
Peak protection is a stereo-linked sample-peak limiter with 1 ms lookahead, not oversampled true-peak limiting. Hardware buffers, transport, and clock conversion add latency; the under-20-ms wired target still needs end-to-end measurement.
Security hardening and its test limits are documented in the security review. Developer ID candidate tooling is available in the release guide; default source builds remain ad-hoc signed and unnotarized.
myEq's original code and documentation are licensed under the MIT License. Copyright © 2026 Tomasz Cholewa.
The DSP's biquad coefficient equations are based on Robert Bristow-Johnson's Audio EQ Cookbook, as published by W3C and edited by Raymond Toy. See third-party acknowledgments and notices for the source, adaptation details, and W3C license. The build includes both notice files in myEq.app/Contents/Resources; in Finder, choose Show Package Contents to read them.

