This GNOME Shell extension provides a convenient indicator for Feral's GameMode. The extension displays the status of GameMode, the number of active clients, and a list of these clients.
- GameMode Status Indicator: Easily see if GameMode is enabled or disabled.
- Active Clients Count: Displays the number of active clients using GameMode.
- Client List: Lists all active clients and their process names.
- Notification Settings: Configure notifications for when GameMode is enabled or disabled.
Figure 1: GameMode is enabled and showing active clients.
Figure 2: GameMode is disabled.
Figure 3: GameMode enabled notification.
Figure 4: GameMode Settings Menu.
If GameMode is not installed you will not be able to use the extension, to install GameMode please refer to: Feral GameMode Docs
-
Clone the Repository:
git clone https://github.com/trsnaqe/gamemode-shell-extension cd gamemodeshellextension -
Automatically Install Extension:
./makezip.sh install
-
Clone the Repository:
git clone https://github.com/trsnaqe/gamemode-shell-extension.git cd gamemode-shell-extension -
Build and Package the Extension:
./makezip.sh build
-
Move and Extract Zip into Extensions:
unzip gamemodeshellextension.zip -d ~/.local/share/gnome-shell/extensions/gamemodeshellextension@trsnaqe.com/ -
Install and Compile the Schema: in settings folder run:
sudo install -Dm644 settings/org.gnome.shell.extensions.gamemodeshellextension.gschema.xml /usr/share/glib-2.0/schemas/org.gnome.shell.extensions.gamemodeshellextension.gschema.xml
sudo glib-compile-schemas /usr/share/glib-2.0/schemas
- Enable Extension:
gnome-extensions enable gamemodeshellextension@trsnaqe.com - Restart the Shell:
- If you are using x11, alt+f2 then type
r
- If you are using wayland, restart the session Note: If makezip.sh does not work, you may need to give it executable permissions:
chmod +x ./makezip.shThe makezip.sh script simplifies the build and installation process of the extension. It includes the following commands:
- build: Builds the extansion into a zip .
- install: Builds the extension, installs it, installs the schema, and activates the extension.
- remove: Removes the build files.
- purge: Removes everything related to the extension.
Once installed, the extension will appear in the GNOME Shell top panel.
- Icon: The icon indicates whether GameMode is currently active.
- Menu: Click on the icon to open the menu, which displays the current status of GameMode, the number of active clients, and a list of these clients.
- Notifications: Toggle notifications for when GameMode is enabled or disabled via the settings menu.
The extension includes settings to control notification preferences:
- GameMode Enabled Notification: Shows a notification when GameMode is turned on.
- GameMode Disabled Notification: Shows a notification when GameMode is turned off.
These settings can be accessed from the extension's menu.
This extension was developed as a weekend project to learn more about DBus integration and GNOME Shell extension development.
- extension.js: Main extension logic.
- client.js: Handles DBus communication with GameMode.
- stylesheet.css: Custom styles for the extension.
- metadata.json: Metadata for the extension.
- settings/org.gnome.shell.extensions.gamemodeshellextension.gschema.xml: Settings schema.
- GNOME Shell: The GNOME desktop environment.
- Feral's GameMode: A Linux tool to optimize the system for gaming.
Contributions are welcome! If you have suggestions or improvements, feel free to open an issue or submit a pull request.
This project is licensed under the LGPL-2.1 License.
Special thanks to Feral Interactive for developing GameMode and the GNOME community for their excellent documentation and support.
For any questions or suggestions, please open an issue on the GitHub repository.
