How sameerasw/essentials works
Essentials is an Android utility and system-customization app for Pixel and other Android devices. Users configure features in the app or invoke them through system surfaces such as Quick Settings, widgets, shortcuts, accessibility, and voice search; app services and handlers then apply the requested device behavior. Major branches include DIY automation, the Island overlay, search and keyboard tools, and image watermarking. The README documents Shizuku/root support for advanced commands. Several feature paths are supported by the tree and README, but their internal wiring was not sampled, so those links are intentionally not inferred.
Main entry points: handlers System handlers · AutomationManager.kt Automation manager · BaseEssentialsAppFunctionService.kt Assistant functions · IslandCoordinator.kt Island coordinator
Components 25
App experience
- Feature screens
app/src/main/java/com/sameerasw/essentials/ui/activities - Settings storage
app/src/main/java/com/sameerasw/essentials/data/repository/SettingsRepository.kt
Device features
- Quick Settings tiles
app/src/main/java/com/sameerasw/essentials/services/tiles - Home widgets
app/src/main/java/com/sameerasw/essentials/services/widgets - Accessibility service
app/src/main/java/com/sameerasw/essentials/services/tiles/ScreenOffAccessibilityService.kt - System handlers
app/src/main/java/com/sameerasw/essentials/services/handlers
Automation
- Automation editor
app/src/main/java/com/sameerasw/essentials/ui/activities/AutomationEditorActivity.kt - Automation service
app/src/main/java/com/sameerasw/essentials/services/automation/AutomationService.kt - Automation manager
app/src/main/java/com/sameerasw/essentials/services/automation/AutomationManager.kt - Trigger modules
app/src/main/java/com/sameerasw/essentials/services/automation/modules - Action executors
app/src/main/java/com/sameerasw/essentials/services/automation/executors - DIY automation model
app/src/main/java/com/sameerasw/essentials/domain/diy - Assistant functions
app/src/main/java/com/sameerasw/essentials/appfunctions/BaseEssentialsAppFunctionService.kt
Island overlay
- Island coordinator
app/src/main/java/com/sameerasw/essentials/island/service/IslandCoordinator.kt - Island plugins
app/src/main/java/com/sameerasw/essentials/island/plugins - Island presentation
app/src/main/java/com/sameerasw/essentials/island/ui/IslandRoot.kt
Search and tools
- Pixel search results
app/src/main/java/com/sameerasw/essentials/ui/activities/PixelSearchResultsActivity.kt - Voice search session
app/src/main/java/com/sameerasw/essentials/services/EssentialsVoiceInteractionSessionService.kt - Essentials keyboard
app/src/main/java/com/sameerasw/essentials/ime/EssentialsInputMethodService.kt - Suggestion engine
app/src/main/java/com/sameerasw/essentials/ime/SuggestionEngine.kt - Image watermarking
app/src/main/java/com/sameerasw/essentials/domain/watermark/WatermarkEngine.kt
Other components
- Device user
- Shizuku or root
- Android system
- Image creator
Connections 24
- Device user → Feature screens: configures features
- Feature screens → Settings storage: reads and writes
- Device user → Quick Settings tiles: invokes controls
- Device user → Home widgets: uses widgets
- Device user → Accessibility service: enables service
- Accessibility service → System handlers: initializes handlers
- Quick Settings tiles → Android system: controls device
- System handlers → Android system: applies behavior
- System handlers → Shizuku or root: advanced commands
- Device user → Automation editor: creates automation
- Automation editor → DIY automation model: stores automation
- Automation service → Automation manager: connects service
- Automation manager → Trigger modules: starts modules
- Automation manager → Action executors: dispatches actions
- Assistant functions → Action executors: executes device actions
- Assistant functions → DIY automation model: adds automation
- Android system → Automation service: starts service
- Island coordinator → Island plugins: coordinates plugins
- Island coordinator → Island presentation: hosts overlay
- Android system → Voice search session: invokes assistant
- Voice search session → Pixel search results: launches results
- Device user → Essentials keyboard: types text
- Essentials keyboard → Suggestion engine: requests suggestions
- Image creator → Image watermarking: processes image