Ubuntu cpu frequency display script especially optimized to many NUMA and cores system
  • Python 78.3%
  • Shell 21.7%
Find a file
2026-05-31 15:15:34 -04:00
assets Upload changes 2026-03-27 04:08:52 +00:00
.gitignore Initial commit 2026-03-26 23:24:10 -04:00
freqdisp Add persistent config and one-click installer 2026-04-18 17:17:21 +00:00
install.sh Improve user install PATH setup 2026-05-31 15:15:34 -04:00
LICENSE Initial commit 2026-03-26 23:24:10 -04:00
README.md Improve user install PATH setup 2026-05-31 15:15:34 -04:00

CPU frequency display

Terminal CPU frequency and usage display for Linux systems, with layout support for large core-count and NUMA-heavy machines.

Quick start

  • via bash (fire-and-forget)
bash <(curl -fsSL https://raw.githubusercontent.com/HalfVulpes/cpufrequencydisplay/master/install.sh)
  • via curl to download then run
curl -fsSLO https://raw.githubusercontent.com/HalfVulpes/cpufrequencydisplay/master/install.sh
chmod +x install.sh
./install.sh
  • via wget to download then run
wget -q https://raw.githubusercontent.com/HalfVulpes/cpufrequencydisplay/master/install.sh
chmod +x install.sh
./install.sh

The installer defaults to:

  • script install folder: ~/.local/share/freqdisp
  • launcher: ~/.local/bin/freqdisp
  • config file: ~/.local/share/freqdisp/.freqdisp.json

It also adds ~/.local/bin to your shell PATH automatically. For Bash it updates ~/.bashrc and ~/.profile; for Zsh it updates ~/.zshrc and ~/.zprofile; other shells use ~/.profile. New terminals pick up the change automatically, and sourced installs update the current shell immediately.

The app saves your current mode and grouping choice whenever you press 1, 2, 3, or 4, then restores those settings on the next launch.

Versioning

  • freqdisp --version prints the installed version
  • local git checkouts use git describe --tags --always --dirty
  • installer-based installs write the selected ref into VERSION

By default, install.sh installs the latest git tag when one exists. You can override that with:

FREQDISP_REF=master bash <(curl -fsSL https://raw.githubusercontent.com/HalfVulpes/cpufrequencydisplay/master/install.sh)

Manual run

If you want to keep a standalone copy instead of using the installer:

chmod +x ./freqdisp
./freqdisp

When run this way, the config is still saved beside the script in the current installation folder.

Example

image-20260327000620920