https://github.com/rafaelrcamargo/ds
Think "docker stats" but with beautiful, real-time charts into your terminal. 📊
https://github.com/rafaelrcamargo/ds
cli docker hacktoberfest rust stats
Last synced: 12 months ago
JSON representation
Think "docker stats" but with beautiful, real-time charts into your terminal. 📊
- Host: GitHub
- URL: https://github.com/rafaelrcamargo/ds
- Owner: rafaelrcamargo
- License: apache-2.0
- Created: 2023-09-22T04:09:20.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2025-07-08T02:12:07.000Z (12 months ago)
- Last Synced: 2025-07-08T04:25:35.130Z (12 months ago)
- Topics: cli, docker, hacktoberfest, rust, stats
- Language: Rust
- Homepage: https://crates.io/crates/docker-stats
- Size: 12.8 MB
- Stars: 34
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# 📊 `ds` - A Terminal-Based Docker Stats Viewer
_Visualize container metrics with real-time charts directly in your terminal._
> [!WARNING]
> `ds` is now stable and no longer under active development. It is feature-complete and should function as expected. If you encounter any issues, please [open an issue](https://github.com/rafaelrcamargo/ds/issues), and pull requests are welcome.
## Overview
`ds` provides real-time monitoring of Docker container statistics, rendering them as charts in the terminal. It serves as a visual alternative to the standard `docker stats` command, making it easier to analyze resource utilization at a glance.
This project was inspired by the need for a visual statistics tool similar to Docker Desktop's, especially when using lighter container management solutions like [OrbStack](https://orbstack.dev/).
## Features
- **Real-Time charting**: Visualize CPU, memory, network, and I/O usage with dynamic charts.
- **Customizable Views**: Choose between compact and full layouts to control the level of detail.
- **Container Filtering**: Display statistics for all containers or specify a subset by name or ID.
- **Rust-Powered**: Built with Rust for performance and reliability.
## Installation
> [!NOTE]
> `ds` is available on [crates.io](https://crates.io/crates/docker-stats) as `docker-stats`.
### From crates.io
```bash
cargo install docker-stats
```
### From Source
Ensure you have [Rust and Cargo](https://doc.rust-lang.org/cargo/getting-started/installation.html) installed.
1. Clone the repository:
```bash
git clone https://github.com/rafaelrcamargo/ds
cd ds
```
2. Build and install the binary:
```bash
cargo install --path .
```
3. Run the application:
```bash
ds
```
## Usage
The default command displays statistics for all running containers:
```bash
ds
```
To view all available options, run:
```bash
ds --help
```
### Examples
#### Compact View
For a minimal overview of all containers, use the compact flag:
```bash
ds -c
```
#### Detailed View for Specific Containers
To monitor specific containers with full details, including network and I/O charts, provide their names or IDs:
```bash
ds -f 5f03524a8fbe api-1
```
## Known Issues
### Slow Startup Time
`ds` may experience a startup delay while it establishes a connection to the Docker daemon and begins receiving statistics. This behavior is inherent to how `docker stats` operates and is consistent with the performance of both OrbStack and Docker Desktop.
### Network Chart Limitations
The network chart does not display data for containers running in `network_mode: host`. Metrics will only be populated for containers using the `bridge` network. This is a known limitation related to how Docker exposes network statistics.
For more context on `network_mode: host` on macOS, see the discussion in the [Docker roadmap](https://github.com/docker/roadmap/issues/238).
## Contributing
Contributions are welcome! If you have suggestions or find a bug, please [open an issue](https://github.com/rafaelrcamargo/ds/issues) or submit a pull request.
## License
This project is licensed under the [Apache License 2.0](LICENSE).