How quantumfate/hypr works
Hypr is a multi-machine Hyprland desktop configuration: users operate a configured compositor through key bindings and window/workspace behavior, while scene documents describe window placement for scene engines to execute. Its runtime also includes focus/workspace management, layouts, themes, and optional desktop services such as Dofus turn swapping and Obsidian integrations. The README and tree establish these product areas, but the sampled source excerpts are mostly auxiliary Python tools; internal Lua call wiring is therefore shown only where supported by explicit documentation, and otherwise left unspecified.
Main entry points: scene Scene engines · obsidian_vault.py Vault utilities · obsidian_linear_sync.py Linear sync · ,scene-apply.sh Scene apply
Components 25
Desktop configuration
- Compositor config
hyprland.lua - Base options
conf/base.lua - Host options
conf/host.lua - Key bindings
hypr/binds.lua - Workspace config
hypr/workspaces.lua - Compositor events
hypr/events/init.lua
Scene management
- Scene documents
docs/scenes.md - Scene apply
bin/,scene-apply.sh - Scene engines
hypr/scene - Window grouping
hypr/scene/grouping.lua - Scene layout
hypr/scene/layout.lua
Focus and navigation
- Hyprfocus
hypr/hyprfocus - Focus dispatcher
bin/,hyprfocus - Window layouts
hypr/layouts
Desktop integrations
- Theme system
hypr/themes - Dofus services
hypr/services/dofus - Turn swap detector
bin/dofus_swap.py - Obsidian tooling
hypr/services/obsidian - Vault utilities
bin/obsidian_vault.py - Linear sync
bin/obsidian_linear_sync.py
Other components
- Desktop user
- Hyprland
- Obsidian
- Linear
- Vault and tag store
Connections 17
- Desktop user → Hyprland: operates
- Compositor config → Hyprland: configures
- Desktop user → Key bindings: uses
- Scene documents → Scene apply: describes placement
- Scene apply → Scene engines: executes scenes
- Scene engines → Window grouping: uses grouping
- Scene engines → Scene layout: uses layout
- Desktop user → Focus dispatcher: invokes
- Focus dispatcher → Hyprfocus: dispatches
- Desktop user → Turn swap detector: runs
- Turn swap detector → Hyprland: queries and focuses
- Desktop user → Vault utilities: runs
- Vault utilities → Obsidian: invokes CLI
- Vault utilities → Vault and tag store: reads and writes
- Desktop user → Linear sync: runs sync
- Linear sync → Linear: reads hierarchy
- Linear sync → Vault and tag store: updates notes