Skip to main content

⚡ Docker Stats Dashboard for your terminal

Project description

⚡ TopDock

A real-time Docker container stats dashboard for your terminal — CPU, memory, network, and block I/O at a glance.

Python 3.10+ License MIT Platform


Install

# recommended
pipx install topdock

# or
pip install topdock

# or directly from source
pipx install git+https://github.com/yourusername/topdock.git

Requires: Python 3.10+, Docker


Usage

topdock                                 # live dashboard
topdock --sort mem                      # sort by memory
topdock --refresh 5 --alert 90          # custom refresh and alert threshold
topdock --snapshot --format json        # one-shot JSON output
topdock --host tcp://192.168.1.10:2375  # remote Docker host
topdock --version

Keyboard Controls

Key Action
/ Scroll rows
PgUp / PgDn Scroll 10 rows
c Sort by CPU
m Sort by Memory
n Sort by Network
b Sort by Block I/O
e Export CSV + JSON
a Clear alerts
q Quit

Uninstall

pipx uninstall topdock
# or
pip uninstall topdock

Contributing

Found a bug or want a feature? Open an issue or PR on GitHub.


License

MIT

Project details


Download files

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

Source Distribution

topdock-0.2.2.tar.gz (9.3 kB view details)

Uploaded Source

Built Distribution

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

topdock-0.2.2-py3-none-any.whl (9.7 kB view details)

Uploaded Python 3

File details

Details for the file topdock-0.2.2.tar.gz.

File metadata

  • Download URL: topdock-0.2.2.tar.gz
  • Upload date:
  • Size: 9.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for topdock-0.2.2.tar.gz
Algorithm Hash digest
SHA256 34db765f6f4341ee64bf6ca38cf1047bde1de9f582cea72c777fa9702d652909
MD5 08d3ff8fc61833a48a659c4268694a9a
BLAKE2b-256 6b1adb4ead0719612d7e83bc4d180d33fbff195eb319d2a801448fcbf5e69e94

See more details on using hashes here.

File details

Details for the file topdock-0.2.2-py3-none-any.whl.

File metadata

  • Download URL: topdock-0.2.2-py3-none-any.whl
  • Upload date:
  • Size: 9.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for topdock-0.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 add806283d273f89b17638955cfb503c90f70e8abcccb24909e90e426524e537
MD5 15430d68c18c0a65048752217691b1d1
BLAKE2b-256 b90a8fccea44052fe6332fcc294b749c175388cad5de7c203ac7065846f67c7b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page