How noctalia-dev/noctalia works
Noctalia is a native Wayland desktop shell: users interact with shell surfaces and services that provide bars, widgets, launcher, notifications, wallpaper, lock screen, and runtime controls. The README describes these capabilities and their compositor relationship; the source tree shows their implementation areas, while sampled excerpts expose selected wiring such as panel surface setup, plugin management, and notification history. The graph preserves documented product branches but omits uncertain internal call paths: much of the application and shell source was not excerpted, and some indexed core paths are absent from the supplied tree.
Main entry points: application.cpp Application coordinator · panel_manager.cpp Panels and launcher · notification_manager.cpp Notification center · compositor_platform.cpp Compositor integration
Components 21
Shell runtime
- Application startup
src/main.cpp - Application coordinator
src/app/application.cpp - Runtime IPC
src/ipc/ipc_service.h
Desktop surfaces
- Panels and launcher
src/shell/panel/panel_manager.cpp - Bar and widgets
src/shell/bar/bar.cpp - Desktop widgets
src/shell/desktop/desktop_widgets_controller.cpp - Rendering engine
src/render/render_context.cpp - Wallpaper surfaces
src/shell/backdrop/backdrop.cpp - Lock screen
src/shell/lockscreen/lockscreen_widgets_controller.cpp
Shell services
- Notification center
src/notification/notification_manager.cpp - Calendar reminders
src/calendar/calendar_service.cpp - Screenshot capture
src/capture/screenshot_service.cpp - Clipboard history
src/wayland/clipboard_service.cpp - System services
src/dbus/network/network_manager_service.cpp - Idle management
src/idle/idle_manager.cpp
Configuration and extensions
- Configuration service
src/config/config_service.h - Theme templates
src/theme/template_engine.cpp - Plugin manager
src/scripting/plugin_manager.cpp
Wayland platform
- Compositor integration
src/compositors/compositor_platform.cpp
Other components
- Desktop user
- Wayland compositor
Connections 25
- Desktop user → Application startup: starts shell
README.md - Application startup → Application coordinator: starts
src/main.cpp - Desktop user → Panels and launcher: uses surfaces
README.md - Desktop user → Notification center: receives alerts
README.md - Desktop user → Clipboard history: uses history
README.md - Desktop user → Runtime IPC: controls runtime
README.md - Application coordinator → Calendar reminders: includes service
- Application coordinator → Screenshot capture: includes service
- Application coordinator → Compositor integration: includes platform
- Application coordinator → Configuration service: includes service
- Application coordinator → Notification center: syncs daemon
- Application coordinator → Plugin manager: updates plugins
- Application coordinator → Panels and launcher: manages panels
- Panels and launcher → Rendering engine: sets scene
src/shell/panel/panel_manager.cpp - Panels and launcher → Compositor integration: creates surface
src/shell/panel/panel_manager.cpp - Wayland compositor → Compositor integration: provides protocols
README.md - Wayland compositor → Idle management: provides idle events
src/idle/idle_manager.cpp - Configuration service → Theme templates: applies templates
- Plugin manager → Panels and launcher: adds panels
- Notification center → Desktop user: shows toasts
README.md - Desktop user → Wallpaper surfaces: selects wallpaper
README.md - Desktop user → Lock screen: locks session
README.md - Desktop user → Desktop widgets: uses widgets
README.md - Application coordinator → Idle management: coordinates idle
- Application coordinator → System services: integrates services