sunnyyang/corefreq

Description

This repository provides a Fedora package for CoreFreq, a powerful, low-level CPU monitoring and tuning software for modern x86_64 processors. It provides detailed, real-time information about CPU frequency, power usage, temperatures, sleep states, and performance counters, with features that resemble those found in a system BIOS.

This package is built to be robust and user-friendly for Fedora users.

Package Features:

• corefreqd: The background daemon that collects CPU data.
• corefreq-cli: A terminal-based user interface to view the data in real-time.
• DKMS Kernel Module: The corefreqk kernel module is packaged for DKMS (Dynamic Kernel Module Support). This means it will be automatically rebuilt for any new kernel you install via dnf update, ensuring it always works without manual intervention.
• Secure Boot Helper: The package includes a user-friendly guide that appears after installation if it detects that Secure Boot has blocked the module from loading. This makes the one-time key enrollment process simple.

Source, Credits, and Contact

This package is a community effort to bring the CoreFreq software to Fedora users in a seamless way.

• Original Application (CoreFreq): All credit for the application itself goes to the original developer, cyring.

  • Official Project Source: https://github.com/cyring/CoreFreq

• Fedora RPM Packaging: This Copr repository and the RPM spec file used to build the package are maintained by Sunny Yang. The packaging source is available for review, contribution, or for anyone interested in learning how it works.

  • Packaging Repository: https://github.com/sunnyyangyangyang/coreFreq-rpm-fedora
  • Contact the Packager: yxh9956@gmail.com

Installation Instructions

1. Enable the Copr Repository

First, enable this Copr repository on your Fedora system.

sudo dnf copr enable sunnyyang/corefreq

2. Install CoreFreq

Next, install the package. DNF will pull in all necessary dependencies like dkms, kernel-devel, gcc, and make.

sudo dnf install corefreq

After you approve the installation, the package's scripts will automatically build the corefreqk kernel module for your current kernel and start the corefreqd service.

3. First-Time Setup for Secure Boot Users

If you have Secure Boot enabled, the installation will succeed, but the kernel module will not load until you approve its signing key. This is a standard, one-time security procedure for any third-party kernel module.

If this is required, you will see a message like this in your terminal after installation:

------------------------------------------------------------------
ATTENTION: SECURE BOOT
The CoreFreq kernel module was built but Secure Boot prevented it from loading.
To enroll the DKMS signing key, please run the following command and then reboot:
sudo mokutil --import /var/lib/dkms/mok.pub
You will be prompted to create a password for the MOK enrollment.
------------------------------------------------------------------

To approve the key, follow these steps:

1. Run the command provided: sudo mokutil --import /var/lib/dkms/mok.pub (You will be asked to create a simple, temporary password. You will only use it once.)
2. Reboot your computer.
3. During boot, a blue screen titled MOK Manager will appear. Select "Enroll MOK".
4. Select "Continue" and then "Yes" when asked to enroll the key.
5. Enter the password you created in step 1.
6. Select "Reboot".

After the reboot, your system will trust the key, and the corefreqk module will load automatically.

4. Usage

Once the service is running, you can view the CPU data by running the command-line interface:

corefreq-cli

5. Uninstallation

To completely remove the package, the service, the kernel module, and all related configurations, simply run:

sudo dnf remove corefreq

Active Releases

The following unofficial repositories are provided as-is by owner of this project. Contact the owner directly for bugs or issues (IE: not bugzilla).

Release	Architectures	Repo Download
Fedora 41	x86_64 (0)*	Fedora 41 (3 downloads)
Fedora 42	x86_64 (37)*	Fedora 42 (26 downloads)
Fedora 43	x86_64 (0)*	Fedora 43 (0 downloads)
Fedora rawhide	x86_64 (0)*	Fedora rawhide (1 downloads)

* Total number of downloaded packages.