MCPcopy
hub / github.com/Faugus/faugus-launcher

github.com/Faugus/faugus-launcher @1.22.7 sqlite

repository ↗ · DeepWiki ↗ · release 1.22.7 ↗
423 symbols 1,175 edges 16 files 0 documented · 0%
README

Faugus Launcher

A simple and lightweight app for running Windows games using 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.22.7/faugus-launcher_1.22.7-1_all.deb
sudo apt install -y ~/faugus-launcher/*.deb
sudo rm -r ~/faugus-launcher

Flatpak

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

YouTube

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

Core symbols most depended-on inside this repo

run
called by 45
faugus/runner.py
set_value
called by 38
faugus/config_manager.py
user_config
called by 20
faugus/path_manager.py
load_json_file
called by 19
faugus/utils.py
set_env
called by 18
faugus/runner.py
selected
called by 16
faugus/launcher.py
read
called by 13
faugus/proton_manager.py
save_json_file
called by 12
faugus/utils.py

Shape

Method 278
Function 129
Class 16

Languages

Python100%

Modules by API surface

faugus/launcher.py197 symbols
faugus/utils.py48 symbols
faugus/runner.py37 symbols
faugus/gamepad.py28 symbols
faugus/proton_manager.py20 symbols
faugus/backup.py17 symbols
faugus/keyboard.py13 symbols
faugus/shortcut.py12 symbols
faugus/path_manager.py10 symbols
faugus/steam_setup.py9 symbols
faugus/proton_downloader.py9 symbols
faugus/components.py9 symbols

For agents

$ claude mcp add faugus-launcher \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact