# basecamp/omarchy architecture

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

- Interactive diagram: https://gitdiagram.com/basecamp/omarchy
- Repository: https://github.com/basecamp/omarchy

## Overview

Omarchy is a Linux distribution whose user-facing product is a configurable desktop environment, complemented by system setup and application integrations. The documented workflow spans navigation and top-bar controls, system panels and services, and utilities such as clipboard history and reminders; input-method setup is a separate configuration stage. The sampled tree exposes many implementations but few wiring points, so the graph preserves major feature areas without guessing how unsampled shell components are connected.

Main entry points: [`default/input-methods/typing_setup.py`](https://github.com/basecamp/omarchy/blob/quattro/default/input-methods/typing_setup.py) (Layout selectors), [`default/input-methods/indicator.py`](https://github.com/basecamp/omarchy/blob/quattro/default/input-methods/indicator.py) (Input indicator), [`default/slack/launcher.py`](https://github.com/basecamp/omarchy/blob/quattro/default/slack/launcher.py) (Slack launcher), [`shell/plugins/bar/widgets/KeyboardLayoutModel.js`](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/bar/widgets/KeyboardLayoutModel.js) (Keyboard widget)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell_ui["Desktop shell"]
  node_bar["Top bar<br/>[BarModel.js]"]
  node_keyboard_widget["Keyboard widget"]
  node_tray_widget["Tray widget<br/>[TrayModel.js]"]
  node_dock["Dock<br/>[DockModel.js]"]
  node_menu["Navigation menu<br/>[MenuModel.js]"]
  node_osd["On-screen display<br/>[OsdModel.js]"]
  node_audio_panel["Audio panel<br/>[Model.js]"]
  node_bluetooth_panel["Bluetooth panel<br/>[Model.js]"]
  node_clock_panel["Clock panel<br/>[Model.js]"]
  node_dropbox_panel["Dropbox panel<br/>[Model.js]"]
  node_elsewhen_panel["Time and greetings<br/>[Model.js]"]
  node_monitor_panel["Monitor panel<br/>[Model.js]"]
  node_network_panel["Network panel<br/>[Model.js]"]
  node_power_panel["Power panel<br/>[Model.js]"]
  node_tailscale_panel["Tailscale panel<br/>[Model.js]"]
  node_weather_panel["Weather panel<br/>[Model.js]"]
  node_wifiqr_panel["Wi-Fi QR panel<br/>[Model.js]"]
end

subgraph group_shell_features["Shell features"]
  node_clipboard["Clipboard history"]
  node_emoji_search["Emoji search<br/>[EmojiSearch.js]"]
  node_image_picker["Image picker"]
  node_fingerprint["Fingerprint lock"]
  node_notifications["Notifications<br/>[Store.js]"]
  node_reminders["Reminders"]
  node_agent_usage["Agent usage<br/>[collectors.py]"]
  node_media_service["Media service<br/>[MediaModel.js]"]
  node_battery_service["Battery service<br/>[BatteryModel.js]"]
  node_idle_service["Idle service<br/>[IdleModel.js]"]
  node_nightlight_service["Night light<br/>[NightlightModel.js]"]
  node_remote_session["Remote sessions"]
end

subgraph group_system["System configuration"]
  node_input_setup["Input configuration<br/>[configure.py]"]
  node_typing_setup["Layout selectors<br/>[typing_setup.py]"]
  node_input_indicator["Input indicator<br/>[indicator.py]"]
end

subgraph group_integrations["Application integrations"]
  node_slack_launcher["Slack launcher<br/>[launcher.py]"]
  node_slack_theme["Slack theme script<br/>[theme.js]"]
end

subgraph group_shared["Shared services"]
end

node_typing_setup -->|"imports setup"| node_input_setup
node_input_indicator -->|"feeds state"| node_keyboard_widget
node_slack_launcher -->|"reads script"| node_slack_theme

click node_bar "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/bar/BarModel.js"
click node_keyboard_widget "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/bar/widgets/KeyboardLayoutModel.js"
click node_tray_widget "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/bar/widgets/TrayModel.js"
click node_dock "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/dock/DockModel.js"
click node_menu "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/menu/MenuModel.js"
click node_osd "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/osd/OsdModel.js"
click node_audio_panel "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/panels/audio/Model.js"
click node_bluetooth_panel "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/panels/bluetooth/Model.js"
click node_clock_panel "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/panels/clock/Model.js"
click node_dropbox_panel "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/panels/dropbox/Model.js"
click node_elsewhen_panel "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/panels/elsewhen/Model.js"
click node_monitor_panel "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/panels/monitor/Model.js"
click node_network_panel "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/panels/network/Model.js"
click node_power_panel "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/panels/power/Model.js"
click node_tailscale_panel "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/panels/tailscale/Model.js"
click node_weather_panel "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/panels/weather/Model.js"
click node_wifiqr_panel "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/panels/wifiqr/Model.js"
click node_clipboard "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/clipboard/ClipboardHistory.js"
click node_emoji_search "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/emojis/EmojiSearch.js"
click node_image_picker "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/image-picker/ImagePickerModel.js"
click node_fingerprint "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/lock/FingerprintModel.js"
click node_notifications "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/notifications/Store.js"
click node_reminders "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/reminders/ReminderFlowModel.js"
click node_agent_usage "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/agents/collectors.py"
click node_media_service "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/services/media/MediaModel.js"
click node_battery_service "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/services/battery/BatteryModel.js"
click node_idle_service "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/services/idle/IdleModel.js"
click node_nightlight_service "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/services/nightlight/NightlightModel.js"
click node_remote_session "https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/services/remote-session/RemoteSessionModel.js"
click node_input_setup "https://github.com/basecamp/omarchy/blob/quattro/default/input-methods/configure.py"
click node_typing_setup "https://github.com/basecamp/omarchy/blob/quattro/default/input-methods/typing_setup.py"
click node_input_indicator "https://github.com/basecamp/omarchy/blob/quattro/default/input-methods/indicator.py"
click node_slack_launcher "https://github.com/basecamp/omarchy/blob/quattro/default/slack/launcher.py"
click node_slack_theme "https://github.com/basecamp/omarchy/blob/quattro/default/slack/theme.js"

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_bar,node_keyboard_widget,node_tray_widget,node_dock,node_menu,node_osd,node_audio_panel,node_bluetooth_panel,node_clock_panel,node_dropbox_panel,node_elsewhen_panel,node_monitor_panel,node_network_panel,node_power_panel,node_tailscale_panel,node_weather_panel,node_wifiqr_panel toneBlue
class node_clipboard,node_emoji_search,node_image_picker,node_fingerprint,node_notifications,node_reminders,node_agent_usage,node_media_service,node_battery_service,node_idle_service,node_nightlight_service,node_remote_session toneAmber
class node_input_setup,node_typing_setup,node_input_indicator toneMint
class node_slack_launcher,node_slack_theme toneRose
```

## Components

### Desktop shell

- [Top bar](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/bar/BarModel.js): `shell/plugins/bar/BarModel.js`
- [Keyboard widget](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/bar/widgets/KeyboardLayoutModel.js): `shell/plugins/bar/widgets/KeyboardLayoutModel.js`
- [Tray widget](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/bar/widgets/TrayModel.js): `shell/plugins/bar/widgets/TrayModel.js`
- [Dock](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/dock/DockModel.js): `shell/plugins/dock/DockModel.js`
- [Navigation menu](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/menu/MenuModel.js): `shell/plugins/menu/MenuModel.js`
- [On-screen display](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/osd/OsdModel.js): `shell/plugins/osd/OsdModel.js`
- [Audio panel](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/panels/audio/Model.js): `shell/plugins/panels/audio/Model.js`
- [Bluetooth panel](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/panels/bluetooth/Model.js): `shell/plugins/panels/bluetooth/Model.js`
- [Clock panel](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/panels/clock/Model.js): `shell/plugins/panels/clock/Model.js`
- [Dropbox panel](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/panels/dropbox/Model.js): `shell/plugins/panels/dropbox/Model.js`
- [Time and greetings](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/panels/elsewhen/Model.js): `shell/plugins/panels/elsewhen/Model.js`
- [Monitor panel](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/panels/monitor/Model.js): `shell/plugins/panels/monitor/Model.js`
- [Network panel](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/panels/network/Model.js): `shell/plugins/panels/network/Model.js`
- [Power panel](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/panels/power/Model.js): `shell/plugins/panels/power/Model.js`
- [Tailscale panel](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/panels/tailscale/Model.js): `shell/plugins/panels/tailscale/Model.js`
- [Weather panel](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/panels/weather/Model.js): `shell/plugins/panels/weather/Model.js`
- [Wi-Fi QR panel](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/panels/wifiqr/Model.js): `shell/plugins/panels/wifiqr/Model.js`

### Shell features

- [Clipboard history](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/clipboard/ClipboardHistory.js): `shell/plugins/clipboard/ClipboardHistory.js`
- [Emoji search](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/emojis/EmojiSearch.js): `shell/plugins/emojis/EmojiSearch.js`
- [Image picker](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/image-picker/ImagePickerModel.js): `shell/plugins/image-picker/ImagePickerModel.js`
- [Fingerprint lock](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/lock/FingerprintModel.js): `shell/plugins/lock/FingerprintModel.js`
- [Notifications](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/notifications/Store.js): `shell/plugins/notifications/Store.js`
- [Reminders](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/reminders/ReminderFlowModel.js): `shell/plugins/reminders/ReminderFlowModel.js`
- [Agent usage](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/agents/collectors.py): `shell/plugins/agents/collectors.py`
- [Media service](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/services/media/MediaModel.js): `shell/plugins/services/media/MediaModel.js`
- [Battery service](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/services/battery/BatteryModel.js): `shell/plugins/services/battery/BatteryModel.js`
- [Idle service](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/services/idle/IdleModel.js): `shell/plugins/services/idle/IdleModel.js`
- [Night light](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/services/nightlight/NightlightModel.js): `shell/plugins/services/nightlight/NightlightModel.js`
- [Remote sessions](https://github.com/basecamp/omarchy/blob/quattro/shell/plugins/services/remote-session/RemoteSessionModel.js): `shell/plugins/services/remote-session/RemoteSessionModel.js`

### System configuration

- [Input configuration](https://github.com/basecamp/omarchy/blob/quattro/default/input-methods/configure.py): `default/input-methods/configure.py`
- [Layout selectors](https://github.com/basecamp/omarchy/blob/quattro/default/input-methods/typing_setup.py): `default/input-methods/typing_setup.py`
- [Input indicator](https://github.com/basecamp/omarchy/blob/quattro/default/input-methods/indicator.py): `default/input-methods/indicator.py`

### Application integrations

- [Slack launcher](https://github.com/basecamp/omarchy/blob/quattro/default/slack/launcher.py): `default/slack/launcher.py`
- [Slack theme script](https://github.com/basecamp/omarchy/blob/quattro/default/slack/theme.js): `default/slack/theme.js`

## Connections

- Layout selectors → Input configuration: imports setup (evidence: `default/input-methods/typing_setup.py`)
- Input indicator → Keyboard widget: feeds state (evidence: `default/input-methods/indicator.py`)
- Slack launcher → Slack theme script: reads script (evidence: `default/slack/launcher.py`)
