sunnyyang/corefreq

Project ID: 188745

Description

This repository provides a Fedora package for CoreFreq, a powerful, low-level CPU monitoring software for modern x86_64 processors. It provides detailed, real-time information about CPU frequency, power usage, temperatures, sleep states, and performance counters.

This package is built using the akmod framework to be robust and user-friendly, integrating seamlessly with Fedora's kernel update process.

Package Features:

corefreqd: The background daemon that collects CPU data.
corefreq-cli: A terminal-based user interface to view the data in real-time.
akmod Kernel Module: The corefreqk kernel module is built using Fedora's akmod standard. This means it will be automatically and reliably rebuilt for any new kernel you install via dnf update, ensuring it works across system updates without manual intervention.
Smart Secure Boot Helper: The package includes an intelligent script that runs after installation. It detects if you are using Secure Boot, checks if the signing key is already enrolled, and provides clear, context-aware instructions to guide you through the one-time key enrollment process if needed.

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 are maintained by Sunny Yang. The packaging source is available for review and contribution.
- 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 automatically pull in all necessary dependencies.

sudo dnf install corefreq

After you approve the installation, the akmod system will begin compiling the corefreqk kernel module in the background. The corefreqd service will start automatically once the module is ready (usually within a minute).

3. First-Time Setup for Secure Boot Users

If you have Secure Boot enabled, the kernel module will be built and signed, but it cannot load until you enroll the akmod signing key. This is a standard, one-time security procedure for any third-party kernel module.

The package's smart script will detect this and show a helpful message in your terminal:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🔐 SECURE BOOT DETECTED - MOK ENROLLMENT REQUIRED
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
To use CoreFreq with Secure Boot, enroll the akmods signing key:

  sudo mokutil --import /etc/pki/akmods/certs/public_key.der

Then REBOOT and follow the on-screen MOK Manager instructions.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

To approve the key, follow these steps:

Run the command provided: sudo mokutil --import /etc/pki/akmods/certs/public_key.der
- You will be asked to create a simple, temporary password. You will only use it once.
Reboot your computer.
During boot, a blue screen titled MOK Manager will appear. Select "Enroll MOK".
Select "Continue" and then "Yes" when asked to enroll the key.
Enter the password you created in step 1.
Select "Reboot".

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

Usage

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

corefreq-cli

Uninstallation

To completely remove the package, the service, the compiled 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 (12)*	Fedora 41 (13 downloads)
Fedora 42	x86_64 (325)*	Fedora 42 (47 downloads)
Fedora 43	x86_64 (2)*	Fedora 43 (14 downloads)
Fedora rawhide	x86_64 (16)*	Fedora rawhide (11 downloads)