PMT (Personal Music Tutor)

Digital Sound Processing Utilities built with PortAudio, Aubio and Qt. The GUI is currently under development.

Features

• Pitch detection: play sounds close to your input source and get information about their frequency and distance from the closest note. For example, if you play the 440Hz Frequency, your output should look like:

Key considerations

• The project uses Docker to simplify the development/build experience.
• It currently supports Linux & Mac (>=Mojave). Has been tested on Ubuntu 18.04 VM and macOS Big Sur workstation.

The current version of pitch detection has not been optimized for different environments/input contexts. Thus, for best results it is advised to use the app in noise-free environments with the sound producing mediums close to the input sources.

Requirements/Dependencies of the host OS

• A microphone
• Docker, currently it should be installed manually! Instructions to install for Ubuntu, Mac. In Linux, you should additionally add your user in the Docker group so that you don't run it as root (Instructions).
• Brew (Mac only). If it's missing, you will be asked to provide admin credentials for its installation in the next steps.

To build the app image and fire up a container with an interactive terminal

• git clone https://github.com/fllprbt/pmt pmt && cd pmt
• bash scripts/run.sh

If everything goes well, you will be connected to the container's terminal.

To run the app

qmake src/pmt.pro && make && ./pmt

Notes to developers

A volume of the codebase is mounted inside the container. Thus, you can edit the project locally and then execute the run commands to recompile and execute your code.