Aviator Digital for Galaxy Watch5 Pro

A high-contrast Wear OS watch face for general-aviation pilots. Local time is primary, UTC is always shown in 24-hour format, and the four lower panels show magnetic heading, raw ambient pressure, blood oxygen, and weather.

Google Play

Both Wear OS packages are available from Google Play:

• Aviator Digital watch face
• Aviator Sensors Companion

Install both packages for the complete experience. The watch face works without the companion, but its heading and pressure panels require Aviator Sensors.

This project is not certified flight equipment. Pressure is the watch sensor's local ambient pressure—not QNH or an airport altimeter setting. SpO2 is fitness and wellness information only and must not be used for diagnosis, treatment, or flight-safety decisions.

Experimental software warning: This code is provided without warranty. It may contain bugs, drain your battery, catch on fire, or steal your pants. Keep backups, use good judgment, and never depend on it for flight safety.

Project layout

• watchface: code-free Watch Face Format app (com.jglenn9k.aviator.watchface).
• sensor-provider: Wear OS app (com.jglenn9k.aviator.sensors) with heading and pressure complication data sources.

Wear OS requires these to be separate application bundles. The face defaults its heading and pressure slots to the companion provider package. Blood oxygen and weather remain normal user-selectable complications, so this project requests no health or location permission and needs no weather API key.

The face deliberately declares WFF version 1 (Wear OS 4 / API 33) because every feature used here is available in that schema and it preserves compatibility with the Watch5 Pro. This is the current declarative WFF packaging model, without unnecessarily requiring Wear OS 6.

Every watch-face build runs :watchface:verifyWatch5ProCompatibility. The build fails if the package stops requiring watch hardware, enables executable code, changes away from WFF v1/API 33, or no longer contains a valid WFF root document.

Screenshots

Watch face

Cyan	Green	Amber

Sensor companion

Magnetic compass	Ambient barometer

Requirements

• Android Studio with Android 16 / API 36 SDK and OpenJDK 25.0.4 (2026-07-21 LTS)
• Galaxy Watch5 Pro SM-R920
• Watch and workstation on the same Wi-Fi network for wireless ADB

This repository intentionally does not include a signing key.

Build

Open the repository in Android Studio and let it install the requested Gradle and SDK components. Build :sensor-provider:assembleDebug and :watchface:assembleDebug for local testing.

For Play-ready bundles, configure release signing in your private Gradle settings, then build :sensor-provider:bundleRelease and :watchface:bundleRelease. They are separate Play artifacts and listings.

Google Play signing

Use Google Play App Signing and let Google generate the app-signing key for each new Play listing. Keep one local upload key for signing both AAB uploads. Create it interactively; passwords are never written into this repository:

scripts/setup-play-signing.sh

This creates the private upload key and public upload certificate under ~/.config/aviator-watch/, then adds the four ANDROID_* signing environment variables to ~/.bash_profile with owner-only permissions. Back up the .jks file and its password separately. The profile contains the passwords in plaintext, so never publish or copy it into the repository. Produce signed local Play artifacts with a new, monotonically increasing version code:

scripts/build-play-release.sh 1.0.0 1

Create two Play Console apps, one for com.jglenn9k.aviator.watchface and one for com.jglenn9k.aviator.sensors, and upload the corresponding AAB to an internal-test release. For each app, first open Test and release → Setup → Advanced settings → Form factors, add Wear OS, opt in to Wear OS distribution, and accept its terms. When creating the release, select Wear OS only in the form-factor selector. A bundle uploaded only to a phone/default track is not installable on a watch even though its manifest requires watch hardware. Accept Play App Signing with Google's generated key for each app.

After publishing the test release, open Monitor and improve → Reach and devices → Device catalog, find Samsung SM-R920, and verify that the active Wear OS track says Supported. If it says Unsupported, expand the variant details:

• An SDK-level mismatch means the watch must be updated to Wear OS 4 / API 33 or newer; Watch Face Format v1 cannot be installed on an older system version.
• Excluded by rule or Manually excluded must be removed in Device catalog.
• A supported device that still cannot install usually means the Google account has not joined the test, the test is unavailable in its country, or the release has not finished review/rollout.

The phone (SM-S926U, for example) is expected to appear as incompatible because these packages deliberately require android.hardware.type.watch. Install from the Play Store on the watch, or choose the watch from the web installer after the Wear OS release becomes available.

No Samsung SDK partnership registration is required. Samsung Health owns the Blood oxygen complication and its permissions; this project only displays the data the user chooses to expose through that complication.

Install on the SM-R920

Enable Developer mode, ADB debugging, and Wireless debugging on the watch. Pair ADB, then install both production-package APKs:

adb connect WATCH_IP:ADB_PORT
adb install -r sensor-provider/build/outputs/apk/debug/sensor-provider-debug.apk
adb install -r watchface/build/outputs/apk/debug/watchface-debug.apk

Select Aviator Digital in the watch-face picker. If a default sensor provider did not bind, edit the face and assign:

• Magnetic heading → Aviator magnetic heading
• Ambient pressure → Aviator ambient pressure
• Blood oxygen → Samsung Health → Blood oxygen
• Weather → Samsung Weather, Google Weather, or another installed provider

Sensor behavior

• HDG: the face shows the last heading captured by the live compass. Tap to open it, hold the watch face-up, and perform a figure-eight motion if prompted. The result is magnetic—not true—heading. * indicates a reading older than 15 minutes.
• BARO: sampled on provider requests and from the sensor dashboard. It uses inHg = hPa × 0.0295299830714 and updates at most every 30 minutes under Wear OS complication scheduling.
• SpO2: supplied by Samsung Health's built-in Blood oxygen complication. Its displayed value, freshness, permissions, and tap behavior are controlled by Samsung Health.
• WX: data and tap behavior come entirely from the provider selected in the watch-face editor.

Verification

Run unit tests with :sensor-provider:testDebugUnitTest. Validate watchface/src/main/res/raw/watchface.xml with Android Studio's WFF validator and memory-footprint tool before publishing. Test compass accuracy, barometer presence, Samsung Health Blood oxygen selection and rendering, ambient burn-in, timezone/DST transitions, and all tap targets on the physical watch.

GitHub binary releases

The included GitHub Actions workflow runs tests, builds signed APK/AAB artifacts, writes SHA-256 checksums, and creates a GitHub Release for tags matching v*.

Configure these repository secrets under Settings → Secrets and variables → Actions before tagging:

• ANDROID_KEYSTORE_BASE64: base64-encoded release keystore
• ANDROID_KEYSTORE_PASSWORD
• ANDROID_KEY_ALIAS
• ANDROID_KEY_PASSWORD Without all four signing secrets, the release build fails rather than publishing unsigned APKs.

Create and push a semantic version tag:

git tag -a v1.0.0 -m "Aviator Digital v1.0.0"
git push origin v1.0.0

The release assets are also retained as workflow artifacts for 30 days.