Skip to content
GNOME Shell extension that adds an applet to the main panel, which shows current CPU(s) frequency.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


What is CPU Frequency?

CPU Frequency is a GNOME Shell extension that adds an applet to the main panel, which shows current CPU(s) frequency.

What it looks like?

Everybody loves screenshots, right?

CPU Frequency

CPU Frequency with menu

CPU Frequency without desaturating


As I couldn't find any real documentation for writing gnome-shell extensions, I based my code on better or worse snippets and tutorials found on internet. Some of the sources are mentioned below:

How it works?

The extension scans /sys/devices/system/cpu[0-9]+/cpufreq directories to find information about available and current CPU frequencies and presents it graphically.


The directory should be copied to /usr/share/gnome-shell/extensions or ~/.local/share/gnome-shell/extensions/:

# cp cpufreq\ /usr/share/gnome-shell/extensions


$ cp cpufreq\ ~/.local/share/gnome-shell/extensions/

Please do not forget to enable the newly installed extension using for example gnome-tweak-tool.

If you don't want icons to be desaturated, you can edit file and change DESATURATE to false:

const DESATURATE = false;


The cpu icons are borrowed from GNOME 2.x applet named cpufreq. The icons are included in GNOME repository, so I assume the original author has nothing against using them in this project. If it's not true, please someone let me know.


Copyright 2011 Aleksander Zdyb

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see

You can’t perform that action at this time.