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.

Installation

Using uv (Recommended)

Install and run with uv:

uv tool install sot

Using pipx

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

Using DEB Package (Experimental - Debian/Ubuntu)

### Using DEB Package (Experimental - Debian/Ubuntu)

⚠️ Experimental: DEB packages are experimental. Use uv or pipx for recommended installation.

Download the latest DEB package from the releases page and install:

# Download latest .deb file from releases
wget https://github.com/anistark/sot/releases/latest/download/sot-*.deb

# Install the package
sudo dpkg -i sot-*.deb

# Install any missing dependencies (if needed)
sudo apt-get install -f

Using RPM Package (Experimental - RHEL/CentOS/Fedora)

⚠️ Experimental: RPM packages are experimental. Use uv or pipx for recommended installation.

Download the latest RPM package from the releases page and install:

# Download latest .rpm file from releases
wget https://github.com/anistark/sot/releases/latest/download/sot-*.rpm

# Install the package
sudo rpm -ivh sot-*.rpm

Verifying Package Signatures (Recommended)

For enhanced security, verify GPG signatures before installing packages:

# Import the public signing key (one time setup)
curl -fsSL https://github.com/anistark/sot/releases/latest/download/public-key.asc | gpg --import

# For DEB packages:
dpkg-sig --verify sot-*.deb
# Or verify using detached signature
gpg --verify sot-*.deb.asc sot-*.deb
# Verify checksums
gpg --verify SHA256SUMS.sig && sha256sum -c SHA256SUMS

# For RPM packages:
gpg --verify sot-*.rpm.asc sot-*.rpm
# Verify checksums
gpg --verify SHA256SUMS-RPM.sig && sha256sum -c SHA256SUMS-RPM

GPG Key Fingerprint: DCD1 9CA3 2C3F ACAA 1360 1C78 F4D7 EFDB 552E 84C9

---

Run with:

sot

---

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:

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