Skip to content

GNOME Shell extension to control ASUS ROG power profiles via asusctl and synchronize them with GNOME's native power settings.

Notifications You must be signed in to change notification settings

Kyworn/ZorkoPower

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 

Repository files navigation

ZorkoPower

ZorkoPower is a GNOME Shell extension designed specifically for ASUS ROG laptops running Linux (Fedora, Arch, etc.) with asusctl installed.

It provides a seamless integration between the ASUS hardware power profiles (managed by asusd) and the GNOME desktop environment, ensuring your system runs exactly how you want it.

Features

  • Direct Control: Switch between ASUS power profiles (Quiet, Balanced, Performance) directly from the GNOME system menu.
  • GNOME Sync: Automatically synchronizes the GNOME Power Profile (power-profiles-daemon) to match the selected ASUS profile (e.g., selecting "Quiet" sets GNOME to "Power Saver").
  • Dynamic Icons: The system tray icon updates in real-time to reflect the current power state (Leaf for Quiet, Balance scale for Balanced, Lightning bolt for Performance).
  • State Persistence: Detects the active profile on startup and updates the UI accordingly.
  • Modern GNOME Support: Compatible with GNOME Shell 45 up to 49+ (ESM modules support).
  • Robust Error Handling: Logs detailed error messages to journalctl for easy debugging.

Requirements

  • GNOME Shell (45 or newer)
  • asusctl (and asusd service running)
  • GHelper users migrating to Linux will feel right at home!

Installation

Manual Installation

  1. Clone this repository into your local extensions directory:

    mkdir -p ~/.local/share/gnome-shell/extensions/
    git clone https://github.com/Kyworn/ZorkoPower.git ~/.local/share/gnome-shell/extensions/zorkopower@zorko.local
  2. Enable the extension:

    gnome-extensions enable zorkopower@zorko.local
  3. Restart GNOME Shell (Log out/Log in on Wayland, or Alt+F2 -> r on X11).

Usage

Click on the power icon in the top-right status bar to open the menu, then select your desired profile:

  • Quiet: Silent fans, power saving, throttled CPU.
  • Balanced: Best mix of performance and battery life.
  • Performance: Max power, higher fan speeds (requires AC power on some models).

Troubleshooting

If the extension doesn't appear or work:

  1. Check if asusd is running: systemctl status asusd
  2. Check logs: journalctl -S today | grep ZorkoPower

License

MIT License

About

GNOME Shell extension to control ASUS ROG power profiles via asusctl and synchronize them with GNOME's native power settings.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published