Omakade

Your games, beautifully together.

Omakade brings your Linux games into one library that follows your Omarchy theme. Browse, organize, and launch games from Steam, Heroic, Lutris, Faugus, Battle.net, GOG, and supported emulators with a keyboard, mouse, or controller.

Watch the demo · Homepage · Guide · Support

Features

• One library for installed games, with optional Steam and Heroic owned-library views
• Console libraries for RetroArch, PCSX2, RPCS3, PPSSPP, Ryujinx, Cemu, melonDS, shadPS4, Dolphin, and Xenia
• Controller-first Couch Mode, plus Game Mode for a chosen display and sound output with desktop restoration when you leave
• Favorites, collections, tags, saved filters, custom artwork, and a random pick
• Optional playtime recording, session history, stats, and a Year in Review image
• Steam achievements and optional RetroAchievements, IGDB, SteamGridDB, and ProtonDB details
• Emulator save backups, personal library backup and restore, and Sunshine/Moonlight export

Installed-game discovery and core browsing work offline without an account or API key. Play uses the owning launcher or emulator; accounts, downloads, updates, DRM, cloud saves, and compatibility settings stay with those applications.

Omakade is an independent community project, not an official Omarchy application.

Install

On Omarchy:

sudo pacman -S omarchy/omakade

Omakade then updates with your system. OPR may carry an older release.

For Omarchy or Arch, my signed package repository provides x86_64 and ARM64 packages. Add it once, then install:

curl -fsSL https://pkgs.btso.dev/install.sh | bash
sudo pacman -S btsouth/omakade

On Omarchy, use sudo pacman -Syu btsouth/omakade to update from this repository explicitly; normal system updates prefer OPR's copy.

You can also download and verify a release package directly:

curl -fLO https://github.com/btsouth/omakade/releases/download/v1.16.1/omakade-1.16.1-1-x86_64.pkg.tar.zst
curl -fLO https://github.com/btsouth/omakade/releases/download/v1.16.1/SHA256SUMS
sha256sum -c SHA256SUMS --ignore-missing
sudo pacman -U ./omakade-1.16.1-1-x86_64.pkg.tar.zst

For ARM64, replace x86_64 with aarch64. Packages are also available under release assets. Upgrading preserves your library and settings.

Omakade is also listed in OmaStore, a community app store that installs it into your home directory. OmaStore 0.4 and newer also set up the omakade-sessiond service, so playtime recording works there too.

Getting started

Open Omakade from the application launcher or run omakade. Installed games appear automatically. Use omakade --demo to try a fictional library.

Control	Action
Ctrl+F	Search
Arrow keys / Enter	Navigate / open details
Escape	Go back
F11 / controller Start	Toggle Couch Mode
Super+Ctrl+G	In-game guide over a game; otherwise return to the desktop / resume Game Mode (add in Settings)
Controller Home button	Same as Super+Ctrl+G; hold it to switch Game Mode and the desktop (turn on in Settings)
Ctrl+D	Settings and source diagnostics
Ctrl+M	Toggle reduced motion

omakade --couch starts fullscreen. Use Settings → Controls → Start Game Mode or omakade --game-mode for a dedicated gaming display and sound output.

The guide covers sources, owned libraries, organization, recording, backups, and streaming. See the Game Mode guide for setup and recovery.

Build

See Contributing for dependencies and build/test commands.

Local data

Your library and custom artwork live in ~/.local/share/omakade/, settings in ~/.config/omakade/config.toml, and downloaded artwork in ~/.cache/omakade/. Optional Steam and IGDB credentials use Secret Service.

Privacy · Changelog · Compatibility reports · Security