OSCILLA Rehearsal Tools

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
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	—
Lock	—	Audio master	—

From a score or the live console: play() stop() rewind() seek(30) seek(-10) seek(50%) speed(1.5) — none of them toggles.

Lock Options (click lock icon):

• Lock Transport: Disables score dragging/scrubbing, allows other UI
• Lock Screen: Full pocket-mode overlay, blocks all interaction

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.

Sounds

Sounds are DSL cues in the score — audio(), audioPool(), audioImpulse(), synth() — made and edited in the DSL inspector (Create, or Record into score). Session audio objects are retired; scripts/migrate-audio-objects.mjs moves old ones into the score.

Playback:

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

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
]	Zoom in	[	Zoom out
\	Zoom to fit	Shift+wheel	Pan a zoomed score

Session Workflow

1. Load any image/graphic as score
2. Drop markers at key positions
3. Add sounds to the score (DSL inspector)
4. Build countdown sequence
5. Draw/annotate during rehearsal

Links

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