https://github.com/Faugus/faugus-launcher
A simple and lightweight app for running Windows games using UMU-Launcher
https://github.com/Faugus/faugus-launcher
games linux proton
Last synced: 4 months ago
JSON representation
A simple and lightweight app for running Windows games using UMU-Launcher
- Host: GitHub
- URL: https://github.com/Faugus/faugus-launcher
- Owner: Faugus
- License: mit
- Created: 2024-06-03T22:39:52.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-05T21:31:03.000Z (4 months ago)
- Last Synced: 2025-06-05T22:28:50.816Z (4 months ago)
- Topics: games, linux, proton
- Language: Python
- Homepage:
- Size: 1.63 MB
- Stars: 328
- Watchers: 10
- Forks: 8
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome - Faugus/faugus-launcher - A simple and lightweight app for running Windows games using UMU-Launcher (Python)
README
# Faugus Launcher
A simple and lightweight app for running Windows games using [UMU-Launcher](https://github.com/Open-Wine-Components/umu-launcher)
### Support the project
# Installation
### Arch-based distributions (AUR)
```
yay -S --noconfirm faugus-launcher
```
### Fedora / Nobara (Copr)
```
sudo dnf -y copr enable faugus/faugus-launcher
sudo dnf -y install faugus-launcher
```
### Bazzite (Copr)
```
sudo dnf5 -y copr enable faugus/faugus-launcher
sudo rpm-ostree -y install faugus-launcher
```
Restart your system.
### Ubuntu / Mint / KDE Neon
```
sudo dpkg --add-architecture i386
sudo apt update
sudo apt install -y wget
mkdir -p ~/faugus-launcher
wget -P ~/faugus-launcher https://github.com/Faugus/faugus-launcher/releases/download/1.6.2/faugus-launcher_1.6.2-1_all.deb
wget -P ~/faugus-launcher https://github.com/Open-Wine-Components/umu-launcher/releases/download/1.2.6/python3-umu-launcher_1.2.6-1_amd64_ubuntu-noble.deb
wget -P ~/faugus-launcher https://github.com/Open-Wine-Components/umu-launcher/releases/download/1.2.6/umu-launcher_1.2.6-1_all_ubuntu-noble.deb
sudo apt install -y ~/faugus-launcher/*.deb
sudo rm -r ~/faugus-launcher
```
### Debian 13
```
sudo dpkg --add-architecture i386
sudo apt update
sudo apt install -y wget
mkdir -p ~/faugus-launcher
wget -P ~/faugus-launcher https://github.com/Faugus/faugus-launcher/releases/download/1.6.2/faugus-launcher_1.6.2-1_all.deb
wget -P ~/faugus-launcher https://github.com/Open-Wine-Components/umu-launcher/releases/download/1.2.6/python3-umu-launcher_1.2.6-1_amd64_debian-13.deb
wget -P ~/faugus-launcher https://github.com/Open-Wine-Components/umu-launcher/releases/download/1.2.6/umu-launcher_1.2.6-1_all_debian-13.deb
sudo apt install -y ~/faugus-launcher/*.deb
sudo rm -r ~/faugus-launcher
```
### openSUSE (Packaged by [ToRRent1812](https://github.com/ToRRent1812))
```
# Tumbleweed
sudo zypper addrepo https://download.opensuse.org/repositories/home:/Rabbit95/openSUSE_Tumbleweed/ home:Rabbit95
sudo zypper --gpg-auto-import-keys install -y faugus-launcher
```
```
# Slowroll
sudo zypper addrepo https://download.opensuse.org/repositories/home:/Rabbit95/openSUSE_Slowroll/ home:Rabbit95
sudo zypper --gpg-auto-import-keys install -y faugus-launcher
```
### Flatpak (EXPERIMENTAL)
Download faugus-launcher-0.6.2-5.flatpak and run:
```
flatpak remote-add --user --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
flatpak install --user org.freedesktop.Platform.Compat.i386//24.08 org.freedesktop.Platform.GL32.default//24.08
flatpak install --user faugus-launcher-0.6.2-5.flatpak
```
Steam Flatpak needs permissions to run Faugus Launcher's shortcuts and to show the game's icon:
```
sudo flatpak override com.valvesoftware.Steam --talk-name=org.freedesktop.Flatpak
sudo flatpak override com.valvesoftware.Steam --filesystem=~/.var/app/org.faugus.faugus_launcher/config/faugus-launcher/
```
Known issues:
- The button Stop can't close individual games/apps due to how Flatpak handles processes. I'll have to rework the game/app monitoring in the future.
- Gamescope doesn't work. Don't ask.
### Build from source
```
meson setup builddir --prefix=/usr
cd builddir
ninja
sudo ninja install
```
Dependencies:
```
meson ninja pygobject requests pillow filelock vdf psutil umu-launcher imagemagick icoextract libayatana-appindicator
```
# Usage
[](https://www.youtube.com/watch?v=Ay6C2f55Pc8)
# Information
### Default prefixes location
```
~/.config/faugus-launcher/prefixes/
```
### Runners location
```
~/.local/share/Steam/compatibilitytools.d/
```
If you want to use native builds like proton-cachyos or proton-ge-custom, please symlink them to the user folder.
```
ln -s /usr/share/steam/compatibilitytools.d/proton-cachyos ~/.local/share/Steam/compatibilitytools.d/
ln -s /usr/share/steam/compatibilitytools.d/proton-ge-custom ~/.local/share/Steam/compatibilitytools.d/
```
### Shortcut locations
For Desktop Environments that support icons on the Desktop
```
~/Desktop/
```
For Application Launchers
```
~/.local/share/applications/
```
# Screenshots
### Main window
### Add/Edit game
### Settings
### GE-Proton Manager
### Create shortcut from .exe file
