https://github.com/TomSchimansky/GuitarTuner

Guitar tuner program made with Python, Tkinter and PyAudio.
https://github.com/TomSchimansky/GuitarTuner

audio-analysis chromatic-tuner dark-mode gui-application guitar guitar-tuner macos macos-app music numpy py2app pyaudio python python3 tkinter tkinter-gui tkinter-python tuner ui-design

Last synced: 2 months ago
JSON representation

Guitar tuner program made with Python, Tkinter and PyAudio.

• Host: GitHub
• URL: https://github.com/TomSchimansky/GuitarTuner
• Owner: TomSchimansky
• License: gpl-2.0
• Created: 2020-06-04T22:26:15.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2024-02-20T15:21:31.000Z (11 months ago)
• Last Synced: 2024-11-07T18:54:46.515Z (3 months ago)
• Topics: audio-analysis, chromatic-tuner, dark-mode, gui-application, guitar, guitar-tuner, macos, macos-app, music, numpy, py2app, pyaudio, python, python3, tkinter, tkinter-gui, tkinter-python, tuner, ui-design
• Language: Python
• Homepage:
• Size: 45.9 MB
• Stars: 157
• Watchers: 3
• Forks: 48
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
![GitHub release (latest by date)](https://img.shields.io/github/v/release/TomSchimansky/GuitarTuner)

![GitHub all releases](https://img.shields.io/github/downloads/TomSchimansky/GuitarTuner/total?color=green&label=macOS%20release%20downloads)

![GitHub Release Date](https://img.shields.io/github/release-date/TomSchimansky/GuitarTuner?color=green)

# GuitarTuner App

![](documentation/readme_images/Preview_Dark.png)

This is a simple **chromatic tuner** designed for guitar tuning, but it should also work with every other instrument.

The played note is automatically recognized through the microphone, and an acoustic signal is

heard when the tuning is correct. If you want you can also change the reference-tone to another

frequency. At the moment, a compiled version is only available for macOS, but you can use it on

Windows too if you run it in the command line.

* Automatic tone detection

* High accuracy: < 0.5 cents (around the A4 area)

* Working from 60 to 2000 Hz (C2 to C7)

* High stability of the pitch indicator

* Support for macOS light and dark-mode

### **➜️ Download macOS app (Intel only):** [Download here](https://github.com/TomSchimansky/GuitarTuner/releases/tag/3.2)

![](documentation/readme_images/Icon_Banner.png)

### Functionality

The app is written in Python with Tkinter, PyAudio and numpy. It uses PyAudio to get access to the raw audio-stream coming from the microphone.

Then a **fast-fourier-transformation** (```numpy.fft```) is applied on the audio-data, which is buffered for about 1.5 seconds.

Then a HPS (Harmonic Product Spectrum) operation is applied to filter the harmonic frequencies.

From the HPS output, you can get the loudest frequency and convert it to a musical note by applying the following

formula: ```12 * numpy.log2(f / a4_frequency) + 69```.

### Run GuitarTuner with python

First you need to install all necessary libraries:

```

pip3 install -r requirements.txt

```

Then you can do:

```

python3 main.py

```

### Create standalone application

You can also create a standalone application for macOS or Windows by yourself. For macOS you can use py2app:

```

python3.8 setup.py py2app

```

For windows, you would need to use py2exe instead and modify the setup.py file.

To keep application size as small as possible, make sure you create a virtual environment where you install

only the necessary libraries. The macOS dark-mode currently **only** works with the **anaconda python** Version.

If you compile the app with a python.org version, you have to disable the dark-mode by deleting

the ```'NSRequiresAquaSystemAppearance': False```entry in setup.py, which causes the application window to go

into dark-mode.

![](documentation/readme_images/Preview_Light.png)