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.).

−

Trayfreq (pronounced trayfreek) is a GTK+ application released under GPL that lets you select your CPU's governor or frequency from a tray icon; therefore, trayfreq only depends GTK+ and something that shows tray icons.

+

{{Warning| Package in AUR might not work with post 3.0.4 kernels. See recent comments. }}

−

== Installing ==

+

=== Latest Version ===

+

0.2.x.dev1-3

−

Install [http://aur.archlinux.org/packages.php?ID=26999 trayfreq from the AUR]. I suggest using one of the [[AUR Helpers]].

+

=== Features ===

+

* 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

−

== System Setup ==

+

== Installation ==

+

Install [https://aur.archlinux.org/packages.php?ID=26999 trayfreq] from the [[AUR]]. [[AUR Helpers]] are available.

−

CPU scaling requires you to have a kernel with the ability already built in or have an appropriate driver module loaded. If the former case represents you, then you do not have to worry. If the latter case represents you, follow the following steps:

+

=== 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.

−

Most modern computers use the module acpi-cpufreq. Other options include the p4-clockmod, powernow-k6, powernow-k7, powernow-k8, and speedstep-centrino drivers.

+

=== Trayfreq Setup ===

−

+

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

−

To load the driver:

+

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

−

# modprobe acpi-cpufreq

+

$ nano ~/.trayfreq.config

−

+

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

−

To load the driver automatically at startup add the module to /etc/rc.conf

+

*{{Ic|[battery]}} &ndash; the group battery

−

# MODULES=( ... acpi-cpufreq ... )

+

**{{Ic|show&#61;1}} &ndash; 1 to show the battery tray icon, 0 to not show it

+

**{{Ic|governor&#61;powersave}} &ndash; this sets the governor to use if the battery is discharging

+

*{{Ic|[ac]}} &ndash; the group for if the batter is not discharging

+

**{{Ic|governor&#61;ondemand}} &ndash; this sets the governor to use if the battery is not discharging

+

*{{Ic|[events]}} &ndash; the group events

+

**{{Ic|activate&#61;/usr/bin/xterm}} &ndash; this sets the program to launch when the tray icon is activated (left clicked usually)

+

*{{Ic|[governor]}} &ndash; the group governor

+

**{{Ic|default&#61;ondemand}} &ndash; this sets the default governor to be set when trayfreq starts

+

*{{Ic|[frequency]}} &ndash; the group frequency

+

**{{Ic|default&#61;800000}} &ndash; 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.

−

== CPU Governors Setup ==

+

Sample File:

−

Some CPU governors may not be built into your kernel, and you can add them to /etc/rc.conf to have them automatically load at startup. Again, edit /etc/rc.conf to load the governors' drivers.

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 {{ic|~/.trayfreq.config}}; if it exists, trayfreq will not look at {{ic|/usr/share/trayfreq/trayfreq.config}}.

−

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

+

== Remarks ==

−

# nano /usr/share/trayfreq/trayfreq.config

+

A desktop file is installed into {{ic|/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.

−

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

−

*[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 overide the governor. Setting a frequency sets the maximum frequency and sets the governor to performance.

−

If you want, you can have a configuration file in your home folder, but it cannot set the program to run when the tray icon is activated for security reasons. The file should be ~/.trayfreq.config; if it exists, trayfreq will still look at /usr/share/trayfreq/trayfreq.config for the program to run when the tray icon is activated, but the configuration file in the home folder will override everything else.

+

== External Links ==

+

*[http://trayfreq.sourceforge.net Trayfreq's Website]

Revision as of 13:52, 15 December 2012

Contents

Introduction

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

0.2.x.dev1-3

Features

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.

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.

Remarks

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.