Skip to content

If you have any trouble running the image, please consult this section. Don't forget to install gstreamer if you run it on Linux.


Snapshots are built from the pimp-my-dweb branch. Images for Linux, MacOS, and Windows are provided. See the latest changelog here. Drop by the Telegram channel or the Matrix room if you have any questions.

Flatpak Install from the Flatpak repository (Linux)

AppImage Download the latest AppImage (Linux)

DMG Download the latest DMG (MacOS)

NSI Download the latest NSI (Windows)

The installers (with the exception of the NSI installer at the moment) automatically fetch the latest needed packages (the Python wheels) when you run them (you will only need to download the installer again when there is a major runtime Python or Qt upgrade). When running for the first time or during an upgrade, you should see a popup with a rotating cube:


A Flatpak repository is available. First, you should setup Flatpak on your Linux system. To register the Flatpak repository and install the latest version, use the following (as root):

flatpak install

If you want to install it as a regular user:

flatpak install --user

Note: If you run into issues with your flatpak installation and GPG signatures, please open an issue here. In such a case you can temporarily use remote-modify to disable GPG verifications:

flatpak remote-modify --no-gpg-verify galacteek-gitlab-snapshots

On your Linux system, the application will appear in the window manager's applications menu within the Internet (or Network) category.

You can also run the application from a terminal (note that you can use the same command-line flags as with the AppImage):

flatpak run io.gitlab.galacteek.Galacteek

Note: Flatpak stores the application's data files in a separate folder (by default .var/app in your HOME), different from what the AppImage uses.

Updating via Flatpak

flatpak update io.gitlab.galacteek.Galacteek

Automatic AppImage install shell script

There's a script which will download the latest AppImage snapshot, verify the file's checksum, and run it for you. Use the following command from a terminal to run it:

curl -L | bash

Note: This script is provided as a convenience to track the latest AppImage. Downloading the AppImage via the direct links is the recommended way to install the software.


Installing gstreamer (Linux)

To use the mediaplayer inside galacteek you will need to have the gstreamer libraries (you'll need gstreamer 1.0) installed on your system. To install gstreamer and the main plugins on a Debian/Ubuntu system, run the following:

sudo apt-get install gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-libav gstreamer1.0-tools gstreamer1.0-x gstreamer1.0-alsa gstreamer1.0-gl gstreamer1.0-qt5 gstreamer1.0-pulseaudio

If you use another type of Linux distribution, search for and install the gstreamer 1.0 packages and the good, bad and ugly plugins.

How to run the AppImage (Linux)

After downloading the AppImage, make it executable and then run it from the shell or double-click on it from the desktop. Example:

chmod +x Galacteek-0.5.5-x86_64.AppImage

How to run with Flatpak (Linux)

flatpak run io.gitlab.galacteek.Galacteek

Command-line flags

This section describes the various flags that you can pass when you run the AppImage.


Use --config-defaults to restore the default configuration.

Only use this flag if the UI won't start !


Use -d to log debugging messages.


Use --goipfs-debug to log debugging messages from go-ipfs.


Use --profile with a profile name to use a custom application profile. The default profile is called main. Example:

./Galacteek-0.5.5-x86_64.AppImage --profile demo

How to run the DMG image (MacOS)

After opening/mounting the DMG image, hold the Control key and click on the galacteek icon, select Open and then accept. You probably need to allow the system to install applications from anywhere in the security settings.

Release workflow

AppImages are built from GitLab CI. They are uploaded to GitLab packages, and they are also distributed on IPFS, which makes it easier to replicate (a big thanks to Pinata for their amazing service!).

At the moment, the DMG and NSI installers are built from GH Actions.