Skip to content

Interested-Deving-1896/eggs-gui

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

eggs-gui

Unified GUI for penguins-eggs — a Linux live ISO remastering tool.

Merges three existing projects into one system with a shared Go backend and multiple frontend options:

Frontend Framework Use case
TUI BubbleTea (Go) Terminal power users, SSH sessions
Desktop NodeGUI (Qt6/TypeScript) Native desktop with CSS styling
Web NiceGUI (Python) Remote/headless access via browser

All frontends connect to a single Go daemon via JSON-RPC over a Unix socket.

Quick Start

# Build daemon + TUI
make all

# Run (starts daemon in background, then TUI)
make run

Architecture

Frontend (TUI/Desktop/Web)
        │
   JSON-RPC over Unix socket
        │
   eggs-daemon (Go)
        │
   penguins-eggs CLI

See ARCHITECTURE.md for the full design.

Features

Merged from pengui, eggsmaker, and eggsmaker (jlendres fork):

  • Produce ISOs with full option control (prefix, basename, compression, theme, excludes, clone)
  • AUTO mode — one-click prepare + produce workflow
  • Dad configuration editor (eggs.yaml)
  • Tools configuration editor (tools.yaml)
  • Wardrobe browser — costumes, accessories, servers
  • Calamares installer management
  • PPA, Skel, Yolk tools
  • ISO copy to USB/directory with progress
  • Version display (eggs, calamares, distro)
  • i18n support (es, en, pt, it)

Development

Prerequisites

  • Go 1.22+ (daemon + TUI)
  • Node.js 20+ (desktop, optional)
  • Python 3.11+ (web, optional)

Building individual components

make daemon      # Go backend daemon
make tui         # BubbleTea terminal UI
make desktop     # NodeGUI desktop app (requires: cd desktop && npm install)
make web         # Instructions for web frontend

Running

The daemon must be running for any frontend to work:

# Terminal 1: start daemon
make run-daemon

# Terminal 2: pick a frontend
make run-tui       # Terminal UI
make run-desktop   # Native desktop
make run-web       # Web UI at http://localhost:8080

Credits

  • pengui by Piero Proietti — PySide6 GUI
  • eggsmaker by Jorge Luis Endres — customtkinter GUI
  • eggsmaker fork by Jorge Luis Endres — enhanced + web UI

License

MIT

About

Unified GUI for penguins-eggs — Go daemon + BubbleTea TUI + NodeGUI desktop + NiceGUI web

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors