# linuxmint/cinnamon architecture

> Architecture diagram of the GitHub repository linuxmint/cinnamon, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/linuxmint/cinnamon
- Repository: https://github.com/linuxmint/cinnamon

## Overview

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: [`src/st/st-widget.c`](https://github.com/linuxmint/cinnamon/blob/master/src/st/st-widget.c) (St Toolkit), [`js/ui/main.js`](https://github.com/linuxmint/cinnamon/blob/master/js/ui/main.js) (Cinnamon Shell), [`js/ui/windowManager.js`](https://github.com/linuxmint/cinnamon/blob/master/js/ui/windowManager.js) (Window Manager), [`js/ui/panel.js`](https://github.com/linuxmint/cinnamon/blob/master/js/ui/panel.js) (Desktop Panel)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Shell Runtime"]
  node_shell_main["Cinnamon Shell<br/>[main.js]"]
  node_window_manager["Window Manager<br/>[windowManager.js]"]
end

subgraph group_ui["Desktop UI"]
  node_workspace_ui["Workspace UI<br/>[workspacesView.js]"]
  node_panel["Desktop Panel<br/>[panel.js]"]
  node_applets["Cinnamon Applets<br/>[applet.js]"]
  node_desklets["Desktop Desklets<br/>[desklet.js]"]
  node_settings_center["Settings Center"]
  node_background["Background Service"]
  node_notification_tray["Notifications<br/>[messageTray.js]"]
  node_screenshot["Screenshot UI<br/>[application.py]"]
end

subgraph group_interaction["Input &amp; Session"]
  node_keyboard_manager["Keyboard Manager<br/>[keyboardManager.js]"]
  node_focus_manager["Focus Manager<br/>[st-focus-manager.c]"]
  node_gestures["Gesture Manager<br/>[gesturesManager.js]"]
  node_screensaver["Screensaver Controller<br/>[controller.js]"]
  node_login_manager["Session Manager<br/>[loginManager.js]"]
end

subgraph group_integration["System Integrations"]
  node_system_tray["System Tray"]
  node_legacy_tray["X11 Tray Manager<br/>[na-tray-manager.c]"]
  node_modem_manager["Modem Integration<br/>[modemManager.js]"]
  node_mpris_controller["Media Controller<br/>[mprisController.js]"]
end

subgraph group_platform["Platform Core"]
  node_cinnamon_core["Cinnamon Core<br/>[main.c]"]
  node_st_toolkit["St Toolkit<br/>[st-widget.c]"]
end

node_user(("Desktop User"))
node_display_server{{"X11 or Wayland"}}
node_desktop_bus{{"System D-Bus"}}
node_settings_store[("Desktop Settings")]
node_logind{{"logind or ConsoleKit"}}
node_screen_service{{"Screensaver Service"}}
node_modem_service{{"ModemManager"}}
node_media_players{{"MPRIS Players"}}

node_user -->|"uses"| node_shell_main
node_shell_main -->|"dispatches"| node_window_manager
node_window_manager -->|"calls"| node_cinnamon_core
node_cinnamon_core -->|"manages"| node_display_server
node_window_manager -->|"manages"| node_workspace_ui
node_workspace_ui -->|"renders"| node_st_toolkit
node_shell_main -->|"starts"| node_panel
node_panel -->|"hosts"| node_applets
node_panel -->|"shows"| node_notification_tray
node_applets -->|"renders"| node_st_toolkit
node_shell_main -->|"loads"| node_desklets
node_desklets -->|"renders"| node_st_toolkit
node_settings_center -->|"writes"| node_settings_store
node_keyboard_manager -->|"reads"| node_settings_store
node_keyboard_manager -->|"queries"| node_desktop_bus
node_focus_manager -->|"navigates"| node_st_toolkit
node_gestures -->|"reads"| node_settings_store
node_gestures -->|"checks"| node_screen_service
node_screensaver -->|"renders"| node_st_toolkit
node_screensaver -->|"locks"| node_screen_service
node_login_manager -->|"connects"| node_logind
node_login_manager -->|"signals"| node_desktop_bus
node_system_tray -->|"creates"| node_legacy_tray
node_legacy_tray -->|"receives"| node_display_server
node_system_tray -->|"renders"| node_st_toolkit
node_background -->|"renders"| node_display_server
node_screenshot -->|"captures"| node_display_server
node_modem_manager -.->|"queries"| node_modem_service
node_mpris_controller -.->|"controls"| node_media_players

click node_shell_main "https://github.com/linuxmint/cinnamon/blob/master/js/ui/main.js"
click node_window_manager "https://github.com/linuxmint/cinnamon/blob/master/js/ui/windowManager.js"
click node_cinnamon_core "https://github.com/linuxmint/cinnamon/blob/master/src/main.c"
click node_st_toolkit "https://github.com/linuxmint/cinnamon/blob/master/src/st/st-widget.c"
click node_workspace_ui "https://github.com/linuxmint/cinnamon/blob/master/js/ui/workspacesView.js"
click node_panel "https://github.com/linuxmint/cinnamon/blob/master/js/ui/panel.js"
click node_applets "https://github.com/linuxmint/cinnamon/blob/master/files/usr/share/cinnamon/applets/calendar%40cinnamon.org/applet.js"
click node_desklets "https://github.com/linuxmint/cinnamon/blob/master/files/usr/share/cinnamon/desklets/clock%40cinnamon.org/desklet.js"
click node_settings_center "https://github.com/linuxmint/cinnamon/blob/master/files/usr/share/cinnamon/cinnamon-settings/cinnamon-settings.py"
click node_background "https://github.com/linuxmint/cinnamon/blob/master/src/background/daemon/cinnamon-background-daemon.c"
click node_notification_tray "https://github.com/linuxmint/cinnamon/blob/master/js/ui/messageTray.js"
click node_keyboard_manager "https://github.com/linuxmint/cinnamon/blob/master/js/ui/keyboardManager.js"
click node_focus_manager "https://github.com/linuxmint/cinnamon/blob/master/src/st/st-focus-manager.c"
click node_gestures "https://github.com/linuxmint/cinnamon/blob/master/js/ui/gestures/gesturesManager.js"
click node_screensaver "https://github.com/linuxmint/cinnamon/blob/master/js/ui/screensaver/controller.js"
click node_login_manager "https://github.com/linuxmint/cinnamon/blob/master/js/misc/loginManager.js"
click node_system_tray "https://github.com/linuxmint/cinnamon/blob/master/src/cinnamon-tray-manager.c"
click node_legacy_tray "https://github.com/linuxmint/cinnamon/blob/master/src/tray/na-tray-manager.c"
click node_modem_manager "https://github.com/linuxmint/cinnamon/blob/master/js/misc/modemManager.js"
click node_mpris_controller "https://github.com/linuxmint/cinnamon/blob/master/js/ui/gestures/mprisController.js"
click node_screenshot "https://github.com/linuxmint/cinnamon/blob/master/files/usr/share/cinnamon/cinnamon-screenshot/application.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_shell_main,node_window_manager,node_user,node_screen_service toneBlue
class node_workspace_ui,node_panel,node_applets,node_desklets,node_settings_center,node_background,node_notification_tray,node_screenshot,node_settings_store toneAmber
class node_keyboard_manager,node_focus_manager,node_gestures,node_screensaver,node_login_manager toneMint
class node_system_tray,node_legacy_tray,node_modem_manager,node_mpris_controller toneRose
class node_cinnamon_core,node_st_toolkit,node_display_server,node_desktop_bus,node_logind,node_modem_service,node_media_players toneIndigo
```

## Components

### Shell Runtime

- [Cinnamon Shell](https://github.com/linuxmint/cinnamon/blob/master/js/ui/main.js): `js/ui/main.js`
- [Window Manager](https://github.com/linuxmint/cinnamon/blob/master/js/ui/windowManager.js): `js/ui/windowManager.js`

### Desktop UI

- [Workspace UI](https://github.com/linuxmint/cinnamon/blob/master/js/ui/workspacesView.js): `js/ui/workspacesView.js`
- [Desktop Panel](https://github.com/linuxmint/cinnamon/blob/master/js/ui/panel.js): `js/ui/panel.js`
- [Cinnamon Applets](https://github.com/linuxmint/cinnamon/blob/master/files/usr/share/cinnamon/applets/calendar%40cinnamon.org/applet.js): `files/usr/share/cinnamon/applets/calendar@cinnamon.org/applet.js`
- [Desktop Desklets](https://github.com/linuxmint/cinnamon/blob/master/files/usr/share/cinnamon/desklets/clock%40cinnamon.org/desklet.js): `files/usr/share/cinnamon/desklets/clock@cinnamon.org/desklet.js`
- [Settings Center](https://github.com/linuxmint/cinnamon/blob/master/files/usr/share/cinnamon/cinnamon-settings/cinnamon-settings.py): `files/usr/share/cinnamon/cinnamon-settings/cinnamon-settings.py`
- [Background Service](https://github.com/linuxmint/cinnamon/blob/master/src/background/daemon/cinnamon-background-daemon.c): `src/background/daemon/cinnamon-background-daemon.c`
- [Notifications](https://github.com/linuxmint/cinnamon/blob/master/js/ui/messageTray.js): `js/ui/messageTray.js`
- [Screenshot UI](https://github.com/linuxmint/cinnamon/blob/master/files/usr/share/cinnamon/cinnamon-screenshot/application.py): `files/usr/share/cinnamon/cinnamon-screenshot/application.py`

### Input & Session

- [Keyboard Manager](https://github.com/linuxmint/cinnamon/blob/master/js/ui/keyboardManager.js): `js/ui/keyboardManager.js`
- [Focus Manager](https://github.com/linuxmint/cinnamon/blob/master/src/st/st-focus-manager.c): `src/st/st-focus-manager.c`
- [Gesture Manager](https://github.com/linuxmint/cinnamon/blob/master/js/ui/gestures/gesturesManager.js): `js/ui/gestures/gesturesManager.js`
- [Screensaver Controller](https://github.com/linuxmint/cinnamon/blob/master/js/ui/screensaver/controller.js): `js/ui/screensaver/controller.js`
- [Session Manager](https://github.com/linuxmint/cinnamon/blob/master/js/misc/loginManager.js): `js/misc/loginManager.js`

### System Integrations

- [System Tray](https://github.com/linuxmint/cinnamon/blob/master/src/cinnamon-tray-manager.c): `src/cinnamon-tray-manager.c`
- [X11 Tray Manager](https://github.com/linuxmint/cinnamon/blob/master/src/tray/na-tray-manager.c): `src/tray/na-tray-manager.c`
- [Modem Integration](https://github.com/linuxmint/cinnamon/blob/master/js/misc/modemManager.js): `js/misc/modemManager.js`
- [Media Controller](https://github.com/linuxmint/cinnamon/blob/master/js/ui/gestures/mprisController.js): `js/ui/gestures/mprisController.js`

### Platform Core

- [Cinnamon Core](https://github.com/linuxmint/cinnamon/blob/master/src/main.c): `src/main.c`
- [St Toolkit](https://github.com/linuxmint/cinnamon/blob/master/src/st/st-widget.c): `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

- 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
