Troubleshooting

🔧 Troubleshooting & FAQ

If you are running into issues with AsusTufFanControl_Linux, check the common problems and solutions below.

❌ Common Issues

1. "Permission Denied" or App Won't Control Fans

Because this tool interacts with low-level ACPI and embedded controllers, it requires root privileges.

• Fix: Ensure you are launching the application through the desktop shortcut (which prompts for your password via Polkit) or running it from the terminal using sudo:

  sudo /opt/asus-tuf-fan-control/AsusTufFanControl_Linux

2. Fans Not Responding / Missing Kernel Modules

If the UI loads but the fan speeds do not change, your system might not have the correct Asus WMI kernel modules loaded.

• Fix: Verify that the modules are loaded by running:

  lsmod | grep asus

  You should see asus_wmi and asus_nb_wmi in the output. If not, your kernel might be too old, or you are running an unsupported custom kernel. Ensure your system is running Linux Kernel 5.4 or higher.

3. Application Fails to Launch (GUI doesn't open)

If nothing happens when you click the app icon, there might be a missing dependency.

• Fix: Try launching the app directly from the terminal to read the error output:

  sudo /opt/asus-tuf-fan-control/AsusTufFanControl_Linux

  If it complains about missing Qt libraries, ensure you have all qt6 base libraries installed on your distribution.

---

❓ FAQ (Frequently Asked Questions)

Q: Does this work on battery power? A: Yes, but keep in mind that running fans at 100% (Turbo mode) will drain your battery significantly faster.

Q: Can I set custom fan curves? A: Yes! Use the GUI to adjust the temperature thresholds to your liking.

---

Still need help? Feel free to open an issue on GitHub.