ShizuStore

Commander

astroboii47

0.1.0-alpha.7 · GitHub

Download APK
Customization Android 10+ 1 week ago MIT
330 ShizuStore
965 GitHub
30 Stars
11 MB Size

More about this app

Keyboard-first command bar and notification hub; uses Shizuku for recent-app switching and privileged shell controls.

Commander icon

Commander

A fast, keyboard-first command bar and notification hub for Android.

Support Commander on Ko-fi

Important

Commander is alpha software. Features may change, and some integrations depend on the Android version, device firmware, launcher, keyboard, and installed apps.

What it does

Commander puts common Android actions behind one searchable overlay. Open the bar from a hardware key, launcher gesture, shortcut, or optional home-screen typing, then type what you want to do.

  • Search installed apps and launcher shortcuts.
  • Switch between recent apps with previews, filtering, keyboard navigation, and optional hold-to-switch shortcuts.
  • Control accessible on-screen actions with compact keyboard hints and control search.
  • Add Todoist tasks with natural-language date and time recognition.
  • Browse Todoist Tasks, Upcoming, and Calendar views from the command bar.
  • Search files and folders, with optional previews and sorting.
  • Start timers, calculate expressions, and convert common units.
  • Search contacts for calls and messages.
  • Open configurable searches in Maps, YouTube, Spotify, Reddit, Play Store, and other apps.
  • Use optional live web suggestions and open a query in a dismissible quick-search sheet, privacy browser, or full browser.
  • Search common Android Settings destinations through a configurable alias.
  • Discover configured search and Tasker aliases directly inside the command bar.
  • Run selected Tasker tasks.
  • Ask Gemini in the overlay or continue a query in ChatGPT.
  • Read, filter, dismiss, open, and reply to supported notifications in Commander Hub.
  • Retain optional encrypted notification history for a user-selected period.
  • Organise SMS contacts and supported app conversations through Commander Contacts.
  • Trigger supported audio, display, media, battery, and device Quick Controls.
  • Launch Commander Bar from a minimal home-screen widget or supported assistant and navigation gestures.
  • Customise accent colour, blur, glow, app-result animation, and interface sounds.

Commander is designed for speed and physical-keyboard devices first. It also works on conventional Android phones and can be operated by touch, but its shortest workflows are built around typing and keyboard navigation.

Why Commander exists

Commander began as a passion project after I could not find the fast, keyboard-centric command palette I wanted on Android. I was also tired of seeing useful everyday workflows divided between subscriptions and paid apps. A tool that can make every interaction with a phone faster should be available to everyone, so Commander is open source.

The renewed interest in keyboard phones gives me hope that we can have more choice, not only in the devices we carry, but in the software designed for them. I still find it remarkable that devices like the Titan 2 and Q25 exist at all. I hope Commander makes them, and Android phones generally, just a little faster and more fun to use.

This project can only improve as a group effort. Testing, device reports, ideas, fixes, and thoughtful feedback are all valuable, especially from people using hardware and workflows I do not have access to.

See Commander in action

Commander app search demonstration
Fast app search from a physical keyboard.

Commander app search
Fast app search
Commander Todoist command
Recognised Todoist dates and times
Commander app search alias
Configurable app aliases
Commander Hub
Commander Hub

Commander running on a physical-keyboard phone
Select to watch the full in-hand walkthrough.

Tested devices

Most development and testing has been done on:

  • Unihertz Titan 2
  • Zinwa Q25
  • CMF Phone 2 Pro

Commander should work on other Android phones, including other keyboard phones, but hardware-key handling and background-launch behaviour vary between manufacturers. If you test another device, please open a compatibility report with the model, Android version, keyboard, launcher, and what worked or failed.

Tested integrations

The first alpha has been developed and personally tested primarily with:

  • Todoist for tasks
  • Google Calendar for calendar events
  • The device's default Clock app for timers
  • Pastiera Enhanced as the physical-keyboard input method
  • Solid Explorer for file and folder results
  • Gemini API for in-bar AI and ChatGPT for app hand-off
  • WhatsApp and Facebook Messenger for supported notification replies and messaging workflows

Other apps may work when they expose compatible Android intents, shortcuts, or notification actions, but they have not received the same level of testing yet.

Install and set up

Open the Commander releases page to download the latest APK

Warning

Play Protect may warn that Commander is unknown or block the installation. Commander is currently distributed directly through GitHub rather than Google Play, so new releases do not yet have Play Store reputation. Commander also offers optional Accessibility, notification, contact, SMS, and file features, which Android correctly treats as sensitive. These permissions are requested only for the related features and are explained in PRIVACY.md.

