Skip to content

About

Personal Fork of OmaLauncher adding traditional android launcher functionality for the Android power user

Resources

Stars

2 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

Omalauncher

This is a personal fork of Omalauncher, created by Simon Schubert. The official app is on Google Play.

This fork follows upstream and adds its own changes: a feed left of the first home page, folders that open out of their tile, and backup & restore. Its APKs are published on this repository's releases and signed with a different key, so they are not the Google Play app: one can't be installed over the other, and the original author doesn't support this fork. Please don't report its problems upstream.

MIT licensed, like the original (LICENSE).

What this fork adds: the feed

Swipe right on the first home page for Hacker News, recent posts from tech accounts on X, and headlines from tech and news sites, in the theme's colors. Settings › feed picks the sites, the X accounts, muted words and how often it refreshes (more).

The feed: Hacker News, posts from X and tech and news headlines, one swipe right from home The feed's settings: sites, X accounts, muted words and how often it refreshes The feed in the White, Tokyo Night and Vantablack themes


An Android home screen with the look of Omarchy, and an optional Arch Linux ARM system next to your phone apps. Omalauncher runs the system under proot, without root, and is its Wayland compositor: every Linux window opens as its own Android task, with its own card in Recents.

Get it on Google Play

The home screen in twelve Omarchy themes, each with different widgets

Screenshot Screenshot Screenshot Screenshot

  • Themes: all 22 Omarchy themes, with their wallpapers, applied to the launcher and to the Linux apps, plus the community themes from omarchy.org/themes, or your own in ~/.config/omarchy/themes
  • Widgets written in OWL, a small declarative language you can edit on the phone, plus a widget store
  • Linux, optional: pacman and the AUR, Linux apps in their own windows, terminal widgets, a file manager, and opt-in GPU acceleration on Mali and Adreno 6xx+ GPUs
  • Coding agents: the bar at the bottom sends a prompt to Claude Code, Codex, Copilot, opencode and others, which open in a terminal
  • Feed: swipe right from the first home page for Hacker News' top 50, tech accounts on X, and tech and news sites, in the theme's colors
  • No account, no ads, no tracking

Needs an arm64 phone with Android 10 or newer. Without Linux, the launcher still has the themes, wallpapers, Android apps and the widgets that don't run commands.

Using it

The bar: the one input at the bottom of the home screen opens apps and asks coding agents. Focusing it opens the list of Linux and Android apps; typing narrows the list, and Enter opens the highlighted app or sends the text to the agent. Short queries that name an app open it, sentences go to the agent; Tab and the arrow keys move the highlight. Tap the agent's name to pick another installed one; the choice is saved in ~/.config/omalauncher/agent. Hold the mic to talk and release to send, or tap it to dictate into the field. Speech is recognized by Android (on the device when the phone supports it), so only text reaches Linux.

The feed: swipe right on the first home page (or press Super+F) and a feed slides in from the left, like Pixel's Discover: Hacker News, recent posts from tech accounts on X, and headlines from tech and news sites, one tab each and all of them together. Tap a story to open it, its [123] for the discussion; swipe it back or press Back to close it. Long-press empty home space to turn it on or off; settings › feed picks the sources, the X accounts, muted words and how often it refreshes. X has no free API for reading, so its posts come through FxTwitter's open API (api.fxtwitter.com), which now and then misses an account.

Backup: settings › backup & restore saves the home screen to a file you pick (pinned apps and folders, widgets with their data, where everything sits, the theme, style and gestures, the feed's settings) and restores it from one, showing what the file holds first and keeping what it replaces so the restore can be undone. It carries a home screen across an uninstall, a new signing key or a new phone; Linux itself isn't in it.

Icons: settings › icons picks an icon pack, from the ones installed (icon packs from the Play Store and F-Droid work) or the ones your agents drew, shows how many of your apps it covers, and puts the apps it has no icon for on its backdrop. "+ new pack" has a coding agent draw a whole pack in the style you describe, in your theme's colors, so it changes with the theme; pick which of your installed agents draws under "drawn by", and later have it fill in the icons for apps you installed since, or change the pack. Tap an app there, or long-press it in the drawer or on home, to give it any pack's icon, a picture, or one the agent draws. Packs are folders in ~/.config/omalauncher/icon-packs and single apps' icons files in ~/.config/omalauncher/icons (apps.txt there lists the name each app's file takes); SVGs use the theme's colors as {{ accent }}, and icon-check shows an icon as the phone draws it. The pack is icons.pack in style.toml.

Touch input in Linux windows: tap is a left click, long press is a right click, drag scrolls; apps with touch support (foot, GTK) get real touch. Hardware keyboard shortcuts: Super+Enter (terminal), Super+Space or Super+A (the bar), Super+1..9 (home pages), Super+F (the feed; inside it r, s, q, 1..5, j/k) on the home screen; Super+Enter and Super+W (close) in Linux windows.

Building

scripts/dev.sh setup gets a machine ready (JDKs, SDK packages, proot, an emulator) and scripts/dev.sh doctor says what's missing; see docs/DEVELOPMENT.md. By hand:

./scripts/fetch-proot.sh          # Termux's proot -> app/src/main/jniLibs (needs bsdtar)
./gradlew :app:installDebug
# optional: skip the 830 MB download on the device
adb push ArchLinuxARM-aarch64-latest.tar.gz /sdcard/Android/data/dev.omalauncher/files/

Tests: ./gradlew :owl:test :app:testDebugUnitTest. ./gradlew :owl:owlJar builds owl/build/cli/owl.jar, the checker the widget store's CI runs.

In debug builds you can launch guest commands with adb shell am start -n dev.omalauncher/.MainActivity --es exec foot.

Layout

  • app/: the Android app (Kotlin, Jetpack Compose, and the JNI bridge in src/main/cpp)
  • owl/: the widget language and the owl command line, plain Kotlin
  • art/: SVG masters for the app, agent and store icons
  • store/: Play listing sources (screenshot frames, privacy policy)
  • fastlane/: the Play listing and the upload lanes
  • scripts/: fetching proot and theme colors, rendering icons, screenshots and widget previews

License

MIT, see LICENSE, for Omalauncher's own code and artwork. The coding agents' logos, the symbol font and Omarchy's theme colors are not covered; THIRD_PARTY.md lists them with their sources and licenses. The app also ships proot, talloc and libandroid-shmem (GPL-2.0, LGPL-3.0 and BSD-3-Clause, prebuilt by Termux), listed in the app under settings › licenses.

Omalauncher is an independent project and is not affiliated with or endorsed by Omarchy, Arch Linux, or the makers of the coding agents it installs.

About

Personal Fork of OmaLauncher adding traditional android launcher functionality for the Android power user

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages