🌐 Web UI
Creating a Preset
- Navigate to the slot you want to create a preset for
- Set the timecode to your desired position
- Click + Add Preset in the preset panel
- Configure:
- Name — Descriptive name (e.g., "Act 2 Start")
- Position — Timecode position (auto-filled from current)
- Behavior — Jump & Play, Jump & Stop, or Jump Only
Recalling a Preset
Click the preset button to jump to that position. The behavior depends on the preset setting.
Preset Behaviors
| Behavior | Description |
|---|
| Jump & Play | Jump to position and immediately start playing |
| Jump & Stop | Jump to position and stop (cue up) |
| Jump Only | Jump to position, maintain current play state |
⌨️ CLI
List Presets
bptimecode preset list --slot 1
Create a Preset
bptimecode preset create --slot 1 --name "Act 2 Start" --position 01:30:00:00 --behavior play
Recall a Preset
bptimecode preset recall --slot 1 --name "Act 2 Start"
# or by index
bptimecode preset recall --slot 1 --index 0
Delete a Preset
bptimecode preset delete --slot 1 --name "Act 2 Start"
🔌 HTTP API
Endpoints
| Method | Endpoint | Description |
|---|
| GET | /api/v1/slots/:id/presets | List presets |
| POST | /api/v1/slots/:id/presets | Create preset |
| POST | /api/v1/slots/:id/presets/:name/recall | Recall preset |
| DELETE | /api/v1/slots/:id/presets/:name | Delete preset |
Create Preset
curl -X POST http://localhost:5050/api/v1/slots/1/presets \
-H "Content-Type: application/json" \
-d {"name": "Act 2 Start", "position": "01:30:00:00", "behavior": "play"}
Recall Preset
curl -X POST http://localhost:5050/api/v1/slots/1/presets/Act%202%20Start/recall
📡 OSC
Addresses
| Address | Args | Description |
|---|
/bptimecode/slot/{id}/preset/{name} | none | Recall preset by name |
/bptimecode/slot/{id}/preset/{index} | none | Recall preset by index |
/bptimecode/slot/{id}/preset/next | none | Recall next preset |
/bptimecode/slot/{id}/preset/prev | none | Recall previous preset |
Examples
# Recall preset by name
oscsend localhost 5051 /bptimecode/slot/1/preset/Act_2_Start
# Recall preset by index (0-based)
oscsend localhost 5051 /bptimecode/slot/1/preset/0
# Next/previous preset
oscsend localhost 5051 /bptimecode/slot/1/preset/next