https://github.com/fraawlen/sysgauges
CPU, RAM, and SWAP Linux desktop monitor
https://github.com/fraawlen/sysgauges
c desktop gui linux monitoring x11
Last synced: 13 days ago
JSON representation
CPU, RAM, and SWAP Linux desktop monitor
- Host: GitHub
- URL: https://github.com/fraawlen/sysgauges
- Owner: fraawlen
- License: agpl-3.0
- Created: 2024-08-29T00:20:39.000Z (almost 2 years ago)
- Default Branch: trunk
- Last Pushed: 2025-02-05T07:15:00.000Z (over 1 year ago)
- Last Synced: 2025-02-05T08:22:18.774Z (over 1 year ago)
- Topics: c, desktop, gui, linux, monitoring, x11
- Language: C
- Homepage:
- Size: 80.1 KB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# SysGauges
SysGauges is a tiny GUI system monitor that keeps track of the CPU load (1min average), RAM and SWAP usage. It's made with the Cassette framework. This program is free and open-source software licensed under the [AGPL-3.0](https://www.gnu.org/licenses/agpl-3.0.html). It's made to run on modern Linux systems.
## Dependencies
Tools:
- C11 compiler with a stdlib
- Make
Library:
- [Cassette](https://github.com/fraawlen/cassette)
## Installation
First, edit the makefile if you want to change the installation destination. It represented by the variables `DIR_INSTALL`. By default, they are set to `/usr/bin/`. Then, build and install SysGauges with the following commands :
```
make
make install
```
## Usage
```
sysgauges [option]
```
By default, the window is created at the top-left of your screen with coordinates 0,0. The maximum values are not displayed, the update interval is set to 1 second, and the alert threshold (the value limit after which an indicator lights up) is set to 0.95. If your system does not use swap, the swap memory gauge will be hidden. These values can be modified using the following options:
```
-a <0.0..1.0> : alert threshold
-h : print help
-H : custom height
-i : update interval in seconds
-m : show max MEM and SWP values
-v : print extra information (window width and height)
-w : custom width
-x : custom x coordinate
-y : custom y coordinate
```
Appearance can be modified through [Cassette's theming options](https://github.com/fraawlen/cassette/blob/trunk/docs/cgui-theming.md). The Cells (widgets) used in SysGauges are `gauge`, `label` and `beacon`. Check out [Cassette's themes](https://github.com/fraawlen/cassette/tree/trunk/cgui/themes) for practical examples.
Credits
-------
- [Terminus](https://terminus-font.sourceforge.net/), font used in banner picture
Mirrors
-------
- 
- 