Skip to content
GG2R10Public

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

13 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

GameModer Plasmoid Icon

GameModer, Plasmoid for KDE Plasma

A lightweight and efficient widget to monitor and control Feral's GameMode directly from your KDE Plasma panel.


Screenshots & Features

Active Menu Inactive Menu
Active Menu Inactive Menu
GameMode Active
Displays registered PIDs and lets you manually unregister GameMode per process[cite: 1, 2].
GameMode Inactive
Lists open application windows so you can manually trigger GameMode on any running process[cite: 2, 3].

How It Works & Efficiency

Unlike widgets that rely on periodic checks (polling rates) or execute the gamemode CLI tool repeatedly, this plasmoid uses a 100% event-driven architecture:

  • D-Bus Event Monitoring (gdbus): Listens directly to GameRegistered and GameUnregistered signals on the session bus using a single persistent watcher (watcher.sh)[cite: 1].
  • 0% Idle CPU Usage: Reader processes block in the kernel and only wake when an actual state change is appended, eliminating background CPU overhead[cite: 1].
  • Shared State Stream (Multicast): Writes updates to a runtime file (state.data)[cite: 1], enabling multiple widget instances to stay synced without spawning extra D-Bus connections[cite: 1, 3].
  • Smart Process Resolution: Resolves human-readable names via /proc and D-Bus properties[cite: 1, 3], correctly identifying native binaries as well as Wine/Proton games[cite: 1].

Selectable Icons and Animations

The panel icon and active-state animation are configurable from the widget's settings — pick an icon per state (idle/active) and how the "GameMode is running" indicator animates.

Multicolor (default) Green buttons Fully green Off (black)
Breathing badge Icon outline
(outline in the badge color, following the icon's shape)

Animations are static by default: a short transition plays when GameMode activates and then nothing runs, so the widget costs no CPU/GPU at rest. An optional continuous mode keeps animating at a capped frame rate (12-60 fps). Under Icon size you can also pick a larger icon.

---: | :---: | | | |


Installation

Option 1: Via KDE Plasma GUI (Recommended)

  1. Right-click your panel or desktop and select Add Widgets...
  2. Click Get New Widgets... $\rightarrow$ Download New Plasma Widgets...
  3. Search for GameMode and install it directly.

Option 2: Manual Installation from Repository

Method A: Copy package contents Clone the repository and copy the contents of the package/ folder into your local Plasma applets directory:

mkdir -p ~/.local/share/plasma/plasmoids/com.github.GG2R10.gamemoder/
cp -r package/* ~/.local/share/plasma/plasmoids/com.github.GG2R10.gamemoder/

Method B: Install Local Package

  1. Compress the contents of the package/ directory into a .zip file (or rename it to .plasmoid).
  2. Open Add Widgets... $\rightarrow$ Get New Widgets... $\rightarrow$ Install from local file...
  3. Select your compressed archive.

Note: If installing manually, you may need to restart plasmashell (plasmashell --replace &) for Plasma to detect the new widget.

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages