.forgejo/workflows/build.yaml

@@ -8,16 +8,11 @@ on:
 
 jobs:
   build:
-    runs-on: [host-amd]
+    runs-on: [docker]
     env:
       BRANCH: ${{ github.ref_name }}
       COMMIT: ${{ github.sha }}
     steps:
-      - name: Install CMake
-        run: |
-          apt-get update && apt-get install -y cmake
-          echo "✅ CMake build tool installed."
-
       - name: Clone current branch
         run: |
           git clone --branch "$BRANCH" https://mentalnet.xyz/forgejo/markmental/tuxdock.git .
@@ -25,9 +20,7 @@ jobs:
 
       - name: Compile tux-dock
         run: |
-          cmake -S . -B build
+          g++ -std=c++17 main.cpp -o tux-dock
-          cmake --build build -j
-          cp build/tux-dock ./tux-dock
           chmod +x tux-dock
           echo "🎉 tux-dock compiled and marked executable!"
 
@@ -49,3 +42,4 @@ jobs:
           name: tux-dock-linux-x86_64-${{ env.BRANCH }}-${{ env.COMMIT }}
           path: tux-dock-linux-x86_64-${{ env.BRANCH }}-*.tar.gz
 
+

.gitignore

@@ -1 +0,0 @@
-build/

CMakeLists.txt

@@ -1,30 +0,0 @@
-cmake_minimum_required(VERSION 3.16)
-
-project(tux-dock LANGUAGES CXX)
-
-set(CMAKE_CXX_STANDARD 17)
-set(CMAKE_CXX_STANDARD_REQUIRED ON)
-set(CMAKE_CXX_EXTENSIONS OFF)
-
-include(FetchContent)
-
-set(FTXUI_BUILD_DOCS OFF CACHE BOOL "" FORCE)
-set(FTXUI_BUILD_EXAMPLES OFF CACHE BOOL "" FORCE)
-set(FTXUI_BUILD_TESTS OFF CACHE BOOL "" FORCE)
-
-FetchContent_Declare(
-  ftxui
-  GIT_REPOSITORY https://github.com/ArthurSonzogni/FTXUI.git
-  GIT_TAG v5.0.0
-)
-
-FetchContent_MakeAvailable(ftxui)
-
-add_executable(tux-dock main.cpp)
-
-target_link_libraries(tux-dock
-  PRIVATE
-    ftxui::screen
-    ftxui::dom
-    ftxui::component
-)

README.md

@@ -1,150 +1,175 @@
-# Tux-Dock
+# 🐧 Tux-Dock
-### A lightweight C++ Docker TUI
+### A lightweight C++ Docker management CLI
 
-Tux-Dock is a modern **C++17** Docker terminal frontend built with **FTXUI**.
+Tux-Dock is a simple, modern, and fast **C++17** command-line utility for managing Docker containers and images.
-It gives you a guided, keyboard-first TUI for common Docker operations like pulling images, running containers, inspecting IPs, and managing images/containers without memorizing long CLI flags.
+It offers a clean, interactive menu for common Docker operations like pulling images, running containers, and inspecting IP addresses — without the overhead of complex GUIs or scripts.
 
 ---
 
-## Features
+## ✨ Features
 
-- Interactive Docker workflows through a single-screen TUI with modal steps.
+- 🔹 **Interactive container management** — start, stop, remove, or attach to containers with simple numbered menus.
-- Picker-based selection (arrow keys + Enter) for containers/images instead of numeric menus.
+- 🔹 **Port mapping made clear** — automatically prompts for and explains host ↔ container port bindings.
-- High-level status panel with responsive wait states for slower operations.
+- 🔹 **Image operations** — pull, list, and delete Docker images; curated pull list (Debian, Ubuntu, Rocky Linux, Alpine) plus a custom entry to grab common bases without retyping them.
-- Rich container display with state and forwarded ports.
+- 🔹 **Script-to-image workflow** — turn a bash setup script into a Dockerfile and build the resulting image in one go.
-- Interactive shell handoff with clean terminal clear before/after shell transitions.
+- 🔹 **Quick MySQL setup** — spin up a MySQL container with version, password, and port configuration in seconds.
-- Image operations: pull/list/delete with curated quick picks and custom image support.
+- 🔹 **Get container IP address** — cleanly retrieves and displays only the container’s assigned IP.
-- Script-to-image workflow: generate Dockerfile from bash script, then optionally build.
+- 🔹 **Run detached commands** — execute background jobs inside a container without attaching an interactive shell.
-- MySQL quick start flow with version/password/port prompts.
+- 🔹 **Modern C++ design** — built with classes, minimal dependencies, and clear abstractions.
-- About screen in-app with project/version/repository info.
+- 🔹 **Interactive run flow** — lists pulled images with numeric selection, allows entering a custom image name, and keeps the port-mapping explanation in place before launching `/bin/sh`.
 
 ---
 
-## Build Requirements
+## 🧩 Build Requirements
 
-- **C++17 or newer** compiler (e.g. `g++`, `clang++`)
+- **C++17 or newer** compiler
-- **CMake 3.16+**
+  (e.g., `g++`, `clang++`)
 - **Docker Engine** installed and running
+  (tested on Debian 12/13, Alpine Linux, and Arch Linux)
 
 ---
 
-## Build & Run
+## ⚙️ Build & Run
 
 ```bash
 # Clone the repo
 git clone https://mentalnet.xyz/forgejo/markmental/tuxdock.git
 cd tuxdock
 
-# Configure & build (FTXUI is fetched automatically)
+# Build the binary
-cmake -S . -B build
+g++ -std=c++17 main.cpp -o tux-dock
-cmake --build build -j
 
 # Run it (requires Docker permissions)
-sudo ./build/tux-dock
+sudo ./tux-dock
-```
+````
 
-Prefer a prebuilt binary? CI artifacts are published at:
+Prefer a prebuilt binary? The CI runner publishes build artifacts for the latest commits at:
 https://mentalnet.xyz/forgejo/markmental/tuxdock/actions
 
 ---
 
-## Menu Overview
+## 🖥️ Menu Overview
 
-Current TUI actions:
+```
-
+Tux-Dock: Docker Management Menu
-1. Pull Docker Image
+----------------------------------
-2. Run/Create Interactive Container
+1.  Pull Docker Image
-3. List All Containers
+2.  Run/Create Interactive Container
-4. List All Images
+3.  List All Containers
-5. Start Container Interactively (boot new session)
+4.  List All Images
-6. Start Detached Container Session
+5.  Start Container Interactively (boot new session)
-7. Delete Docker Image
+6.  Start Detached Container Session
-8. Stop Container
+7.  Delete Docker Image
-9. Remove Container
+8.  Stop Container
+9.  Remove Container
 10. Attach Shell to Running Container
 11. Run Detached Command in Container
 12. Spin Up MySQL Container
 13. Get Container IP Address
 14. Create Dockerfile & Build Image from Bash Script
-15. About Tux-Dock
+15. Exit
-16. Exit
+```
+
+Each action guides you through the required steps.
+For container-related commands, Tux-Dock automatically lists available containers and lets you choose by **number**, not by typing long IDs.
 
 ---
 
-## Design Overview
+## 📡 Example: Getting a Container’s IP Address
 
