Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions packages/omamobile-shell/LICENSE.omarchy
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
Copyright (c) David Heinemeier Hansson

Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
45 changes: 44 additions & 1 deletion packages/omamobile-shell/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ Omarchy Mobile's phone profile for Omarchy's own shell. It isn't a fork: these a
| --- | --- |
| `plugins/omamobile.bar` | Phone status bar (a full `bar` plugin) |
| `plugins/omamobile.quicksettings` | Pull-down quick settings |
| `plugins/omamobile.launcher` | Home bar: app search, app grid and a prompt to the user's Omarchy default agent; over an app, the home pill in a 44 px strip that reserves its height, so apps end above it (as on Android it is just the pill: double-tap for the keyboard, hold for the voice bar) |
| `plugins/omamobile.launcher` | Home bar: a separate native app-search view on tap; App Library and the existing optional agent flow on swipe; over an app, the home pill in a 44 px strip that reserves its height, so apps end above it (as on Android it is just the pill: double-tap for the keyboard, hold for the voice bar) |
| `plugins/omamobile.switcher` | Recent apps: swipe up on the dock, or swipe up and hold on the home pill over an app; hold a card to show the app with another one, or give it its own screen again |
| `plugins/omamobile.home` | Home screens: pages of apps and widgets on the wallpaper, with an edit mode. The built-ins include every widget in Simon Schubert's [omarchy-widgets](https://github.com/SimonSchubert/omarchy-widgets) `widgets/simonschubert/` (MIT): the OWL originals, from the `omamobile-owl-widgets` package, run by our own OWL runtime (`owl/`, see `owl/SPEC-NOTES.md`). `widgets/OWL.md` is his OWL language guide (MIT, `widgets/LICENSE-owl-guide`) |
| `plugins/omamobile.keyboard` | The on-screen keyboard's show and hide calls, for the home pill (double-tap it), the keyboard's Hide key and scripts; a keyboard shown by hand goes away when the home screen comes up; the language sheet for the keyboard's globe key |
Expand Down Expand Up @@ -103,3 +103,46 @@ Open, save and choose-a-folder requests through the portal (Qt, GTK, Electron an
The package contract follows omarchy-mac's: `./install DESTDIR` stages files and enables nothing, `test/all` runs the package's own tests, and `version` holds the version.

Develop on a desktop with `phone/dev/run-desktop` from the repo root.

## Native app Search

Set the launcher's `nativeSearch` setting to `true` to open app Search
when tapping the dock. The default tap and swipe up open the App Library
and its existing optional agent flow.
Search uses Omarchy's application library and normal app-launch command. It
does not index files, select an agent or access accounts.

The view follows Commons palette, font, spacing, controls and corner settings;
its animation follows `Style.duration` when available. A full-screen background
takes no input, the content respects the status/keyboard reservations, and the
existing Home strip remains visible even after manually hiding the keyboard.
Home and app activation release Search input before changing screens.

Native focus is briefly primed with Exclusive, then released to OnDemand, using
the focus lifecycle from Omarchy's MIT-licensed `shell/Ui/KeyboardPanel.qml`.
That component is present in both supported Omarchy package families. Its
David Heinemeier Hansson copyright and license are retained in
`LICENSE.omarchy`. Offscreen component tests verify cancellation and focus
intent; a phone acceptance must separately verify first-tap OSK activation,
keyboard touches, Back/Home, immediate reopen and lock interaction.

Native Search cancels pending focus and closes when the launcher's existing session-lock observation reports locked. Unlocking never reopens it without a new explicit tap. This observation is asynchronous and is not a security boundary or a replacement for the compositor lock protocol. Existing fullscreen exclusion of Home/Back gesture strips remains in force; a Search opened over fullscreen can still close using its visible close button or Escape. The Search panels currently use Quickshell's default output; multi-output active-screen routing is not qualified by the offscreen tests.

### Search presentation

Search retains the phone layout: the query row stays at the top, followed by
three suggested apps, or matching results while typing. App rows have icons,
names and descriptions without an enclosing border. Colors, font family and
size, spacing, control borders, corner rounding and motion follow Commons.
The view uses the drawer's `Commons.Color.menu.background` surface over its
`Commons.Color.menu.scrim`. Secondary text and glyphs use the launcher's
`Qt.darker(foreground, 1.3)` ink. Close, search and chevron use the shell icon
font at `Style.font.iconLarge`; Search adds no theme keys or custom alpha
values. Rounding follows the configured Hyprland/theme value.

Search registers with the shared Back surface client while open. Back first
dismisses the keyboard, then closes Search. Back has no dependency on the
launcher plugin.
The home screen pauses widgets and yields Back while Search is open. The
strip uses the existing lock rule when the keyboard is up. Physical lock,
keyboard and gesture acceptance still requires this package on a phone.
1 change: 1 addition & 0 deletions packages/omamobile-shell/install
Original file line number Diff line number Diff line change
Expand Up @@ -70,6 +70,7 @@ install -Dm644 applications/omamobile-agent.desktop "$destination/usr/share/appl
install -Dm644 applications/omamobile-open-intent.desktop "$destination/usr/share/applications/omamobile-open-intent.desktop"
install -Dm644 applications/omamobile-update.desktop "$destination/usr/share/applications/omamobile-update.desktop"
install -Dm644 LICENSE "$destination/usr/share/licenses/omamobile-shell/LICENSE"
install -Dm644 LICENSE.omarchy "$destination/usr/share/licenses/omamobile-shell/LICENSE.omarchy"
# OWL.md is Simon Schubert's OWL guide (MIT). The built-in widgets themselves
# come from omamobile-owl-widgets, which ships the store's licence.
install -Dm644 widgets/LICENSE-owl-guide "$destination/usr/share/licenses/omamobile-shell/LICENSE-owl-guide"
Expand Down
1 change: 1 addition & 0 deletions packages/omamobile-shell/plugins/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -874,6 +874,7 @@ back instead; start it further in.
| Fingerprint setup (`omamobile.fingerprint`) | Its Cancel (stops a running enrollment), or Done after one. Not while polkit asks |
| Voice settings; the voice bar's check before Ask, and its error (`omamobile.voice`) | Closes; the check's text is discarded, as its Discard |
| Home screen (`omamobile.home`), only while it shows with nothing open over it | A sheet goes back one sheet or closes (a widget's unsaved settings are asked about first: Save, or Discard changes), then edit mode ends, then the pages go to the home page |
| App search (`omamobile.launcher`) | Closes Search after the keyboard has been dismissed |
| A widget's opened screen (`OwlCell.qml`) | Closes, as a tap on its title |

3. **Escape, to whatever has the keyboard focus**: an app, or a shell sheet
Expand Down
7 changes: 4 additions & 3 deletions packages/omamobile-shell/plugins/omamobile.home/Home.qml
Original file line number Diff line number Diff line change
Expand Up @@ -628,9 +628,9 @@ Item {
}
}
}
// The app drawer covers it once fully open (its surface is always mapped,
// so it has no openlayer event to go by; drawerProgress below).
readonly property bool homeShown: HomeModel.homeShown(owlPanelOff, appOnScreen, coveringLayers) && drawerProgress < 1
// The drawer and Search surfaces stay mapped. Use their launcher state
// to pause widgets and leave Back to the visible surface.
readonly property bool homeShown: HomeModel.homeShown(owlPanelOff, appOnScreen, coveringLayers) && drawerProgress < 1 && !searchOpened
readonly property bool owlPaused: !homeShown
// The app drawer (omamobile.launcher's root, through its DrawerLink.js,
// which DrawerLinkClient.qml beside it imports), for the swipe up and for
Expand All @@ -641,6 +641,7 @@ Item {
source: Qt.resolvedUrl("../omamobile.launcher/DrawerLinkClient.qml")
}
readonly property var drawer: drawerLink.item ? drawerLink.item.drawer : null
readonly property bool searchOpened: !!drawer && drawer.searchOpened === true
readonly property real drawerProgress: drawer && drawer.progress !== undefined ? Number(drawer.progress) || 0 : 0
// The dock (omamobile.launcher) reserves no space, so that no window
// changes size as the drawer opens over it; the home screen keeps its
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -1048,6 +1048,7 @@ function drawerFallbackOpens(travel, speed) {
// volume display and the on-screen keyboard (Back's own first stop).
var BACK_FURNITURE = ["omarchy-background", "omarchy-bar", "omarchy-notifications", "omarchy-osd",
"omamobile-home", "omamobile-dock", "omamobile-home-strip", "omamobile-back", "omamobile-launcher",
"omamobile-app-search", "omamobile-app-search-background",
"omamobile-fingerprint", "omamobile-fingerprint-guard", "omamobile-call-top", "omamobile-voice-bar", "osk"]

// Everything else mapped over the home screen after one Hyprland event
Expand Down
Loading