diff options
Diffstat (limited to 'resources/TUTORIAL.md')
| -rw-r--r-- | resources/TUTORIAL.md | 148 |
1 files changed, 148 insertions, 0 deletions
diff --git a/resources/TUTORIAL.md b/resources/TUTORIAL.md new file mode 100644 index 0000000..e4d60d5 --- /dev/null +++ b/resources/TUTORIAL.md @@ -0,0 +1,148 @@ +# Tutorial + +If this is your first time trying out **Orca**, watch this [introduction video](https://www.youtube.com/watch?v=RaI_TuISSJE). If you want to learn how to use a handful of basic operators, have a look at the [workshop](WORKSHOP.md). + +## General + +- On **OSX**, setup [IAC virtual MIDI buses](https://help.ableton.com/hc/en-us/articles/209774225-Using-virtual-MIDI-buses). +- On **Windows**, setup [loopMidi](http://www.tobias-erichsen.de/software/loopmidi.html). +- On **Linux**, setup [qjacktl](https://qjackctl.sourceforge.io/). + +## Pilot + +[Pilot](https://github.com/hundredrabbits/Pilot) is a minimalist synth software designed to work via UDP, and to quickly get started with Orca. This **requires no setup**, as long as both applications are open, they should be able to communicate with each other. + +- Launch Orca & Pilot. +- In Orca, make sure that UDP is pointing to port `49161`. +- Bang something like `;03Cff` to [play a note](https://github.com/hundredrabbits/pilot#play). +- Bang something like `;revff` to [add reverb](https://github.com/hundredrabbits/pilot#effects). + +## Ableton Live + +To send [Midi notes](https://github.com/hundredrabbits/Orca#midi) to [Ableton Live](https://www.ableton.com/en/) instruments, bang the Midi operator `:`, like `:03C` to send to _Channel 1, Octave 3, Note C_. Have a look at [midi.orca](https://github.com/hundredrabbits/Orca/blob/master/examples/_midi.orca) to see it in action. + +- Launch Ableton Live. +- Create a new **midi instrument** track. +- Select `IAC Driver(Bus 1)`(OSX), or `LoopMidi`(Windows), in the instrument's inputs dropdown. +- Activate the **In** toggle, on the instrument track. + +## SonicPi + +To send [OSC messages](https://github.com/hundredrabbits/Orca#osc) to [SonicPi](http://sonic-pi.net), select [port 4559](https://github.com/hundredrabbits/Orca#osc). SonicPi listens to the address defined in `sync`, to send to the `live_loop`, bang the OSC node `=`, like `=a`. Have a look at [sonicpi.orca](https://github.com/hundredrabbits/Orca/blob/master/examples/software/sonicpi.orca) to see it in action. If you need help, visit the [SonicPi x Orca forum](https://in-thread.sonic-pi.net/t/using-orca-to-control-sonic-pi-with-osc/2381/). + +``` +live_loop :drum do + use_real_time + sync "/osc/a" + sample :bd_haus, rate: 1 +end +``` + +## Bitwig [Linux and JACK] + +The following is taken from this page: https://answers.bitwig.com/questions/1218/how-do-i-get-midi-inout-of-bws-on-linux + +- Quit Bitwig if running. +- Start `qjacktl`. +- Go to _Setup > Settings > Parameters_ and set MIDI Driver to "none" (this turns off jack-midi) +- Go to Setup > Misc and check "Enable ALSA Sequencer Support" (if not enabled) +- Stop Jack if running and quit gjackctl +- Run sudo modprobe snd_virmidi midi_devs=1 (to enable virtual midi with one device which is easier to understand for now) +- Start qjacktl +- Start jack +- Open Connections: Connect device on left "0: QuNexus MIDI 1" (as an example) to "0:VirMIDI 5-0" +- Open Bitwig +- Under Options > Preferences > Controllers click "Add controller manually" +- Choose "Generic MIDI Keyboard" +- Once it appears as an input choose "Virtual Raw MIDI/1" + +## VCV Rack + +- Start VCV Rack +- Add a "VCV MIDI-CV" module to your rack +- Set the first parameter, MIDI Driver, to your local loopback driver + - Windows: Start loopMIDI, be sure to create at least one device, then select "loopMIDI" as the parameter + - Linux: Use "ALSA" (the widely supported Linux sound architecture) +- Set the second parameter to the MIDI interface + - Windows: Use the loopMIDI device you created + - Linux: Select the default "MIDI Through" device (available by default on most ALSA configurations) +- Start Orca +- Use the Hotkey Ctrl+Period to cycle through MIDI output devices until you see your device in the lower-right corner +- Bang a MIDI command to VCV: `:03c88` to get a note and gate trigger from MIDI-CV + +## Dotgrid + +To send [UDP messages](https://github.com/hundredrabbits/Orca#udp) to [Dotgrid](http://github.com/hundredrabbits/Dotgrid), select [port 49160](https://github.com/hundredrabbits/Orca#udp). To draw lines on Dotgrid, you need to bang the UDP node `;` with different [commands](https://github.com/hundredrabbits/Dotgrid/blob/master/desktop/sources/scripts/listener.js). Have a look at [dotgrid.orca](https://github.com/hundredrabbits/Orca/blob/master/examples/software/dotgrid.orca) to see it in action. + +- `;0`, clear layer **#1**. +- `;0l1234`, add a line from `1,2` to `3,4`. +- `;`, redraw. + +Here's a list of supported operations. + +``` +;0 // Clear Layer 1 +;0l1234 // Add Line from 1,2 to 3,4 +;0c1234 // Add Clockwise Arc from 1,2 to 3,4 +;0r1234 // Add Reverse Arc from 1,2 to 3,4 +; // Redraw +``` + +## FAQS + +### Why does placement of `V` matter? + +Orca operates linearly from the top-left, to the bottom-right, operators are executed in that sequence, and so the variables stored at the top, can be overwritten by the variables declared at the bottom. + +### Why is orca not making any sound? + +Orca is not a synthetizer, it is meant to control audio & visual software, or hardware. Orca will never include domain specific operators to generate music or to create pictures. It is designed to be as generic as possible. + +## Golf + +### Modulo + +Will output the modulo of `6 % 4`. + +``` +1X. +6I4 +``` + +### Uppercase + +Will output uppercase `C`. + +``` +cA1. +.dAZ +``` + +### Lowercase + +Will output lowercase `C`. + +``` +H.. +CM1 +``` + +### Substract + +Will substract `8 - 3`. + +``` +.3Mz +8Ax. +``` + +### Not Null + +Will bang if not null. + +``` +cYc +J.J +cFc +``` + |