How krishnarajan7/liova works
Liova is a macOS menu-bar app that turns the Mac’s notch into an interactive display for system events, media, and coding-agent activity. The main path is menu-bar launch into app coordination, feature state and activity prioritization, then notch presentation; scripts and local links can also submit activities through the plugin interface. The README documents the broader feature set and opt-in network services. Several feature implementations were not sampled, so those branches use exact enclosing directories and documented relationships; edges reflect only shown imports/calls or README statements.
Main entry points: AppCoordinator.swift App coordinator · ActivityRenderer.swift Notch rendering · ActivityEngine.swift Activity engine · NotchController.swift Notch controller
Components 25
App and display
- Menu bar
App/MenuBarIcon.swift - App coordinator
App/AppCoordinator.swift - Settings
Packages/LiovaKit/Sources/LiovaCore/LiovaSettings.swift - Display manager
Packages/LiovaKit/Sources/LiovaCore/DisplayManager.swift - Notch controller
Packages/LiovaKit/Sources/LiovaUI/NotchController.swift - Notch rendering
Packages/LiovaKit/Sources/LiovaUI/ActivityRenderer.swift
Core and plugin API
- Activity engine
Packages/LiovaKit/Sources/LiovaCore/ActivityEngine.swift - Plugin API
Packages/LiovaKit/Sources/LiovaPluginKit/Activity.swift - Local IPC
Packages/LiovaKit/Sources/LiovaIPC/IPCClient.swift - CLI commands
Packages/LiovaKit/Sources/LiovaIPC/CommandLine/CLIParser.swift
Notch features
- Now playing
Packages/LiovaKit/Sources/LiovaFeatures/NowPlaying/NowPlayingFeature.swift - Agent Island
Packages/LiovaKit/Sources/LiovaFeatures/Agents - Battery and headphones
Packages/LiovaKit/Sources/LiovaFeatures - Downloads
Packages/LiovaKit/Sources/LiovaFeatures/Downloads - Notch utilities
Packages/LiovaKit/Sources/LiovaFeatures - Volume and brightness HUD
Packages/LiovaKit/Sources/LiovaFeatures/HUD/HUDFeature.swift
System providers
- Lyrics service
Packages/LiovaKit/Sources/LiovaProviders/Lyrics/LyricsClient.swift - Weather service
Packages/LiovaKit/Sources/LiovaProviders/Weather/OpenMeteoClient.swift - Update service
Packages/LiovaKit/Sources/LiovaProviders/Updates/GitHubReleaseClient.swift
Other components
- Mac user
- Local socket
- User scripts
- LRCLIB
- Open-Meteo
- GitHub releases
Connections 24
- Mac user → Menu bar: opens
- Menu bar → App coordinator: launches
- App coordinator → Settings: uses
App/AppCoordinator.swift - App coordinator → Display manager: uses
App/AppCoordinator.swift - App coordinator → Activity engine: uses
App/AppCoordinator.swift - App coordinator → Notch controller: configures
App/AppCoordinator.swift - App coordinator → Now playing: starts
App/AppCoordinator.swift - App coordinator → Volume and brightness HUD: starts
App/AppCoordinator.swift - Activity engine → Plugin API: manages
Packages/LiovaKit/Sources/LiovaCore/ActivityEngine.swift - User scripts → CLI commands: submits activity
- CLI commands → Local IPC: parses commands
Packages/LiovaKit/Sources/LiovaIPC/CommandLine/CLIParser.swift - Local IPC → Local socket: connects over
- Local socket → Activity engine: delivers activity
- Notch controller → Activity engine: shows activity
Packages/LiovaKit/Sources/LiovaUI/NotchController.swift - Notch controller → Notch rendering: hosts views
Packages/LiovaKit/Sources/LiovaUI/NotchController.swift - Now playing → Lyrics service: looks up lyrics
- Lyrics service → LRCLIB: fetches from
- Weather service → Open-Meteo: fetches from
- Update service → GitHub releases: checks releases
Packages/LiovaKit/Sources/LiovaProviders/Updates/GitHubReleaseClient.swift - Battery and headphones → Notch rendering: appears in notch
- Agent Island → Notch rendering: appears in notch
- Downloads → Notch rendering: appears in notch
- Notch utilities → Notch rendering: appears in notch
- Volume and brightness HUD → Notch rendering: shows HUDs