Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


A software oscilloscope attempting to mimic the aesthetic of old school ray oscilloscopes.

How to use

After starting the oscilloscope a welcome message is already loaded, press ▶︎ play to make sure your audio setup works. If it doesn't, open settings and try to choose another output device.

To open files you can either click the folder icon, or drag a file from Explorer/Finder/Nautilus/... to the application.

Key Action
Space Play/Pause
f Fullscreen
Tab Hide interface
e Export to image sequence

For more information

Programmer Documentation

Project setup

Things are moving around a bit sometimes. Make sure to read these instructions before each build.

  1. Download and unzip Openframeworks 0.10.1
  2. Open the folder apps/myApps/ (in the OpenFrameworks folder)
  3. Clone the repository with submodules: git clone --recursive
  4. Download the binary release for ofxAvCodec from
  5. Replace the addons/ofxAvCodec/libs with the libs folder from the download

Compiling with XCode (OSX11.5+)

  1. Add the --deep value to the Other Code Signing Flags key in the Build Settings tab
  2. Open apps/myApps/oscilloscope/Oscilloscope.xcodeproject and then Build&Run
  3. (Optional) Sign&Notarize with apple: Copy scripts/ to, then run scripts/ osx 1.1.0

You can also build with make && make run on the command line. The resulting build will have no icon/no proper name/no retina support.

Compiling with Visual studio 2017

The shell commands can be run from a git bash, cygwin, msys, or any other shell emulator.

  1. run scripts/
  2. run scripts/ win64
  3. Open oscilloscope.sln and Build&Run

Compiling with make in Linux

This is a full install including OF (thx rrolison68!)

wget -c
tar -zxvf of_v0.10.1_linux64gcc6_release.tar.gz
mv of_v0.10.1_linux64gcc6_release OF
cd OF/scripts/linux/ubuntu
sudo ./
cd OF/apps/myApps
git clone --recursive
cd Oscilloscope
cp -R addons/ofxMightyUI/bin/data/* bin/data/
cp -R addons/ofxFontAwesome/bin/data/* bin/data/
make -j2

See scripts/ for the full distribution process.

Package the software

  • for osx run scripts/ $platform $version
  • platform is one of osx linux linux64 win64
  • version is whatever version you want, e.g. 1.0.6


License/Source code

  • Openframeworks. A creative coding library. The larger part of it is licensed as MIT/BSD.
  • FFmpeg and ofxAvCodec. FFmpeg is the encoder/decoder library and licensed under the gpl/lgpl 2.1. The binaries included here were compiled to comply with the lgpl. A copy of the LGPL together with instructions how the library was compiled for each platform can be found in the legal folder.
  • The sourcecode for this application is freely available on github.
You can’t perform that action at this time.