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: 19 days 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 (about 2 years ago)
- Default Branch: main
- Last Pushed: 2026-05-17T19:00:35.000Z (25 days ago)
- Last Synced: 2026-05-17T20:53:23.293Z (25 days ago)
- Topics: games, linux, proton
- Language: Python
- Homepage:
- Size: 19.3 MB
- Stars: 1,737
- Watchers: 12
- Forks: 66
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
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.
## Debian-based distributions
### PPA (Ubuntu, Mint, KDE Neon...)
```
sudo dpkg --add-architecture i386
sudo add-apt-repository -y ppa:faugus/faugus-launcher
sudo apt update
sudo apt install -y faugus-launcher
```
### .deb package
```
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.20.1/faugus-launcher_1.20.1-1_all.deb
sudo apt install -y ~/faugus-launcher/*.deb
sudo rm -r ~/faugus-launcher
```
## [Flatpak](https://flathub.org/apps/io.github.Faugus.faugus-launcher)
### Installation:
```
flatpak install flathub io.github.Faugus.faugus-launcher
```
### Running:
```
flatpak run io.github.Faugus.faugus-launcher
```
### MangoHud installation:
```
flatpak install org.freedesktop.Platform.VulkanLayer.MangoHud/x86_64/25.08
```
### Important permissions:
```
# Allow Faugus Launcher to detect Steam users and games
sudo flatpak override io.github.Faugus.faugus-launcher --filesystem=~/.var/app/com.valvesoftware.Steam/
sudo flatpak override io.github.Faugus.faugus-launcher --talk-name=org.freedesktop.Flatpak
# Allow Steam to run Faugus Launcher shortcuts
sudo flatpak override com.valvesoftware.Steam --talk-name=org.freedesktop.Flatpak
# Allow Steam to see Faugus Launcher games icons
sudo flatpak override com.valvesoftware.Steam --filesystem=~/.var/app/io.github.Faugus.faugus-launcher/config/faugus-launcher/
sudo flatpak override com.valvesoftware.Steam --filesystem=~/.config/faugus-launcher/
```
### Known issues:
- The 'stop' button won't close games/apps
- Gamescope doesn't work
- It may not use the system theme in some DEs
## Build from source
```
meson setup builddir --prefix=/usr
cd builddir
ninja
sudo ninja install
```
### Dependencies:
```
meson ninja pygobject requests pillow vdf psutil pygame imagemagick icoextract libayatana-appindicator libcanberra vulkan-tools
```
# Usage
[](https://www.youtube.com/watch?v=Ay6C2f55Pc8)
# Information
### Default prefixes location
```
~/Faugus/
```
### Runners location
```
~/.local/share/Steam/compatibilitytools.d/
```
### Shortcut locations
For Desktop Environments that support icons on the Desktop
```
~/Desktop/
```
For Application Launchers
```
~/.local/share/applications/
```
### Gamepad mapping
| Action | Playstation | Xbox |
|---------------|-------------|----------|
| Confirm | Cross | A |
| Cancel | Circle | B |
| Game menu | Triangle | Y |
| Kill | Square | X |
| Add game/app | L1 | LB |
| Settings | R1 | RB |
| Power options | Options | Menu |
# Screenshots
### Main window
### Add/Edit game
### Settings
### Proton Manager
### Create shortcut from .exe file
