Crate podbox 

podbox — Podman-native container environment manager.

Turns a single TOML definition file into a fully integrated, systemd-managed container environment with selective XDG directory sharing, Wayland/audio passthrough, GPU acceleration, and desktop integration (.desktop export, binary shims).

Modules

build

cli

codegen

compositor

Host-side Wayland compositor bridge: socket setup, the bidirectional byte-stream bridge loop, and the firewall. The bridge_loop and firewall flow are one tightly-coupled unit; stays above ~300 LOC as a single cohesive concern (documented exemption, per MODULARIZATION_GUIDE).

config

Definition-file schema for podbox.

diff

editor

env

error

export

Host-side export of container binaries and .desktop files: bubblewrap/ shim export, symlinking, and per-container uninstall. One cohesive export flow (.desktop discovery/rewrite lives in the desktop submodule); stays above ~300 LOC as a single cohesive concern (documented exemption, per MODULARIZATION_GUIDE).

guest

history

Append-only action history for podbox containers.

labels

lock

podman

ports

process

profiles

protocol

Protocol types and framing for host-guest IPC.

quadlet_install

Quadlet/systemd install and uninstall for a container definition.

socket_host

systemd

systemd integration for podbox: unit control, status queries, and diagnostics. systemctl helpers live in units, status parsing and diagnostics in [status].

ui

Minimal terminal-output helpers for the podbox CLI.

wizard

xdg

Constants

VERSION