How kernalix7/winpodx works
WinPodX runs Windows apps in a containerized guest and presents them as native Linux applications. The primary workflow is setup and provisioning, guest app discovery, desktop-entry registration, then launching an app through a FreeRDP RemoteApp session. The repository also includes a GUI/tray dashboard, host-device and VM controls, and reverse-open file/URL integration. Edges reflect README statements or relationships listed in the SOURCE INDEX; unsampled implementation details are not inferred beyond those documented connections.
Main entry points: setup_cmd.py Setup wizard · entry.py Desktop entries · main.py CLI · __init__.py App discovery
Components 21
Setup and VM
- CLI
src/winpodx/cli/main.py - Setup wizard
src/winpodx/cli/setup_cmd.py - Configuration
src/winpodx/core/config.py - Provisioning
src/winpodx/core/provisioner.py - Container backend
src/winpodx/backend/podman.py - VM compose
src/winpodx/core/pod/compose.py
Guest apps
- Windows guest
- App discovery
src/winpodx/core/discovery/__init__.py - App catalog
src/winpodx/core/app.py - Windows execution
src/winpodx/core/windows_exec.py - Transport dispatch
src/winpodx/core/transport/dispatch.py - FreeRDP sessions
src/winpodx/core/rdp.py - App commands
src/winpodx/cli/app.py
Linux desktop
- GUI
src/winpodx/gui/main_window.py - Desktop entries
src/winpodx/desktop/entry.py - Icon management
src/winpodx/desktop/icons.py - Tray launcher
src/winpodx/desktop/tray.py
Host integrations
- Device controls
src/winpodx/core/devices.py - Reverse-open
src/winpodx/reverse_open/listener.py - Linux desktop
Other components
- User
Connections 25
- User → CLI: runs commands
- User → GUI: opens dashboard
- CLI → Setup wizard: routes setup
src/winpodx/cli/main.py - Setup wizard → Configuration: writes config
- Setup wizard → Provisioning: starts provisioning
- Provisioning → Container backend: controls pod
src/winpodx/core/provisioner.py - Container backend → VM compose: runs compose
src/winpodx/backend/podman.py - VM compose → Windows guest: creates VM
- Setup wizard → App discovery: discovers apps
- App discovery → Windows guest: queries apps
src/winpodx/core/discovery/__init__.py - App discovery → App catalog: persists results
src/winpodx/core/discovery/__init__.py - CLI → App commands: routes app commands
src/winpodx/cli/main.py - App commands → App catalog: manages apps
src/winpodx/cli/app.py - App commands → Desktop entries: registers entries
src/winpodx/cli/app.py - Desktop entries → App catalog: reads app data
src/winpodx/desktop/entry.py - Desktop entries → Icon management: uses icons
src/winpodx/desktop/entry.py - Linux desktop → Desktop entries: shows launchers
- User → Linux desktop: launches app
- Windows execution → Transport dispatch: dispatches execution
src/winpodx/core/windows_exec.py - Transport dispatch → FreeRDP sessions: selects transport
- FreeRDP sessions → Windows guest: opens RemoteApp
- GUI → Provisioning: runs setup
- GUI → Device controls: controls devices
- Windows guest → Reverse-open: sends open requests
- Reverse-open → Linux desktop: opens host files