> Complete documentation index: [llms.txt](/llms.txt). Markdown versions of all pages are available by appending `.md` to page URLs.

# Download & Installation

> Download and install Mission Control 2 on Windows, macOS or Linux for the Binho Nova, including which release files to pick.

## Download and Install the Binho Mission Control Software <a href="#step-1-download-and-install-the-binho-mission-control-software" id="step-1-download-and-install-the-binho-mission-control-software"></a>

Mission Control 2 runs on Windows, macOS and Linux. It is the GUI for the _Binho Nova_ and _Supernova_ host adapters.

Find and download the Binho Mission Control installer suitable for the OS (Windows, Linux, or Mac) in the following public repository.

[https://github.com/binhollc/MissionControl2-releases/releases](https://github.com/binhollc/MissionControl2-releases/releases)

* For **Mac** users, download either the `Binho-Mission-Control-2-x.y.z-mac.zip` or the `Binho-Mission-Control-2-x.y.z.dmg` file. For the .zip file, unzip it to access the application. For the .dmg file, mount it and drag the application to the Applications folder.
* **Linux** users should download the `Binho-Mission-Control-2-x.y.z.AppImage` file. Once downloaded, make it executable (using a tool like `chmod`) and then run it.
* For **Windows** users, download the `Binho-Mission-Control-2-Setup-x.y.z.exe` file and run the installer.

The `.blockmap` and `.yml` files are not needed to install. They are used for update checks and differential updates. The source code is available in both zip and tar.gz formats.

### Windows Installer Notes

The Windows Defender SmartScreen prompt is displayed when running the installer. Click "_More Info_" and then the "_Run Anyway_" button to continue. Our software releases are code-signed, however we're still building our reputation within Microsoft SmartScreen so that eventually this warning will go away.

### Mac Installer Notes

On the first connection to a virtual COM port on a Mac, ensure that the user account has the necessary permissions. Here is a list of potential Issues with USB Serial or HID drivers:

* **Driver Conflicts:** Sometimes, multiple drivers can try to control the same piece of hardware, leading to conflicts. Ensure that no conflicting drivers are installed.
* **System Integrity Protection (SIP):** On newer versions of macOS, SIP can prevent certain drivers from loading. If issues occur, check if the driver is compatible with SIP or if there's a need to temporarily disable SIP (though this is generally not recommended for security reasons).
* **Access Permissions:** Ensure that any required drivers or applications have the necessary permissions to access USB devices. Check this in System Preferences > Security & Privacy > Privacy tab.
* **Cable Issues:** Sometimes, the problem might be as simple as a faulty USB cable. Always try a different cable to rule out this possibility.
* **Update Drivers:** Ensure that the latest drivers are installed for the device. Outdated drivers can sometimes cause compatibility issues, especially after a macOS update.

### Linux Installer Notes

**Problem:** When trying to connect to the Binho host adapter using Binho Mission Control on Linux, an error related to USB access permissions can occur. This is because, by default, certain USB devices may not have the appropriate permissions set for user-level access.

**Detection:** Binho Mission Control should automatically detect this issue and provide instructions to resolve it.

**Solution:** To grant the necessary permissions, follow the steps below:

1. Open a terminal.
2.  Create a new user group named 'binho' and add the current user to this group:

    ```bash
    groupadd binho
    usermod -a -G binho $USER
    ```
3.  Add a new udev rule to set the correct permissions for Binho devices:

    ```bash
    echo 'SUBSYSTEM=="usb", MODE="0666", GROUP="binho"' | sudo tee /etc/udev/rules.d/99-binho.rules
    ```
4.  Reload the udev rules. If this does not work, reboot the system:

    ```bash
    sudo udevadm control --reload
    sudo udevadm trigger
    ```
5.  Once done, a confirmation message appears:

    ```bash
    echo "USB device configuration has been installed. Please log out and log back in or reboot."
    ```

After following these steps, Binho Mission Control should be able to access the Binho host adapter without any permission issues.

## Launch the Mission Control Software & Connect to the Device <a href="#step-2-launch-the-mission-control-software-and-connect-to-the-device" id="step-2-launch-the-mission-control-software-and-connect-to-the-device"></a>

Plug the host adapter into the computer with the supplied USB cable, then double-click the app icon to launch Mission Control 2. The device is ready to use.