ref: 85272b47266eee888a03b81229d5237afb623a39
parent: dfe4c6fb70a1bf75a519a58afdf4461acbf1b810
author: cancel <cancel@cancel.fm>
date: Sun Jan 12 10:28:34 EST 2020
Update readme for new PortMidi device selection menu
--- a/README.md
+++ b/README.md
@@ -16,11 +16,33 @@
sudo apt-get install git libncurses5-dev libncursesw5-dev libportmidi-dev
git clone https://github.com/hundredrabbits/Orca-c.git
cd Orca-c
-make # Compile orca
-build/orca --portmidi-list-devices # Select MIDI device
-build/orca --portmidi-output-device 2 # Start livecoding
+make # Compile orca
+build/orca # Run orca
```
+To choose your MIDI output device, press F1 (or `Ctrl+D`) to open the main menu, and then select `MIDI Output...`
+
+```
+┌ ORCA ──────────────┐┌ PortMidi Device Selection ─────┐
+│ New ││ > [*] #0 - Midi Through Port-0 │
+│ Open... ││ [ ] #2 - ES1371 │
+│ Save │└────────────────────────────────┘
+│ Save As... │
+│ │
+│ Set BPM... │
+│ Set Grid Size... │
+│ Auto-fit Grid │
+│ │
+│ > MIDI Output... │
+│ │
+│ Controls... │
+│ Operators... │
+│ About... │
+│ │
+│ Quit │
+└────────────────────┘
+```
+
## Prerequisites
Core library: A C99 compiler (no VLAs required), plus enough libc for `malloc`, `realloc`, `free`, `memcpy`, `memset`, and `memmove`. (Also, `#pragma once` must be supported.)
@@ -132,10 +154,7 @@
```sh
$ ./tool build --portmidi orca # compile orca using build script
-$ build/orca --portmidi-list-devices # query for midi devices
-ID: 3 Name: IAC Driver Bus
-ID: 4 Name: USB MIDI Device
-$ build/orca --portmidi-output-device 3 # run orca with midi device 3
+$ build/orca # run orca
```
### `orca` Livecoding Environment Controls