vMix IO
======================================
vMix IO is a free application that converts capture devices into Open Media Transport (OMT) inputs and outputs on the network.
More information on OMT can be found at https://www.openmediatransport.org

======================================
SYSTEM REQUIREMENTS
======================================
* PC an x86_64 processor supporting at least AVX2
* Minimum 8GB of DDR5 memory. Dual Channel memory recommended for > 4x 1080p sources
* Windows 10 or Linux Mint 33 or higher
(Other Debian based distributions higher than version 12 should also work)
* A Blackmagic DeckLink capture card with the latest drivers installed.
(Other capture cards that support either MediaFoundation (Windows) or V4L2 (Linux) should work but have not been tested)
* A gigabit network card (2.5Gbps required for > 4x 1080p60)
(Intel and Realtek 2.5Gbps network cards have been tested)

======================================
INSTALLATION﻿
======================================

Before proceeding with the installation, first make sure the DeckLink drivers are installed and working, if using a DeckLink card.
This can be done by running Media Express on the system and verifying signals are being received for each input.

Additionally, if you are not using Linux Mint, you may need to install the following from a Terminal:

sudo apt install libsamplerate0
sudo apt install webp

--------------------------------------
Linux
--------------------------------------
1. Extract the files in the download to a dedicated directory.

2. Open a Terminal and navigate to the directory

In Linux Mint you can right click the folder within the file browser and select Open in Terminal

3. Run the following command:

chmod +x vMixIO

4. Run the following command to start vMixIO

./vMixIO

5. If all is working, it should show a message on screen stating that vMixIO is now running.

6. Browse to http://localhost:8080 in a browser running on the same machine and enter in the default username/password of admin/admin

--------------------------------------
Windows
--------------------------------------
1. Extract the files in the download to a dedicated directory.

2. Double click the vMixIO icon to start.

3. The console window can be minimised if needed, but closing it will stop the service.


======================================
RUNNING ON STARTUP
======================================

By default vMixIO will only run on demand. To have it automatically start when the system boots up, follow the instructions below:

--------------------------------------
Linux
--------------------------------------
1. Make sure vMixIO is closed if already running.

If a terminal/console is open running vMixIO, type Ctrl+C to exit.

2. Open a Terminal and navigate to the directory containing vMixIO

In Linux Mint you can right click the folder within the file browser and select "Open in Terminal"

3. Run the following command:

chmod +x installservice.sh

4. Run the following command and follow the prompts:

./installservice.sh

5. If all is working, vMixIO should now be running as a service and will also run automatically on startup.

--------------------------------------
Windows
--------------------------------------
1. Open the directory containing vMixIO

2. Right click the vMixIO icon and choose Create Shortcut

3. Right click the shortcut and click Properties

4. Where it says Run: Normal window, change this to Run: Minimized

5. Press the Windows logo key + R, type shell:startup, then select OK. This opens the Startup folder.

6. Copy and paste the shortcut into this folder.

7. vMixIO will now run automatically as a minimized app after logging in.

8. To login automatically, you can use the free app Autologin:

https://learn.microsoft.com/en-us/sysinternals/downloads/autologon