-Tux-Dock is now structured around **two main classes**:
+```
+Available Containers:
+1. mysql-container (ebaf5dbae393)
+2. webapp (fa29b6c1f1e8)
+
+Select container to view IP (1-2): 2
+Container IP Address: 172.17.0.3
+```
+
+---
+
+## 🧱 Design Overview
+
+Tux-Dock is built using a single class:
 
 ```cpp
 class DockerManager {
 public:
-  struct ContainerInfo {
+    void pullImage();
-    std::string id;
+    void runContainerInteractive();
-    std::string name;
+    void listContainers() const;
-    std::string status;
+    void listImages() const;
-    std::string ports;
+    void startInteractive();
-    bool running;
+    void startDetached();
-  };
+    void deleteImage();
-
+    void stopContainer();
-  // Docker command/data layer
+    void removeContainer();
-  std::vector<ContainerInfo> getContainerList() const;
+    void execShell();
-  std::vector<std::pair<std::string, std::string>> getImageList() const;
+    void execDetachedCommand();
-  bool pullImage(...);
+    void createDockerfile();
-  bool runContainerInteractive(...);
+    void spinUpMySQL();
-  bool startInteractive(...);
+    void showContainerIP();
-  bool startDetached(...);
-  bool stopContainer(...);
-  bool removeContainer(...);
-  bool deleteImage(...);
-  bool execShell(...);
-  bool execDetachedCommand(...);
-  bool spinUpMySQL(...);
-  bool showContainerIP(...);
-  bool createDockerfile(...);
-};
-
-class TuxDockApp {
-public:
-  void Run();
 
 private:
-  // TUI orchestration layer
+    static void runCommand(const std::string& cmd);
-  void OpenInput(...);
+    std::vector<std::pair<std::string, std::string>> getContainerList() const;
-  void OpenSelect(...);
+    std::string selectContainer(const std::string& prompt);
-  void OpenConfirm(...);
+    /* NEW helper – retrieves all images */
-  void RunDeferredStatusAction(...);
+    std::vector<std::pair<std::string, std::string>> getImageList() const;
-  void RunWithRestoredIO(...);
-  void ExecuteSelectedAction();
-  // action handlers bridge UI -> DockerManager
 };
 ```
 
-### Responsibilities
+### Method Reference
+- `pullImage` — prompt for an image name and run `docker pull`.
+- `runContainerInteractive` — configure port mappings and start a new interactive container session.
+- `listContainers` — show all Docker containers (running or stopped).
+- `listImages` — list local Docker images.
+- `startInteractive` — start an existing container and attach a shell.
+- `startDetached` — start an existing container in detached mode.
+- `deleteImage` — remove a local Docker image.
+- `stopContainer` — stop a running container.
+- `removeContainer` — delete a container after confirmation.
+- `execShell` — attach a shell to a running container.
+- `execDetachedCommand` — run a background command inside a container.
+- `createDockerfile` — turn a bash script into a Dockerfile and build an image.
+- `spinUpMySQL` — launch a MySQL container with custom port, password, and version.
+- `showContainerIP` — display a container’s IP address.
+- `runCommand` — helper to invoke shell commands.
+- `getContainerList` — retrieve Docker container IDs and names for selection menus.
+- `getImageList` — gather local Docker image IDs and names for menus and reporting.
+- `selectContainer` — present a menu to pick a container interactively.
 
-- `DockerManager`
+This makes the codebase **extensible** — adding new Docker features like `docker logs` or `docker stats` requires only a small new method.
-  - Executes Docker commands.
-  - Escapes shell arguments and returns success/failure + user-facing messages.
-  - Collects container/image data used by the UI.
-
-- `TuxDockApp`
-  - Renders the FTXUI interface.
-  - Manages modal flows (input/select/confirm/message).
-  - Handles status updates, deferred actions, and interactive shell transitions.
-  - Coordinates end-to-end user flows by calling `DockerManager` methods.
-
-This split keeps Docker behavior isolated while making UI behavior easier to extend.
 
 ---
 
-## About / Version
+## 🧠 Why C++?
 
-- Version: `022526-dev`
+C++ was one of my formative languages when I was learning to program — it’s where I first grasped core concepts like memory management, data structures, OOP and abstraction.
-- Created by: `markmental`
+Writing Tux-Dock in C++ is both nostalgic and practical: it combines the clarity of modern design with the raw performance and control that first inspired me to code.
-- GitHub: https://github.com/MARKMENTAL/tuxdock
-- Forgejo: https://mentalnet.xyz/forgejo/markmental/tuxdock
 
 ---
 
-## License
+## 📜 License
 
 MIT License — free to use, modify, and share.
+
+---
+
+### 💡 Tip
+
+If you’d like Tux-Dock to run without `sudo`, add your user to the Docker group:
+
+```bash
+sudo usermod -aG docker $USER
+```
+
+Then log out and back in.
+
+---
+
+**Author:** MARKMENTAL
+**Project:** Tux-Dock — *A clean and modern CLI for Docker power users.*
+
+
+---

compile.sh

@@ -1,3 +1,3 @@
 #!/bin/sh
 
-cmake -S . -B build && cmake --build build -j && echo "tux-dock successfully compiled!"
+g++ -std=c++17 main.cpp -o tux-dock && echo "tux-dock successfully compiled!"