asusctl

From ArchWiki

asusctlAUR allows ROG & TUF laptop owners to control their laptops from a CLI, it supports keyboard control (brightness, RGB and backlight effects), setting a custom charge limit, changing system power profiles, setting custom fan curves and controlling AniMe matrix displays.

Installation

Install the asusctlAUR package or alternatively from a custom repository, then enable the asusd.service systemd service.

Some features may require a newer version of Linux, specifically 6.1 or newer. ASUS Linux does offer a custom kernel which includes patches not yet merged into the mainline kernel.

Usage

Issuing the command asusctl on its own will output a list of supported options. You can also use subvalues to list options from subcategories, for example asusctl bios will list all options from the BIOS subcategory.

When dealing with subcategories, your current setting can be queried by swapping the case of the flag. Uppercase flags make changes, lowercase flags query current setting. For example asusctl bios -o will return the current panel overdrive state while asusctl bios -O true will set it to enabled.

Show supported options

The following command is used to display all the options your laptop supports:

$ asusctl -s

Charge limit

Set a battery charge limit with the following:

$ asusctl -c limit 

where limit is between 20 and 100.

Note: A charging limit of 75 is suitable for a laptop that is unplugged often. 60 is a good value for one that is left plugged in most of the time

Panel overdrive

If your laptop supports panel overdrive it can be toggled with the following command:

$ asusctl bios -O <true/false>

Power profiles

Quiet, Balanced and Performance modes are supported.

Change power profiles with the following:

$ asusctl profile -P profile

or use the following to cycle through all profiles:

$ asusctl profile -n

You can set a power profile in /etc/asusd/profile.conf if you wish to have one automatically loaded during boot.

Note: Power profile switching requires the power-profiles-daemon package to be running.

Using the MUX switch

Switching to discrete graphics only (MUX switch)

supergfxctl is capable of detecting whether the MUX switch is enabled or not and does not cause the display manager to fail if it is enabled. Using other Optimus managers with asusctl to control a MUX might cause issues.

Switching to discrete graphics is done with the following command:

$ asusctl bios -D 0

and then rebooting.

Switching back to Optimus mode

Switching to Optimus mode is done with the following command:

$ asusctl bios -D 1

and then rebooting.

Visual Effects

RGB/Keyboard backlight

Use the following commands to toggle LED modes:

Next mode:

$ asusctl led-mode -n

Previous mode:

$ asusctl led-mode -p

Keyboard backlighting effects can be defined by editing /etc/asusd/asusd-ledmodes.toml.

RGB effect settings (assuming you have a supported model) are stored at /etc/asusd/aura.conf. Manually editing this file is usually not necessary and it will be recreated each time asusd.service is restarted.

AniMe matrix display

For laptops that have an AniMe matrix display, the settings and options to control it are stored at /etc/asusd/anime.conf.

To make use of it under Linux you first need to enable the asusd-user user unit.

rog-control-center

Many functions of asusctl can be controlled in a GUI, it is packaged as rog-control-centerAUR or can be obtained from the ASUS Linux#Custom repository.

If your laptop has RGB, backlighting effects or an AniMe matrix display then using this tool will drastically improve your ability to control them.

Custom fan curves

Using rog-control-center it is possible to define custom fan curves for both the CPU and GPU, for each of the supported power profiles.

Warning: This feature seems to be very unstable. If, after you enable it, you experience general stuttering, videos dropping frames or other seemingly power related issues you should disable it and leave it off.