Back to plugins
Game Launcher
v1.7.0 Alexander

About

Game Launcher

Browse and launch games from Steam, Lutris, and Heroic Games Launcher directly from your bar. Opens a full-height side panel with search, cover art, and one-click launch — or the original look. One panel, two looks — flipping Panel style under Settings → Plugins re-renders it live.

Plugin

Field Value
ID alexander/game-launcher
Entries Bar widget: launcher; panels: browser (sidebar dock), original (center box); launcher provider: search
Launcher Prefix /g
Plugin API 43

Requirements

Requires xdg-utils (provides xdg-open) and gcc on PATH.

# Debian/Ubuntu
sudo apt install xdg-utils gcc

# Fedora
sudo dnf install xdg-utils gcc

# Arch
sudo pacman -S xdg-utils gcc

The scanner binary (gamelauncher) is compiled automatically on first use — the plugin runs cc to build it when needed. No manual build step required.

Usage

Add the bar widget alexander/game-launcher:launcher to your bar. The widget shows a gamepad icon — click it to open it (look follows Panel style).

In the panel, use the search bar to filter by name or runner. Click Launch on any game to start it. The last game you launched always moves to the top of the list with a Last played badge, and stays there across restarts.

To open the panel via IPC:

noctalia msg panel-toggle alexander/game-launcher:browser
noctalia msg panel-toggle alexander/game-launcher:original

From the launcher, type /g followed by a game name to search. Activate a result to launch the game.

In the panel: Up/Down moves the highlight and keeps it in view, the mouse wheel scrolls the list, and Enter launches the highlighted game. Both panels show the full game list in a scroll. The side panel (browser) is 400 px wide and docks on the right by default; the original panel (original) is 680 × 560 and centered. To dock the side panel on the left instead, change its Position under Settings → Plugins.

Settings

Setting Type Default Description
glyph glyph device-gamepad-2 Bar widget icon
steampoacher_enabled bool false Enable steampoacher proxy for Steam cover art
steam_enabled bool true Show Steam games
heroic_enabled bool true Show Heroic games
lutris_enabled bool true Show Lutris games

Security & Data Flow

The plugin addresses all findings from Noctalia's security audit:

1. No shell commands in C scanner — The scanner (gamelauncher.c) uses only local filesystem reads and a bundled SQLite database reader. No system(), popen(), curl, wget, python3, or grep is invoked. All network requests (cover downloads) are handled in Luau via Noctalia's built-in noctalia.http and noctalia.download APIs, which respect offline mode.

2. No shell injection in launch paths — The C scanner outputs protocol URLs only (e.g., steam://rungameid/730, lutris:rungame/slug, heroic://launch/appid). Luau validates each URL against known protocol prefixes, filters every character through a strict allowlist ([%w_%-%.%/] — no shell metacharacters), and double-quotes the argument before passing it to xdg-open via noctalia.runAsync.

3. xdg-utils declared — xdg-utils is listed in plugin.toml dependencies.

4. Steampoacher opt-in & disclosure — By default, Steam cover art is fetched directly from store.steampowered.com/api/appdetails. The API only provides small header_image art (460×215). For high-resolution library capsule covers, enable the steampoacher Cloudflare Worker by setting steampoacher_enabled to true in ~/.config/noctalia/plugins/game-launcher.json. When enabled, Steam app IDs from your installed library are sent to the proxy at steam-asset-proxy.steampoacher.workers.dev, which returns a CDN capsule URL on shared.steamstatic.com with full-size 1200×450 art. Cover art for Heroic games uses the art URL from Heroic launcher metadata.

[!NOTE] Without steampoacher enabled, Steam covers will be bad (600×900 instead of high resolution).

Notes

  • Scans all detected Steam library folders, Lutris SQLite databases, and Heroic store caches (Legendary, GOG, Nile).
  • Results are cached in ~/.cache/gamelauncher/games.json and rescanned on click if sources changed.
  • Last-played launches are stored in the plugin data dir (recent.json, newest 30) and shared live between the panels and the /g provider, so the last game stays on top everywhere.
  • No external CLI tools (curl, wget, python3, grep) are invoked anywhere in the plugin.

Versions

VersionPlugin APIUpdated
v1.7.0 latest43Nov 7, 2026
v1.5.1 13Oct 13, 2026
v1.0.1 9Jul 24, 2026
v1.0.0 4Jul 20, 2026

Older versions stay installable on a Noctalia release whose plugin API is below the latest version's.