dot/.local/share/gnome-shell/extensions/Vitals@CoreCoding.com/README.md

55 lines
2.5 KiB
Markdown
Raw Normal View History

2020-05-11 09:16:27 +00:00
gnome-shell-extension-vitals
====================================
Vitals is a GNOME 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 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.
## Installation
### 1) Install these packages
#### Ubuntu
apt install gir1.2-gtop-2.0 lm-sensors
#### Fedora
yum install libgtop2-devel lm_sensors
#### Arch/Manjaro
sudo pacman -Syu libgtop lm_sensors gnome-icon-theme-symbolic
### 2a) Download from GitHub (either perform step 2a or 2b, not both)
mkdir -p ~/.local/share/gnome-shell/extensions
git clone https://github.com/corecoding/Vitals.git ~/.local/share/gnome-shell/extensions/Vitals@CoreCoding.com
### 2b) Download from extensions.gnome.org
https://extensions.gnome.org/extension/1460/vitals/
### 3) Activate after installation
Restart GNOME Shell (`Alt+F2`, `r`, `Enter`) and enable the extension through gnome-tweak-tool.
## Credits
Vitals was originally forked from [gnome-shell-extension-freon](https://github.com/UshakovVasilii/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!
### Icons
* (voltage|fan)-symbolic.svg - inherited from Freon project.
* (system|storage)-symbolic.svg - from Pop! OS theme.
* temperature-symbolic.svg - [iconnice studio](https://www.iconfinder.com/iconnice).
* (cpu|memory)-symbolic.svg - [DinosoftLabs](https://www.iconfinder.com/dinosoftlabs).
* network\*.svg - [Yannick Lung](https://www.iconfinder.com/yanlu).
* Health icon - [Dod Cosmin](https://www.iconfinder.com/icons/458267/cross_doctor_drug_health_healthcare_hospital_icon).
## 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
* Reload extension `gnome-shell-extension-tool -r Vitals@CoreCoding.com`
* 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`