Download Commander only from this repository's Releases page. Each release includes a SHA-256 checksum so you can verify that the APK was downloaded intact. Do not disable Play Protect globally. If Android does not offer an informed install-anyway option, wait for a verified distribution route or build Commander from the public source.

  1. Download the APK from the latest GitHub release.
  2. Allow installation from the app you used to download it, then install Commander.
  3. Open Commander Settings.
  4. Configure only the permissions and integrations you intend to use.
  5. Add Commander Bar to a hardware key, launcher gesture, or automation app.

Commander requires Android 10 or newer.

Android may block Accessibility for manually installed apps until Allow restricted settings is enabled from Commander’s Android app-info page. Commander Settings provides direct links to both app info and Accessibility.

See the complete setup guide for notification access, home typing, files, contacts, Todoist, Gemini, Tasker, and keyboard shortcuts.

Default commands

Input Action
normal text Search installed apps
Space Search files and folders
@ Message a contact
# Call a contact
- Add a task
! Create a note
* Create a calendar event
+ Start a timer
, Calculate or convert units
/ Search the web
? Ask Gemini in Commander
?? Continue in ChatGPT

The note and file triggers are configurable. Search aliases can also be assigned to supported apps and services.

Commander Hub

Commander Hub uses Android’s notification-listener interface to collect active notifications into one keyboard-friendly view. It supports configurable category tabs, unread highlighting, dismissing notifications, opening their original destination, and inline replies when the originating app exposes an Android direct-reply action. Optional tabs can be shown automatically, kept visible, or hidden.

Notification history is off by default. When enabled, Commander retains encrypted text snapshots for the selected period. Images and live notification actions are not retained.

Reply support is determined by the notification. Some apps or notification types do not provide a reply action, and grouped notifications may expose only a summary.

Messaging integrations have additional Android and app-level constraints. WhatsApp and Messenger contacts cannot be queried as freely as ordinary device contacts. Exact-chat opening and quick replies therefore depend on conversation shortcuts, a live reply-capable notification, or an intent exposed by the installed app. Commander cannot guarantee silent background sending, and some flows may still require confirmation inside the messaging app.

Permissions and privacy

Commander has no advertising or analytics SDK. Data is processed locally except when you explicitly use a feature that contacts an external service, such as Gemini, Todoist, or a web/app search.

Powerful permissions are optional and feature-specific. Notification access, Accessibility, contacts, SMS, and full-file access should be enabled only if you use the corresponding feature. Gemini and Todoist credentials are encrypted with Android Keystore before being stored.

Read PRIVACY.md for the complete data and permission explanation.

Current alpha limitations

  • Home-screen typing depends on the active launcher and device keyboard handling.
  • Blur support varies by device and firmware.
  • Messaging-app automation depends on the intents, shortcuts, notifications, or reply actions exposed by those apps.
  • File access and folder opening can vary by file manager and Android storage implementation.
  • Commander Home remains experimental and is hidden from the alpha launcher build.

Roadmap

These are directions for future releases rather than promises or fixed deadlines:

  • Finish Commander Home as an optional launcher experience that can reduce reliance on Accessibility for home-screen typing.
  • Expand custom command triggers.
  • Simplify Settings and build a clearer first-run onboarding flow.
  • Support more task and calendar apps.
  • Add more configurable search providers and app-search integrations.
  • Expand quick-reply support across messaging apps.
  • Improve contact and conversation lookup.
  • Support more AI providers through bring-your-own-key integrations and app-intent hand-offs.
  • Improve blur on unsupported Android builds and deepen integration where device firmware permits it.

Build from source

Requirements:

  • JDK 17 or newer
  • Android SDK 36
./gradlew assembleDebug

The debug APK is written to app/build/outputs/apk/debug/.

API keys, signing keys, local.properties, and machine-specific paths are not part of the repository.

Contributing

Device reports, focused bug reports, and small pull requests are welcome. Please read CONTRIBUTING.md before submitting changes.

Support development

Commander is an open-source passion project. If it makes your phone faster or a little more fun to use, you can help support continued development:

Support Commander on Ko-fi

Licence and attribution

Commander is released under the MIT License. Third-party software and font notices are listed in NOTICE.md.

Commander is an independent project. It is not affiliated with, endorsed by, or sponsored by The Minimal Company Inc. or the makers of the third-party apps and services it can open.

Close

How Shizuku is used

Can browse, preview, switch and dismiss recent apps and run system controls via `ActivityTaskManager` and shell commands through Shizuku.

