Skip to content
forked from fflewddur/tophat

An elegant system resource monitor for the GNOME shell

License

Notifications You must be signed in to change notification settings

esalvati/tophat

 
 

Repository files navigation

TopHat

TopHat is an elegant system resource monitor for the GNOME shell. It displays CPU, memory, and network activity in the GNOME top bar.

Screenshot of TopHat

Installation

Install TopHat from the GNOME Shell extensions page.

Most Debian-based systems (including Ubuntu and Pop!_OS) will also need 'gir1.2-gtop-2.0' to be installed. Usually this means running the command sudo apt install gir1.2-gtop-2.0.

Requirements

  • GNOME 3.32 or newer
  • The gtop system monitoring library (e.g., 'libgtop' on Debian-based systems, likely already installed as part of GNOME)
  • GIRepository (gir) bindings for the gtop system monitoring library (e.g., 'gir1.2-gtop-2.0' on Debian-based systems)

Compatibility

The latest release of TopHat has been tested on the following systems:

  • CentOS Stream 8
  • CentOS Stream 9
  • Debian 11.4
  • Fedora 36
  • Pop!_OS 22.04 LTS
  • Ubuntu 22.04 LTS
  • Ubuntu 22.10 (Preview)

Release notes

See RELEASES.md for the list of fixes and new functionality included in each release.

Contributing and dev notes

Contributions to improve TopHat are welcome! To avoid duplicate work, check the issue tracker first. If an issue doesn't already exist for your idea, please create one.

To view logged output, use the command journalctl -f -o cat /usr/bin/gnome-shell.

To simulate heavy system load, use the stress-ng tool, e.g. stress-ng --timeout 10s --cpu 8.

To install manually:

mkdir -p ~/.local/share/gnome-shell/extensions/
ln -s [path to tophat repository] ~/.local/share/gnome-shell/extensions/[email protected]

License

TopHat is distributed under the terms of the GNU General Public License, version 3 or later. See the license file for details.

Credits

TopHat was designed and written by Todd Kulesza, with much inspiration from the GNOME system-monitor extension and iStat Menus.

Icons

The images in the 'icons' directory are derived works from thenounproject.com and used under the Creative Commons Attribution license. The authors of each original work are:

icons/cpu.svg: jai
icons/mem.svg: Loudoun Design Co.
icons/net.svg: Pixel Bazaar

All icons were edited to make them more legible at small sizes.

About

An elegant system resource monitor for the GNOME shell

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 96.8%
  • CSS 3.0%
  • Shell 0.2%