jaakkopasanen /AutoEq

Automatic headphone equalization from frequency responses

★ 16,456⑂ 2,570👁 204⑃ 106● 982▤ 0
PythonMITCreated 2018-03-04
+1
Daily
16,456
stars
2,570
forks
204
watchers
106
prs
982
issues
0
releases

README

AutoEq
AutoEq is a tool for automatically equalizing headphones.

Go to autoeq.app to get started.

This Github repository now mainly serves developers. The contributions of this project are:
 Web application for easily equalize and tweak headphone frequency responses without needing to install anything
 Library for working with (headphone) frequency responses and optimizing parametric equalizers
 PyPi package for installing the library on your projects
 Collection of headphone measurements as numerical data from
oratory1990,
crinacle,
Innerfidelity,
Rtings and legacy
headphone.com measurements (which are not the same as what the company produces today).
 Collection of different headphone frequency response targets as numerical data
 Pre-computed equalizer settings in results, although these should not be used by normal users since
autoeq.app exists

!Sennheiser HD 800

Sennheiser HD 800 equalization results plotted

 Updates
2023-10-29 AutoEq version 4.0.0. Improved and unified naming conventions across the project. Cleaned up obsolete
files and reorganized directory structure. Completely reworked database management tools.

2022-05-14 Web application. Reorganized measurements and results.

2022-10-30 Restructured the project and published in PyPi. Source code moved under autoeq directory and 
command line usage changed from python autoeq.py to python -m autoeq with underscores _ replaced with hyphens -
in the parameter names. 

2022-09-18 Parametric eq optimizer reworked. The new optimizer supports shelf filters, has a powerful configuration
system, run 10x faster, has limits for Fc, Q and gain value ranges and treats +10 kHz range as average value instead of
trying to fix it precisely.

 Usage
AutoEq produces settings for basically all types of equalizer apps but does not do the equalization itself. You'll need
a different app for that. Go to autoeq.app and select your equalizer app of choice. Quick
instructions for importing the produced settings will be shown there.

 Command Line Use
In addition to the web application, AutoEq can be used from command line (terminal). This is advanced use mainly
intended for developers. The following instructions apply for command line and Python interface use.

 Installing
- Download and install Git: https://git-scm.com/downloads. When installing Git on Windows, use Windows SSL verification
instead of Open SSL or you might run into problems when installing project dependencies.
- Download and install 64-bit Python 3. Make sure to check Add Python 3.X to PATH.
- You may need to install libsndfile if you're having problems with soundfile
when installing and/or running AutoEq.
- On Linux you may need to install Python dev packages
shell
sudo apt install python3-dev python3-pip python3-venv

- On Linux you may need to install pip
- On Windows you may need to install
Microsoft Visual C++ Redistributable for Visual Studio 2015, 2017, and 2019
- Open a terminal / command prompt. On Windows, search cmd in the start

Top issues

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON