How basecamp/omarchy works
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: typing_setup.py Layout selectors · indicator.py Input indicator · launcher.py Slack launcher · KeyboardLayoutModel.js Keyboard widget
Components 34
Desktop shell
- Top bar
shell/plugins/bar/BarModel.js - Keyboard widget
shell/plugins/bar/widgets/KeyboardLayoutModel.js - Tray widget
shell/plugins/bar/widgets/TrayModel.js - Dock
shell/plugins/dock/DockModel.js - Navigation menu
shell/plugins/menu/MenuModel.js - On-screen display
shell/plugins/osd/OsdModel.js - Audio panel
shell/plugins/panels/audio/Model.js - Bluetooth panel
shell/plugins/panels/bluetooth/Model.js - Clock panel
shell/plugins/panels/clock/Model.js - Dropbox panel
shell/plugins/panels/dropbox/Model.js - Time and greetings
shell/plugins/panels/elsewhen/Model.js - Monitor panel
shell/plugins/panels/monitor/Model.js - Network panel
shell/plugins/panels/network/Model.js - Power panel
shell/plugins/panels/power/Model.js - Tailscale panel
shell/plugins/panels/tailscale/Model.js - Weather panel
shell/plugins/panels/weather/Model.js - Wi-Fi QR panel
shell/plugins/panels/wifiqr/Model.js
Shell features
- Clipboard history
shell/plugins/clipboard/ClipboardHistory.js - Emoji search
shell/plugins/emojis/EmojiSearch.js - Image picker
shell/plugins/image-picker/ImagePickerModel.js - Fingerprint lock
shell/plugins/lock/FingerprintModel.js - Notifications
shell/plugins/notifications/Store.js - Reminders
shell/plugins/reminders/ReminderFlowModel.js - Agent usage
shell/plugins/agents/collectors.py - Media service
shell/plugins/services/media/MediaModel.js - Battery service
shell/plugins/services/battery/BatteryModel.js - Idle service
shell/plugins/services/idle/IdleModel.js - Night light
shell/plugins/services/nightlight/NightlightModel.js - Remote sessions
shell/plugins/services/remote-session/RemoteSessionModel.js
System configuration
- Input configuration
default/input-methods/configure.py - Layout selectors
default/input-methods/typing_setup.py - Input indicator
default/input-methods/indicator.py
Application integrations
- Slack launcher
default/slack/launcher.py - Slack theme script
default/slack/theme.js
Connections 3
- Layout selectors → Input configuration: imports setup
default/input-methods/typing_setup.py - Input indicator → Keyboard widget: feeds state
default/input-methods/indicator.py - Slack launcher → Slack theme script: reads script
default/slack/launcher.py