# Trayfreq-archlinux

Trayfreq-archlinux (trayfreq is pronounced like 'tray freak') is a Gtk3 application released under the GPL that lets you select your cores' governor or frequency from a tray icon and displays information about your battery pictorially. Trayfreq-archlinux is designed to be desktop-environment-independent so it depends only on Gtk3, a system tray and sudo. It's the perfect addition to Xfce, LXDE, and Window Managers (Openbox, Fluxbox, etc.).

## Short history

The original version was abandoned at 0.2.x.dev1-3 (sometime during 2009) and eventually failed as `/proc/acpi/` became deprecated. The original project was forked and named trayfreq-archlinux with the aim of bringing trayfreq back into functionality.

## Features

- Displays an icon that shows you the current CPU frequency as a proportion of the maximum
- When the CPU icon is right-clicked, it provides a menu of available frequencies and governors to choose.
- (Optional) Displays a icon that shows you the status of your battery (charging, discharging, charged) and its current charge
- Automatic switching of CPU governor based on AC adapter presence
- Configuration can be reloaded on-the-fly by sending the `USR1` signal
- Very lightweight and desktop-environment-independent

## Installation

Install trayfreq-archlinux from the AUR. Then optionally edit the configuration file. If you want to have per-user configuration, then create a trayfreq.conf in your home directory:

    $ cp /etc/trayfreq.conf ~/.trayfreq.conf

Without this, what you change in the next step will be system-wide – it's your choice.

Open the appropriate config file (`/etc/trayfreq.conf` or `~/.trayfreq.conf`) with your favourite editor. Everything will be commented out; uncomment what you want to use. Note that, if a default frequency is set, it will override the governor.

## Troubleshooting and tips

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.

If trayfreq doesn't seem to want to change the governor, it’ll be because it's detected that it's not running as root and has tried to use sudo to elevate its privelliges. However, it requires that it has passwordless access to run `/usr/bin/trayfreq-set`. If you have sudo configured such that you type your password to authenticate, you'll need to add this line to `/etc/sudoers`:

    your_user_name ALL = NOPASSWD: /usr/bin/trayfreq-set

## See also

- Trayfreq-archlinux upstream website
- Trayfreq-archlinux source (don't assume this is stable!)
- Original Trayfreq Website

Categories:

- Power management
- CPU