Installation

🛠️ Installation Guide

This guide will walk you through compiling and setting up AsusTufFanControl_Linux on your machine.

⚠️ Disclaimer: This tool manipulates low-level system hardware (Embedded Controller and ACPI methods). Improper fan settings could lead to overheating. Always monitor temperatures when adjusting fan curves. Use at your own risk.

📋 Prerequisites & System Requirements

Before installing, make sure your system meets the following requirements:

• OS: Linux (Kernel 5.4+)
• Hardware: ASUS TUF / ROG / Strix Gaming Laptop
• Kernel Modules: asus_wmi and asus_nb_wmi (these are usually auto-loaded by your kernel)
• Build Dependencies: Qt6, CMake, and GCC

---

🚀 Step-by-Step Installation

1️⃣ Clone the Repository

Open your terminal and download the latest version of the tool to your local machine:

git clone https://github.com/Karthigaiselvam-R-official/AsusTufFanControl_Linux.git
cd AsusTufFanControl_Linux

2️⃣ Run the Setup Script

This script installs required dependencies, builds ec_probe, configures Polkit for permissions, and sets up desktop integration.

chmod +x setup.sh
sudo ./setup.sh

3️⃣ Build the Application

Compile the source code using CMake. (Note: This step automatically runs patch_translations.py to ensure all languages are up to date).

mkdir build && cd build
cmake ..
make -j$(nproc)

4️⃣ Install the Binary

Move the compiled application to the /opt/ directory so it can be run properly:

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

---

▶️ Running the Application

Once installed, you can launch the application in two ways:

• 🖱️ Desktop (Recommended): Launch "ASUS TUF Fan Control" from your desktop's Applications menu. A password prompt will appear to grant the app the elevated privileges it needs to control hardware.
• 💻 Terminal: You can also run it directly from the terminal using sudo:

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