Skip to content
tcholewaPublic

About

Native macOS menu bar equalizer with eight parametric bands and a shared-memory virtual output driver.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

myEq

CI

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.

Screenshots

Equalizer window

myEq equalizer window with a segmented LED output spectrum beneath the EQ curve, eight parametric bands, preamp, and stereo output meters

Menu bar

Menu panel with status, output, Your sound preset and response preview, and a subdued Open equalizer button

Both previews are rendered from source with synthetic display data; native window/popover chrome is not shown.

Features

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

Requirements and project status

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.

Build and install

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

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

Use

  1. 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.
  2. 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.
  3. 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.
  4. 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.

Output compatibility

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.

Development and contributing

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.

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.

License and acknowledgments

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.

About

Native macOS menu bar equalizer with eight parametric bands and a shared-memory virtual output driver.

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages