Toptle 🐢
A transparent process monitor that displays real-time resource stats in your terminal title.
Your terminal title shows: ORIGINAL_TITLE 🐢5.2% CPU, 45.1MB RAM🐢
Installation
Via Nix flake:
nix profile install github:YPares/toptle
# or run directly:
nix run github:YPares/toptle -- <command>
From source:
git clone https://github.com/YPares/toptle.git && cd toptle
pip install -e .
Usage
toptle [OPTIONS] [--] COMMAND [ARGS...]
Options:
--refresh,-r- Update interval in seconds (default: 2.0)--metrics,-m- Display: cpu,ram,disk,files,threads,procs,all (default: cpu,ram)--pty,-p- PTY mode for edge cases
Examples:
toptle python -m http.server 8000 # Basic usage
toptle -r 0.5 make -j4 # Faster updates
toptle -m all ./build-script.sh # All metrics
toptle --pty special-app # PTY mode if needed
Features
- Customizable metrics - CPU, RAM, disk I/O, file descriptors, threads, process count
- Process tree monitoring - Tracks parent and all child processes
- Title interception - Captures and combines with app titles (requires
--pty)
Modes
- Default: Direct mode - zero overhead but will ignore title sequence(s) sent by application
--pty: PTY mode - full title interception. Might also be needed by certain apps to work properly
Limitations
- Title display depends on terminal emulator support for ANSI escape sequences
- Process tree detection may miss processes that detach from the parent
1 maintainer
Metadata
1 maintainer
Release files for toptle 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| toptle-0.1.1.tar.gz | 11.6 kB | Without provenance | Details for toptle-0.1.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| toptle-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for toptle-0.1.1-py3-none-any.whl |
Total release size: 22.3 kB
Release files / toptle-0.1.1.tar.gz
| Download URL | toptle-0.1.1.tar.gz |
|---|---|
| Size | 11.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ede3487ba82779cc90bc8cedc1ddb8bec35d69bc8e21e23fdf4d49139f2adcb2
|
|
BLAKE2b-256 checksum How to use checksums |
7504cb9a6fa8bf04af6c82d157e956a4c673f29e03ff593b5cebaa4b92c269cb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.14
|
Release files / toptle-0.1.1-py3-none-any.whl
| Download URL | toptle-0.1.1-py3-none-any.whl |
|---|---|
| Size | 10.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
cc8e91b329c02cda25cfa68af9a77f2feb04f17a04313756081a2805a8d518e8
|
|
BLAKE2b-256 checksum How to use checksums |
aa39fb36bf783b5d1b6511e3e5e8ef0d6e2bd07b1099b1c32cc5b2bae3767e3a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.8.14
|
Security for toptle 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
