🚩🧡🕉️ || जय श्री राम || 🕉️🧡🚩

---

PuffyContainer 🐳

A beautiful terminal UI to manage Docker containers and images without stress. Written in Go with Bubbletea 🧋

Compatible with both Windows and Linux containers through Docker.

✨ Features

• 🐋 Container Management: View all Docker containers (running and stopped)
• 📦 Image Management: View all Docker images with details
• 🔍 Container Inspection: View detailed information including:
  • Container ID and Image
  • CPU and Memory limits
  • Network configuration
  • Environment variables
• 🖼️ Image Inspection: View detailed information including:
  • Image name and ID
  • Size and creation date
• 🌐 Cross-Platform: Works on both Windows and Linux with Docker installed
• ⚡ Real-time Updates: Live container and image status
• 🎨 Beautiful TUI: Clean, modern terminal interface

🚀 Quick Start

Prerequisites

• Docker installed and running
• Go 1.20+ (for building from source)

Installation

From Source

git clone https://github.com/VinsmokeSomya/PuffyContainer.git

cd PuffyContainer

go build -o puffycontainer.exe ./cmd  # Windows

go build -o puffycontainer ./cmd      # Linux/macOS

Quick Run (Development)

git clone https://github.com/VinsmokeSomya/PuffyContainer.git

cd PuffyContainer

go mod tidy

go run cmd/main.go

🎮 Usage

Start the terminal UI:

./puffycontainer.exe  # Windows

./puffycontainer      # Linux/macOS

Controls

Key	Action
↑ / ↓	Navigate up/down in tables
Tab	Switch between Containers and Images
Enter	View detailed information
q / Ctrl+C	Exit application

Interface Layout

┌─────────────────────────────────────┐┌──────────────────────────────────────┐
│ Containers                          ││ Container/Image Details              │
│─────────────────────────────────────││                                      │
│ running   nginx:latest              ││ ID: abc123...                        │
│ stopped   redis:alpine              ││ Image: nginx:latest                  │
│                                     ││ CPU: 2                               │
└─────────────────────────────────────┘│ Memory: 512MB                        │
┌─────────────────────────────────────┐│ Networks: bridge: 172.17.0.2        │
│ Images                              ││ Environment: PATH=/usr/local/bin...  │
│─────────────────────────────────────││                                      │
│ nginx        latest                 ││                                      │
│ redis        alpine                 ││                                      │
└─────────────────────────────────────┘└──────────────────────────────────────┘

🔧 Docker Commands Used

The application uses standard Docker CLI commands:

• docker ps -a - List all containers
• docker images - List all images
• docker inspect - Get detailed information about containers/images

🖥️ Supported Platforms

• Windows: Works with Docker Desktop or Docker Engine
• Linux: Works with Docker Engine
• Windows Containers: Supported when Docker is configured for Windows containers
• Linux Containers: Supported when Docker is configured for Linux containers

🛠️ Development

The application is built with:

• Bubble Tea - TUI framework
• Bubbles - TUI components
• Lipgloss - Styling

Building from Source

# Clone the repository
git clone https://github.com/VinsmokeSomya/PuffyContainer.git

cd PuffyContainer

# Install dependencies
go mod tidy

# Build for your platform
go build -o puffycontainer ./cmd

# Or build for specific platforms
GOOS=windows GOARCH=amd64 go build -o puffycontainer.exe ./cmd

GOOS=linux GOARCH=amd64 go build -o puffycontainer ./cmd

GOOS=darwin GOARCH=amd64 go build -o puffycontainer ./cmd

🐛 Troubleshooting

Problem	Solution
No containers/images showing	Ensure Docker is running and you have containers/images available
Permission errors	On Linux, ensure your user is in the docker group or run with sudo
Command not found	Ensure Docker is installed and in your PATH
Application crashes	Check Docker daemon is running and accessible

🤝 Contributing

Contributions are welcome! Feel free to submit a pull request or open an issue for any suggestions or improvements.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

🌟 Show Your Support

Give a ⭐️ if this project helped you!

📧 Contact

• GitHub: @VinsmokeSomya
• Repository: PuffyContainer