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, Microsoft Store and PC Game Pass (through Xodus Nexus), and supported emulators with a keyboard, mouse, or controller.

Watch the demo · Homepage · Guide · Compatibility · Troubleshooting · 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, Xenia, and Kyty (PS5)
• Automatic discovery of known native ports, with links to available ports for your console dumps
• Controller-first fullscreen Game Mode, on the display you are using or on 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
• Highlights: save the last moments of a game from the in-game guide, a key or a controller's capture button, and clip Steam achievements as they unlock
• Steam and Xbox 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, install it from the Omarchy Package Repository (OPR):

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, normal system updates prefer OPR's copy. To take this repository's newer version early, run omarchy update and then sudo pacman -S btsouth/omakade.

You can also download and verify a release package directly:

curl -fLO https://github.com/btsouth/omakade/releases/download/v1.19.0/omakade-1.19.0-1-x86_64.pkg.tar.zst
curl -fLO https://github.com/btsouth/omakade/releases/download/v1.19.0/SHA256SUMS
sha256sum -c SHA256SUMS --ignore-missing
sudo pacman -U ./omakade-1.19.0-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.

SHA256SUMS comes from the same place as the package, so it only catches a damaged download. To check that a package was built by this repository's release workflow, verify its GitHub build attestation with the GitHub CLI:

gh attestation verify omakade-1.19.0-1-x86_64.pkg.tar.zst -R btsouth/omakade
gh attestation verify omakade-1.19.0-1-aarch64.pkg.tar.zst -R btsouth/omakade

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, and the controller Home button service, which stays off until you turn it on in Settings.

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	Start or leave Game Mode on this display
Super+Ctrl+G	Start Game Mode on your chosen display; over a game, open the in-game guide; in Game Mode, return to the desktop or resume (add it in Settings → Controls)
Controller Home button	In-game guide over a game; otherwise same as Start; hold it to switch Game Mode and the desktop (turn it on in Settings → Controls)
Ctrl+D	Settings and source diagnostics
Ctrl+M	Toggle reduced motion

Fullscreen is always Game Mode. F11, Start and omakade --couch start it on the display you are using and leave sound and notifications alone. Use Settings → Controls → Start Game Mode, Super+Ctrl+G or omakade --game-mode for a dedicated gaming display and sound output.

The guide covers sources, Home, owned libraries, organization, connections, recording, stats, backups, streaming, and the command line.

User guides

• Guide: sources and everyday features
• Game Mode: fullscreen play, a dedicated gaming display, and recovery
• In-game guide: the overlay that opens over a running game
• Highlights: save clips of the last moments of a game
• Emulator save protection: automatic save copies and restores
• Native ports: native PC ports of console games
• Compatibility: what each source supports, and test reports
• Troubleshooting: missing games, sources that are not found, launch errors, covers, and logs

Build

See Contributing for dependencies and build/test commands, and Architecture for a map of the source tree.

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, RetroAchievements, IGDB, SteamGridDB, and RomM credentials are stored in Secret Service, never in the settings file.

Privacy · Changelog · Compatibility · Security

More for Omarchy

• Omaroll: a photo and video viewer and library that follows your theme.
• Omaframe: screenshots and screen recordings, with frames and backgrounds.
• Omalink: your Android phone on the desktop, through KDE Connect.