sot · PyPI

Command-line system obervation tool.

sot is a Command-line System Obervation Tool in the spirit of top. It displays various interesting system stats and graphs them. Works on all operating systems.

Install and run with pipx. Setup pipx before proceeding.

python3 -m pipx install sot
python3 -m pipx ensurepath
sudo pipx ensurepath --global

or in single line:

python3 -m pipx install sot && python3 -m pipx ensurepath && sudo pipx ensurepath --global

Run with:

sot

sot-demo

Features

System

CPU Usage
- Per Core and Thread level
Processes with ID, threads, memory and cpu usage

Disk

Disk Usage
- Per Read/Write
Capacity
- Free
- Used
- Total
- Percent

Memory

Memory Usage
Capacity
- Free
- Available
- Used
- Swap

Network

Local IP
Upload/Download Speed
Bandwidth
Network Usage

For all options, see

sot -H

usage: sot [--help] [--version] [--log LOG] [--net NET]

Command-line System Obervation Tool ≈

options:
  --help, -H     Show this help message and exit.
  --version, -V  Display version information
  --log, -L LOG  Debug log file
  --net, -N NET  Network interface to display (default: auto)

Main Theme:

Color	Hex	RGB
sky_blue3	`#5fafd7`	`rgb(95,175,215)`
aquamarine3	`#5fd7af`	`rgb(95,215,175)`
yellow	`#808000`	`rgb(128,128,0)`
bright_black	`#808080`	`rgb(128,128,128)`
slate_blue1	`#875fff`	`rgb(135,95,255)`
red3	`#d70000`	`rgb(215,0,0)`
dark_orange	`#d75f00`	`rgb(215,95,0)`

All supported colors.

🏴 ≈ 🏴

sot uses:

Textual for layouting
rich for rich text
psutil for fetching system data.

Tested Systems:

MacOs
Ubuntu

If you use a system that's not listed above, feel free to add to the list. If you're facing any issues, would be happy to take a look.

Other top alternatives in alphabetical order:

tiptop ✨ This project was created on top of tiptop, when it became unmaintained.
bashtop, bpytop, btop
bottom (one of my fav)
Glances
gtop
htop

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sot-4.3.1.tar.gz (35.4 kB view details)

Uploaded Jul 19, 2025 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

sot-4.3.1-py3-none-any.whl (30.2 kB view details)

Uploaded Jul 19, 2025 Python 3

File details

Details for the file sot-4.3.1.tar.gz.

File metadata

Download URL: sot-4.3.1.tar.gz
Upload date: Jul 19, 2025
Size: 35.4 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.1.0 CPython/3.13.3

File hashes

Hashes for sot-4.3.1.tar.gz
Algorithm	Hash digest
SHA256	`5fb2f1a4c18936acae855bc356555d501b10b1e6768bdab8059e35f56826833c`
MD5	`7a8d2a2f8e1b77cdd494712ba7233e65`
BLAKE2b-256	`f0cc4d7b91ea6234a0c9242f6163f22ed5d293bf39f25c6f90ea2d35a6927064`

See more details on using hashes here.

File details

Details for the file sot-4.3.1-py3-none-any.whl.

File metadata

Download URL: sot-4.3.1-py3-none-any.whl
Upload date: Jul 19, 2025
Size: 30.2 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.1.0 CPython/3.13.3

File hashes

Hashes for sot-4.3.1-py3-none-any.whl
Algorithm	Hash digest
SHA256	`ac8ea01b56bfed402a127d67bc7668fefa0b90f1d92d2eb7e608350537c2a453`
MD5	`1c356256807df7e1152743848a671fc1`
BLAKE2b-256	`5bd4fb064f88fd275a54bf107e5bc676b547ba8c45d99ab90325d3f127373a49`