pharpend / Oscilloscope

Oscilloscope for Mac/Windows written in OF.

Oscilloscope

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

Not a programmer?

This is the programming documentation. If you are not a programmer please

• either visit the user page at asdfg.me/osci/
• or click on the releases tab and download the latest version for your platform

Project setup

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

1. Download and unzip Openframeworks 0.10.1
2. Open the folder apps/myApps/
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.1
5. Replace the addons/ofxAvCodec/libs with the libs folder from the download

Compiling with XCode (OSX10.10+)

1. (optional) run scripts/clean.sh
2. (optional) run scripts/prepare.sh osx
3. Open apps/myApps/oscilloscope/Oscilloscope.xcodeproject and then Build&Run
4. (Optional) Code sign by running scripts/sign-mac.sh bin/Oscilloscope.app "Developer ID Application: Name of your certificate" (run security find-identity -v -p codesigning to get a list of installed certs)

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

1. run scripts/clean.sh
2. run scripts/prepare.sh linux64
3. run make && make run

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.