/fancontrol-coolerpad

Gnome extension to assist automatic cooling of your laptop using a coolong pad

Primary LanguageJavaScript

  1. Definition
  2. Dependencies
  3. Environment
  4. Manual
    1. Uhubctl
    2. How to set it up
    3. First settings
    4. Different modes
  5. Upcoming features

1. Definition

fancontrol@coolerpad.org is a gnome extension that automates cooling of your laptop through a cooling pad so you can concentrate on your work. It works by turning a designated USB port on/off depending on fan speed/temperature reaching the threshold.

2. Dependencies

Please make sure to install the following linux package:

NOTE: Instructions found in the link above. Ensure you can turn your targeted USB port on/off using the package above.

3. Environment

  • Ubuntu Canonical 20.04.
  • Gnome 3.36.9 as tested.

Run the command below to find your Gnome version

> gnome-shell --version
  • Uhubctl - 2.4.0-30-g6f1c71d5 as tested.

4. Manual

4.1 Uhubctl

Refer to section 2 above to make sure Uhubctl is working properly as the extension depends on this.

4.2 How to set it up

  • Clone this repo into your local folder.
  • Copy the fancontrol@coolerpad.org folder into ~/.local/share/gnome-shell/extensions folder.
  • Press Alt + F2 to refresh all extensions.
  • Fan will appear on the extension bar with the icon:

NOTE: On/Off/Auto options will be greyed out until you set the settings as in the next section below.

4.3 First settings

  • Open extension menu, click "Preferences" option.
  • Settings window will appear as in the picture referenced.
  • Take note of the "Hub" and "Port" inputs in the picture above, set these from your Uhubctl instructions.
  • Customize your update time, fan speed and GPU temperature threshold settings.
  • Click on "Save settings" button at the bottom.
  • Navigate back to extension menu and set your preferred mode.

4.4 Different modes

  • On - turns on USB port power to target port.
  • Off - turn off USB port power.
  • Auto - monitors GPU temperature and Fan speed threshold to switch USB port power.

5. Upcoming features

5.1 Temp range mode ✅ (v1.1)

Sets a lower and upper boundary of temperature where if it reaches the higher boundary, the USB port power is switched on. When cooled till it has reached the lower boundary, it's switched off.

Picture references

1. Preferences option

2. Preferences window

3. Modes