Installation

Installation

URSA runs on Android 8.0 (Oreo) and newer.

Install from F-Droid (recommended)

Install URSA on F-Droid for normal store updates. F-Droid builds and signs the phone app independently from tagged source.

Install a GitHub release

1. Go to the repository's Releases.
2. Download the ursa-<version>.apk asset from the latest release (for example ursa-v1.1.0.apk).
3. On your phone, open the file and allow installation from your browser or files app if prompted. This is normal for apps installed outside a store.

Every release APK is signed and ships with a CycloneDX SBOM, SHA-256 checksums, and a build-provenance attestation, so you can verify what you installed.

Install the Wear OS companion (optional)

If you have a Wear OS watch, there is a separate ursa-wear-<version>.apk on the same Releases page. It is sideloaded directly on the watch:

1. On the watch: Settings > System > About, tap Build number seven times to enable developer options, then turn on ADB debugging (and Wireless debugging).
2. From your computer: adb connect <watch-ip>:<port> (or connect over USB), then adb install ursa-wear-<version>.apk.
3. See Wear OS for public-page setup, tiles/complications, and optional same-signed phone pairing.

Build from source

You need Android Studio (its bundled JDK is fine) and the Android SDK.

git clone https://github.com/greyfoundry/ursa-android.git
cd ursa-android
./gradlew assembleDebug          # phone app -> app/build/outputs/apk/debug/
./gradlew :wear:assembleDebug    # watch app -> wear/build/outputs/apk/debug/

Copy the APK to your device and install it, or install over USB with adb install. For a full development setup, see Building and Testing.

Next: Getting Started.