📊 ds - Real-time Stats with Terminal Charts

Visualize container stats with beautiful, real-time charts directly in your terminal.

[!IMPORTANT] This is a WIP, main should be stable, but keep in mind this is changing constantly. Thanks! :)

Why ds?

• Missing Charts: While experimenting with OrbStack, a lightweight Docker container management tool, I found that it lacks the visual charts that Docker Desktop provides. This project aims to bridge that gap.
• Visual Analysis: Visualizing system stats in real-time can help spot issues that might go unnoticed in text-based outputs. ds brings colors and moving charts to your system analysis.
• Rust-Powered 😶‍🌫️: This project is written in Rust, leveraging its performance and reliability.

Installation

[!NOTE] There's a "beta" version of this tool available on crates.io. You can install it with cargo install ds.

Source

Ensure you have Cargo installed. Then, clone this repo:

git clone https://github.com/rafaelrcamargo/ds

Development

Then just cd into the directory and run:

cargo run -- <ARGS> # For development

Release

In the project directory, run:

cargo run --release -- <ARGS> # For production

Then add this command to your $PATH, you can run:

# May require sudo
mv target/release/ds /usr/local/bin

Usage

To use it with the default settings, just run:

ds

This is akin to docker stats.

For more options, you can run:

ds -h

Examples & Use Cases

Some examples of how you can use this tool.

Compact view for all containers

For a basic overview of all containers in a space-saving format:

ds -c

Full view for some containers

To see detailed stats for a specific container, including NET and IO charts:

ds -f 5f03524a8fbe api-1

Roadmap

• https://github.com/rafaelrcamargo/ds/issues/2
• https://github.com/rafaelrcamargo/ds/issues/5
• https://github.com/rafaelrcamargo/ds/issues/8

Pain Points

Some things that are bad, but expected.

License

This project is licensed under the Apache License 2.0.