Skip to content

ashuntu/gnomehud

Folders and files

NameName
Last commit message
Last commit date

Latest commit

1c8d7c5 · May 25, 2022

History

93 Commits
May 10, 2022
May 17, 2022
May 20, 2022
May 22, 2022
May 18, 2022
Apr 13, 2022
Apr 13, 2022
May 19, 2022
May 20, 2022
May 20, 2022
May 19, 2022
May 20, 2022
May 20, 2022
May 9, 2022
May 20, 2022

Repository files navigation

GNOME HUD WIP

GNOME Shell extension for displaying system information like CPU usage, RAM usage, GPU usage, and FPS.

Under active initial development, everything subject to change.

Screenshots

Indicator Popup Menu

Example Overlay

Preferences Window (General)

Preferences Window (Styles)

Preferences Window (Monitors)

Installation

Manual

  1. Download or clone the repository to ~/.local/share/gnome-shell/extensions/
  2. Rename the repository's folder to gnomehud@ashuntu.github.io
  3. Restart the GNOME Shell with Alt + F2, r, then Enter. Alternatively, log out or restart the computer
  4. If the extension isn't already enabled, use gnome-extensions enable gnomehud@ashuntu.github.io

Bundle

  1. Download the .zip extension bundle
  2. Run gnome-extensions install gnomehud@ashuntu.github.io.shell-extension.zip
  3. Restart the GNOME Shell with Alt + F2, r, then Enter. Alternatively, log out or restart the computer
  4. If the extension isn't already enabled, use gnome-extensions enable gnomehud@ashuntu.github.io

If the extension does not appear, make sure you have user extensions enabled with gsettings set org.gnome.shell disable-user-extensions false

Usage

Use Super + Alt + G to toggle the overlay.

Settings & Configuration

Extension settings can be accessed through the indicator in the status area with the 'Settings' button. Alternatively, open the settings window manually with gnome-extensions prefs gnomehud@ashuntu.github.io.

Development

View logs

GNOME Shell
GNOME shell, overlay, and indicator logs

journalctl -f -o cat /usr/bin/gnome-shell

GJS
Preferences window logs

journalctl -f -o cat /usr/bin/gjs

Compile (Preferences) Schemas

glib-compile-schemas schemas/

Generate Translations

xgettext --from-code=UTF-8 --output=po/example.pot *.js monitors/*.js

Pack Extension

gnome-extensions pack gnomehud@ashuntu.github.io --podir=po --extra-source={*.js}

Useful Links

Name Link
GJS Docs https://gjs-docs.gnome.org/
GJS Guide https://gjs.guide/extensions/
GNOME Shell Source https://gitlab.gnome.org/GNOME/gnome-shell/-/tree/main/js/ui
Icon Spec https://specifications.freedesktop.org/icon-naming-spec/icon-naming-spec-latest.html