Skip to content

Installation

Xaymar edited this page Dec 20, 2023 · 81 revisions

Installation Guide

Please make sure you have read and understand the About StreamFX and FAQ page.

Windows

Conflicting Software

  • Windows Defender: Due to the binaries not being signed, Windows Defender warns about running them. You can bypass this warning by clicking "More Info" and then "Run anyway".
  • Norton/Avira/Avast AntiVirus: May not like the use of InnoSetup and prevents writing files, resulting in corrupted installations. Please ensure that you temporarily disable your AntiVirus or whitelist the installer file.
  • Multiple different installations of StreamFX may conflict with each other. You should avoid using a System-wide install if a user has a User-only install, and avoid both System-wide and User-only install in case of a Portable installation.
  1. Close all instances of OBS Studio.
  2. Download the .exe Installer of either the latest Production or Testing for Windows.
  3. Run the Installer once it is downloaded. Depending on your System settings, you may be greeted by multiple warning meant to get your attention:
    • Microsoft SmartScreen may warn you that the file is unsigned and as such can't be verified. This warning can be bypassed by clicking More info and then Run anyway.
    • Windows Defender may warn you about a Security Warning, with a similar reason as above. This can be bypassed by clicking Run.
  4. The Installer will now ask you if you wish to install for just you (User-only) or all users (System-wide).
    • User-only: Allows installation as User-only and Portable, and will not require Administrator rights for installing, uninstalling or updating StreamFX.
    • System-wide: Allows installation as System-wide and Portable to restricted locations, but will require Administrator rights for installing, uninstalling or updating StreamFX.
  5. Read and then agree to the License Terms.
  6. Select which Installation Mode you wish to use. See 3 for an explanation.
    • System-wide: StreamFX will be available to any user on this System, as long as they are using a compatible OBS Studio version. Updating and uninstalling will require Administrator rights.
    • User-only: StreamFX will only be available to you and other users will need to install StreamFX as well. Updating and uninstalling will not require Administrator rights.
    • Portable: StreamFX will be extracted for Portable usage of OBS Studio. Updating and uninstalling may require Administrator rights depending on your choice in step 3.
  7. This page differs depending on the choice in step 5:
    • Portable: Select the directory to which StreamFX will be extracted.
    • System-wide and User-only: Select if and where the Start Menu entries will be placed.
  8. Click Install to complete the installation.
  9. Click Finish to be done.

Linux (Ubuntu, Debian, ...)

  1. Close all instances of OBS Studio.
  2. Download the latest Production or Testing release of your choice for Linux.
  3. Extract the archive to ~/.config/obs-studio/.
  4. Done, you can now launch OBS Studio and StreamFX should load.

MacOS

⚠ Due to a bug in the MacOS Package Installer, extra caution needs to be paid to these steps. Failure to adhere to them will cause the plugin to not install correctly.

  1. Close all instances of OBS Studio.
  2. Download the .pkg Installer of the latest Production or Testing release of your choice for MacOS.
  3. Option Click (or Right Click) on the .pkg file.
  4. Select Open, which will bypass an annoying safety warning.
    • A window will pop up asking if you trust this file. To continue you have to select Open.
  5. A Package Installer window will now appear, which you can follow until the Installation Type step.
  6. On the Installation Type step, click the Change Install Location... button.
    • This may now ask you for permission to access your files, however this permission is not needed.
  7. Select Install for me only and click Continue.
  8. Click Install to install StreamFX.
  9. Click Close to finish installing.
  10. Done.

Building from Source

If all other options failed, you can always attempt to build the project from source. While this option is much more difficult for beginners, it allows you to mess with many more things. Perhaps it is your entry into a world of wondering why the code doesn't compile despite it looking correct, and parsing cryptic errors and warnings.

Clone this wiki locally