{"id":35492701,"url":"https://github.com/karthigaiselvam-r-official/asustuffancontrol_linux","last_synced_at":"2026-01-04T17:01:28.301Z","repository":{"id":331020792,"uuid":"1124806590","full_name":"Karthigaiselvam-R-official/AsusTufFanControl_Linux","owner":"Karthigaiselvam-R-official","description":"\"A powerful, expert-level system control utility for ASUS TUF and ROG laptops on Linux. Features advanced Fan Control, Battery Health management, and Aura Sync RGB customization with a premium Qt6/QML glassmorphic UI.\"","archived":false,"fork":false,"pushed_at":"2026-01-01T16:38:13.000Z","size":1372,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-02T02:42:28.298Z","etag":null,"topics":["asus","aura-sync","battery-management","cpp","fan-control","linux","qml","qt","rgb-control","rog","system-monitor","tuf-controller","tuf-gaming"],"latest_commit_sha":null,"homepage":"","language":"QML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Karthigaiselvam-R-official.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-29T16:42:00.000Z","updated_at":"2026-01-01T16:40:36.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Karthigaiselvam-R-official/AsusTufFanControl_Linux","commit_stats":null,"previous_names":["karthigaiselvam-r-official/asustuffancontrol_linux"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/Karthigaiselvam-R-official/AsusTufFanControl_Linux","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Karthigaiselvam-R-official%2FAsusTufFanControl_Linux","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Karthigaiselvam-R-official%2FAsusTufFanControl_Linux/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Karthigaiselvam-R-official%2FAsusTufFanControl_Linux/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Karthigaiselvam-R-official%2FAsusTufFanControl_Linux/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Karthigaiselvam-R-official","download_url":"https://codeload.github.com/Karthigaiselvam-R-official/AsusTufFanControl_Linux/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Karthigaiselvam-R-official%2FAsusTufFanControl_Linux/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28206344,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2026-01-04T02:00:06.065Z","response_time":58,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["asus","aura-sync","battery-management","cpp","fan-control","linux","qml","qt","rgb-control","rog","system-monitor","tuf-controller","tuf-gaming"],"created_at":"2026-01-03T16:12:29.104Z","updated_at":"2026-01-04T17:01:28.295Z","avatar_url":"https://github.com/Karthigaiselvam-R-official.png","language":"QML","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# 🎮 ASUS TUF Fan Control\n\n\n\n![Platform](https://img.shields.io/badge/Platform-Linux-FCC624?style=for-the-badge\u0026logo=linux\u0026logoColor=black)\n![Language](https://img.shields.io/badge/C++-00599C?style=for-the-badge\u0026logo=c%2B%2B\u0026logoColor=white)\n![Framework](https://img.shields.io/badge/Qt6-41CD52?style=for-the-badge\u0026logo=qt\u0026logoColor=white)\n![Build](https://img.shields.io/badge/CMake-064F8C?style=for-the-badge\u0026logo=cmake\u0026logoColor=white)\n![License](https://img.shields.io/badge/License-GPLv3-blue?style=for-the-badge)\n![Translations](https://img.shields.io/badge/Translations-22_Languages-orange?style=for-the-badge\u0026logo=google-translate\u0026logoColor=white)\n\n**A powerful system control utility for ASUS Gaming Laptops on Linux**\n\n*Open-source alternative to Armoury Crate \u0026 G-Helper*\n\n\u003c/div\u003e\n\n---\n\n## 📸 Screenshots\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cimg src=\"resources/SystemInfo.png\" width=\"400\" alt=\"Dashboard\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"resources/FanControl.png\" width=\"400\" alt=\"Fan Control\"\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003cb\u003eSystem Dashboard\u003c/b\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003cb\u003eFan Control\u003c/b\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cimg src=\"resources/AuraSync.png\" width=\"400\" alt=\"Aura Sync\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"resources/BatteryManagement.png\" width=\"400\" alt=\"Battery\"\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\u003cb\u003eAura Sync RGB\u003c/b\u003e\u003c/td\u003e\n    \u003ctd align=\"center\"\u003e\u003cb\u003eBattery Management\u003c/b\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## ✨ Features\n\n### 🌀 Fan Control\n- Real-time RPM monitoring for CPU \u0026 GPU fans\n- **Manual Mode:** Silent / Balanced / Turbo performance modes\n- **Auto Fan Curve:** Temperature-based automatic mode switching\n- Visual animated fan indicators\n- Automatic thermal management via ACPI/WMI\n\n### 🎛️ Auto Fan Curve (NEW)\nIntelligent temperature-based fan management that automatically switches between modes:\n\n| Mode | Condition | Use Case |\n|------|-----------|----------|\n| **Silent** | CPU \u003c Silent Threshold | Light tasks, quiet environment |\n| **Balanced** | Between thresholds | Normal usage, web browsing |\n| **Turbo** | CPU \u003e Turbo Threshold | Gaming, heavy workloads |\n\n**Built-in Presets:**\n- 🎮 **Gaming** – Silent ≤40°C, Turbo ≥60°C (aggressive cooling)\n- ⚖️ **Balanced** – Silent ≤50°C, Turbo ≥70°C (default)\n- 🔇 **Quiet** – Silent ≤65°C, Turbo ≥80°C (prioritize silence)\n- 🚀 **Performance** – Silent ≤35°C, Turbo ≥50°C (max cooling)\n\n### 🔋 Battery Health\n- Charge limiting (60% / 80% / 100%) to extend battery lifespan\n- Real-time charging status\n- Persistent settings across reboots\n\n### 💡 Aura Sync RGB\n- Keyboard backlight control\n- Multiple effects: Static, Breathing, Strobing, Rainbow\n- Custom color picker\n- Brightness adjustment\n\n### 📊 System Dashboard\n- CPU/GPU temperature \u0026 utilization\n- Memory and disk usage\n- Network activity monitoring\n- MTP device detection (Android phones, cameras)\n\n### 🎨 Premium UI\n- Modern glassmorphic design\n- Dark / Light mode support\n- Responsive sidebar navigation\n- Built with Qt6/QML\n\n### 🌍 Global Language Support\n- Fully translated into **22 languages** including:\n  **Tamil**, Bengali, Spanish, French, German, Chinese, Japanese, Korean, Russian, Portuguese, Italian, Arabic, Turkish, Hindi, and more.\n- Automatic system language detection\n- Right-to-Left (RTL) layout support (Arabic, Farsi, Urdu)\n\n---\n\n## �️ Supported Hardware\n\n| Series | Models |\n|--------|--------|\n| **TUF Gaming** | F15, F17, A15, A17, Dash F15 |\n| **ROG Strix** | G15, G17, Scar 15, Scar 17, G512, G513, G531, G713, G733 |\n| **ROG Zephyrus** | G14, G15, M15, M16 |\n| **ROG Flow** | X13, X16, Z13 |\n\n### ✅ Tested Distributions\nUbuntu • Fedora • Arch Linux • Kali Linux • Manjaro • Pop!_OS\n\n---\n\n## 📋 Prerequisites\n\n| Requirement | Details |\n|-------------|---------|\n| **OS** | Linux (Kernel 5.4+) |\n| **Hardware** | ASUS TUF / ROG / Strix Gaming Laptop |\n| **Modules** | `asus_wmi`, `asus_nb_wmi` (auto-loaded) |\n| **Dependencies** | Qt6, CMake, GCC |\n\n---\n\n## 📥 Installation\n\n### 1️⃣ Clone the Repository\n```bash\ngit clone https://github.com/Karthigaiselvam-R-official/AsusTufFanControl_Linux.git\ncd AsusTufFanControl_Linux\n```\n\n### 2️⃣ Run Setup Script\n```bash\nchmod +x setup.sh\nsudo ./setup.sh\n```\n\u003e This installs dependencies, builds `ec_probe`, configures polkit, and sets up desktop integration.\n\n### 3️⃣ Build the Application\n```bash\nmkdir build \u0026\u0026 cd build\ncmake .. \n# (This automatically runs patch_translations.py to ensure all languages are up to date)\nmake -j$(nproc)\n```\n\n### 4️⃣ Install the Binary\n```bash\nsudo cp ./AsusTufFanControl_Linux /opt/asus-tuf-fan-control/\n```\n\n---\n\n## ▶️ Running the Application\n\n### 🖱️ Desktop (Recommended)\nLaunch **\"ASUS TUF Fan Control\"** from your Applications menu.\nA password prompt will appear, then the app runs with elevated privileges.\n\n### 💻 Terminal\n```bash\nsudo /opt/asus-tuf-fan-control/AsusTufFanControl_Linux\n```\n\n\u003e **Note:** Root privileges are required for EC/ACPI hardware access.\n\n---\n\n## 🔧 How It Works\n\n```\n┌─────────────────────────────────────────────────────┐\n│                    Application                       │\n├─────────────────────────────────────────────────────┤\n│  Qt6/QML UI  →  C++ Backend  →  Hardware Control    │\n└─────────────────────────────────────────────────────┘\n                         │\n         ┌───────────────┼───────────────┐\n         ▼               ▼               ▼\n    ┌─────────┐    ┌──────────┐    ┌──────────┐\n    │  ACPI   │    │   WMI    │    │    EC    │\n    │  Call   │    │  Sysfs   │    │  Probe   │\n    └─────────┘    └──────────┘    └──────────┘\n         │               │               │\n         └───────────────┴───────────────┘\n                         │\n                   Hardware Layer\n            (Fans, Battery, RGB, Sensors)\n```\n\n**Fallback Chain:** ACPI → WMI Thermal Policy → WMI PWM → EC Probe\n\n---\n\n## ⚠️ Disclaimer\n\n\u003e **Use at your own risk.**\n\nThis tool manipulates low-level system hardware (Embedded Controller and ACPI methods).\n\n- Improper fan settings could lead to overheating\n- The authors are not responsible for any hardware damage\n- Always monitor temperatures when adjusting fan curves\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome!\n\n1. Fork the project\n2. Create your feature branch: `git checkout -b feature/AmazingFeature`\n3. Commit your changes: `git commit -m 'Add some AmazingFeature'`\n4. Push to the branch: `git push origin feature/AmazingFeature`\n5. Open a Pull Request\n\n---\n\n## 👤 Author\n\n**Karthigaiselvam R**\n\n[![Email](https://img.shields.io/badge/Email-karthigaiselvamr.cs2022%40gmail.com-red?style=flat-square\u0026logo=gmail)](mailto:karthigaiselvamr.cs2022@gmail.com)\n[![LinkedIn](https://img.shields.io/badge/LinkedIn-Karthigaiselvam_R-blue?style=flat-square\u0026logo=linkedin)](https://www.linkedin.com/in/karthigaiselvam-r-7b9197258/)\n\n---\n\n## 📄 License\n\n**Source Available License:** Commons Clause + GNU General Public License v3.0\n\n| ✅ Allowed | 🚫 Not Allowed |\n|------------|----------------|\n| Use freely | Sell the software |\n| Modify code | Commercial services |\n| Share code | Paid distribution |\n\nSee [LICENSE](LICENSE) for full text.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**If you find this project useful, please ⭐ star the repository!**\n\nMade with ❤️ for the ASUS Linux Community\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkarthigaiselvam-r-official%2Fasustuffancontrol_linux","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkarthigaiselvam-r-official%2Fasustuffancontrol_linux","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkarthigaiselvam-r-official%2Fasustuffancontrol_linux/lists"}