sot


Namesot JSON
Version 4.3.2 PyPI version JSON
download
home_pageNone
SummarySystem Oberving Tool
upload_time2025-07-19 10:51:28
maintainerNone
docs_urlNone
authorNone
requires_python>=3.10
licenseNone
keywords cli linux monitor system tools
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <p align="center" style="background-color: #ffffff;">
  <a href="https://github.com/anistark/sot"><img alt="sot" src="https://raw.githubusercontent.com/anistark/sot/refs/heads/main/images/sot.png" width="200px"/></a>
  <p align="center">Command-line system obervation tool.</p>
</p>

`sot` is a Command-line System Obervation Tool in the spirit of [top](<https://en.wikipedia.org/wiki/Top_(software)>). It displays various interesting system stats and graphs them. Works on all operating systems.

[![PyPI Downloads](https://static.pepy.tech/badge/sot)](https://pepy.tech/projects/sot)

Install and run with [`pipx`](https://github.com/pypa/pipx). Setup pipx before proceeding.

<!--pytest-codeblocks: skip-->

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

or in single line:

<!--pytest-codeblocks: skip-->

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

Run with:

<!--pytest-codeblocks: skip-->

```sh
sot
```

![sot-demo](https://github.com/user-attachments/assets/780449fd-27e0-40ee-ae9a-7527bf99d7de)

---

## 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

<!--pytest-codeblocks:skipif(sys.version_info < (3, 10))-->

```sh
sot -H
```

<!--pytest-codeblocks: expected-output-->

```
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](https://rich.readthedocs.io/en/latest/appendix/colors.html).

---

<p align="center">
  <p align="center">🏴 ≈ 🏴</p>
</p>

---

`sot` uses:
- [Textual](https://github.com/willmcgugan/textual/) for layouting
- [rich](https://rich.readthedocs.io/en/latest/index.html) for rich text
- [psutil](https://github.com/giampaolo/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](https://github.com/nschloe/tiptop) ✨ This project was created on top of `tiptop`, when it became unmaintained.
- [bashtop](https://github.com/aristocratos/bashtop), [bpytop](https://github.com/aristocratos/bpytop), [btop](https://github.com/aristocratos/btop)
- [bottom](https://github.com/ClementTsang/bottom) (one of my fav)
- [Glances](https://github.com/nicolargo/glances)
- [gtop](https://github.com/aksakalli/gtop)
- [htop](https://github.com/htop-dev/htop)

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "sot",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": null,
    "keywords": "cli, linux, monitor, system, tools",
    "author": null,
    "author_email": "Kumar Anirudha <dev@anirudha.dev>",
    "download_url": "https://files.pythonhosted.org/packages/7d/da/24ee5d5351ac880d1b79ddb8955bf788a66578942cd9dc40fba3404ee810/sot-4.3.2.tar.gz",
    "platform": null,
    "description": "<p align=\"center\" style=\"background-color: #ffffff;\">\n  <a href=\"https://github.com/anistark/sot\"><img alt=\"sot\" src=\"https://raw.githubusercontent.com/anistark/sot/refs/heads/main/images/sot.png\" width=\"200px\"/></a>\n  <p align=\"center\">Command-line system obervation tool.</p>\n</p>\n\n`sot` is a Command-line System Obervation Tool in the spirit of [top](<https://en.wikipedia.org/wiki/Top_(software)>). It displays various interesting system stats and graphs them. Works on all operating systems.\n\n[![PyPI Downloads](https://static.pepy.tech/badge/sot)](https://pepy.tech/projects/sot)\n\nInstall and run with [`pipx`](https://github.com/pypa/pipx). Setup pipx before proceeding.\n\n<!--pytest-codeblocks: skip-->\n\n```sh\npython3 -m pipx install sot\npython3 -m pipx ensurepath\nsudo pipx ensurepath --global\n```\n\nor in single line:\n\n<!--pytest-codeblocks: skip-->\n\n```sh\npython3 -m pipx install sot && python3 -m pipx ensurepath && sudo pipx ensurepath --global\n```\n\nRun with:\n\n<!--pytest-codeblocks: skip-->\n\n```sh\nsot\n```\n\n![sot-demo](https://github.com/user-attachments/assets/780449fd-27e0-40ee-ae9a-7527bf99d7de)\n\n---\n\n## Features\n\n### System\n\n- CPU Usage\n  - Per Core and Thread level\n- Processes with ID, threads, memory and cpu usage\n\n### Disk\n\n- Disk Usage\n  - Per Read/Write\n- Capacity\n  - Free\n  - Used\n  - Total\n  - Percent\n\n### Memory\n\n- Memory Usage\n- Capacity\n  - Free\n  - Available\n  - Used\n  - Swap\n\n### Network\n\n- Local IP\n- Upload/Download Speed\n- Bandwidth\n- Network Usage\n\n---\n\nFor all options, see\n\n<!--pytest-codeblocks:skipif(sys.version_info < (3, 10))-->\n\n```sh\nsot -H\n```\n\n<!--pytest-codeblocks: expected-output-->\n\n```\nusage: sot [--help] [--version] [--log LOG] [--net NET]\n\nCommand-line System Obervation Tool \u2248\n\noptions:\n  --help, -H     Show this help message and exit.\n  --version, -V  Display version information\n  --log, -L LOG  Debug log file\n  --net, -N NET  Network interface to display (default: auto)\n```\n\nMain Theme:\n\n| Color | Hex | RGB |\n| --- | --- | --- |\n| sky_blue3 | `#5fafd7` | `rgb(95,175,215)` |\n| aquamarine3 | `#5fd7af` | `rgb(95,215,175)` |\n| yellow | `#808000` | `rgb(128,128,0)` |\n| bright_black | `#808080` | `rgb(128,128,128)` |\n| slate_blue1 | `#875fff` | `rgb(135,95,255)` |\n| red3 | `#d70000` | `rgb(215,0,0)` |\n| dark_orange | `#d75f00` | `rgb(215,95,0)` |\n\nAll supported [colors](https://rich.readthedocs.io/en/latest/appendix/colors.html).\n\n---\n\n<p align=\"center\">\n  <p align=\"center\">\ud83c\udff4 \u2248 \ud83c\udff4</p>\n</p>\n\n---\n\n`sot` uses:\n- [Textual](https://github.com/willmcgugan/textual/) for layouting\n- [rich](https://rich.readthedocs.io/en/latest/index.html) for rich text\n- [psutil](https://github.com/giampaolo/psutil) for fetching system data.\n\nTested Systems:\n\n- MacOs\n- Ubuntu\n\n_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._\n\n---\n\nOther top alternatives in alphabetical order:\n\n- [tiptop](https://github.com/nschloe/tiptop) \u2728 This project was created on top of `tiptop`, when it became unmaintained.\n- [bashtop](https://github.com/aristocratos/bashtop), [bpytop](https://github.com/aristocratos/bpytop), [btop](https://github.com/aristocratos/btop)\n- [bottom](https://github.com/ClementTsang/bottom) (one of my fav)\n- [Glances](https://github.com/nicolargo/glances)\n- [gtop](https://github.com/aksakalli/gtop)\n- [htop](https://github.com/htop-dev/htop)\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "System Oberving Tool",
    "version": "4.3.2",
    "project_urls": {
        "Code": "https://github.com/anistark/sot",
        "Documentation": "https://github.com/anistark/sot#readme",
        "Homepage": "https://github.com/anistark/sot",
        "Issues": "https://github.com/anistark/sot/issues"
    },
    "split_keywords": [
        "cli",
        " linux",
        " monitor",
        " system",
        " tools"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "ea9ded716f3a9aacba56c9ec9ce227b6eae7387a6eb82c3dffc9054104a7a537",
                "md5": "7f4d940ed9afe2fa200b05d2b2e737dc",
                "sha256": "3796a6d940e90aa6fa764b2142a8e32043d02c2639ce814065cd79e7740ac08c"
            },
            "downloads": -1,
            "filename": "sot-4.3.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "7f4d940ed9afe2fa200b05d2b2e737dc",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 30179,
            "upload_time": "2025-07-19T10:51:26",
            "upload_time_iso_8601": "2025-07-19T10:51:26.497673Z",
            "url": "https://files.pythonhosted.org/packages/ea/9d/ed716f3a9aacba56c9ec9ce227b6eae7387a6eb82c3dffc9054104a7a537/sot-4.3.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "7dda24ee5d5351ac880d1b79ddb8955bf788a66578942cd9dc40fba3404ee810",
                "md5": "550ccaeb68c5051c658e12000f601724",
                "sha256": "16786fbe6f29d69658552ef2a38e058677f282183f58d041367b62183c93ffd6"
            },
            "downloads": -1,
            "filename": "sot-4.3.2.tar.gz",
            "has_sig": false,
            "md5_digest": "550ccaeb68c5051c658e12000f601724",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 35385,
            "upload_time": "2025-07-19T10:51:28",
            "upload_time_iso_8601": "2025-07-19T10:51:28.536224Z",
            "url": "https://files.pythonhosted.org/packages/7d/da/24ee5d5351ac880d1b79ddb8955bf788a66578942cd9dc40fba3404ee810/sot-4.3.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-19 10:51:28",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "anistark",
    "github_project": "sot",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "tox": true,
    "lcname": "sot"
}
        
Elapsed time: 1.61403s