How sanjyay/mirador works
Mirador is an Omarchy Shell plugin for navigating workspaces and windows in a fullscreen overview. Users open it by keyboard or gesture, browse in full, focused, or cycle views, then select, activate, close, or move windows. WorkspaceOverview is the apparent central UI from the source tree; README capabilities establish the broader workflow, but sampled excerpts do not show QML call wiring, so internal UI links are marked unverified. Geometry, window modeling, gestures, and jiggle animation are represented as distinct supporting layers.
Main entry points: WorkspaceOverview.qml Workspace overview · JiggleController.qml Jiggle controller · mirador Mirador launcher · mirador.bindings.lua Key bindings
Components 18
Entry and input
- Mirador launcher
bin/mirador - Key bindings
mirador.bindings.lua - Gesture bindings
mirador.gestures.lua - Gesture decisions
GestureHelper.js
Overview UI
- Workspace overview
WorkspaceOverview.qml - Carousel cycle
CarouselCycleView.qml - Compact cycle
CompactCycleView.qml - Workspace card
WorkspaceCard.qml - Insertion card
InsertionWorkspaceCard.qml - Window preview
WindowPreview.qml - Demo overlay
DemoInputOverlay.qml
Workspace and geometry
- Window model
WindowModel.js - Window geometry
WindowGeometry.js
Interaction effects
- Jiggle controller
JiggleController.qml - Jiggle surface
JiggleSurface.qml - Jiggle physics
JigglePhysics.js
Other components
- User
- Hyprland compositor
Connections 20
- User → Mirador launcher: opens overview
README.md - User → Key bindings: uses shortcuts
README.md - User → Gesture bindings: uses gestures
README.md - Key bindings → Mirador launcher: dispatches commands
README.md - Mirador launcher → Workspace overview: summons UI
- Gesture bindings → Workspace overview: toggles modes
- Workspace overview → Carousel cycle: offers cycle view
- Workspace overview → Compact cycle: offers cycle view
- Workspace overview → Workspace card: renders workspaces
- Workspace overview → Insertion card: offers workspace target
- Workspace card → Window preview: renders windows
- Workspace overview → Window model: models window state
- Workspace overview → Window geometry: computes layouts
- Hyprland compositor → Workspace overview: provides workspace state
- Hyprland compositor → Window preview: provides window geometry
README.md - User → Gesture decisions: pinches to switch
- Gesture decisions → Workspace overview: selects mode
- Workspace overview → Jiggle controller: animates changes
- Jiggle controller → Jiggle surface: updates surface
- Jiggle controller → Jiggle physics: uses physics