From ArchWiki
Jump to: navigation, search


Trayfreq (pronounced tray-freek) is a GTK+ application released under GPL that lets you select your CPU's governor or frequency from a tray icon and displays information for your battery. Trayfreq is designed to be desktop-environment-independent so it depends only on GTK+ and a system tray to show its icons. Trayfreq is the perfect addition to Xfce, LXDE, and Window Managers (Openbox, Fluxbox, etc.).

Warning: Package in AUR might not work with post 3.0.4 kernels. See recent comments.

Latest Version



  • Displays a icon that shows you the relative current CPU frequency
  • When the CPU icon is right-clicked, it provides a menu of available frequencies and governors to choose.
  • When the CPU icon is left-clicked, it runs a command (set in config file, default nothing)
  • Displays a icon that shows you the status of your Battery (Charging, Discharging, Charged) and its relative current charge (optional)
  • Toggling of CPU governor based on if the battery is discharging or not.
  • Lightweight, Desktop-Environment Independent


Install trayfreq from the AUR. AUR Helpers are available.

System Setup

For Trayfreq to work, you will need the appropriate kernel modules loaded and added to your rc.conf. See CPU Frequency Scaling for instructions on loading cpufreq drivers and governors.

Trayfreq Setup

Now, let's edit the configuration file for trayfreq.

$ cp /usr/share/trayfreq/trayfreq.config ~/.trayfreq.config
$ nano ~/.trayfreq.config

Everything will be commented out; uncomment what you want to use. Let's go through the options

  • [battery] – the group battery
    • show=1 – 1 to show the battery tray icon, 0 to not show it
    • governor=powersave – this sets the governor to use if the battery is discharging
  • [ac] – the group for if the batter is not discharging
    • governor=ondemand – this sets the governor to use if the battery is not discharging
  • [events] – the group events
    • activate=/usr/bin/xterm – this sets the program to launch when the tray icon is activated (left clicked usually)
  • [governor] – the group governor
    • default=ondemand – this sets the default governor to be set when trayfreq starts
  • [frequency] – the group frequency
    • default=800000 – this sets the default frequency in hertz to be set when trayfreq starts

Note that, if a default frequency is set, it will override the governor.

Sample File:


If you want, you can have a configuration file in your home folder, but it can now set the program to run when the tray icon is activated too. The file should be ~/.trayfreq.config; if it exists, trayfreq will not look at /usr/share/trayfreq/trayfreq.config.


A desktop file is installed into /etc/xdg/autostart/. It will automatically start once installed. If you do not want it to start automatically, open the start up manager that comes with your desktop enviroment and uncheck trayfreq.

External Links