Skip to content

wmarquardt/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 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

2) Install extension

Ubuntu/Debian/Fedora

    Visit Gnome Extensions website, search for Vitals and click switch icon

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/Vitals@CoreCoding.com

2) Clone from GitHub

mkdir -p ~/.local/share/gnome-shell/extensions
git clone https://github.com/corecoding/Vitals.git ~/.local/share/gnome-shell/extensions/Vitals@CoreCoding.com -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 becaus 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

  • (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.

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 Vitals@CoreCoding.com
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.

About

A glimpse into your computer's temperature, voltage, fan speed, memory usage and CPU load.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 98.6%
  • CSS 1.4%