Skip to content

asaadhajtaleb/ThrottleFixGUI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ThrottleFixGUI Banner

⚠️ Important Warning & Disclaimer

System Privileges: This application requires root (sudo) privileges to function. It directly modifies sensitive system files, hardware power states, kernel modules, and boot images (initramfs/mkinitcpio) to take control of your CPU, GPU, and Fans.

Disclaimer of Liability: This software is provided "AS IS", without warranty of any kind, express or implied. By using this application, you acknowledge that altering factory thermal and power limits can be dangerous. The author is NOT responsible for any system instability, kernel panics, data loss, overheating, hardware damage, or bricked devices. Proceed and use entirely at your own risk.

Who is this app for?

This application is built exclusively for Linux users. It is highly recommended if you face any of the following issues:

  • Your CPU is stuck at 800MHz (BD PROCHOT): Perfect for laptops that severely throttle CPU speed down to 800MHz. This frustrating issue is often triggered by a dead/removed battery, an underpowered or unrecognized charger, or faulty motherboard thermal sensors. This app bypasses these false hardware flags, unlocks the strict power limits, and restores your CPU to its some, or near-full, or full performance.
  • You want to maximize battery life: Even if your laptop is healthy, you can use this app to turn off the dedicated graphics card with a single click. This drastically lowers power consumption during daily tasks.
  • Your laptop shuts down without a battery: If you are using the laptop without a battery, the charger might not provide enough power for both the CPU and GPU. Disabling the dedicated GPU frees up the system's power budget (wattage), allowing the CPU to boost safely without instantly shutting down the device.
  • You want manual Fan Control (Intel Macs ONLY): Easily adjust your Apple hardware's fan speeds to prevent overheating during heavy workloads. (Note: This feature is exclusively designed for Apple hardware).

🛠️ Dependencies

To ensure all features work correctly, the following packages are required:

  • python3: The core logic engine.
  • python3-gi: For rendering the GTK graphical interface.
  • cpupower: Required for CPU frequency management.
  • msr-tools: Required for unlocking CPU power registers via wrmsr.

🚀 Installation

You can install the app using either Git or by downloading the script directly.

Method 1: Using Git

Open your terminal and run these commands one by one:

git clone https://github.com/asaadhajtaleb/ThrottleFixGUI.git
cd ThrottleFixGUI
chmod +x install.sh
sudo ./install.sh

Method 2: Direct Script Download

If you don't have git installed, you can download and run the installer directly using wget:

wget https://raw.githubusercontent.com/asaadhajtaleb/ThrottleFixGUI/main/install.sh
chmod +x install.sh
sudo ./install.sh

💻 Usage

After installation, you can launch ThrottleFixGUI directly from your application menu.

📸 Screenshot

Screenshot

🤝 Contributing & Support

Found a bug or have a feature request?

  • Issues: Please report them in the Issues section.
  • Contributions: Pull requests are welcome! Let's make this tool better together.
  • Connect: Feel free to reach out on LinkedIn.

About

Universal Linux Thermal & Power Control for Intel MacBooks and Linux Laptops.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages