<h1 align="center">CPU Power Manager for Gnome Shell</h1> <p align="center"> <img alt="Screenshot" width="331" src="./img/header.png"/>  <br> <a href="https://github.com/deinstapel/cpupower/actions?query=workflow%3A%22latest%20build%22"> <img src="https://github.com/deinstapel/cpupower/workflows/latest%20build/badge.svg" alt="latest build"> </a> <a href="https://github.com/deinstapel/cpupower/actions?query=workflow%3A%22release%20build%22"> <img src="https://github.com/deinstapel/cpupower/workflows/release%20build/badge.svg" alt="release build"> </a> <a href="https://github.com/deinstapel/cpupower/releases"> <img alt="Lastest release" src="https://img.shields.io/github/v/release/deinstapel/cpupower?label=latest%20release&sort=semver"> </a> <img alt="Gnome 42" src="https://img.shields.io/badge/gnome-42-blue?logo=gnome&logoColor=white"> <a href="https://github.com/deinstapel/cpupower/blob/master/LICENSE"> <img alt="License" src="https://img.shields.io/github/license/deinstapel/cpupower.svg"> </a> <a title="Crowdin" target="_blank" href="https://crowdin.com/project/cpupower"> <img src="https://badges.crowdin.net/cpupower/localized.svg"> </a> <a href="http://makeapullrequest.com"> <img alt="PRs Welcome" src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg" target="_blank" /> </a> <br> <i>Gnome-Shell Extension for controlling the frequency setting of your CPU</i> <br><br> <a href="#prerequisites">Prerequisites</a> • <a href="#installation">Installation</a> • <a href="#translating">Translating</a> • <a href="#packaging">Packaging</a> • <a href="#developing">Developing</a> </p>

Prerequisites

You need to have a CPU which is supported by the cpufreq or intel_pstate CPU frequency scaling driver of the Linux kernel. This applies for most modern CPU's. Furthermore, the following software needs to be installed to use this extension:

Gnome (since it's an extension)
Policykit (ships default with gnome)
For Intel Core CPU's intel_pstate needs to be enabled in the Linux kernel (should be the default in almost all Distros)
For AMD Ryzen CPU's no further requirements are needed
A POSIX compatible shell

Installation

Installing this extension can either be done via distribution packages provided by us (recommended) or via the Gnome extensions website (often outdated). Have a look at the options below to find the correct installation method for your system.

Info: The $ at the beginning of a line means that this line should be run as the user who is using the extension (most likely you). If you don't know what that means, just open up a terminal and use it as is. Commands are run as your user by default. So for the line $ echo Hello world you would type echo Hello world into your terminal and hit enter.

Info: The # at the beginning of a line means that this line must be run with root privileges (the name of the administrator account on Linux systems). So for the line # dnf update you would then e.g. run sudo dnf update in your terminal if your system uses sudo. Your system is most likely using sudo and if not you would know it.

<details> <summary><code>click to expand</code> <h3>Any newer Ubuntu release or Ubuntu based distribution. <i>If unsure do this!</i></h3></summary>

To install the extension on any newer Ubuntu based system (e.g. PopOS) run the below commands.

WARNING: This will not work for ElementaryOS, Linux Mint, and any other Ubuntu which is not using the GNOME desktop environment. Running the below commands will likely break your system otherwise!

Info: It is safe to install this extension if only a single package is installed by the below apt-get install command. If more packages are to be installed, please stop doing so and if unsure create an issue asking for help!

$ sudo add-apt-repository ppa:fin1ger/cpupower
$ sudo apt-get update
$ sudo apt-get install gnome-shell-extension-cpupower

Now log out and back in again. Yes, this is really necessary thanks to Gnome. After logging back in, enable the extension with:

$ gnome-extensions enable cpupower@mko-sl.de

The extension should now be enabled and ready to use!

</details>

<details> <summary><code>click to expand</code> <h3>Ubuntu 18.04 (Bionic Beaver)</h3></summary>

To install this extension on Ubuntu Bionic Beaver please run the following commands:

$ sudo add-apt-repository ppa:fin1ger/cpupower
$ sudo apt-get update
$ sudo apt-get install gnome-shell-extension-cpupower

Now log out and back in again. Yes, this is really necessary thanks to Gnome. After logging back in, enable the extension with:

$ gnome-shell-extension-tool -e cpupower@mko-sl.de

The extension should now be enabled and ready to use!

</details>

<details> <summary><code>click to expand</code> <h3>Debian or debian based distributions</h3></summary>

To install the extension on any newer Debian based system run the below commands.

WARNING: This will not work when using any desktop environment other than GNOME. Running the below commands while using other desktop environments will likely break your system!

Info: It is safe to install this extension if only a single package is installed by the below apt-get install command. If more packages are to be installed, please stop doing so and if unsure create an issue asking for help!

# apt-key adv --keyserver keyserver.ubuntu.com --recv-keys D76A018A2B4E77F5
# add-apt-repository 'deb http://ppa.launchpad.net/fin1ger/cpupower/ubuntu hirsute main'
# apt-get update
# apt-get install gnome-shell-extension-cpupower

Note: Debian is not using sudo by default. If you do not have sudo, get a root shell by typing su in a terminal and entering your superuser password.

Now log out and back in again. Yes, this is really necessary thanks to Gnome. After logging back in, enable the extension with:

$ gnome-extensions enable cpupower@mko-sl.de

The extension should now be enabled and ready to use!

</details>

<details> <summary><code>click to expand</code> <h3>Fedora / CentOS / Mageia / OpenMandriva</h3></summary>

To install this extension on most RPM based Linux distributions run the below commands.

WARNING: This will not work when using any desktop environment other than GNOME. Running the below commands while using other desktop environments will likely break your system!

Info: It is safe to install this extension if only a single package is installed by the below dnf install command. If more packages are to be installed, please stop doing so and if unsure create an issue asking for help!

# dnf copr enable fin-ger/cpupower
# dnf install gnome-shell-extension-cpupower

You need to have the package dnf-plugins-core installed. If the above commands are failing try installing them with dnf install dnf-plugins-core and rerun the above commands.

Caution: Due to a name change required by the Fedora admins of my Fedora account, the name of the copr also changed. fin_ger/cpupower has changed to fin-ger/cpupower.

Now log out and back in again. Yes, this is really necessary thanks to Gnome. After logging back in, enable the extension with:

$ gnome-extensions enable cpupower@mko-sl.de

The extension should now be enabled and ready to use!

</details>

<details> <summary><code>click to expand</code> <h3>OpenSUSE</h3></summary>

Download the appropriate .repo file for your OpenSUSE release (most likely the latest version) and save it to /etc/zypp/repos.d/. Now run the following commands:

# zypper install gnome-shell-extension-cpupower

Now log out and back in again. Yes, this is really necessary thanks to Gnome. After logging back in, enable the extension with:

$ gnome-extensions enable cpupower@mko-sl.de

The extension should now be enabled and ready to use!

</details>

<details> <summary><code>click to expand</code> <h3>Install via the Gnome extension website (probably outdated)</h3></summary>

Open the cpupower Gnome extensions website in your default webbrowser. Click on the blue slider to install the extension.

After installation, click on the CPU icon in the top bar of your Gnome shell and follow the instructions. You need to enter your root password to install a policy kit rule. This rule is used to set the clock frequency of your CPU.

You are now ready to use this extension!

</details>

<details> <summary><code>click to expand</code> <h3>Your distribution is not listed?</h3></summary>

Fear not! We have other options for installing this extension. Although, you will not receive automatic updates which might be dangerous if we encounter security issues in the extension and you miss the fix for that issue. If you regularly check for updates yourself you can of course still use this extension without any risk.

If your distribution is capable of installing DEB or RPM packages, have a look at the releases page of this repository for downloadable pre-built packages.

Another option is to install the extension zip file manually. To do so, download the latest zip from the release page. Now run the following commands:

$ gnome-extensions install /path/to/cpupower.zip

Now log out

Cpupower

Install / Use

README

Prerequisites

Installation