KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #codex #claude-code #mcp #rust #deepseek-harness #typescript #ai-agent #cli

ofxAudioAnalyzer

★ 192 Open GitHub ↗

openFrameworks wrapper for Essentia. Audio analysis algorithms in real-time

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# ofxAudioAnalyzer

## Description

[openFrameworks](http://openframeworks.cc/) addon for audio analysis. It provides the following algorithms :
* RMS, Instant power, Energy, Pitch frequency, Pitch Confidence, Pitch Salience, HFC, Centroid, Inharmonicity, Spectral Complexity, Dissonance, Roll Off, Odd To Even Harmonic Energy Ratio, Strong Peak, Strong Decay,  Onsets, Spectrum, Mel Bands, MFCC, Harmonic Pitch Class Profile, Tristimulus

See [AlgorithmsReference.md](AlgorithmsReference.md)

This addon uses [Essentia](http://essentia.upf.edu/) library.

Demo video: https://vimeo.com/129795472

## Compatibility

OSX & Linux - OF 0.10.0

Tested with OSX 10.11.6 and Ubuntu 14.04

## Compilation

* Linux: Makefiles.

* OSX: The best and easiest way is to use Xcode Projects. You can also use the makefiles, but in OSX you'll need to add ofxAudioDecoder to addons.make.

## Dependencies

For playing and analyzing audio files (see [Audio File Player](#audio-file-player)), *ofxAudioDecoder* addon is needed for OSX.

## Usage

* The examples included in the repository can be used to build new projects specially the empty ones. They can be compiled with Xcode or by Terminal using the Makefiles.

* Creating a new project:

- Create a new project using the Project Generator. Be sure to include **ofxAudioAnalyzer** and **ofxAudioDecoder** addons.

- Include ofxAudioAnalyzer header into ofApp.h
  ```cpp
    #include "ofxAudioAnalyzer.h"
  ```
  - Create an instance of ofxAudioAnalyzer into ofApp class:
  ```cpp
  ofxAudioAnalyzer audioAnalyzer;
  ```
  - In the **setup()** function setup the audioAnalyzer's parameters (sampleRate, bufferSize, channels). Be sure that the parameters of the audioAnalyzer **match the parameters** of the ofSoundStream or the audio files you load to the sound player to avoid errors:
  ```cpp
  audioAnalyzer.setup(44100, 512, 2);
  ```
  - Analyze the ofSoundBuffer in ofApp::audioIn() and ofApp::audioOut() when using ofSoundStream, or in the ofApp::update() if you are using audio file player, ofSoundBuffer **parameters must always match** audioAnalyzer's:
  ```cpp
  audioAnalyzer.analyze(soundBuffer);
  ```

- Retrieve analysis results specifying algorithm, channel, smooth amount and if you want it normalized (Smoothing and normalizing are optionals. Normalizing is not necessary for all algorithms, some of them output values from 0.0-1.0 by default. See *allAlgorithms* example):
  ```cpp
  float rms = audioAnalyzer.getValue(RMS, channel, smoothAmount, doNormalize);
  ```

## Audio File player

This repository includes an extended version of ofBaseSoundPlayer taken and modified from: https://github.com/YCAMInterlab/ofxTimeline/tree/master/libs/ofOpenALSoundPlayer_TimelineAdditions/src.

This class [ofSoundPlayerExtended] lets you load, play and *analyze* audiofiles (wav & mp3). See examples: *allAlgorithms*, *audioFilePlayer* and *onsets* to understand how it works.

- In OSX, ofSoundPlayerExtended uses [ofxAudioDecoder](https://github.com/kylemcdonald/ofxAudioDecoder).  This fork was used for testing the examples https://github.com/leozimmerman/ofxAudioDecoder .

- Linux: ofxAudioDecoder, is not compatible with Linux. For replacing it you need to use mpg123 lib. See this forum's thread to know how to make sure OF uses it: https://forum.openframeworks.cc/t/error-running-soundplayerexample-on-the-pi/13197/6?u=lzmmrman

**(!)** ofSoundPlayerExtended is not really necessary for the addon to work. If you don't need or it's giving to much errors, just remove it from Xcode project or the addon's /src directory.

## Issues
For any bug, help or feature request [open an  issue](https://github.com/leozimmerman/ofxAudioAnalyzer/issues)
or check this [OF Forum Thread](https://forum.openframeworks.cc/t/ofxaudioanalyzer-update/24712).

## License
Essentia library and this addon are distributed under  Affero GPLv3 license. See [License](LICENSE)

ofxAudioAnalyzer

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README