Install LOG on a Wear OS watch

LOG runs on the watch by itself. It is not a companion screen for a phone app: the watch talks to the cloud over Wi-Fi or its own LTE, signs in with the same short code as the desktop window, and can approve a run while your laptop is closed.

These builds are distributed as signed APKs; they are not in Google Play yet. Downloading a watch APK on your phone does not install it on the watch. Install both watch files over ADB using the steps below.

What you install

Two files, because a watch face cannot ship inside an app bundle. That is a store rule, not our preference.

• The app: screens, approvals, and the complication that feeds the face.
• The watch face: LOG's own face, drawn by the system renderer.

Both are signed with the LogiShell release key. Installing only the face gives you a face that shows the time: the mood on it comes from the app.

What has to be true first

• Wear OS 6 (API 36) or newer for the app and face together. The app alone has a minimum of API 33, but the face uses Watch Face Format 4 and requires API 36. These are build requirements; a successful build does not prove that every watch model has been tested.
• The watch is set up with an Android phone. Samsung watches cannot be paired from an iPhone at all.
• The watch and your computer are on the same Wi-Fi.

Turn on debugging

On Samsung Galaxy Watch: Settings → About watch → Software information (or Software), then tap Software version five times. Return to Settings → Developer options, enable ADB debugging, then Wireless debugging, and confirm Allow. These are settings on the watch itself. Other watch brands can use different menu names; see the Samsung setup guide and Wear OS debugging guide.

The wireless debugging screen shows an address and a port. Keep it open: it also produces the six digit pairing code.

Install

curl -fL https://dl.logishell.com/wear/latest.apk -o LogiShell-Wear.apk
curl -fL https://dl.logishell.com/wear/latest-face.apk -o LogiShell-Wear-Face.apk
adb pair <ip>:<pairing-port>     # the code and port come from "Pair new device"
adb connect <ip>:<port>          # the port on the main debugging screen, a different one
adb -s <ip>:<port> install -r LogiShell-Wear.apk
adb -s <ip>:<port> install -r LogiShell-Wear-Face.apk

Select the watch address explicitly when a phone is also connected. The phone takes the separate Android app APK, not either watch file.

adb ships with the Android platform tools. On macOS with Homebrew: brew install --cask android-platform-tools.

The requirements follow the Watch Face Format compatibility table. Pairing and connection use different ports; see wireless debugging.

After the install

The app is in the watch's app list. The face is not: long press the current watch face, choose Add, and pick LOG.

Open the app once and sign in: it shows a short code, you confirm it where you are already signed in, and the watch keeps the session. From then on approvals arrive on the wrist.

The system always returns to the watch face, so an app cannot stay on screen. The face is what keeps LOG visible.