Oscilloscope

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.

For more information

• either visit the user page at oscilloscopemusic.com/osci.php
• download the latest version

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 https://github.com/kritzikratzi/Oscilloscope.git
4. Download the binary release for ofxAvCodec from https://github.com/kritzikratzi/ofxAvCodec/releases/tag/0.2
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/osx-config-template.sh to osx-config.sh, then run scripts/dist.sh 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/clean.sh
2. run scripts/prepare.sh win64
3. Open oscilloscope.sln and Build&Run

Compiling with make in Linux

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

cd
wget -c https://openframeworks.cc/versions/v0.10.1/of_v0.10.1_linux64gcc6_release.tar.gz
tar -zxvf of_v0.10.1_linux64gcc6_release.tar.gz
mv of_v0.10.1_linux64gcc6_release OF
cd OF/scripts/linux/ubuntu
sudo ./install_dependencies.sh
cd
cd OF/apps/myApps
git clone --recursive https://github.com/kritzikratzi/Oscilloscope.git
cd Oscilloscope
scripts/clean.sh
cp -R addons/ofxMightyUI/bin/data/* bin/data/
cp -R addons/ofxFontAwesome/bin/data/* bin/data/
make -j2
bin/Oscilloscope

See scripts/readme.md for the full distribution process.

Package the software

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

Contributors

• https://github.com/subwolf/ Linux support
• https://github.com/s-ol/ Linux support

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.