# 🐳 DockrTUI
A fast, modern and keyboard-driven terminal dashboard for Docker — built with Rust and `ratatui`.
Because managing containers shouldn’t feel like typing spells in Bash.
---
<p align="center">
<video src="https://nextcloud.orbitnet.fr/s/Ws72Zga28dnDX88/download" width="800" controls></video>
</p>
> 🎥 *See DockrTUI in action!*
> Browse containers, networks & compose projects at lightning speed — all from your terminal.
---
## 🚀 Features
- **Containers, Images, Networks & Compose** — all in one place
- **Quick actions** — start, stop, restart, inspect, prune
- **Smart search and filtering**
- **Built-in shell** inside containers (`cd`, history, autocomplete, etc.)
- **Compose integration** — detect and control your Compose projects
- **Clean, efficient TUI** powered by `ratatui`
---
## ⚡ Installation
You can install DockrTUI directly with Cargo:
```bash
cargo install dockrtui
```
Once installed, run it from anywhere:
```bash
dockrtui
```
> 🐧 Requires Docker CLI installed and running.
> Tested on Linux and WSL2.
---
## 🕹️ Usage
Navigate everything with your keyboard:
| `Tab` | Switch tab |
| `↑` / `↓` | Navigate |
| `Enter` / `Space` | Start / stop container |
| `r` / `F5` | Refresh |
| `b` | Open built-in shell |
| `t` | Show stats |
| `l` | Show logs |
| `q` | Quit |
---
## 🧭 Tabs Overview
* **Containers** → view, start, stop, restart, inspect
* **Images** → list, remove, check creation date and size
* **Networks** → inspect, clean, or create networks
* **Compose** → view detected Compose projects and run `up`, `down`, `logs`, etc.
---
## 🐚 Built-in Shell
Each container can be opened in an interactive shell directly from the UI.
Supports `cd`, autocompletion with `Tab`, and persistent working directory.
---
## 🛠️ Requirements
* Docker CLI (`docker ps` must work)
* UTF-8 terminal with 256 colors
* Rust toolchain (only for installation)
---
## 💡 Example
```bash
dockrtui
```
Then use `Tab` to move between Containers, Images, Networks, and Compose.
---
## ⚖️ License
MIT License © OrbitNet
Built with ❤️ in Rust.