Skip to content

Gdalik/EarQuiz_Frequencies

Repository files navigation

EarQuiz Frequencies Logo

License: GPL v3 Documentation Supported Platforms

EarQuiz Frequencies is a software for technical ear training on equalization. Its main goal is to help musicians and all kinds of audio professionals or students (producers, recording/mixing/mastering/live sound engineers, audio designers, etc.) develop and master the ability to aurally recognize frequency bands. In general, anybody who wants to teach himself/herself how to adjust an audio system with equalizer by ear consciously may find it useful.

This application is based on the world-renowned Golden Ears method of David Moulton, whose course is half dedicated to building this essential critical listening skill. Built-in presets are similar to his easy-to-difficult patterns, but a user can also change the settings to do more than what is already available. This software may be used by educators in the audio industry to produce superb quality training and test materials for their students.

Features

  • Internal pink noise generator or any external audio file in WAV, AIFF, FLAC, MP3, or OGG format as audio source.
  • 15 built-in presets with increasing difficulty.
  • 1-octave (10-band) and 1/3-octave (30-band) EQ.
  • Exercise patterns with boost and/or cut frequencies.
  • Single-band and Dual-band exercise patterns.
  • Custom adjustable frequency gain level from ±1 to ±18 dB.
  • Custom adjustable filter bandwidth/Q-factor.
  • Auto peak-normalization, preventing digital clipping during equalization.
  • Easy non-destructive trimming of external audio files.
  • Adjustable example/slice length from 10 up to 30 seconds.
  • Adjustable audio processing parameters of training examples (EQ On/Off time proportion, EQ On↔︎Off transition time, example fade in/out duration).
  • Auto-saving trimmed ranges and example/slice lengths for different audio sources.
  • Exporting learning and test audio file packages in WAV, AIFF, FLAC, MP3, or OGG format.
  • Audio format converter.
  • Reading M3U, M3U8, PLS, XSPF playlists supported.
  • Exporting M3U and M3U8 playlists supported.
  • Convenient and flexible playlist navigation.
  • Dark Mode support (on macOS, Linux, and Windows 11).
  • And other features (see EarQuiz Frequencies Help)...

Installation

To use the application out of the box, you can just download the distribution package for your OS (Windows, macOS or Linux), run it and follow the installation process.

You can also clone (download) this repository and launch the program from Python. It has been tested with Python 3.9, 3.10, 3.11 and 3.12. So, make sure the proper version of interpreter is installed on your computer.

The repository doesn't contain any pre-compiled dependencies, so they should be installed before the application execution. Though it is technically possible to use the "base" Python environment, creating a separate virtual environment for the project and all its packages is highly recommended. Then, once you have activated the project's virtual environment, installing all the requirements using the package manager is as simple as:

pip install -r requirements.txt

After that, you can start the application with:

python -m main

Building from Source

You can build executables yourself for Windows, macOS or Linux from this codebase.

  1. Use the platform you are going to build on. E.g., you cannot make an executable package for Windows under macOS, and creating a macOS bundle under Windows is not possible as well.
  2. Make sure, the relevant version of Python is installed, a virtual environment for the project is created, all the requirements are installed, and you can run the application from the source code, using the interpreter.
  3. With the activated virtual environment, install PyInstaller using the package manager:

    pip install -U pyinstaller

  4. On macOS (Intel), run:

    pyinstaller macos_build.spec

    On macOS (Apple Silicon), run:

    pyinstaller macos_build-arm64.spec

    On Windows, run:

    pyinstaller windows_build.spec

    On Linux, run:

    pyinstaller linux_build.spec

The bundled application should now be available in the dist folder.

License

EarQuiz Frequencies is Copyright © 2023-2024 by Gdaliy Garmiza.
EarQuiz Frequencies is licensed under the GNU General Public License v3.

This application uses the following open source libraries:

Privacy Policy

This program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it.

Code Signing Policy

For Windows binaries, starting from version 0.1.5, this application uses free code signing provided by SignPath.io, and a certificate by the SignPath Foundation.