Open-source synthesizer for making music by drawing objects, text, and images on an oscilloscope using audio. Allows for 3D rendering of `.obj` files, `.svg` images, `.txt` files, and Blender scenes on Windows and macOS.
Everything is controllable from a Digital Audio Workstation (DAW), allowing for parameter automation and MIDI control. If you prefer to use osci-render as a standalone application, you can do that too!
Osci-render is a fully programmable synthesiser, allowing for custom visuals, sounds, and audio effects to be scripted using Lua, and interacted with using your DAW.
<ahref="https://www.youtube.com/watch?v=qQIYtuoDx3w"><imgsrc="https://img.youtube.com/vi/qQIYtuoDx3w/0.jpg"alt="Announcing osci-render 2.0 - an audio plugin for oscilloscope music"></a>
<ahref="https://www.youtube.com/watch?v=qQIYtuoDx3w"><p>Announcing osci-render 2.0 - an audio plugin for oscilloscope music</p></a>
Pay what you want from the official website: [osci-render.com](https://osci-render.com) to get access to the latest version.
After you've purchased, you'll be sent an email with a download link. Here you can download the latest version for Windows or macOS, as a standalone application or as a VST or AU plugin.
## Installation
### Standalone Application
Run the `osci-render.exe` file on Windows, or the `osci-render.app` file on macOS. You may need to allow the application to run if you get a warning.
Details on how to bypass security warnings or 'app is damaged' warnings on macOS can be found [here](https://support.apple.com/en-us/HT202491).
### VST Plugin
Copy the `osci-render.vst3` file to your VST plugins folder, and restart your DAW. This is usually located at: `C:\Program Files\Common Files\VST3` on Windows, or `/Library/Audio/Plug-Ins/VST3` on macOS.
### AudioUnit (AU) Plugin
Copy the `osci-render.component` file to your AU plugins folder, and restart your DAW. This is usually located at: `/Library/Audio/Plug-Ins/Components` on macOS.
## Getting Started
Run the application, or add the plugin to your DAW. You should see the below interface, and hear a sine wave playing, and a circle being drawn on the software oscilloscope.
Now you can start opening `.obj` files, `.svg` files, or `.txt` files using the Choose File button, or creating your own files from a set of examples by specifying the file type, and using the Create File button.
To start editing the file you've opened, click the arrow button on the very right of the interface to open the code editor:
Here you can edit the file, and see the changes in real-time. You can also edit the code while the file is playing, and the changes will be applied immediately.
Now, you can start applying audio effects to the image by enabling the effects you want to use in the Audio Effects section of the interface. You can rearrange the order of the effects by dragging them up and down, and animate the parameters using the drop-down menus next to each effect.
You can change the allowed range of each effect by right-clicking on the effect name, and changing the minimum and maximum values. This will change the range the parameter is animated over, and the range of the parameter when being controlled from a DAW.
### Rendering a Blender scene
This [video](https://www.youtube.com/watch?v=pCn297Ejvlw) explains how to install and use osci-render with Blender. Please note that the video is made for osci-render 1.0, so the interface will look slightly different, but the process is the same.
- Download the Blender add-on from [Releases](https://github.com/jameshball/osci-render/releases) named `osci-render-blender-addon.zip`
- [Install and enable the add-on](https://docs.blender.org/manual/en/latest/editors/preferences/addons.html#installing-add-ons) in Blender
- 'osci-render settings' menu will now appear under 'Render Properties'
- Open osci-render
- Click 'Connect to osci-render'
- If the filename in osci-render changes to 'Rendering from Blender' you have successfully connected
- Add a camera to the scene (if not already present)
- Add a Scene Line Art object to the scene
- Press Shift+A and navigate to Grease Pencil > Scene Line Art
- Go to 'Modifier Properties' of the newly created Line Art object
- Click 'Bake Line Art' under the the 'Bake' settings to generate line art for the current animation/scene/camera
- You should now see the scene on the oscilloscope!
### MIDI
To enable MIDI control, open the MIDI settings at the bottom of the interface, and click 'Enable MIDI'.
Make sure your MIDI device is enabled by clicking Audio > Settings from the top menu, and enabling your MIDI device under Active MIDI inputs:
