whatisgithub

What is onlyeq?

zollans/onlyeq — explained in plain English

Analysis updated 2026-05-18

5SwiftAudience · generalComplexity · 2/5LicenseSetup · easy

In one sentence

A menu bar app that adds a system wide parametric equalizer to macOS using Apple's audio tap API, with no virtual driver install needed.

Mindmap

mindmap
  root((OnlyEQ))
    What it does
      System wide EQ
      No virtual driver
      Menu bar app
    Features
      Parametric curve editor
      Import AutoEq peqdb
      Per device profiles
    Tech stack
      Swift
      Core Audio process tap
      Sparkle updates
    Use cases
      Tune headphone sound
      Boost volume safely
      Per app audio exclude
    Setup
      macOS 14.4 plus
      Install script
      Build from source

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Apply a headphone correction EQ profile system wide without a virtual audio driver.

USE CASE 2

Boost system volume safely with automatic clipping protection.

USE CASE 3

Keep separate EQ profiles for headphones and speakers that switch automatically.

USE CASE 4

Exclude specific apps, like a DAW, from the system EQ to avoid audio conflicts.

What is it built with?

SwiftCore AudioSwiftPMSparkle

How does it compare?

zollans/onlyeqalamofire/rdar-urlsessiontaskmetricsnilava/tabtype
Stars555
LanguageSwiftSwiftSwift
Last pushed2017-12-15
MaintenanceDormant
Setup difficultyeasyeasymoderate
Complexity2/51/52/5
Audiencegeneraldevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires macOS 14.4 or newer, the app is unnotarized, so the install script clears the quarantine flag itself.

Released into the public domain under the Unlicense, so you can use, modify, or redistribute it for any purpose with no attribution required.

So what is it?

OnlyEQ is a system wide parametric equalizer for macOS that lives quietly in the menu bar. Most similar tools require installing a virtual audio driver like BlackHole, which the author found messy and prone to breaking. Instead, OnlyEQ uses a process tap feature Apple added in macOS 14.4: it taps into the system's audio output, runs it through digital filters, and sends the adjusted sound back out. There is nothing extra to install, no admin password needed, and it adds only about 10 milliseconds of delay, which is fine for music or video but something to watch for latency sensitive recording work. The app gives you a full parametric equalizer with a draggable curve editor, supporting peak, shelf, high and low pass, notch, and band pass filters, with as many bands as you want. It can import headphone correction profiles from a long list of existing formats, including AutoEq, Equalizer APO, peqdb, and several others, either by dropping in a file or searching built in databases. Different audio devices can each keep their own EQ profile, so headphones and speakers do not share settings. Extra touches include volume boosting with automatic protection against clipping, a safety limiter, quick A/B comparison, one click bypass, an exclude list for apps like DAWs that handle their own audio routing, and global keyboard shortcuts. Under the hood, a muted system audio tap and the real output device are combined into a private aggregate device, and an audio callback runs the signal through standard filter math before writing it back out. This approach avoids the common failure points of older virtual driver tools, such as Bluetooth devices distorting or the driver breaking after a macOS update. The tradeoff is that macOS always shows its recording indicator while the app runs, older macOS versions are not supported, and some professional audio software may not get along with the tap approach. Installation is a single shell script, or you can build it from source with the Xcode Command Line Tools in about a minute. It requires macOS 14.4 or newer, and it is released into the public domain under the Unlicense, so there are no restrictions on how you use it.

Copy-paste prompts

Prompt 1
Walk me through installing OnlyEQ using the install script and granting system audio recording permission.
Prompt 2
Show me how to import an AutoEq profile for my headphones into OnlyEQ.
Prompt 3
Explain how OnlyEQ's process tap approach avoids needing a virtual audio driver.
Prompt 4
Help me build OnlyEQ from source using the Xcode Command Line Tools.

Frequently asked questions

What is onlyeq?

A menu bar app that adds a system wide parametric equalizer to macOS using Apple's audio tap API, with no virtual driver install needed.

What language is onlyeq written in?

Mainly Swift. The stack also includes Swift, Core Audio, SwiftPM.

What license does onlyeq use?

Released into the public domain under the Unlicense, so you can use, modify, or redistribute it for any purpose with no attribution required.

How hard is onlyeq to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is onlyeq for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.