Skip to content

Widgets

Jump to bottom
sameerasw edited this page Aug 9, 2026 · 1 revision

🧩 Widgets

The Widgets group contains home screen and launcher widgets powered by Essentials.

Screen Off Widget

ID: Screen off widget
Permissions: ACCESSIBILITY
Sub-feature of: Widgets

A transparent, empty home screen widget that turns off the screen when tapped — effectively a "tap to sleep" shortcut on your home screen.

How it works

  • Adds a ScreenOffWidgetProvider as a standard Android App Widget
  • When tapped, it communicates with ScreenOffAccessibilityService to invoke performGlobalAction(GLOBAL_ACTION_LOCK_SCREEN)
  • No UI is shown — the widget is invisible by design

Adding to Home Screen

  1. Long-press home screen → Widgets
  2. Find "Essentials" → "Screen Off"
  3. Drag to desired position

Settings

Setting Key Description
Haptic feedback haptic_picker Choose the haptic pattern when tapped

Pixel Searchbar

ID: Pixel Searchbar
Permissions: WRITE_SECURE_SETTINGS
Toggle: Yes
Beta: 🧪
Sub-feature of: Widgets
Pixel only: ✅

Restores and customizes the Pixel Launcher's search bar widget. Allows enabling it even if it was removed or configuring its appearance.

Settings Screen

Opens PixelSearchbarSettingsActivity with customization options for:

  • Searchbar style
  • Corner radius
  • Background color/opacity

Notes

  • Marked as Beta — behavior may vary across Pixel launcher versions.
  • Requires WRITE_SECURE_SETTINGS and optionally Shizuku/Root for some settings.

Batteries

ID: Batteries
Permissions: BLUETOOTH_CONNECT, BLUETOOTH_SCAN
Sub-feature of: Widgets

A widget that displays battery levels for all connected Bluetooth accessories (earbuds, headphones, smartwatches, etc.) in one place.

Features

  • Scans for connected BT devices and reads battery levels
  • Supports multiple simultaneous devices
  • Refreshes automatically when device battery state changes

Adding the Widget

  1. Long-press home screen → Widgets
  2. Find "Essentials" → "Batteries"
  3. Resize as needed

Notes

  • Reads battery via the BLUETOOTH_CONNECT permission and BT profile battery APIs
  • Some BT devices don't expose their battery level via standard Android APIs — only devices that advertise battery via HFP/A2DP will appear

Parent: Widgets Group

Widgets
├── Screen off widget
├── Pixel Searchbar (Pixel only, Beta)
└── Batteries

Clone this wiki locally