How hyacinthe-primus/dynamic-island works
Dynamic Island is a Windows 11 desktop shell: a floating pill and application dock expose system controls and productivity tools. The runtime starts through a watchdog, launches the Qt application and island window, then presents tabbed features backed by engines, Windows services, and local JSON storage. The README documents additional feature breadth and optional integrations; where their implementation was not sampled, the graph uses documented relationships rather than asserting unseen calls.
Main entry points: island.py Island window · app.py Qt application · tabs Feature tabs · main.py Runtime entry
Components 24
Runtime and UI
- Runtime entry
src/dynamic_island/main.py - Watchdog
src/dynamic_island/core/application/watchdog.py - Qt application
src/dynamic_island/app.py - Island window
src/dynamic_island/ui/windows/island.py - Island rendering
src/dynamic_island/ui/components/painting.py - Feature tabs
src/dynamic_island/ui/tabs - Tray controls
src/dynamic_island/ui/components/tray.py
Product Features
- Agenda
src/dynamic_island/engines/agenda.py - Tasks and notes
src/dynamic_island/engines/tasks.py - Timers
src/dynamic_island/engines/timers.py - App launcher
src/dynamic_island/engines/launcher.py - File shelf
src/dynamic_island/engines/files.py - Clipboard history
src/dynamic_island/engines/clipboard.py - Info, wallet, developer
src/dynamic_island/engines
Platform Services
- Network controls
src/dynamic_island/engines/network.py - Hotspot controls
src/dynamic_island/engines/hotspot.py - Phone service
src/dynamic_island/services/phone.py - Windows controls
src/dynamic_island/services/system.py
Shared Foundations
- JSON collections
src/dynamic_island/infrastructure/storage/collection.py - Settings
src/dynamic_island/core/config/settings.py - Data paths
src/dynamic_island/core/config/paths.py - Localization
src/dynamic_island/core/localization - Natural-language parsing
src/dynamic_island/engines/nlp.py
Other components
- Desktop user
Connections 30
- Desktop user → Runtime entry: starts app
README.md - Runtime entry → Watchdog: starts by default
src/dynamic_island/main.py - Runtime entry → Qt application: runs island mode
src/dynamic_island/main.py - Watchdog → Qt application: launches app
- Qt application → Island window: creates window
src/dynamic_island/app.py - Qt application → Tray controls: creates tray
src/dynamic_island/app.py - Island window → Island rendering: renders window
src/dynamic_island/ui/windows/island.py - Island window → Feature tabs: shows features
README.md - Island window → Agenda: reads agenda
src/dynamic_island/ui/windows/island.py - Island window → Tasks and notes: uses tasks
src/dynamic_island/ui/windows/island.py - Island window → Timers: uses timers
src/dynamic_island/ui/windows/island.py - Island window → App launcher: uses launcher
src/dynamic_island/ui/windows/island.py - Island window → File shelf: uses file shelf
src/dynamic_island/ui/windows/island.py - Island window → Clipboard history: uses clipboard
src/dynamic_island/ui/windows/island.py - Island window → Info, wallet, developer: uses feature engines
src/dynamic_island/ui/windows/island.py - Island window → Hotspot controls: uses hotspot
src/dynamic_island/ui/windows/island.py - Island window → Windows controls: controls taskbar
src/dynamic_island/ui/windows/island.py - Agenda → Natural-language parsing: parses entries
src/dynamic_island/engines/agenda.py - Tasks and notes → Natural-language parsing: parses tasks
src/dynamic_island/engines/tasks.py - Tasks and notes → JSON collections: stores items
src/dynamic_island/engines/tasks.py - Agenda → JSON collections: stores events
src/dynamic_island/engines/agenda.py - JSON collections → Settings: reads sync setting
src/dynamic_island/infrastructure/storage/collection.py - JSON collections → Data paths: resolves data folder
src/dynamic_island/infrastructure/storage/collection.py - Qt application → Data paths: resolves icon
src/dynamic_island/app.py - Qt application → Windows controls: sets window style
src/dynamic_island/app.py - Runtime entry → Phone service: phone integration
src/dynamic_island/main.py - Feature tabs → Network controls: offers network panels
README.md - Feature tabs → Phone service: offers phone tools
README.md - Feature tabs → Info, wallet, developer: offers documented tools
README.md - Feature tabs → Localization: localized interface
README.md