OSCILLA Session Layer

No SVG Authoring Required — Works with Any Score

Top Bar (Left to Right)

Element	Description
Timer 00:00	Performance time — click for fullscreen timer
Mute	Toggle audio mute
OSC addr	OSC output address field
Pen	Text/audio annotation editor
Audio	Audio object editor
Text	Text cue editor
Marker down	Drop marker at playhead
Marker up	Toggle marker visibility
Network	Pointer sharing
Console	Live console
scroll/page	View mode toggle
Parts	Instrumental part selector
Menu	Settings, import/export

Bottom Bar — Transport

Element	Key	Element	Key
Rewind	Home	Next marker	up
Prev marker	down	Skip to end	End
Play/Pause	Space	Speed -/+	+/-
Marker popup	—	Rehearsal marks	—
New annotation	—	Toggle annotations	—

Markers

Drop:      down button or M key
Jump:      up/down arrows
Edit:      Click marker label
Move:      Drag horizontally

Pause Markers — Enable "Pause on crossing" in editor with duration + optional countdown.

Audio Objects

Click Audio button, then click score to place.

Types:

Type	Description
Audio	Single file playback
Pool	Random/sequential from directory
Impulse	Continuous stochastic process
Synth	Web Audio oscillator + effects

Controls:

• Gain, Pan, Pitch, Fade In/Out, Loop
• Pool/Impulse: Polyphony, Pan Random, Pitch Random
• Impulse: Rate (events/sec), Jitter

Playback:

• Single click: Play / Pause / Resume
• Double click: Stop
• Drag cursor while paused to scrub

Display modes: Waveform, Handle, Hidden

Playhead trigger: Enable in editor — auto-plays when playhead enters region.

Recording

In Audio Object editor, click Record:

1. Browser requests microphone access
2. Click to start/stop recording
3. Recording saved to project audio folder
4. Assign directly to audio object

Drawing Mode

D          Enter/exit draw mode
V          Select mode (move groups)
E          Eraser mode
S          Toggle local/shared
Delete     Delete selected
Ctrl+Z     Undo stroke
Escape     Exit drawing

Fullscreen Timer

Click stopwatch to enter fullscreen view.

• Mini timer: click to swap displays
• Selection: choose sequence/cue
• Red ring: open sequence editor
• View button cycles: solid, blur, transparent

Countdown Sequences

Sequence: "Performance"    Loop: 1
- Intro       120s   onComplete: ...
- Development 180s   onComplete: ...
- Climax       90s
Then: chain to next sequence

onComplete accepts any cue expression (see Cue Cheatsheet).

Annotations

Click Pen, then click score to place.

• Text: notes, instructions
• Trigger: cue expression, fires on click
• Scope: local or shared

Parts

Click Parts button, select instrument. Your part highlights, others dim. Define in SVG with part:name.

Keyboard Reference

Key	Action	Key	Action
Space	Play/Pause	M	Drop marker
up	Next marker	D	Draw mode
down	Prev marker	V	Select mode
Home	Rewind	E	Eraser
End	Jump to end	Esc	Exit mode
+	Speed up	Ctrl+Z	Undo
-	Speed down	S	Toggle share

Session Workflow

1. Load any image/graphic as score
2. Drop markers at key positions
3. Place audio objects on score
4. Build countdown sequence
5. Draw/annotate during rehearsal

Links

Docs: https://oscilla.kompot.si
Repo: https://git.kompot.si/rob/oscilla