base on Automatic headphone equalization from frequency responses # AutoEq AutoEq is a tool for automatically equalizing headphones. Go to **[autoeq.app](https://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](https://pypi.org/project/autoeq/) for installing the library on your projects * Collection of headphone [measurements](./measurements) as numerical data from [oratory1990](https://www.reddit.com/r/oratory1990/wiki/index/list_of_presets/), [crinacle](https://crinacle.com), [Innerfidelity](https://www.stereophile.com/content/innerfidelity-headphone-measurements), [Rtings](https://www.rtings.com/headphones/1-5/graph) and legacy headphone.com measurements (which are not the same as what the company produces today). * Collection of different headphone frequency response [targets](./targets) as numerical data * Pre-computed equalizer settings in [results](./results), although these should not be used by normal users since **[autoeq.app](https://autoeq.app)** exists  *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](./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](https://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](https://www.python.org/getit/)**. Make sure to check *Add Python 3.X to PATH*. - You may need to install [libsndfile](http://www.mega-nerd.com/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](https://pip.pypa.io/en/stable/installing/) - On Windows you may need to install [Microsoft Visual C++ Redistributable for Visual Studio 2015, 2017, and 2019](https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads) - Open a terminal / command prompt. On Windows, search `cmd` in the start menu. - Clone AutoEq ```shell git clone https://github.com/jaakkopasanen/AutoEq.git ``` - Go to AutoEq location ```shell cd AutoEq ``` - Create a python virtual environment ```shell python -m venv venv ``` - Activate virtualenv ```shell # On Windows venv\Scripts\activate.bat # On Linux and Mac . venv/bin/activate ``` - Update pip ```shell python -m pip install -U pip ``` - Install required packages ```shell python -m pip install -U -e . ``` - Verify installation. If everything went well, you'll see the list of command line parameters AutoEq accepts. ```shell python -m autoeq --help ``` ```shell python -m autoeq --input-file="measurements/oratory1990/data/over-ear/Sennheiser HD 800.csv" --output-dir="my_results" --target="targets/harman_over-ear_2018_wo_bass.csv" --max-gain=24 --parametric-eq --parametric-eq-config=4_PEAKING_WITH_LOW_SHELF,4_PEAKING_WITH_HIGH_SHELF --bass-boost=6 --convolution-eq --fs=48000 --bit-depth=32 --f-res=16 ``` When coming back at a later time you'll only need to activate virtual environment again ```shell # On Windows cd AutoEq venv\Scripts\activate.bat # On Linux and Mac cd AutoEq . venv/bin/activate ``` To learn more about virtual environments, read [Python' venv documentation](https://docs.python.org/3.9/library/venv.html). #### Updating AutoEq is in active development and gets new measurements, results and features all the time. You can get the latest version from git ```shell git pull ``` Dependencies may change from time to time, you can update to the latest with ```shell python -m pip install -U -e . ``` #### Checking Installation This prints out CLI parameters if installation was successful. ```shell python -m autoeq --help ``` ### Example Equalizing Sennheiser HD 650 and saving results to `my_results/`: ```shell python -m autoeq --input-file="measurements/oratory1990/data/over-ear/Sennheiser HD 650.csv" --output-dir="my_results" --target="targets/harman_over-ear_2018.csv" --convolution-eq --parametric-eq --ten-band-eq --fs=44100,48000 ``` ### Building Add changelog entry before building and update version number in pyproject.toml! Install `build` and `twine` ```shell python -m pip install build twine ``` Add updates to `autoeq/README.md` before building! Build PyPi package on Windows ```shell copy /y README.md README.md.bak && copy /y autoeq\README.md README.md && python -m build && copy /y README.md.bak README.md && del README.md.bak ``` Build PyPi package on Linux / MacOS ```shell cp README.md README.md.bak && cp autoeq/README.md README.md && python -m build && cp README.md.bak README.md && rm README.md.bak ``` publish ```shell python -m twine upload dist/autoeq-<VERSION>* ``` Remember to add Git tag! ## Contact [Issues](https://github.com/jaakkopasanen/AutoEq/issues) are the way to go if you are experiencing problems or have ideas or feature requests. Issues are not the correct channel for headphone requests because this project sources the measurements from other databases and a headphone missing from AutoEq means it has not been measured by any of the supported sources. You can find me in [Reddit](https://www.reddit.com/user/jaakkopasanen), [Audio Science Review](https://www.audiosciencereview.com/forum/index.php?members/jaakkopasanen.17838/) and [Head-fi](https://www.head-fi.org/members/jaakkopasanen.491235/) if you just want to say hello. ", Assign "at most 3 tags" to the expected json: {"id":"13679","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"