SOT(1)

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

SYNOPSIS
sot [--help] [--version] [--log LOG] [--net NET] {info,bench,disk} ...

DESCRIPTION
Command-line System Observation Tool ≈

POSITIONAL ARGUMENTS

sot info
    Display system information

sot bench
    Disk benchmarking

sot disk
    Interactive disk information viewer

COMMAND 'sot info'
usage: sot info [-h]

COMMAND 'sot bench'
usage: sot bench [-h] [--output OUTPUT] [--duration DURATION]

OPTIONS 'sot bench'

--output OUTPUT, -o OUTPUT
    Output file for benchmark results (JSON format)

--duration DURATION, -d DURATION
    Duration for each benchmark test in seconds (default: 10s)

COMMAND 'sot disk'
usage: sot disk [-h]

OPTIONS

--version, -V
    Display version information with styling

--log LOG, -L LOG
    Debug log file path (enables debug logging)

--net NET, -N NET
    Network interface to display (default: auto-detect best interface)

EXAMPLES

sot Launch the interactive system monitoring TUI

sot --net eth0
    Monitor system with specific network interface

sot info
    Display comprehensive system information

sot bench
    Run interactive disk benchmark

sot bench --duration 30 --output results.json
    Run 30-second benchmarks and save results to JSON

sot disk
    View interactive disk information

FEATURES

  System Monitoring

•   CPU usage per core and thread

•   Process management with interactive sorting

•   Memory usage and capacity monitoring

•   Network upload/download speed and bandwidth

•   Disk I/O statistics and usage

  System Information (sot info)

•   Hardware details (chip, GPU, memory)

•   Software information (OS, kernel, shell)

•   Display configuration and brightness

•   Battery status and system uptime

•   OS-specific ASCII logos

  Disk Benchmarking (sot bench)

•   Sequential read/write throughput

•   Random read/write IOPS

•   Latency percentiles (p50, p95, p99)

•   JSON export for results

INTERACTIVE CONTROLS
When running the main sot interface:

q   Quit the application

O   Enter order-by mode for process sorting

Arrow keys
    Navigate columns in order-by mode

Enter
    Toggle sort direction (DESC ↓ → ASC ↑ → OFF)

CONFIGURATION
sot does not require configuration files. All options are provided via command-line arguments.

EXIT STATUS

0   Success

1   General error (insufficient permissions, invalid arguments, etc.)

SEE ALSO
top(1), htop(1), btop(1), iostat(1), vmstat(8)

BUGS
Report bugs at: https://github.com/anistark/sot/issues

COPYRIGHT
MIT License © 2024-2026 Kumar Anirudha

AUTHOR
Written by Kumar Anirudha.

AVAILABILITY
The latest version is available at: https://github.com/anistark/sot