# omatether

iPhone USB tethering for **Omarchy / Arch** (systemd-networkd + iwd stack),
with a gum TUI. Plug an iPhone in over USB and use its internet connection —
the phone's Wi-Fi if it's on one, cellular otherwise. Works headless too.

## TUI

Run `omatether.sh` with no arguments (or launch **iPhone Tether** from Walker —
it opens as a small floating window). The dashboard shows phone / tether / route
state live and offers only the actions that make sense right now:

```
╭───────────────────────╮
│    OMATETHER          │
│  iPhone USB internet  │
╰───────────────────────╯
  Cowboy Bebop — paired
󰛳  Tether up: eth0  172.20.10.11/28
󰈀  Internet via enp6s0 (phone is fallback)

> Switch internet → iPhone
  Status (full check)
  Refresh
  Quit
```

- **Connect phone** — waits for USB, walks you through unlock + Trust, brings
  the connection up (shown only when not yet connected)
- **Switch internet → iPhone** — routes all traffic via the phone
- **Switch back → ethernet/wifi** — back to normal (tether stays as fallback)

## How it works

- `usbmuxd` handles the iOS pairing/trust handshake (udev-activated, no service to enable)
- the kernel's `ipheth` driver exposes the phone as a normal network interface
- a `systemd-networkd` profile (`10-iphone-tether.network`) matches by
  `Driver=ipheth` and DHCPs it, at **fallback priority** (route metric 750)
  so it never hijacks ethernet (100) or Wi-Fi (600); "Switch → iPhone"
  rewrites the metric to 50 and reloads networkd

## Install

```bash
./omatether.sh install   # packages + networkd profile + Walker launcher
./omatether.sh           # TUI: pick "Connect phone", unlock, tap Trust
```

Then on the phone: **Settings → Personal Hotspot → Allow Others to Join: ON**.
After that it's zero-touch — plug in and the connection comes up by itself.

## CLI

Everything is scriptable without the TUI:

| Command | What it does |
|---|---|
| `install` | Install packages, networkd profile, Walker launcher |
| `pair` / `unpair` | Manage the Trust pairing |
| `status` | Device, interface, IP, route, live connectivity test |
| `priority high` | Route all traffic via the phone even when ethernet is up |
| `priority low` | Back to fallback-only (default) |
| `uninstall` | Remove the networkd profile + launcher |

## Notes

- iOS shares whatever uplink it has: on Wi-Fi it shares the Wi-Fi; otherwise cellular.
- The tether interface usually appears as `eth0`; the profile matches by driver, not name.
- `RequiredForOnline=no` — an unplugged phone never blocks boot.
- DNS follows the Omarchy convention (`UseDNS=no`; global resolvers via systemd-resolved).
- If the phone was plugged in before usbmuxd existed it can show as unresponsive —
  the tool restarts usbmuxd automatically to rescan.