Installation¶

Flatpak¶

GitHub¶

System Dependencies

Please follow the guide that matches your distro the most:

Arch Linux

On Arch Linux (and possibly other distros) you may need to install the following system packages using the distribution specific package manager:

xdg-desktop-portal xdg-desktop-portal-gtk libportal libportal-gtk4

Ubuntu Linux

On Ubuntu Linux (tested on 24.04.1 LTS) you may need to install the following system packages using the distribution specific package manager:

gir1.2-xdpgtk4-1.0 libgirepository1.0-dev libportal-gtk4-1 libportal-gtk4-dev build-essential libdbus-glib-1-dev

Fedora

Please run the following command to install all needed dependencies:

sudo dnf install -y gcc gcc-c++ kernel-headers python3-devel gobject-introspection-devel glib2-devel cairo-devel cairo-gobject-devel dbus-devel libffi-devel libjpeg-turbo-devel zlib-devel libtiff-devel freetype-devel lcms2-devel libwebp-devel openjpeg2-devel libunwind-devel lz4-devel bzip2-devel elfutils-debuginfod-client-devel portaudio-devel

Clone StreamController from GitHub by typing:

git clone https://github.com/Core447/StreamController

Enter the StreamController directory:
```
cd StreamController
```
Create a virtual environment:
```
python3 -m venv .venv
```
Activate the virtual environment:
```
source .venv/bin/activate
```
Install pip requirements:
```
pip install -r requirements.txt
```
Optional: Switch branches

If you want to try out a specific branch, you can change the branch using:
```
git checkout <branch>
```
Launch the app:
```
python3 main.py
```

Unofficial packages¶

The following packages are functional but unofficial and maintained by our community:

Help¶

If you encounter any problems, please go through Common Problems. You can also open an issue on the StreamController GitHub repository or on the Discord.