Misc options
Platform Specific Issues
Newly Added Parameters

&midi

Global hotkey support via MIDI input.

WARNING: Can be changed/tweaked in future versions.

Options

Value

Description

1

A3 to G4 notes

2

A1 to G2 notes

3

Note C1 + velocities

4

Designed for the director to control guests

&midi=1

MIDI message

Function

Note G3

Toggle Chat

Note A3

Toggle Mute

Note B3

Toggle Video Output

Note C4

Toggle Screen Share

Note D4

Hang up

Note E4

Raise Hand Toggle

Note F4

Record Local Video Toggle

Note G4

Enable the Director’s audio [director only]

Note A4

Stop the Director’s Audio [director only]

&midi=2

MIDI message

Function

Note G1

Toggle Chat

Note A1

Toggle Mute

Note B1

Toggle Video Output

Note C2

Toggle Screen Share

Note D2

Hang up

Note E2

Raise Hand Toggle

Note F2

Record Local Video Toggle

Note G2

Enable the Director’s audio [director only]

Note A2

Stop the Director’s Audio [director only]

&midi=3

MIDI message

Function

Note C1 + Velocity 0

Toggle Chat

Note C1 + Velocity 1

Toggle Mute

Note C1 + Velocity 2

Toggle Video Output

Note C1 + Velocity 3

Toggle Screen Share

Note C1 + Velocity 4

Hang up

Note C1 + Velocity 5

Raise Hand Toggle

Note C1 + Velocity 6

Record Local Video Toggle

Note C1 + Velocity 7

Enable the Director’s audio [director only]

Note C1 + Velocity 8

Stop the Director’s Audio [director only]

&midi=4

MIDI message

Function

Command = 110

with values accepted from 0 to 8 for local toggle options.

Command = 110+N

where N is the guest’s order in the control room.

In this case, for hotkeying remote guests as a director:

MIDI message

Function

Value 0

Opens the Transfer Popup

Value 1

Add/remove from scene 1

Value 2

Mute guest in scene

Value 3

Mute guest everyone

Value 4

Hangup the guest

Value 5

Toggle Solo Chat with this guest

Value 6

Toggle the remote speaker

Value 7

Toggle the remote display

Value 12 to 18

Add/remove from scene 2 to 8

All the above hotkey mappings are purely experimental at this time and will change based on user feedback. These mappings should allow a user to use a StreamDeck with OBS.Ninja.

Remote MIDI control

This is available for version 19 and higher.

This lets you route all MIDI messages from one computer to another computer, with the purpose of remote trigger the VDO.Ninja hotkeys.

https://vdo.ninja/beta/?midiremote=4&director=ROOMNAMEHERE
https://vdo.ninja/beta/?room=ROOMNAMEHERE&midiout=1&vd=0&ad=0&push&autostart&label=MIDI_CONTROLLER
  • &midiremote={reference &midi's values; 1 to 4}

Remote controlling demo

MIDI pass-through mode

This is available for version 18 and higher.

This lets you route all MIDI messages from one computer to another computer, going from local MIDI device input to the remote MIDI device output. Example usage:

https://vdo.ninja/?view=Nwz2C7d&midiin=1
https://vdo.ninja/?midiout=0&push=Nwz2C7d
  • &midiin={midi output device index; defaults to all} (or &midipull / &mi) -- allows for receiving of remote midi. Device indeces starts at 1, where an index of 0 implies "all".

  • &midiout={midi input device index; defaults to all} (or &midipush / &mo) -- allows for sending of remote midi. Device indices starts at 1, where an index of 0 implies "all".

It's important to not send and receive between two tabs locally if from the same midi device, as that will create a feedback loop; computer won't like it.

Check the console log or https://vdo.ninja/midi to see which midi device is what device index.

Example of how to find the midi device order ID

Video Guides

https://www.youtube.com/watch?v=uidN3bLLiVk
https://www.youtube.com/watch?v=mdAzAZo65Mc