YAFI is another GUI for the Framework Laptop Embedded Controller.
It is written in Python with a GTK4 Adwaita theme, and uses the CrOS_EC_Python library to communicate with the EC.
It has support for fan control, temperature monitoring, LED control, and battery limiting.
You can download the latest release from the Releases page.
There are builds for Flatpak, and PyInstaller for portable execution on Linux or Windows.
YAFI is also available on Flathub: flatpak install flathub au.stevetech.yafi.
To allow YAFI to communicate with the EC, you need to copy the 60-cros_ec_python.rules file to /etc/udev/rules.d/ and reload the rules with sudo udevadm control --reload-rules && sudo udevadm trigger.
If your Laptop's BIOS supports Framework's EC driver, there is no need to install any third-party drivers. YAFI should also work without administrator privileges.
Otherwise, YAFI supports the PawnIO driver, and will be automatically used if installed and there is no Framework driver available. YAFI will need to be run as administrator to communicate with the driver.
Currently the PawnIO driver does not support Framework 13 mainboards with 11th, 12th, or 13th Gen Intel CPUs.
Build and install the Flatpak package with flatpak-builder --install --user build au.stevetech.yafi.json.
You can also create a flatpak bundle with flatpak-builder --repo=repo build au.stevetech.yafi.json and install it with flatpak install --user repo au.stevetech.yafi.flatpak.
This project requires PyGObject, and the introspection data for GTK4 and Adwaita. On Debian/Ubuntu, you can install these with:
sudo apt install python3-gi gir1.2-gtk-4.0 gir1.2-adw-1Install the package with pip install yafi.
Pipx is also supported.
It is possible to run YAFI on Windows using gvsbuild and installing YAFI via pip, but it can be complicated and is therefore not recommended.
This error occurs when the udev rules are not installed or not working. Make sure you have copied the 60-cros_ec_python.rules file to /etc/udev/rules.d/ and reloaded the rules with sudo udevadm control --reload-rules && sudo udevadm trigger.
This error occurs when /dev/cros_ec is not found, and the CrOS_EC_Python library also cannot talk over LPC.
You can either update your kernel to have a working cros_ec_dev driver, or run YAFI as root.
It can also occur if you do not have a CrOS EC, like on non Framework laptops.
YAFI is not affiliated with Framework Computer Inc. in any way.
YAFI is licensed under the GPL-2.0-or-later license, and comes with no warranty or guarantee of any kind. Use at your own risk.
