How osouthgate/omarchy-minimize works
Omarchy Minimize is an Omarchy bar widget and service for hiding individual Hyprland windows, listing minimized and compatible scratchpad/Dock windows, and restoring them by compositor address. Its main flow runs from bar or keyboard actions through the service, which reconciles live compositor clients, plans address-guarded moves, and updates the sidebar. Users can also review help and configure optional conflict-checked shortcuts. The README documents service behavior and session-scoped metadata; sampled source covers the pure model and transaction builders, but not their runtime wiring.
Main entry points: Service.qml Minimize service · configure-shortcuts Shortcut configurator · ShortcutSettingsView.qml Shortcut settings · Panel.qml Bar widget
Components 13
Sidebar interface
- Bar widget
Panel.qml - Window row
WindowRow.qml - Help view
HelpView.qml - Shortcut settings
ShortcutSettingsView.qml
Window management
- Minimize service
Service.qml - Client model
MinimizeModel.js - Compositor transactions
CompositorTransaction.js - Session metadata
Service.qml
Shortcut setup
- Shortcut configurator
bin/configure-shortcuts
Desktop integration
- Omarchy shell
- Hyprland compositor
- Hyprland bindings
Other components
- User
Connections 16
- User → Bar widget: clicks
- User → Window row: selects
- User → Shortcut settings: configures
- Bar widget → Minimize service: invokes actions
- Window row → Minimize service: requests restore
- Shortcut settings → Minimize service: requests actions
- Minimize service → Client model: plans and reconciles
- Minimize service → Compositor transactions: builds moves
- Minimize service → Hyprland compositor: queries clients and dispatches
- Hyprland compositor → Minimize service: returns live state
- Minimize service → Session metadata: reads and writes
- Omarchy shell → Minimize service: dispatches commands
- Shortcut settings → Shortcut configurator: optional setup
- Shortcut configurator → Hyprland compositor: checks binds and reloads
- Shortcut configurator → Hyprland bindings: backs up and edits
- Shortcut configurator → Hyprland compositor: validates config