Skip to content

acerctl 0.1.0

Pre-release
Pre-release

Choose a tag to compare

View all tags
@FnnDK FnnDK released this 14 Oct 03:28
· 51 commits to main since this release
v0.1.0
6378f8b

First release of acerctl: the controls of Acer's NitroSense, PredatorSense and AcerSense on Linux, alongside the in-tree acer_wmi driver. It ships a system daemon (acerd), a CLI (acerctl), a tray agent and an app in three flavors (Nitro, Predator and Acer Control Center). Each feature shows up only when the laptop's firmware offers it.

This is a pre-release: only two laptops have been tested.

Tested hardware

  • Acer Nitro ANV15-52 (Fedora Silverblue 44): the kernel modules, daemon and CLI are validated on the hardware. This covers operating modes with AC/battery rules and power-profiles-daemon/tuned sync, fans (auto, max, manual), sensors, keyboard backlight timeout, USB charging while off, the 80 % charge limit and calibration, scenarios with App Sync, and the Sense key.
  • Acer Aspire AG15-71P (Bluefin 44): the 80 % charge limit (GNOME "Preserve Battery Health"), the Sense key, the app and the tray. The firmware has no operating modes or fans, so the app does not show them.
  • Predator: not tested. acerd --simulate PHN16-72 or PH16-71 models these laptops from public reports, including RGB keyboard, light bar and logo lighting. Lighting has no real backend yet.

To help support other models, run sudo sh tools/survey.sh --probes and open the link it prints (see docs/hardware-reports.md).

Downloads

  • acerctl-0.1.0-linux-x86_64.tar.gz: prebuilt binaries (x86_64, glibc ≥ 2.34, WebKitGTK 4.1 for the app), the install scripts and the kernel modules as source. The steps are in its INSTALL.md.
  • acerctl-0.1.0.tar.gz: the source with vendored Go modules and the built frontend, which builds without network access.
  • SHA256SUMS

Installing the binary archive

tar xzf acerctl-0.1.0-linux-x86_64.tar.gz && cd acerctl-0.1.0-linux-x86_64
sudo sh packaging/build-sign.sh && sudo sh packaging/install-modules.sh   # needs make, gcc and kernel headers
sudo sh packaging/install-daemon.sh install
sudo sh packaging/install-gui.sh
acerctl status

Nitro and Predator models also need acer_wmi loaded with predator_v4 for operating modes and fans (see the README).

Known limitations

  • Installation is done by scripts into /usr/local, /etc and /var/lib. There are no rpm, deb or Flatpak packages yet.
  • The kernel modules must be rebuilt after every kernel update (sudo sh packaging/build-sign.sh). With Secure Boot, the script signs them with the akmods key on Fedora; on other distributions, sign them with your own enrolled MOK.
  • Builds are x86_64 only.
Assets 5
Loading