https://github.com/baldomo/asusctltray
Simple tray profile switcher for asusctl
https://github.com/baldomo/asusctltray
appindicator asus asusctl asusd dbus dbus-python linux profiles python3 tray-application
Last synced: 10 days ago
JSON representation
Simple tray profile switcher for asusctl
- Host: GitHub
- URL: https://github.com/baldomo/asusctltray
- Owner: Baldomo
- License: mit
- Created: 2020-10-29T22:28:15.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-05-16T23:34:06.000Z (11 months ago)
- Last Synced: 2025-03-27T02:06:59.640Z (27 days ago)
- Topics: appindicator, asus, asusctl, asusd, dbus, dbus-python, linux, profiles, python3, tray-application
- Language: Python
- Homepage:
- Size: 311 KB
- Stars: 40
- Watchers: 3
- Forks: 5
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# asusctltray
This is a simple tray widget based on `appindicator` which lets the user change their ROG laptop power profiles and graphics mode on the fly. Easy turbo boost toggling is also included (it was temporarily removed from `asusctl`).
All functionality is provided through `dbus` method calls.
## Table of contents
- [asusctltray](#asusctltray)
- [Table of contents](#table-of-contents)
- [Installation](#installation)
- [Arch](#arch)
- [Manual install](#manual-install)
- [Note for GNOME 40+ users](#note-for-gnome-40-users)
- [Usage](#usage)
- [Screenshots](#screenshots)
## Installation
This project depends on `AppIndicator3`. Refer to your distro's documentation/software repositories to install it (both the runtime and development files are needed).
### Arch
[`asusctltray-git`](https://aur.archlinux.org/packages/asusctltray-git/) on the AUR (requires `supergfxctl` available on the [official `asus-linux` g14 repo](https://asus-linux.org/wiki/arch-guide/#repo))
### Manual install
Running the script `install.sh` as root will install `asusctltray` to `/usr/local/bin`, the icon to `/usr/share/pixmaps` and the `asusctl.desktop` to `/usr/share/applications`. This makes the tray icon available in application menus.
### Note for GNOME 40+ users
GNOME dropped support for `appindicator`/tray icons (see [blog post](https://blogs.gnome.org/aday/2017/08/31/status-icons-and-gnome/) and [Status of Status Icons in GNOME Shell](https://discourse.gnome.org/t/status-of-status-icon-in-gnome-shell/6441)).
Unofficial support for tray icons can be easily brought back to the shell with [ubuntu/gnome-shell-extension-appindicator](https://github.com/ubuntu/gnome-shell-extension-appindicator), which I tested with asusctltray and can recommend.
Moreover, GNOME users should check out the excellent [asusctl-gex](https://gitlab.com/asus-linux/asusctl-gex/-/tree/main) shell extension from the maintainers of `asusctl`.
## Usage
> ⚠️ `pkexec` is required for boost toggling
On click: open context menu with all the profiles, selecting one will apply it (`dbus` is used extensively for both profile switching and GFX control).
## Screenshots
