HTTP WEB API

Parent Previous Next

The vMix API provides access to common functions through the HTTP protocol.

For example, the following command will signal vMix to fade Preview to Active within 1 second:


http://127.0.0.1:8088/api/?Function=Fade&Duration=1000



Setup


The API uses the same web address as the standard Web Interface and can be configured from the Web tab in Settings.


Parameters


Function


Specify a function to execute.

This can be any of the functions provided for the Shortcuts feature.
To view a list of what is possible, in vMix go to Settings, Shortcuts and click Add.
All the functions in the "Function" dropdown box can be called from the API.


Click here to view a list of some of the Shortcut Functions that are available.


Duration


If the specified function is a transition this parameter can be set to a time in milliseconds.


Input


Specify an input by its number starting from 1.

0 can be used for Preview and -1 for Active.

A GUID can be used to specify an Input instead of a number.
For example:


http://127.0.0.1:8088/API/?Function=Fade&Duration=1000&Input=877bb3e7-58bd-46a1-85ce-0d673aec6bf5


SelectedName


When using Title or XAML inputs, SelectedName can be used to specify the name of the text field to modify.

For example:


http://127.0.0.1:8088/API/?Function=SetText&Input=877bb3e7-58bd-46a1-85ce-0d673aec6bf5&SelectedName=Headline&Value=Hello


SelectedIndex


Specify an index to pass to the input
The following Inputs support the SelectedIndex parameter:

       VideoList: Specify the video to play starting from 1
           Virtual Set: Specify the camera zoom to transition to
           Title: Specify the text item to configure starting from 0



Value


Value is used with the following API Functions:


       SetImage: Specify the image to display in an image field within a supported XAML or Title input

       SetText: Specify the text to display in the text field specified by SelectedIndex above.
       SetPosition: In milliseconds
       SetCountdown: As a timespan (00:00:00)
       SetFader: As a number between 0 and 255
       AddInput: Specify the Video/Image/Photos or Xaml input filename in the following formats:

               Video|c:\filename.wmv
               Image|c:\filename.jpg
               ...


Return


If successful, the API will return the standard 200 response code.

If an error occurs, the API will return the standard 500 error code.


Information


If all parameters are left blank the API will return state information in XML format.

The following is an example of the XML output:


<vmix>

<version>11.0.0.16</version>

<inputs>

<input key="26cae087-b7b6-4d45-98e4-de03ab4feb6b" number="1" type="Xaml" title="NewsHD.xaml" state="Paused" position="0" duration="0" muted="True" loop="False" selectedIndex="0">

NewsHD.xaml

<text index="0" name="Headline">Hello</text>

<text index="1" name="Description">Hello</text>

</input>

<input key="55cbe357-a801-4d54-8ff2-08ee68766fae" number="2" type="VirtualSet" title="LateNightNews" state="Paused" position="0" duration="0" muted="True" loop="False" selectedIndex="0">

LateNightNews

<overlay index="0" key="2fe8ff9d-e400-4504-85ab-df7c17a1edd4"/>

<overlay index="1" key="20e4ee9a-05cc-4f58-bb69-cd179e1c1958"/>

<overlay index="2" key="94b88db0-c5cd-49d8-98a2-27d83d4bf3fe"/>

</input>

</inputs>

<overlays>

<overlay number="1"/>

<overlay number="2">1</overlay>

<overlay number="3"/>

<overlay number="4"/>

<overlay number="5"/>

<overlay number="6"/>

</overlays>

<preview>1</preview>

<active>2</active>

<fadeToBlack>False</fadeToBlack>

<transitions>

<transition number="1" effect="Fade" duration="500"/>

<transition number="2" effect="Wipe" duration="500"/>

<transition number="3" effect="Fly" duration="500"/>

<transition number="4" effect="CubeZoom" duration="3000"/>

</transitions>

<recording>False</recording>

<external>False</external>

<streaming>False</streaming>

<playList>False</playList>

<multiCorder>False</multiCorder>

</vmix>


In the example above Input 2 is active and Input 1 is currently running as Overlay 2.