Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/nicciniamh/sysinfo

Terminal and GTK program to display system information using bar graphs
https://github.com/nicciniamh/sysinfo

cpu-monitoring curses disk-usage gtk3 linux python3 sysadmin system systeminformation users

Last synced: 22 days ago
JSON representation

Terminal and GTK program to display system information using bar graphs

Awesome Lists containing this project

README 

        
% sysinfo(1) | General Commands Manual



# System Information

The sysinfo program displays cpu, ram and diskusage as well as uptime, load average and cpu temperature on sysfs systems which support it. Display may be on a terminal or in a GTK application. 

CPU percentages are graphed, per core. 



## Requirements



* python-psutil

* python-curses



### Compatibility

sysinfo has been tested on macOS Catalina and macOS Ventura, Debian Bullseye and Ubuntu Server. GTK may not be available on Macintosh Systems. 



### Program Arguments

```

--gtk				Use GUI

--nocolor			Don't use color in terminal

--nofilesystems		Don't show filesystem usage

--nosystem			Don't show system information

--notitle			Don't set a title on the terminal

--nousers			Don't display logged in users.

--termwidth			An integer representing number of terminal columns

--watch, -w			Clear screen and refresh every watch-interval

--interval, -i 		Seconds to wait between refresh >.15 seconds.

```



### Terminal Watch Mode

When the option --watch or -w is used, sysinfo clears the screen, and updates the information every interval

seconds (set with -i or --interval). Unless --notitle is set, the terminal title is updated showing the program name and hostname. To exit, press Escape, Q or q. 



## Installation



To install perform these actions:



`cp sysinfo ~/bin # or any folder on your PATH`



To install the manual page:



`cp sysinfo.1 /usr/local/man/man1 # Optional, this can be any path on MANPATH`



For the Desktop files, if running in a linux/unix-like environment that supports Opendesktop standards, suchs as Gnome, Mate, Cinnamon, LXDE, KDE, etc.:



```

desktop-file-install --dir=~/.local/share/applications sysinfo.desktop

desktop-file-install --dir=~/.local/share/applications sysinfo-gtk.desktop

update-desktop-database ~/.local/share/applications

```



## Background

Since there are a variety of tools that produce similar results, why another one? Initially, I wanted an alternative for the *nix df command which would show diskusage using bar graphs. Once this worked, I looked for other information to add, then added the GTK interface, then the curses code to exit more gracefully from the terminal watch mode.



## Technicals

sysinfo is written in Python and relies heavily on the psutil module. Originally written for a terminal app, it made sense to add a  Gtk interface.



* Gtk code should only get executed when the --gtk flag is used. This is to prevent an exception on systems without Gtk. 

* To calculate the network speeds a thread is created which calculates the difference in total bytes sent/received. This is done every second so we can determine bytes per second. 

* curses is used in terminal watch mode. This is to allow receiving the terminal quit codes (esc, q or Q) to end the program.



# License

Sysinfo Copyright (C) 2023 Nicole Stevens. This program comes with ABSOLUTELY NO WARRANTY. This is

free software, and you are welcome to redistribute it under certain conditions. This program is

licenced under GNU GENERAL PUBLIC LICENSE Version 3. See LICENSE.txt which should have been

distributed with this program. Please see [GNU Public License v3](https://www.gnu.org/licenses/gpl-3.0.txt)



# Author

Nicole Stevens - https://github.com/nicciniamh