How linuxmint/cinnamon works
Cinnamon is a Linux desktop shell. The principal workflow is user input entering the shell, being dispatched through window management, panels, applets, workspaces, and input services, then producing an interactive desktop surface. The repository also contains settings, screenshots, backgrounds, notifications, screensaver control, legacy X11 tray support, and optional ModemManager/MPRIS integrations. This map emphasizes sampled runtime modules; several broader shell relationships are represented conservatively because source excerpts were partial.
Main entry points: st-widget.c St Toolkit · main.js Cinnamon Shell · windowManager.js Window Manager · panel.js Desktop Panel
Components 29
Shell Runtime
- Cinnamon Shell
js/ui/main.js - Window Manager
js/ui/windowManager.js
Desktop UI
- Workspace UI
js/ui/workspacesView.js - Desktop Panel
js/ui/panel.js - Cinnamon Applets
files/usr/share/cinnamon/applets/calendar@cinnamon.org/applet.js - Desktop Desklets
files/usr/share/cinnamon/desklets/clock@cinnamon.org/desklet.js - Settings Center
files/usr/share/cinnamon/cinnamon-settings/cinnamon-settings.py - Background Service
src/background/daemon/cinnamon-background-daemon.c - Notifications
js/ui/messageTray.js - Screenshot UI
files/usr/share/cinnamon/cinnamon-screenshot/application.py
Input & Session
- Keyboard Manager
js/ui/keyboardManager.js - Focus Manager
src/st/st-focus-manager.c - Gesture Manager
js/ui/gestures/gesturesManager.js - Screensaver Controller
js/ui/screensaver/controller.js - Session Manager
js/misc/loginManager.js
System Integrations
- System Tray
src/cinnamon-tray-manager.c - X11 Tray Manager
src/tray/na-tray-manager.c - Modem Integration
js/misc/modemManager.js - Media Controller
js/ui/gestures/mprisController.js
Platform Core
- Cinnamon Core
src/main.c - St Toolkit
src/st/st-widget.c
Other components
- Desktop User
- X11 or Wayland
- System D-Bus
- Desktop Settings
- logind or ConsoleKit
- Screensaver Service
- ModemManager
- MPRIS Players
Connections 29
- Desktop User → Cinnamon Shell: uses
- Cinnamon Shell → Window Manager: dispatches
- Window Manager → Cinnamon Core: calls
- Cinnamon Core → X11 or Wayland: manages
- Window Manager → Workspace UI: manages
- Workspace UI → St Toolkit: renders
- Cinnamon Shell → Desktop Panel: starts
- Desktop Panel → Cinnamon Applets: hosts
- Desktop Panel → Notifications: shows
- Cinnamon Applets → St Toolkit: renders
- Cinnamon Shell → Desktop Desklets: loads
- Desktop Desklets → St Toolkit: renders
- Settings Center → Desktop Settings: writes
- Keyboard Manager → Desktop Settings: reads
- Keyboard Manager → System D-Bus: queries
- Focus Manager → St Toolkit: navigates
- Gesture Manager → Desktop Settings: reads
- Gesture Manager → Screensaver Service: checks
- Screensaver Controller → St Toolkit: renders
- Screensaver Controller → Screensaver Service: locks
- Session Manager → logind or ConsoleKit: connects
- Session Manager → System D-Bus: signals
- System Tray → X11 Tray Manager: creates
- X11 Tray Manager → X11 or Wayland: receives
- System Tray → St Toolkit: renders
- Background Service → X11 or Wayland: renders
- Screenshot UI → X11 or Wayland: captures
- Modem Integration → ModemManager: queries
- Media Controller → MPRIS Players: controls