This is an AI-assisted analysis of Shizuku-related usages in the app's public source code. It is best effort, so it may not catch every single usage.

How this app uses Shizuku

Commander uses Shizuku to power its recent app switcher and several system quick controls from the command bar.

  • Browse recent apps: see a filtered list of recently used apps retrieved with privileged task access, with a shell dump fallback when the privileged service is unavailable.
  • Show app previews: display live thumbnail images for recent tasks using privileged task snapshots.
  • Switch between apps: jump directly to a selected recent task with a privileged foreground move, falling back to a shell move command or a normal app launch.
  • Dismiss recent tasks: close or remove a recent task from the switcher with privileged task removal.
  • Start split screen: identify the app under Commander to use as the split screen target by reading shell recent activity output through Shizuku.
  • Change system theme: apply the chosen dark, light or auto night mode with the cmd uimode night shell command through Shizuku.
  • Control battery protection: turn charging protection on or off or set a 70, 80, 90 or 100 percent limit with service call shell commands through Shizuku.
  • Toggle mini mode: switch the device mini mode state with a service call shell command through Shizuku.
  • Toggle scroll assistant: flip touchpad scrolling on or off by reading a system property and issuing a service call shell command through Shizuku.
  • Open audio output: open the system media output dialog with an am broadcast shell command through Shizuku when the normal broadcast fails.

Android APIs or commands used

  • ActivityTaskManager.getService
  • ActivityTaskManager.getRecentTasks
  • ActivityTaskManager.getTaskSnapshot
  • ActivityTaskManager.takeTaskSnapshot
  • ActivityTaskManager.moveTaskToFront
  • ActivityTaskManager.startActivityFromRecents
  • ActivityTaskManager.removeTask
  • TaskSnapshot.getHardwareBuffer
  • TaskSnapshot.getColorSpace
  • Bitmap.wrapHardwareBuffer
  • dumpsys activity recents
  • cmd uimode night
  • service call agui_common
  • service call AService
  • am broadcast
  • am stack move-task
  • getprop persist.sys.scroll_assistant

Notable details

Switching apps can still open the app normally when the privileged switch fails, recent apps can fall back to shell output, and audio output first tries a normal system broadcast before using Shizuku.

Close

Changelog

What's new for version 0.1.0-alpha.7

Commander 0.1.0 alpha 7

Alpha 7 makes Commander substantially more usable on conventional touch-screen phones while preserving its fast keyboard-first workflows.

Highlights

  • Faster Commander Bar: launch, focus, keyboard hand-off, and first-character handling have been tightened to reduce intermittent cold-start delay.
  • Flexible triggers: commands can have multiple custom triggers, including words and symbols, and supported triggers work at the start, end, or inline in a query.
  • Quick web lookup: optional live suggestions can open in a dismissible browser sheet, a privacy browser, or the full default browser.
  • Split-screen workflows: choose two apps, split the active app, or use a fast Recents-assisted flow on compatible Android builds.
  • Better touch support: result actions, file previews, app pickers, trigger pills, and a 1×1 Commander Bar widget make physical keys optional for more workflows.
  • Assistant routing: supported assistant invocation types can route separately to Commander Bar or another selected app.

Experimental Home status

Commander Home is still under active development. Its code remains in the project, but its launcher entry, shortcut, search result, and Settings UI are disabled in this public build. Commander Bar and Commander Hub continue to work independently.

Privacy note

Live Google query suggestions are optional and disabled by default. Enabling them sends the current web query to Google Suggest. Quick search uses the installed browser’s Custom Tab; private search is delegated to a supported installed privacy browser such as Firefox Focus.

Compatibility

This release adds testing and refinements for Nothing OS on CMF Phone 2 Pro alongside the existing Titan 2 and Zinwa Q25 testing. Android OEM behaviour still varies for assistant gestures, blur, split screen, Accessibility, and background app launches.

Close

Permissions

13 permissions requested

  • android.permission.READ_CONTACTS
  • android.permission.READ_CALENDAR
  • android.permission.SEND_SMS
  • android.permission.INTERNET
  • android.permission.SET_WALLPAPER
  • android.permission.ACCESS_NETWORK_STATE
  • android.permission.PACKAGE_USAGE_STATS
  • android.permission.CAMERA
  • android.permission.WRITE_SETTINGS
  • android.permission.MANAGE_EXTERNAL_STORAGE
  • com.android.alarm.permission.SET_ALARM
  • com.astroboii47.commander.DYNAMIC_RECEIVER_NOT_EXPORTED_PERMISSION
  • moe.shizuku.manager.permission.API_V23
Close