Skip to content

corecoding/Vitals

Repository files navigation

Vitals

Vitals is a GNOME Shell extension for displaying your computer's temperature, voltage, fan speed, memory usage, processor load, system resources, network speed and storage stats in your GNOME Shell's top menu bar. This is a one stop shop to monitor all of your vital sensors. Vitals uses asynchronous polling to provide a smooth user experience.

How it works

Installation

1) Install support packages

Ubuntu/Debian

sudo apt install gnome-shell-extension-manager gir1.2-gtop-2.0 lm-sensors

Fedora

sudo dnf install libgtop2-devel lm_sensors

Arch/Manjaro

sudo pacman -Syu libgtop lm_sensors gnome-icon-theme-symbolic gnome-icon-theme git

openSUSE

sudo zypper install libgtop-devel

2) Install extension

Ubuntu/Debian

    Open the Extension Manager (installed above), search for Vitals and click Install.

Fedora

    Visit Gnome Extensions website, search for Vitals and click switch (power on) icon.
     Get it on GNOME Extensions

Arch/Manjaro

git clone https://aur.archlinux.org/gnome-shell-extension-vitals-git.git/
cd gnome-shell-extension-vitals-git

# always verify content before installing
less PKGBUILD
makepkg

# example filename, different each release
pacman -U gnome-shell-extension-vitals-git-v52.0.4.r0.gb446cfc-1-any.pkg.tar.zst

3) Activate after installation

Ubuntu/Debian/Fedora

    At this point, Vitals should be running. If you reversed steps 1 and 2 above, you will need to restart your session by logging out and then back in.

Arch/Manjaro

    Open the Extensions application and toggle on Vitals

Beta testing

Advanced users requesting bug fixes or asking for new features may occasionally be asked to help QA.

1) Remove existing copy of Vitals

    Remove existing copy of vitals - expert users only!
# rm -ri ~/.local/share/gnome-shell/extensions/[email protected]

2) Clone from GitHub

mkdir -p ~/.local/share/gnome-shell/extensions
git clone https://github.com/corecoding/Vitals.git ~/.local/share/gnome-shell/extensions/[email protected] -b develop

3) Activate develop version

Ubuntu/Debian/Fedora

    You will need to restart your session by logging out and then back in.

Arch/Manjaro

    Open the Extensions application and toggle on Vitals

Credits

Vitals was originally forked from gnome-shell-extension-freon. I was having trouble finding an up to date, resource friendly and fully featured system monitoring tool. My biggest pet peeve was random system delays because of I/O blocking polls, and thus, the idea for Vitals was born! It has been refactored several times over, so most of the code is new or different.

Icons

Original Theme

  • (voltage|fan)-symbolic.svg - inherited from Freon project.
  • (system|storage)-symbolic.svg - from Pop! OS theme.
  • temperature-symbolic.svg - iconnice studio.
  • (cpu|memory)-symbolic.svg - DinosoftLabs.
  • network*.svg - Yannick Lung.
  • Health icon - Dod Cosmin.

GNOME Theme

  • (battery | storage)-symbolic.svg - from Adwaita Icon Theme.
  • (memory | network* | system | voltage)-symbolic.svg - from Icon Development Kit.
  • fan-symbolic.svg - inherited from Freon project, with mild modifications.
  • (temperature | cpu)-symbolic.svg - designed by daudix.

Disclaimer

Sensor data is obtained from the system using hwmon and GTop. Core Coding and the Vitals authors are not responsible for improperly represented data. No warranty expressed or implied.

Development Commands

Description Command
Launch preferences gnome-shell-extension-prefs [email protected]
View logs journalctl --since="`date '+%Y-%m-%d %H:%M'`" -f | grep Vitals
Compile schemas glib-compile-schemas --strict schemas/
Compile translation file msgfmt vitals.po -o vitals.mo
Launch Wayland virtual window dbus-run-session -- gnome-shell --nested --wayland
Read hot-sensors value dconf read /org/gnome/shell/extensions/vitals/hot-sensors
Write hot-sensors value dconf write /org/gnome/shell/extensions/vitals/hot-sensors "['_memory_usage_', '_system_load_1m_']"

Donations

Please consider donating if you find this extension useful.

Star History

Star History Chart