How pop-os/cosmic-epoch works
COSMIC Desktop is a Linux desktop environment composed of a login/session entry point, Wayland desktop rendering, shell services, system utilities, and first-party applications. The principal workflow is initiated by a user selecting COSMIC in an external display manager and logging in; the selected session then assembles the compositor and interactive desktop shell.
Components
Login and rendering
• User — path: null. External actor who selects a session, logs in, and interacts with the desktop.
• Display manager — path: null. External login/session chooser documented by the installation instructions.
• COSMIC Greeter — cosmic-greeter. COSMIC login and display-manager component; the README documents enabling it as a display manager.
• COSMIC Session — cosmic-session. Desktop-session entry point installed and selected from a display manager.
• COSMIC Compositor — cosmic-comp. Wayland window/compositing subsystem; its role is established by the component inventory and Wayland-focused dependency requirements.
• COSMIC Workspaces — cosmic-workspaces-epoch. Workspace organization for the desktop.
• COSMIC Monitor — cosmic-monitor. Monitor/display management application.
• COSMIC RandR — cosmic-randr. Display-output configuration utility.
Shell and interaction
• COSMIC Panel — cosmic-panel. Desktop panel and shell surface.
• COSMIC App Library — cosmic-applibrary. Graphical application browsing and launching surface.
• COSMIC Launcher — cosmic-launcher. Fast application search and launch interface.
• COSMIC Applets — cosmic-applets. Panel-resident desktop controls and applets.
• COSMIC Notifications — cosmic-notifications. User notification presentation and management.
State and platform services
• COSMIC Settings — cosmic-settings. User-facing desktop settings application.
• COSMIC Settings Daemon — cosmic-settings-daemon. Background settings/state service paired with the settings UI.
• COSMIC Backgrounds — cosmic-bg. Desktop background and wallpaper management.
• COSMIC Idle — cosmic-idle. Inactivity detection and idle-related desktop behavior.
• COSMIC On-Screen Keyboard — cosmic-osk. On-screen keyboard facility.
• COSMIC Screenshot — cosmic-screenshot. Desktop screenshot capture utility.
• COSMIC Portal — xdg-desktop-portal-cosmic. XDG desktop portal implementation for application-to-desktop integration.
• COSMIC Initial Setup — cosmic-initial-setup. First-run desktop configuration.
First-party applications
• COSMIC Files — cosmic-files. File-management application.
• COSMIC Edit — cosmic-edit. Text-editing application.
• COSMIC Terminal — cosmic-term. Terminal emulator.
• COSMIC Player — cosmic-player. Media-player application.
• COSMIC Store — cosmic-store. Software-store application.
Relationships
• User -> Display manager: selects the COSMIC desktop entry and logs in; directly documented by the installation instructions.
• Display manager -> COSMIC Greeter: may use the COSMIC greeter as its login frontend; the README documents this deployment option.
• Display manager -> COSMIC Session: launches the selected COSMIC session after login; documented by the session-selection instructions.
• COSMIC Greeter -> COSMIC Session: hands off a successful COSMIC login to the selected session when the COSMIC greeter is enabled; exact implementation is not shown.
• COSMIC Session -> COSMIC Compositor: assembles the compositor as part of the running desktop session; this is product-level composition, not a verified call sequence.
• COSMIC Session -> COSMIC Panel: owns or starts the desktop shell alongside the session; exact startup wiring is unavailable.
• COSMIC Compositor -> COSMIC Workspaces: provides the rendered window/workspace environment.
• COSMIC Monitor -> COSMIC Compositor: supplies monitor-management behavior for the rendered desktop; the concrete interface is not sampled.
• COSMIC RandR -> COSMIC Compositor: applies display-output configuration to the compositor; exact call direction is unverified.
• COSMIC Panel -> COSMIC Applets: hosts or exposes panel applets.
• User -> COSMIC Launcher: invokes application search and launch interaction.
• COSMIC Launcher -> COSMIC Files: launches a selected first-party application; the other listed applications are parallel targets, but their individual launch paths are not established.
• User -> COSMIC App Library: browses and selects applications through the application library.
• COSMIC Settings -> COSMIC Settings Daemon: forms the documented UI-to-background-settings boundary; the repository sample does not establish its IPC or persistence mechanism.
• COSMIC Screenshot -> COSMIC Compositor: obtains desktop display content for capture; this relationship is role-based because no source calls are available.
• COSMIC Portal -> External applications: exposes desktop integration interfaces to applications outside this repository.
• External applications — path: null. Applications that consume the desktop portal interfaces.
Coverage limits
No source excerpts were provided, so imports, process startup order, IPC, persistence, and concrete provider interfaces cannot be confirmed. The README also names libraries and a theme editor not present in the supplied tree; they are therefore not mapped as repository components.
Main entry points: cosmic-comp COSMIC Compositor · cosmic-session COSMIC Session · cosmic-greeter COSMIC Greeter · cosmic-panel COSMIC Panel
Components 27
Login and Rendering
- COSMIC Greeter
cosmic-greeter - COSMIC Session
cosmic-session - COSMIC Compositor
cosmic-comp - COSMIC Workspaces
cosmic-workspaces-epoch - COSMIC Monitor
cosmic-monitor - COSMIC RandR
cosmic-randr
Shell and Interaction
- COSMIC Panel
cosmic-panel - COSMIC App Library
cosmic-applibrary - COSMIC Launcher
cosmic-launcher - COSMIC Applets
cosmic-applets - COSMIC Notifications
cosmic-notifications
State and Platform Services
- COSMIC Settings
cosmic-settings - COSMIC Settings Daemon
cosmic-settings-daemon - COSMIC Backgrounds
cosmic-bg - COSMIC Idle
cosmic-idle - COSMIC On-Screen Keyboard
cosmic-osk - COSMIC Screenshot
cosmic-screenshot - COSMIC Portal
xdg-desktop-portal-cosmic - COSMIC Initial Setup
cosmic-initial-setup
First-Party Applications
- COSMIC Files
cosmic-files - COSMIC Edit
cosmic-edit - COSMIC Terminal
cosmic-term - COSMIC Player
cosmic-player - COSMIC Store
cosmic-store
External Actors
- User · Selects a session, logs in, and interacts with the desktop.
- Display Manager
- External Applications · Applications consuming desktop portal interfaces.
Connections 16
- User → Display Manager: selects and logs in
- Display Manager → COSMIC Greeter: may use · Optional login frontend deployment.
- Display Manager → COSMIC Session: launches
- COSMIC Greeter → COSMIC Session: hands off login · Applies when the COSMIC greeter is enabled.
- COSMIC Session → COSMIC Compositor: assembles · Product-level session composition; startup sequence is unverified.
- COSMIC Session → COSMIC Panel: starts shell · Product-level ownership; startup wiring is unavailable.
- COSMIC Compositor → COSMIC Workspaces: provides environment
- COSMIC Monitor → COSMIC Compositor: manages monitors · Concrete interface is not sampled.
- COSMIC RandR → COSMIC Compositor: configures outputs · Exact call direction is unverified.
- COSMIC Panel → COSMIC Applets: hosts applets
- User → COSMIC Launcher: searches and launches
- COSMIC Launcher → COSMIC Files: launches · Representative established first-party launch target.
- User → COSMIC App Library: browses and selects
- COSMIC Settings → COSMIC Settings Daemon: uses settings service · IPC and persistence mechanism are unconfirmed.
- COSMIC Screenshot → COSMIC Compositor: captures display · Role-based relationship; no source calls are available.
- COSMIC Portal → External Applications: exposes interfaces