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
1 change: 1 addition & 0 deletions packages/omamobile-shell/PKGBUILD
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ depends=(omarchy omamobile-apps 'omamobile-omarchy>=0.1.11' 'omamobile-owl-widge
iproute2 jq # omamobile-sleepd: ss for SSH sessions; jq also for omamobile-keys
# Both are in Omarchy's base package list, which root images install.
dnsmasq # the Hotspot tile: NetworkManager's shared mode hands out addresses with it
qrencode # the Hotspot page: the QR code that joins a device to the hotspot
foot xdg-terminal-exec # guard for hand-built/partial installations
xdg-desktop-portal-gnome) # the file chooser (portal/hyprland-portals.conf)
checkdepends=(nodejs) # test/weather.py runs HomeModel.js under node
Expand Down
6 changes: 5 additions & 1 deletion packages/omamobile-shell/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ Omarchy Mobile's phone profile for Omarchy's own shell. It isn't a fork: these a
| Path | What it is |
| --- | --- |
| `plugins/omamobile.bar` | Phone status bar (a full `bar` plugin) |
| `plugins/omamobile.quicksettings` | Pull-down quick settings |
| `plugins/omamobile.quicksettings` | Pull-down quick settings; the Wi-Fi, Bluetooth and Hotspot tiles have pages behind their chevrons (the Hotspot page: name, password, a QR code to join, and `hotspot-panel.sh`'s VPN boxes where a device's hotspot backend has them) |
| `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.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`) |
Expand Down Expand Up @@ -91,6 +91,10 @@ machine: the model comes from a pinned commit of whisper.cpp's model
repository with a pinned sha256, and makepkg keeps it in its source cache
afterwards.

## Hotspot page

The page behind the Hotspot tile's chevron talks to `hotspot-panel.sh`. By default that runs NetworkManager's "Hotspot" connection (the one the tile makes with `nmcli device wifi hotspot`): name, password and a QR code to join, and no VPN boxes, since NetworkManager's shared mode has no switch for them; its devices follow the phone's default route. A device that brings its own hotspot (its own hostapd and firewall) installs an executable at `/etc/omamobile/hotspot-backend` from its device package, or the owner puts one at `~/.config/omamobile/hotspot-backend`; it takes the same verbs (`state`, `set NAME PASS`, `share on|off`, `alltraffic on|off`) and prints the same lines, and with it come the VPN boxes and, in `uplink_note`, the sentence on where its devices' traffic goes. No device package ships one yet: the Pixel 9a's is its owner's own for now.

## File dialogs

Open, save and choose-a-folder requests through the portal (Qt, GTK, Electron and Flatpak apps alike) get Nautilus's libadwaita file chooser from xdg-desktop-portal-gnome, not xdg-desktop-portal-gtk's GTK 3 desktop chooser, whose Places sidebar took half of the 480 px width. Nautilus's chooser folds its sidebar away at phone width and has touch-sized rows; `hypr/phone.lua` tiles it, even when it has a parent window, so it fills the screen between the bar and the on-screen keyboard. Only FileChooser goes to the gnome backend: its other interfaces need gnome-shell. It runs without gnome-shell (its Mutter service channel is missing, so it falls back to a plain Wayland connection). xdg-desktop-portal-gtk stays as the fallback and for its other interfaces. GTK apps that would draw their own chooser in-process are sent to the portal too (`GTK_USE_PORTAL=1` for GTK 3, `GDK_DEBUG=portals` for GTK 4, in `environment.d/20-omamobile-osk.conf`); Qt Widgets apps keep Omarchy's `QT_QPA_PLATFORMTHEME=gtk3` for now.
Expand Down
Loading