How hunoia/luno works
Luno is an Android gesture-and-overlay utility: users configure gestures, panels, actions, and automation rules, then invoke them through system gestures, the floating ball, or quick search. The runtime dispatches actions and automation against Android capabilities; settings and rules are persisted through the configuration layer. The graph preserves the major product branches visible in the tree. Several relationships are omitted because their implementing source was not sampled and the README provides no additional evidence.
Main entry points: ConfigProvider.kt Configuration API · ActionDispatcher.kt Action dispatch · QuickSearchActivity.kt Quick search · SideGestureService.kt Gesture service
Components 24
App entry
- Application setup
app/src/main/java/hunoia/luno/App.kt - Gesture service
app/src/main/java/hunoia/luno/service/SideGestureService.kt
Gesture runtime
- Gesture coordinator
app/src/main/java/hunoia/luno/runtime/GestureCoordinator.kt - Gesture overlays
feature/gesture/src/main/java/hunoia/luno/runtime/overlay/ButtonWindowController.kt - Floating ball
feature/floatball/src/main/java/hunoia/luno/runtime/floatball/FloatBallService.kt - Runtime host
core/runtime/src/main/java/hunoia/luno/runtime/RuntimeHost.kt - Shizuku bridge
core/bridge/src/main/java/hunoia/luno/shizuku/ShizukuManager.kt
Actions and search
- Action library
feature/actions/src/main/java/hunoia/luno/domain/action/ActionLibrary.kt - Action dispatch
feature/execute/src/main/java/hunoia/luno/action/dispatcher/ActionDispatcher.kt - System controllers
feature/actions/src/main/java/hunoia/luno/action/controller/Controllers.kt - Quick search
feature/quicklaunch/src/main/java/hunoia/luno/quicklaunch/QuickSearchActivity.kt - Search result rows
feature/search/src/main/java/hunoia/luno/quicklaunch/query/SearchEngineResultRows.kt - App launching
capability/launch/src/main/java/hunoia/luno/quicklaunch/launch/AppLaunchCoordinator.kt - Link dispatch
feature/link/src/main/java/hunoia/luno/link/LinkDispatcher.kt
Automation
- Automation engine
feature/automation/src/main/java/hunoia/luno/runtime/automation/AutomationEngine.kt - Automation editor
app/src/main/java/hunoia/luno/ui/automation/AutomationEditScreen.kt - Condition evaluation
feature/conditions/src/main/java/hunoia/luno/runtime/condition/ConditionEvaluator.kt
Configuration
- Configuration API
core/data/src/main/java/hunoia/luno/config/ConfigProvider.kt - Settings stores
core/data/src/main/java/hunoia/luno/config/store/SettingsStores.kt - Stored action contract
core/domain/src/main/kotlin/hunoia/luno/core/domain/StoredAction.kt - Backup and restore
core/data/src/main/java/hunoia/luno/config/backup/ConfigBackupRepository.kt
Other components
- Device user
- Accessibility service
- Android system
Connections 20
- Device user → Gesture service: performs gestures
- Accessibility service → Gesture service: hosts service
app/src/main/java/hunoia/luno/service/SideGestureService.kt - Gesture service → Gesture coordinator: delegates actions
app/src/main/java/hunoia/luno/service/SideGestureService.kt - Device user → Quick search: opens search
- Quick search → Action dispatch: dispatches action
feature/quicklaunch/src/main/java/hunoia/luno/quicklaunch/QuickSearchActivity.kt - Quick search → Search result rows: renders results
- Floating ball → Link dispatch: dispatches links
feature/floatball/src/main/java/hunoia/luno/runtime/floatball/FloatBallService.kt - Floating ball → Stored action contract: creates launch action
feature/floatball/src/main/java/hunoia/luno/runtime/floatball/FloatBallService.kt - Action dispatch → System controllers: executes actions
- Action dispatch → App launching: launches apps
- Action library → Stored action contract: uses action contract
core/domain/src/main/kotlin/hunoia/luno/core/domain/StoredAction.kt - Automation editor → Configuration API: edits rules
- Automation engine → Condition evaluation: evaluates conditions
- Automation engine → Configuration API: records events
- Application setup → Configuration API: initializes configuration
- Configuration API → Settings stores: reads and writes
core/data/src/main/java/hunoia/luno/config/ConfigProvider.kt - Backup and restore → Settings stores: backs up settings
- Gesture coordinator → Runtime host: uses runtime
- Gesture overlays → Android system: manages overlay windows
feature/gesture/src/main/java/hunoia/luno/runtime/overlay/ButtonWindowController.kt - Shizuku bridge → Android system: requests system access
core/bridge/src/main/java/hunoia/luno/shizuku/ShizukuManager.kt