secubox/secubox-deb
1
0
Fork 0
mirror of https://github.com/CyberMind-FR/secubox-deb.git synced 2026-07-28 21:17:36 +00:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity
270f655d3a
secubox-deb/packages/secubox-ui-manager
History
CyberMind-FR bd7dda0c6f feat(secubox): complete meta-script generator Tasks 14-17 
Task 14: Arch Profiles
- Add profiles/arch/arm64.yaml and profiles/arch/amd64.yaml
- Add ResolveWithArch() to merger for base → arch → tier chain
- Add tests for arch profile resolution

Task 15: Package secubox.yaml for All Packages
- Add scripts/generate-secubox-yaml.py generator script
- Generate 131 debian/secubox.yaml files with:
  - Category detection (security, network, system, etc.)
  - Tier assignment (all, lite, standard, pro)
  - API socket and UI path detection

Task 16: APT Repository Setup
- Add apt/conf/ reprepro configuration (multi-arch arm64/amd64)
- Add apt/hooks/lintian-check pre-publish validation
- Add scripts/apt-publish.sh and scripts/apt-sync.sh
- Add apt/README.md documentation

Task 17: CI Integration
- Add .github/workflows/build-secubox-cli.yml
- Build for linux-amd64 and linux-arm64
- Version injection via ldflags
- GitHub releases on tag push

Code Quality Fixes (Tasks 10-13):
- Add atomic writes for OTA boot control files (0600 perms)
- Fix NVME device extraction (nvme0n1p2 → nvme0n1)
- Add scanner.Err() checks in hardware detection
- Fix URL injection validation in fetch command
- Add proper cleanup on checksum failures

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-05-11 05:32:29 +02:00
..
.pybuild/cpython3_3.12_secubox-ui-manager docs: Add modules architecture documentation 2026-04-10 10:47:35 +02:00
bin fix: Remove :9443 from internal kiosk URLs 2026-04-10 11:30:38 +02:00
debian feat(secubox): complete meta-script generator Tasks 14-17 2026-05-11 05:32:29 +02:00
ui feat: Add secubox-ui-manager, boot architecture docs, and plymouth theme 2026-04-10 10:23:54 +02:00
README.md feat: Add secubox-ui-manager, boot architecture docs, and plymouth theme 2026-04-10 10:23:54 +02:00

README.md

SecuBox UI Manager

Unified UI management system for SecuBox with automatic mode selection, graceful fallback, and hypervisor optimization.

Features

  • Three UI Modes:

    • KUI (Kiosk UI): X11 + Chromium fullscreen kiosk
    • TUI (Terminal UI): Textual-based console application
    • Console: Standard getty login fallback

  • Automatic Detection:

    • Hypervisor detection (VirtualBox, QEMU/KVM, VMware, bare metal)
    • Display capabilities (X11, Wayland, framebuffer, TTY)
    • Graphics hardware and driver selection

  • Graceful Fallback:

    • Priority chain: KUI → TUI → Console
    • Automatic retry with configurable limits
    • Console mode always succeeds (terminal state)

  • Health Monitoring:

    • Periodic health checks for running mode
    • Automatic fallback on failure detection
    • Configurable failure threshold

  • Modular Debug System:

    • 6 verbosity levels (SILENT → TRACE)
    • Component-based filtering
    • Multiple output channels (journald, console, FIFO)

Installation

apt install secubox-ui-manager

Usage

Command Line

# Auto-detect and start (default)
secubox-ui-manager

# Force specific mode
secubox-ui-manager --mode tui

# Enable debug logging
secubox-ui-manager --debug 4

# Show current status
secubox-ui-manager --status

# Reset state machine
secubox-ui-manager --reset

Kernel Command Line

Override UI mode via kernel parameters:

secubox.ui=tui    # Force TUI mode
secubox.ui=kui    # Force KUI mode
secubox.ui=console # Force console mode

Environment Variables

# Debug level (0-5)
export SECUBOX_UI_DEBUG=4

# Filter components (comma-separated)
export SECUBOX_UI_DEBUG_COMPONENTS=state,kui,health

Configuration

Configuration file: /etc/secubox/ui/ui.toml

[general]
default_mode = "auto"

[fallback]
priority = ["kui", "tui", "console"]
timeout_seconds = 30
max_retries = 2

[debug]
level = 1
components = []

[kui]
user = "kiosk"
url = "http://127.0.0.1:8080/"
vt = 7
disable_gpu = true

[health]
check_interval = 10.0
failure_threshold = 3

Debug Levels

Level Name Description
0 SILENT No output
1 ERROR Errors only
2 WARN Warnings and errors
3 INFO Informational messages
4 DEBUG Debug traces
5 TRACE Full trace including syscalls

Architecture

secubox-ui-manager/
├── ui/
│   ├── __init__.py          # Package exports
│   ├── manager.py           # Main orchestrator
│   ├── lib/
│   │   ├── debug.py         # Modular debug system
│   │   ├── state_machine.py # UI state machine
│   │   ├── hypervisor.py    # VM detection & config
│   │   ├── display.py       # Display capabilities
│   │   ├── fallback.py      # Fallback chain logic
│   │   └── health.py        # Health monitoring
│   ├── drivers/
│   │   ├── kui_driver.py    # KUI (X11+Chromium)
│   │   ├── tui_driver.py    # TUI (Textual)
│   │   └── console_driver.py # Console (getty)
│   └── config/
│       └── ui.toml          # Default configuration
├── bin/
│   └── secubox-ui-manager   # CLI entry point
└── debian/                  # Debian packaging

State Machine

INIT → DETECTING → SELECTING → [KUI|TUI|CONSOLE]_STARTING
                                        ↓ success
                               [KUI|TUI|CONSOLE]_OK
                                        ↓ failure
                                    FALLBACK → next mode
                                        ↓ all failed
                                      ERROR

Hypervisor Optimization

Hypervisor Driver 3D Resolution Notes
VirtualBox modesetting OFF 1280x720 vboxvideo too slow
QEMU/KVM modesetting ON* native *with virtio-gpu
VMware vmware ON native Full acceleration
Bare metal auto ON native Hardware detection

Files

  • /etc/secubox/ui/ui.toml - User configuration
  • /run/secubox/ui/state.json - Current state
  • /run/secubox/ui/health.json - Health status
  • /run/secubox/ui/debug.fifo - Debug FIFO for tools

systemd Integration

# Service status
systemctl status secubox-ui-manager

# View logs
journalctl -u secubox-ui-manager -f

# Restart
systemctl restart secubox-ui-manager

Author

Gerald KERMA devel@cybermind.fr CyberMind - https://cybermind.fr

License

Proprietary / ANSSI CSPN candidate