auto-cpufreq for Debian
======================

Unlike the upstream project, this package does not ship the auto-cpufreq
self-installer (scripts/auto-cpufreq-install.sh). The daemon is managed
through the systemd unit that ships with the package.

To enable and start the daemon (persistent, automatic CPU optimizations):

    sudo systemctl enable --now auto-cpufreq

or, equivalently, via the bundled CLI wrapper:

    sudo auto-cpufreq --enable

In the GTK application (auto-cpufreq-gtk), the "Enable Daemon" button does
the same thing: it asks for your password through polkit and then enables and
starts the service. The menu entry "Disable Daemon" stops and disables it.

To stop and disable it:

    sudo systemctl disable --now auto-cpufreq
    sudo auto-cpufreq --disable

Note: the upstream --install / --remove options have been renamed to
--enable / --disable in this package, because the original options invoked
the upstream installer which is incompatible with dpkg.

Conflicting power management daemons
------------------------------------

auto-cpufreq controls the CPU scaling governor itself. Other power
management daemons also set the governor, and running more than one of
them means they continuously overwrite each other's settings, resulting
in unpredictable CPU frequencies.

This applies to:

  * power-profiles-daemon (installed by default on GNOME)
  * tlp
  * tuned

If you want auto-cpufreq to have sole control of the governor, disable
and mask the others, for example:

    sudo systemctl disable --now power-profiles-daemon
    sudo systemctl mask power-profiles-daemon

To switch back:

    sudo systemctl unmask power-profiles-daemon
    sudo systemctl enable --now power-profiles-daemon

This package intentionally does NOT mask power-profiles-daemon for you:
silently disabling another package's service is not appropriate for a
Debian package. The decision is left to the system administrator.