# OSC Remote

To enable OSC input in blinderkitten, you must enable it in file -> preferences -> OSC Remote control

#### Cuelists

You must specify your target cuelist by replacing {id} with your cuelist's ID in the adress

| Command                           | Arguments   | Infos                                                                             |
| --------------------------------- | ----------- | --------------------------------------------------------------------------------- |
| /cuelist/{id}/go(/{cueId})        |             | cueId can be given if you wan to jump to go to a specific cue                     |
| /cuelist/{id}/goback              |             |                                                                                   |
| /cuelist/{id}/gorandom            |             |                                                                                   |
| /cuelist/{id}/off                 |             |                                                                                   |
| /cuelist/{id}/kill                |             |                                                                                   |
| /cuelist/{id}/toggle              |             |                                                                                   |
| /cuelist/{id}/load(/{cueId})      |             | cueId load the given cue, if not given, the command will show the load cue window |
| /cuelist/{id}/loadandgo(/{cueId}) |             | cueId load the given cue, if not given, the command will show the load cue window |
| /cuelist/{id}/loadrandom          |             |                                                                                   |
| /cuelist/{id}/flash               | int status  | 1 is press, 0 is release                                                          |
| /cuelist/{id}/swop                | int status  | 1 is press, 0 is release                                                          |
| /cuelist/{id}/htplevel            | float value | value between 0 and 1                                                             |
| /cuelist/{id}/ltplevel            | float value | value between 0 and 1                                                             |
| /cuelist/{id}/flashlevel          | float value | value between 0 and 1                                                             |

#### Effects

You must specify your target effect by replacing {id} with your effect's ID in the adress

| Command               | Arguments   | Infos                      |
| --------------------- | ----------- | -------------------------- |
| /effect/{id}/start    |             |                            |
| /effect/{id}/stop     |             |                            |
| /effect/{id}/taptempo |             |                            |
| /effect/{id}/size     | float value | value between 0 and 1      |
| /effect/{id}/speed    | float value | value in cycles per minute |

#### Carousels

You must specify your target carousel by replacing {id} with your carousels's ID in the adress

| Command                 | Arguments   | Infos                      |
| ----------------------- | ----------- | -------------------------- |
| /carousel/{id}/start    |             |                            |
| /carousel/{id}/stop     |             |                            |
| /carousel/{id}/taptempo |             |                            |
| /carousel/{id}/size     | float value | value between 0 and 1      |
| /carousel/{id}/speed    | float value | value in cycles per minute |

#### Mappers

You must specify your target mapper by replacing {id} with your mapper's ID in the adress

| Command            | Arguments   | Infos                 |
| ------------------ | ----------- | --------------------- |
| /mapper/{id}/start |             |                       |
| /mapper/{id}/stop  |             |                       |
| /mapper/{id}/size  | float value | value between 0 and 1 |

#### Virtual buttons and faders

Replace {col}, {row} and {page} in the command to target wanted element.

When page is not specified, the current page is used

| Command                        | Arguments   | Infos                       |
| ------------------------------ | ----------- | --------------------------- |
| /virtbutton/{page}/{col}/{row} | float value | Virtual button grid element |
| /virtbutton/{col}/{row}        | float value | Virtual button grid element |
| /virtabove/{page}/{col}/{row}  | float value | Virtual fader above button  |
| /virtabove/{col}/{row}         | float value | Virtual fader above button  |
| /virtbelow/{page}/{col}/{row}  | float value | Virtual fader below button  |
| /virtbelow/{col}/{row}         | float value | Virtual fader below button  |
| /virtrotary/{page}/{col}/{row} | float value | Virtual rotary              |
| /virtrotary/{col}/{row}        | float value | Virtual rotary              |
| /virtfader/{page}/{col}        | float value | Virtual fader               |
| /virtfader/{col}               | float value | Virtual fader               |

#### Encoders

<table><thead><tr><th width="322">Command</th><th>Arguments</th><th>Infos</th></tr></thead><tbody><tr><td>/encoders/hl</td><td></td><td></td></tr><tr><td>/encoders/blind</td><td></td><td></td></tr><tr><td>/encoders/mode</td><td></td><td></td></tr><tr><td>/encoders/encoderRange</td><td></td><td></td></tr><tr><td>/encoders/numbersOrNames</td><td></td><td></td></tr><tr><td>/encoders/littleMoveLeft</td><td></td><td></td></tr><tr><td>/encoders/littleMoveRight</td><td></td><td></td></tr><tr><td>/encoders/bigMoveLeft</td><td></td><td></td></tr><tr><td>/encoders/bigMoveRight</td><td></td><td></td></tr><tr><td>/encoders/commandUp</td><td></td><td></td></tr><tr><td>/encoders/commandDown</td><td></td><td></td></tr><tr><td>/encoders/explodeCommand</td><td></td><td></td></tr></tbody></table>

#### Other inputs

| Command      | Arguments         | Infos                    |
| ------------ | ----------------- | ------------------------ |
| /grandmaster | float value (0-1) | input panel grand master |
| /key         | String            |                          |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://norbertrostaing.gitbook.io/blinderkitten/annexes/osc-remote.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.