How yunnijian/flymefreeform works
FlymeFreeform is an Android Xposed module that adds Flyme-style corner gestures and freeform-window shortcuts to ColorOS. The main flow is: System UI recognizes a configured corner swipe, the gesture coordinator presents a radial app chooser, and the chosen app opens using the platform’s existing freeform capability; “More” hands off to ColorOS’s all-apps sidebar panel. The app also configures settings, pinned apps, outside-tap close, and mini-window swipe behavior. Some subsystem links are documented in the README; unsampled implementations are represented only where their existence or relationship is supported by the index or README.
Main entry points: SystemUiCornerInputMonitor.kt Corner input monitor · FreeformGestureCoordinator.kt Gesture coordinator · ModuleSettingsSnapshot.kt Settings snapshot · CornerRadialOverlayView.kt Radial overlay
Components 27
Settings and configuration
- App entry
app/src/main/kotlin/io/github/mangi/flymefreeform/MainActivity.kt - Control and pins UI
app/src/main/kotlin/io/github/mangi/flymefreeform/ui/ControlScreen.kt - Framework connection
app/src/main/kotlin/io/github/mangi/flymefreeform/framework/FrameworkConnectionRepository.kt - Settings snapshot
app/src/main/kotlin/io/github/mangi/flymefreeform/config/ModuleSettingsSnapshot.kt - Preference protocol
app/src/main/kotlin/io/github/mangi/flymefreeform/config/ModulePreferences.kt - Outside-tap mode
app/src/main/kotlin/io/github/mangi/flymefreeform/config/OutsideTapCloseMode.kt
Gesture runtime
- Gesture coordinator
app/src/main/kotlin/io/github/mangi/flymefreeform/platform/common/FreeformGestureCoordinator.kt - Corner gesture engine
app/src/main/kotlin/io/github/mangi/flymefreeform/gesture/CornerGestureEngine.kt - Runtime environment
app/src/main/kotlin/io/github/mangi/flymefreeform/hook/ModuleEnvironmentState.kt - Hook configuration
app/src/main/kotlin/io/github/mangi/flymefreeform/hook/ProcessConfiguration.kt - Corner input monitor
app/src/main/kotlin/io/github/mangi/flymefreeform/hook/SystemUiCornerInputMonitor.kt - Outside-tap hook
app/src/main/kotlin/io/github/mangi/flymefreeform/hook/OutsideTapCloseHookInstaller.kt - Outside-tap classifier
app/src/main/kotlin/io/github/mangi/flymefreeform/gesture/OutsideTapGestureEngine.kt - Mini-window swipe hook
app/src/main/kotlin/io/github/mangi/flymefreeform/hook/HandleSwipeUpHookInstaller.kt
Overlay and app choice
- App catalog
app/src/main/kotlin/io/github/mangi/flymefreeform/platform/common/AppCatalog.kt - Launcher app repository
app/src/main/kotlin/io/github/mangi/flymefreeform/apps/LauncherAppRepository.kt - Radial overlay
app/src/main/kotlin/io/github/mangi/flymefreeform/window/CornerRadialOverlayView.kt
Platform integration
- Platform routing
app/src/main/kotlin/io/github/mangi/flymefreeform/platform/PlatformRouting.kt - ColorOS platform
app/src/main/kotlin/io/github/mangi/flymefreeform/platform/coloros/ColorOsPlatform.kt - HyperOS platform
app/src/main/kotlin/io/github/mangi/flymefreeform/platform/hyperos/HyperOsPlatform.kt - Freeform launcher
app/src/main/kotlin/io/github/mangi/flymefreeform/platform/common/FreeformLauncher.kt - Sidebar client
app/src/main/kotlin/io/github/mangi/flymefreeform/platform/coloros/ColorOsSidebarClient.kt - More-panel session
app/src/main/kotlin/io/github/mangi/flymefreeform/window/MorePanelSession.kt
Other components
- Device user
- Android System UI
- Android freeform system
- ColorOS sidebar
Connections 26
- Device user → Control and pins UI: configures
- App entry → Control and pins UI: hosts
app/src/main/kotlin/io/github/mangi/flymefreeform/MainActivity.kt - Control and pins UI → Framework connection: updates settings
app/src/main/kotlin/io/github/mangi/flymefreeform/ui/ControlScreen.kt - Framework connection → Settings snapshot: reads and writes
app/src/main/kotlin/io/github/mangi/flymefreeform/framework/FrameworkConnectionRepository.kt - Settings snapshot → Preference protocol: uses keys
app/src/main/kotlin/io/github/mangi/flymefreeform/config/ModuleSettingsSnapshot.kt - Settings snapshot → Outside-tap mode: decodes mode
app/src/main/kotlin/io/github/mangi/flymefreeform/config/ModuleSettingsSnapshot.kt - Android System UI → Corner input monitor: delivers touch
- Corner input monitor → Corner gesture engine: interprets gesture
app/src/main/kotlin/io/github/mangi/flymefreeform/hook/SystemUiCornerInputMonitor.kt - Corner input monitor → Hook configuration: reads settings
app/src/main/kotlin/io/github/mangi/flymefreeform/hook/SystemUiCornerInputMonitor.kt - Corner input monitor → Runtime environment: checks conditions
app/src/main/kotlin/io/github/mangi/flymefreeform/hook/SystemUiCornerInputMonitor.kt - Gesture coordinator → Corner gesture engine: processes gesture
app/src/main/kotlin/io/github/mangi/flymefreeform/platform/common/FreeformGestureCoordinator.kt - Gesture coordinator → Radial overlay: shows overlay
app/src/main/kotlin/io/github/mangi/flymefreeform/platform/common/FreeformGestureCoordinator.kt - Gesture coordinator → App catalog: loads app choices
app/src/main/kotlin/io/github/mangi/flymefreeform/platform/common/FreeformGestureCoordinator.kt - App catalog → Launcher app repository: queries apps
app/src/main/kotlin/io/github/mangi/flymefreeform/platform/common/AppCatalog.kt - Radial overlay → Freeform launcher: launches selection
- Freeform launcher → Android freeform system: opens freeform
- Radial overlay → Sidebar client: hands off More
- Sidebar client → More-panel session: tracks panel
app/src/main/kotlin/io/github/mangi/flymefreeform/platform/coloros/ColorOsSidebarClient.kt - Sidebar client → ColorOS sidebar: requests all-apps panel
- Platform routing → ColorOS platform: selects platform
app/src/main/kotlin/io/github/mangi/flymefreeform/platform/PlatformRouting.kt - Platform routing → HyperOS platform: selects platform
app/src/main/kotlin/io/github/mangi/flymefreeform/platform/PlatformRouting.kt - Outside-tap hook → Outside-tap classifier: classifies taps
app/src/main/kotlin/io/github/mangi/flymefreeform/hook/OutsideTapCloseHookInstaller.kt - Outside-tap classifier → Outside-tap mode: uses mode
app/src/main/kotlin/io/github/mangi/flymefreeform/gesture/OutsideTapGestureEngine.kt - Device user → Outside-tap hook: taps outside
- Device user → Mini-window swipe hook: swipes handle
- Device user → Corner input monitor: swipes corner