Installation

Installation

URSA runs on Android 8.0 (Oreo) and newer.

Install the app (recommended)

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.

An F-Droid listing is planned. URSA is fully FOSS with no Firebase or proprietary dependencies, so it qualifies; the listing just is not up yet.

Install the Wear OS tile (optional)

If you have a Wear OS watch, there is a separate ursa-wear-<version>.apk on the same Releases page for the status tile. It is sideload-only (there is no Google-services sync), so you install it 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 adding the tile and pointing it at a status page.

Build from source

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

git clone https://github.com/AstorisTheBrave/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.