How jkuhl-dev/fedora-desktop works
Fedora Desktop Configurator lets users select desktop and software changes, save or load profiles, and apply them through either the GTK interface or a profile-driven CLI. The main runtime path is application entry → option selection/profile loading → setup orchestration → Fedora and desktop-system changes. The repository also contains dedicated application-setup, VPN, and system-configuration scripts. Relationships below follow the shown imports/calls and README workflow; some script-to-option wiring and unsampled setup branches are not visible in the excerpts.
Main entry points: setup.py Setup orchestrator · AdwApp.py GTK / CLI app · sudo_utils.py Privilege elevation · OptionStore.py Option and profiles
Components 24
Application entry
- Program entry
src/main.py - GTK / CLI app
src/gui/AdwApp.py - Option window
src/gui/MainWindow.py - App metadata
src/data/Info.py
Options and profiles
- Option and profiles
src/data/OptionStore.py - Option actions
src/data/Option.py - Option categories
src/data/Category.py - Action types
src/data/OperationType.py - Resource paths
src/data/Paths.py
Setup execution
- Setup orchestrator
src/workflows/setup.py
System utilities
- Desktop settings
src/utils/platform_utils.py - RPM packages
src/utils/dnf_utils.py - Flatpak packages
src/utils/flatpak_utils.py - GNOME extensions
src/utils/gnome_extension_utils.py - Privilege elevation
src/utils/sudo_utils.py - User prompts
src/utils/zenity_utils.py - Sleep prevention
src/utils/caffeine_utils.py - File operations
src/utils/file_utils.py - VPN helpers
src/utils/vpn_utils.py - Console output
src/utils/print_utils.py
Configuration scripts
- Setup scripts
src/scripts - Application setup
src/scripts/application - VPN setup
src/scripts/vpn
Other components
- Desktop user
Connections 31
- Desktop user → Program entry: launches
- Program entry → GTK / CLI app: starts
src/main.py - GTK / CLI app → Option window: opens
src/gui/AdwApp.py - GTK / CLI app → Option and profiles: loads profile
src/gui/AdwApp.py - GTK / CLI app → Setup orchestrator: runs CLI setup
src/gui/AdwApp.py - Option window → Option and profiles: manages selections
src/gui/MainWindow.py - Option window → Setup orchestrator: starts setup
src/gui/MainWindow.py - Option and profiles → Option actions: loads options
src/data/OptionStore.py - Option actions → Option categories: uses
src/data/Option.py - Option actions → Action types: stores actions
- Setup orchestrator → Option and profiles: reads active options
src/workflows/setup.py - Setup orchestrator → Action types: dispatches actions
src/workflows/setup.py - Setup orchestrator → RPM packages: installs packages
src/workflows/setup.py - Setup orchestrator → Flatpak packages: installs Flatpaks
src/workflows/setup.py - Setup orchestrator → Desktop settings: applies settings
src/workflows/setup.py - Setup orchestrator → GNOME extensions: manages extensions
src/workflows/setup.py - Setup orchestrator → Setup scripts: loads scripts
src/workflows/setup.py - Setup scripts → Application setup: includes
- Setup scripts → VPN setup: includes
- Setup orchestrator → Sleep prevention: prevents sleep
src/workflows/setup.py - Setup orchestrator → Privilege elevation: requests authentication
src/workflows/setup.py - Privilege elevation → User prompts: requests password
src/utils/sudo_utils.py - Privilege elevation → Sleep prevention: handles cancellation
src/utils/sudo_utils.py - RPM packages → Privilege elevation: runs privileged commands
src/utils/dnf_utils.py - Flatpak packages → Privilege elevation: runs privileged commands
src/utils/flatpak_utils.py - File operations → Privilege elevation: copies system files
src/utils/file_utils.py - Setup orchestrator → Console output: prints progress
src/workflows/setup.py - GTK / CLI app → Desktop settings: reads distro
src/gui/AdwApp.py - GTK / CLI app → User prompts: selects CLI prompts
src/gui/AdwApp.py - Option and profiles → Resource paths: uses options directory
src/data/OptionStore.py - Program entry → App metadata: uses app metadata
src/main.py