Omahub
← All plugins
S

Game Mode Switcher

by silvaio

One-click Game Mode for Omarchy: lock compositor shortcuts, optimize Hyprland, silence the desktop, and optionally launch Steam in Gamescope / Big Picture.

GitHub

Security review

Review recommended · 1 finding

Deterministic scan — not a security guarantee

Medium
Risk level
Medium
Analyzed commit
4a9b2b8
Scanned
1 month ago

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

Low
AI risk level
Low
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
4a9b2b8
Reviewed
1 month ago

The plugin is a transparent game-mode switcher that toggles Hyprland settings, power profiles, and optional Steam sessions. The flagged eval is used to load a local Lua submap definition via hyprctl, not to execute untrusted input, and all commands are constructed from fixed strings and boolean settings.

  • Uses hyprctl eval to load a Lua file, but the file is bundled with the plugin and the eval string is not user-controlled.
  • Modifies system settings (power profile, notifications, Hyprland options) without per-action confirmation, but this is the plugin's documented purpose and reversible on exit.
How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/silvaio/gamemode-switcher --enable
Desktop #Hyprland #bar #power-management

Game Mode Switcher

One-click Game Mode for Omarchy Quattro.

  • Do-not-disturb, stay-awake, night light off, performance power profile
  • Disable Hyprland animations, blur, shadows, and gaps — then restore the previous values on exit
  • Lock system keys (on by default): suppress Super binds and Alt+Tab so they don't pull you out of a game. Super+1–10, copy/paste/cut, volume/brightness, and Super+Ctrl+G stay available
  • Optional Steam session: Steam Deck UI in Gamescope, or Steam Big Picture if Gamescope is missing
  • Quick-launch only the game clients you actually have installed

The bar stays. Click the gamepad chip to leave.

Install

omarchy plugin add https://github.com/silvaio/gamemode-switcher.git --enable

Or develop locally:

mkdir -p ~/.config/omarchy/plugins
cp -a . ~/.config/omarchy/plugins/silvaio.gamemode
omarchy plugin validate ~/.config/omarchy/plugins/silvaio.gamemode
omarchy plugin enable silvaio.gamemode --section right

Usage

  • Click the gamepad chip to enter or leave Game Mode
  • Right-click for settings, key lock, Steam session, and quick launch

Enable a Steam session from the panel (or the command below) so entering Game Mode also starts Big Picture / Gamescope.

Optional keybind:

o.bind("SUPER + CTRL + G", "Game Mode", "omarchy-shell silvaio.gamemode toggleMode")

omarchy bar set silvaio.gamemode steamGamescope true

Steam session

When Steam session is on, entering Game Mode starts Steam and keeps Game Mode on until Big Picture / Gamescope ends, Steam quits, or you click the chip again.

Gamescope installed? Steam already running? What happens
Yes No Nested fullscreen Gamescope with Steam Deck UI
Yes Yes Steam is shut down, then restarted inside Gamescope
No No Steam starts in gamepad / Big Picture UI
No Yes The running client is sent to Big Picture (steam://open/bigpicture)

Without Gamescope, Big Picture is fullscreened on the workspace you were looking at. Game Mode does not change dwindle vs scrolling (SUPER + L). When the session ends, Steam goes back to the workspace and tile-or-float state it had before.

The Steam quick-launch button only focuses (and, if needed, moves) the existing Steam window. It does not enter Big Picture.

Leaving

  • Click the gamepad chip, exit Big Picture, quit Steam, or leave Gamescope — Game Mode restores the desktop, and Steam returns to where it was

Key lock

On by default. Entering Game Mode switches Hyprland into a silvaio-gamemode submap so desktop Super binds (menu, close window, fullscreen, …) and Alt+Tab stop stealing keys from the game.

Still available:

  • Super+1 through Super+10 — workspace switching
  • Super+C / Super+V / Super+X — Omarchy universal copy / paste / cut
  • Volume, brightness, media keys, screenshot (Print), lid switch
  • Super+Ctrl+G (or Super+Alt+G) — leave Game Mode
  • Click the gamepad chip — always works, even if a bind is stuck

Turn it off from the panel if you want desktop binds while Game Mode is optimizing everything else.

If you already defined a personal gamemode submap in ~/.config/hypr/bindings.lua, remove it so it doesn't fight the plugin. Bind the hotkey to the plugin instead:

o.bind("SUPER + ALT + G", "Game Mode", "omarchy-shell silvaio.gamemode toggleMode")

Settings

Key Default Meaning
lockKeys true Enter Game Mode suppresses Hyprland Super binds and Alt+Tab. Workspaces 1–10 and copy/paste/cut stay available.
steamGamescope false Enter Game Mode launches a Steam Gamescope / Big Picture session. Leaving that session exits Game Mode.

Dependencies

Ships with Omarchy: hyprctl, jq, notify-send, and usually powerprofilesctl.

Optional, only if you enable the Gamescope session:

  • Steam (steam or the Steam desktop entry)
  • Gamescope (gamescope) — without it, Game Mode uses Steam Big Picture
omarchy pkg add gamescope

Remove

Exit Game Mode first so notifications, idle, power profile, and Hyprland settings are restored. Then:

omarchy plugin remove silvaio.gamemode

License

MIT