Initial commit: Helios Tracker location responder app

Minimal Android app that receives LOCATE commands via ntfy push
notifications and replies with GPS coordinates + battery level.
Uses WorkManager, FusedLocationProvider, and OkHttp.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

.gitignore

@@ -0,0 +1,11 @@
+*.iml
+.gradle
+/local.properties
+/.idea
+.DS_Store
+/build
+/app/build
+/captures
+.externalNativeBuild
+.cxx
+local.properties

README.md

@@ -0,0 +1,177 @@
+# Helios Tracker
+
+A minimal Android app that acts as a **location responder** for IoT systems. It receives `LOCATE` commands via [ntfy](https://ntfy.sh) push notifications and replies with the device's current GPS coordinates and battery level.
+
+The app has no background service of its own — it uses the ntfy Android app as a trigger via Broadcast Intents.
+
+## How It Works
+
+```
+Server                          ntfy.sh                        Phone
+  |                               |                              |
+  |-- POST "LOCATE" to topic ---->|                              |
+  |                               |-- Push notification -------->|
+  |                               |                              | ntfy app broadcasts intent
+  |                               |                              | NtfyReceiver catches it
+  |                               |                              | WorkManager starts LocationWorker
+  |                               |                              | Gets GPS + battery level
+  |                               |<-- POST location ------------|
+  |<-- Subscribe / poll --------- |                              |
+  |                               |                              |
+```
+
+1. The **ntfy app** (installed separately) subscribes to a topic and receives push messages.
+2. When a message arrives, ntfy broadcasts an Android Intent (`io.heckel.ntfy.MESSAGE_RECEIVED`).
+3. **Helios Tracker** listens for this broadcast, filters for the configured topic, and checks if the message is `LOCATE`.
+4. A `WorkManager` job gets the current location (WiFi/cell-based, ~100m accuracy) and battery level.
+5. The result is sent back via HTTP POST to a configurable ntfy reply topic.
+
+## Server-Side Usage
+
+### Send a LOCATE command
+
+```bash
+# Simple curl — send "LOCATE" to your listen topic
+curl -d "LOCATE" https://ntfy.sh/YOUR_LISTEN_TOPIC
+```
+
+### Wait for the response
+
+```bash
+# Subscribe and wait for the next message on the reply topic (blocking)
+curl -s "https://ntfy.sh/YOUR_REPLY_TOPIC/json?poll=1&since=30s"
+```
+
+### Full example: locate and get response
+
+```bash
+#!/bin/bash
+LISTEN_TOPIC="my-device-locate"
+REPLY_TOPIC="my-device-reply"
+
+# Subscribe in background, wait for one message
+curl -s -m 60 "https://ntfy.sh/$REPLY_TOPIC/json?since=now&poll=0" > /tmp/location.json &
+LISTENER=$!
+
+sleep 1
+
+# Send LOCATE command
+curl -s -d "LOCATE" "https://ntfy.sh/$LISTEN_TOPIC"
+echo "LOCATE sent, waiting for response..."
+
+# Wait for the listener
+wait $LISTENER
+
+# Parse the response
+cat /tmp/location.json | jq -r '.message'
+# Output: Lat: 52.5200, Lon: 13.4050, Battery: 72%
+```
+
+### Python example
+
+```python
+import requests
+import json
+import time
+import threading
+
+LISTEN_TOPIC = "my-device-locate"
+REPLY_TOPIC = "my-device-reply"
+
+result = {}
+
+def listen():
+    r = requests.get(
+        f"https://ntfy.sh/{REPLY_TOPIC}/json",
+        params={"since": "now", "poll": "0"},
+        stream=True, timeout=60
+    )
+    for line in r.iter_lines():
+        if line:
+            msg = json.loads(line)
+            if msg.get("event") == "message":
+                result["location"] = msg["message"]
+                return
+
+# Start listener
+t = threading.Thread(target=listen)
+t.start()
+time.sleep(1)
+
+# Send LOCATE
+requests.post(f"https://ntfy.sh/{LISTEN_TOPIC}", data="LOCATE")
+print("LOCATE sent, waiting...")
+
+t.join(timeout=60)
+print(result.get("location", "No response"))
+# Output: Lat: 52.5200, Lon: 13.4050, Battery: 72%
+```
+
+### Home Assistant example (REST command)
+
+```yaml
+# configuration.yaml
+rest_command:
+  locate_phone:
+    url: "https://ntfy.sh/my-device-locate"
+    method: POST
+    payload: "LOCATE"
+```
+
+### Node-RED example
+
+Send a `msg.payload = "LOCATE"` to an **HTTP Request** node configured as POST to `https://ntfy.sh/YOUR_LISTEN_TOPIC`. Subscribe to the reply topic with a second HTTP Request node or an MQTT input.
+
+### Response format
+
+The app replies with a plain-text message:
+
+```
+Lat: 52.5200, Lon: 13.4050, Battery: 72%
+```
+
+## Setup
+
+### Prerequisites
+
+1. Install the [ntfy Android app](https://play.google.com/store/apps/details?id=io.heckel.ntfy) on the target device.
+2. Subscribe to your chosen listen topic in the ntfy app.
+
+### App Configuration
+
+1. Open **Helios Tracker** on the device.
+2. Grant **location permissions** (including "Allow all the time" for background access).
+3. Enter your **listen topic** (the topic ntfy subscribes to).
+4. Enter your **reply topic** (where location responses are posted).
+
+### Permissions
+
+| Permission | Why |
+|---|---|
+| `ACCESS_FINE_LOCATION` | GPS-based location |
+| `ACCESS_COARSE_LOCATION` | WiFi/cell-based location |
+| `ACCESS_BACKGROUND_LOCATION` | Location access when app is not in foreground |
+| `INTERNET` | Send location via HTTP POST |
+
+## Architecture
+
+| Component | Role |
+|---|---|
+| `NtfyReceiver` | BroadcastReceiver — catches `io.heckel.ntfy.MESSAGE_RECEIVED`, filters by topic, enqueues worker |
+| `LocationWorker` | CoroutineWorker — gets location via FusedLocationProviderClient, sends result via OkHttp |
+| `Prefs` | SharedPreferences wrapper for topic configuration |
+| `MainActivity` | Jetpack Compose UI — permission management and topic configuration |
+
+## Build
+
+```bash
+./gradlew assembleDebug
+# or install directly:
+./gradlew installDebug
+```
+
+Requires Android Studio with AGP 9.0+ and JDK 17.
+
+## License
+
+MIT

app/.gitignore

@@ -0,0 +1 @@
+/build

app/build.gradle.kts

@@ -0,0 +1,70 @@
+plugins {
+    alias(libs.plugins.android.application)
+    alias(libs.plugins.kotlin.compose)
+}
+
+android {
+    namespace = "com.example.helios_location_finder"
+    compileSdk {
+        version = release(36) {
+            minorApiLevel = 1
+        }
+    }
+
+    defaultConfig {
+        applicationId = "com.example.helios_location_finder"
+        minSdk = 24
+        targetSdk = 36
+        versionCode = 1
+        versionName = "1.0"
+
+        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
+    }
+
+    buildTypes {
+        release {
+            isMinifyEnabled = false
+            proguardFiles(
+                getDefaultProguardFile("proguard-android-optimize.txt"),
+                "proguard-rules.pro"
+            )
+        }
+    }
+
+    compileOptions {
+        sourceCompatibility = JavaVersion.VERSION_17
+        targetCompatibility = JavaVersion.VERSION_17
+    }
+
+    buildFeatures {
+        compose = true
+    }
+}
+
+dependencies {
+    implementation(libs.androidx.core.ktx)
+
+    // Compose
+    implementation(platform(libs.compose.bom))
+    implementation(libs.compose.ui)
+    implementation(libs.compose.ui.tooling.preview)
+    implementation(libs.compose.material3)
+    implementation(libs.activity.compose)
+    debugImplementation(libs.compose.ui.tooling)
+
+    // WorkManager
+    implementation(libs.work.runtime.ktx)
+
+    // Google Play Services Location
+    implementation(libs.play.services.location)
+
+    // OkHttp
+    implementation(libs.okhttp)
+
+    // Coroutines for Play Services .await()
+    implementation(libs.coroutines.play.services)
+
+    testImplementation(libs.junit)
+    androidTestImplementation(libs.androidx.junit)
+    androidTestImplementation(libs.androidx.espresso.core)
+}

app/proguard-rules.pro

@@ -0,0 +1,21 @@
+# Add project specific ProGuard rules here.
+# You can control the set of applied configuration files using the
+# proguardFiles setting in build.gradle.
+#
+# For more details, see
+#   http://developer.android.com/guide/developing/tools/proguard.html
+
+# If your project uses WebView with JS, uncomment the following
+# and specify the fully qualified class name to the JavaScript interface
+# class:
+#-keepclassmembers class fqcn.of.javascript.interface.for.webview {
+#   public *;
+#}
+
+# Uncomment this to preserve the line number information for
+# debugging stack traces.
+#-keepattributes SourceFile,LineNumberTable
+
+# If you keep the line number information, uncomment this to
+# hide the original source file name.
+#-renamesourcefileattribute SourceFile

app/src/androidTest/java/com/example/helios_location_finder/ExampleInstrumentedTest.kt

@@ -0,0 +1,24 @@
+package com.example.helios_location_finder
+
+import androidx.test.platform.app.InstrumentationRegistry
+import androidx.test.ext.junit.runners.AndroidJUnit4
+
+import org.junit.Test
+import org.junit.runner.RunWith
+
+import org.junit.Assert.*
+
+/**
+ * Instrumented test, which will execute on an Android device.
+ *
+ * See [testing documentation](http://d.android.com/tools/testing).
+ */
+@RunWith(AndroidJUnit4::class)
+class ExampleInstrumentedTest {
+    @Test
+    fun useAppContext() {
+        // Context of the app under test.
+        val appContext = InstrumentationRegistry.getInstrumentation().targetContext
+        assertEquals("com.example.helios_location_finder", appContext.packageName)
+    }
+}

app/src/main/AndroidManifest.xml

@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
+
+    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
+    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
+    <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
+    <uses-permission android:name="android.permission.INTERNET" />
+
+    <application
+        android:allowBackup="true"
+        android:dataExtractionRules="@xml/data_extraction_rules"
+        android:fullBackupContent="@xml/backup_rules"
+        android:icon="@mipmap/ic_launcher"
+        android:label="@string/app_name"
+        android:roundIcon="@mipmap/ic_launcher_round"
+        android:supportsRtl="true"
+        android:theme="@style/Theme.Helioslocationfinder"
+        tools:targetApi="31">
+
+        <activity
+            android:name=".MainActivity"
+            android:exported="true"
+            android:theme="@style/Theme.Helioslocationfinder">
+            <intent-filter>
+                <action android:name="android.intent.action.MAIN" />
+                <category android:name="android.intent.category.LAUNCHER" />
+            </intent-filter>
+        </activity>
+
+        <receiver
+            android:name=".NtfyReceiver"
+            android:exported="true">
+            <intent-filter>
+                <action android:name="io.heckel.ntfy.MESSAGE_RECEIVED" />
+            </intent-filter>
+        </receiver>
+
+    </application>
+
+</manifest>

app/src/main/java/com/example/helios_location_finder/LocationWorker.kt

@@ -0,0 +1,175 @@
+package com.example.helios_location_finder
+
+import android.Manifest
+import android.content.Context
+import android.content.Intent
+import android.content.IntentFilter
+import android.content.pm.PackageManager
+import android.location.Location
+import android.os.BatteryManager
+import android.os.Looper
+import android.util.Log
+import androidx.core.content.ContextCompat
+import androidx.work.CoroutineWorker
+import androidx.work.WorkerParameters
+import com.google.android.gms.location.LocationCallback
+import com.google.android.gms.location.LocationRequest
+import com.google.android.gms.location.LocationResult
+import com.google.android.gms.location.LocationServices
+import com.google.android.gms.location.Priority
+import com.google.android.gms.tasks.CancellationTokenSource
+import kotlinx.coroutines.suspendCancellableCoroutine
+import kotlinx.coroutines.tasks.await
+import kotlinx.coroutines.withTimeoutOrNull
+import okhttp3.MediaType.Companion.toMediaType
+import okhttp3.OkHttpClient
+import okhttp3.Request
+import okhttp3.RequestBody.Companion.toRequestBody
+import kotlin.coroutines.resume
+
+class LocationWorker(
+    context: Context,
+    params: WorkerParameters
+) : CoroutineWorker(context, params) {
+
+    companion object {
+        private const val TAG = "LocationWorker"
+        private const val NTFY_BASE_URL = "https://ntfy.sh/"
+        private const val LOCATION_TIMEOUT_MS = 30_000L
+    }
+
+    private val client = OkHttpClient()
+
+    override suspend fun doWork(): Result {
+        Log.d(TAG, "LocationWorker started")
+
+        val replyTopic = Prefs.getReplyTopic(applicationContext)
+        if (replyTopic.isBlank()) {
+            Log.e(TAG, "No reply topic configured")
+            return Result.failure()
+        }
+        val replyUrl = NTFY_BASE_URL + replyTopic
+
+        if (!hasLocationPermission()) {
+            Log.e(TAG, "No location permission")
+            sendMessage(replyUrl, "Error: Location permission not granted")
+            return Result.failure()
+        }
+
+        val locationClient = LocationServices.getFusedLocationProviderClient(applicationContext)
+
+        try {
+            // Strategy 1: getCurrentLocation
+            val cancellationSource = CancellationTokenSource()
+            var location: Location? = try {
+                withTimeoutOrNull(LOCATION_TIMEOUT_MS) {
+                    locationClient.getCurrentLocation(
+                        Priority.PRIORITY_BALANCED_POWER_ACCURACY,
+                        cancellationSource.token
+                    ).await()
+                }
+            } catch (e: Exception) {
+                Log.w(TAG, "getCurrentLocation failed: ${e.message}")
+                null
+            } finally {
+                cancellationSource.cancel()
+            }
+
+            // Strategy 2: getLastLocation as fallback
+            if (location == null) {
+                Log.d(TAG, "getCurrentLocation returned null, trying getLastLocation")
+                location = try {
+                    locationClient.lastLocation.await()
+                } catch (e: Exception) {
+                    Log.w(TAG, "getLastLocation failed: ${e.message}")
+                    null
+                }
+            }
+
+            // Strategy 3: requestLocationUpdates as last resort
+            if (location == null) {
+                Log.d(TAG, "getLastLocation returned null, trying requestLocationUpdates")
+                location = withTimeoutOrNull(LOCATION_TIMEOUT_MS) {
+                    requestSingleUpdate(locationClient)
+                }
+            }
+
+            if (location == null) {
+                Log.w(TAG, "All location strategies failed")
+                sendMessage(replyUrl, "Error: Could not determine location")
+                return Result.retry()
+            }
+
+            val battery = getBatteryLevel()
+            val payload = "Lat: ${location.latitude}, Lon: ${location.longitude}, Battery: $battery%"
+
+            Log.d(TAG, "Sending location: $payload")
+            sendMessage(replyUrl, payload)
+
+            return Result.success()
+        } catch (e: SecurityException) {
+            Log.e(TAG, "SecurityException", e)
+            sendMessage(replyUrl, "Error: SecurityException - ${e.message}")
+            return Result.failure()
+        } catch (e: Exception) {
+            Log.e(TAG, "Unexpected error", e)
+            sendMessage(replyUrl, "Error: ${e.message}")
+            return Result.retry()
+        }
+    }
+
+    private suspend fun requestSingleUpdate(
+        locationClient: com.google.android.gms.location.FusedLocationProviderClient
+    ): Location = suspendCancellableCoroutine { cont ->
+        val request = LocationRequest.Builder(
+            Priority.PRIORITY_BALANCED_POWER_ACCURACY, 1000L
+        ).setMaxUpdates(1).build()
+
+        val callback = object : LocationCallback() {
+            override fun onLocationResult(result: LocationResult) {
+                locationClient.removeLocationUpdates(this)
+                val loc = result.lastLocation
+                if (loc != null && cont.isActive) {
+                    cont.resume(loc)
+                }
+            }
+        }
+
+        locationClient.requestLocationUpdates(request, callback, Looper.getMainLooper())
+
+        cont.invokeOnCancellation {
+            locationClient.removeLocationUpdates(callback)
+        }
+    }
+
+    private fun hasLocationPermission(): Boolean {
+        return ContextCompat.checkSelfPermission(
+            applicationContext, Manifest.permission.ACCESS_FINE_LOCATION
+        ) == PackageManager.PERMISSION_GRANTED || ContextCompat.checkSelfPermission(
+            applicationContext, Manifest.permission.ACCESS_COARSE_LOCATION
+        ) == PackageManager.PERMISSION_GRANTED
+    }
+
+    private fun getBatteryLevel(): Int {
+        val intentFilter = IntentFilter(Intent.ACTION_BATTERY_CHANGED)
+        val batteryStatus = applicationContext.registerReceiver(null, intentFilter)
+        val level = batteryStatus?.getIntExtra(BatteryManager.EXTRA_LEVEL, -1) ?: -1
+        val scale = batteryStatus?.getIntExtra(BatteryManager.EXTRA_SCALE, -1) ?: -1
+        return if (level >= 0 && scale > 0) (level * 100 / scale) else -1
+    }
+
+    private fun sendMessage(url: String, text: String) {
+        try {
+            val request = Request.Builder()
+                .url(url)
+                .post(text.toRequestBody("text/plain".toMediaType()))
+                .build()
+
+            client.newCall(request).execute().use { response ->
+                Log.d(TAG, "POST response: ${response.code}")
+            }
+        } catch (e: Exception) {
+            Log.e(TAG, "Failed to send message", e)
+        }
+    }
+}

app/src/main/java/com/example/helios_location_finder/MainActivity.kt

@@ -0,0 +1,242 @@
+package com.example.helios_location_finder
+
+import android.Manifest
+import android.content.pm.PackageManager
+import android.os.Build
+import android.os.Bundle
+import androidx.activity.ComponentActivity
+import androidx.activity.compose.setContent
+import androidx.activity.result.contract.ActivityResultContracts
+import androidx.compose.foundation.layout.Arrangement
+import androidx.compose.foundation.layout.Column
+import androidx.compose.foundation.layout.Spacer
+import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.foundation.layout.fillMaxWidth
+import androidx.compose.foundation.layout.height
+import androidx.compose.foundation.layout.padding
+import androidx.compose.material3.Button
+import androidx.compose.material3.ButtonDefaults
+import androidx.compose.material3.MaterialTheme
+import androidx.compose.material3.OutlinedTextField
+import androidx.compose.material3.OutlinedTextFieldDefaults
+import androidx.compose.material3.Surface
+import androidx.compose.material3.Text
+import androidx.compose.material3.darkColorScheme
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.mutableStateOf
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.graphics.Color
+import androidx.compose.ui.unit.dp
+import androidx.core.content.ContextCompat
+
+private val Orange = Color(0xFFFF6D00)
+private val OrangeLight = Color(0xFFFFAB40)
+private val DarkSurface = Color(0xFF1A1A1A)
+
+private val HeliosDarkColorScheme = darkColorScheme(
+    primary = Orange,
+    onPrimary = Color.Black,
+    secondary = OrangeLight,
+    onSecondary = Color.Black,
+    background = Color.Black,
+    surface = DarkSurface,
+    onBackground = Color.White,
+    onSurface = Color.White,
+    error = Color(0xFFCF6679),
+)
+
+class MainActivity : ComponentActivity() {
+
+    private val foregroundGranted = mutableStateOf(false)
+    private val backgroundGranted = mutableStateOf(false)
+
+    private val foregroundPermissionLauncher = registerForActivityResult(
+        ActivityResultContracts.RequestMultiplePermissions()
+    ) { permissions ->
+        foregroundGranted.value = permissions.values.any { it }
+        checkPermissions()
+    }
+
+    private val backgroundPermissionLauncher = registerForActivityResult(
+        ActivityResultContracts.RequestPermission()
+    ) { granted ->
+        backgroundGranted.value = granted
+    }
+
+    override fun onCreate(savedInstanceState: Bundle?) {
+        super.onCreate(savedInstanceState)
+        checkPermissions()
+
+        val listenTopic = mutableStateOf(Prefs.getListenTopic(this))
+        val replyTopic = mutableStateOf(Prefs.getReplyTopic(this))
+
+        setContent {
+            MaterialTheme(colorScheme = HeliosDarkColorScheme) {
+                Surface(
+                    modifier = Modifier.fillMaxSize(),
+                    color = MaterialTheme.colorScheme.background
+                ) {
+                    StatusScreen(
+                        foregroundGranted = foregroundGranted.value,
+                        backgroundGranted = backgroundGranted.value,
+                        listenTopic = listenTopic.value,
+                        replyTopic = replyTopic.value,
+                        onListenTopicChange = { value ->
+                            listenTopic.value = value
+                            Prefs.setListenTopic(this, value)
+                        },
+                        onReplyTopicChange = { value ->
+                            replyTopic.value = value
+                            Prefs.setReplyTopic(this, value)
+                        },
+                        onRequestForegroundPermission = { requestForegroundPermissions() },
+                        onRequestBackgroundPermission = { requestBackgroundPermission() }
+                    )
+                }
+            }
+        }
+    }
+
+    override fun onResume() {
+        super.onResume()
+        checkPermissions()
+    }
+
+    private fun checkPermissions() {
+        foregroundGranted.value = ContextCompat.checkSelfPermission(
+            this, Manifest.permission.ACCESS_FINE_LOCATION
+        ) == PackageManager.PERMISSION_GRANTED || ContextCompat.checkSelfPermission(
+            this, Manifest.permission.ACCESS_COARSE_LOCATION
+        ) == PackageManager.PERMISSION_GRANTED
+
+        backgroundGranted.value = if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
+            ContextCompat.checkSelfPermission(
+                this, Manifest.permission.ACCESS_BACKGROUND_LOCATION
+            ) == PackageManager.PERMISSION_GRANTED
+        } else {
+            true
+        }
+    }
+
+    private fun requestForegroundPermissions() {
+        foregroundPermissionLauncher.launch(
+            arrayOf(
+                Manifest.permission.ACCESS_FINE_LOCATION,
+                Manifest.permission.ACCESS_COARSE_LOCATION
+            )
+        )
+    }
+
+    private fun requestBackgroundPermission() {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
+            backgroundPermissionLauncher.launch(Manifest.permission.ACCESS_BACKGROUND_LOCATION)
+        }
+    }
+}
+
+@Composable
+fun StatusScreen(
+    foregroundGranted: Boolean,
+    backgroundGranted: Boolean,
+    listenTopic: String,
+    replyTopic: String,
+    onListenTopicChange: (String) -> Unit,
+    onReplyTopicChange: (String) -> Unit,
+    onRequestForegroundPermission: () -> Unit,
+    onRequestBackgroundPermission: () -> Unit
+) {
+    val textFieldColors = OutlinedTextFieldDefaults.colors(
+        focusedBorderColor = Orange,
+        unfocusedBorderColor = OrangeLight.copy(alpha = 0.5f),
+        focusedLabelColor = Orange,
+        cursorColor = Orange,
+    )
+
+    Column(
+        modifier = Modifier
+            .fillMaxSize()
+            .padding(24.dp),
+        horizontalAlignment = Alignment.CenterHorizontally,
+        verticalArrangement = Arrangement.Center
+    ) {
+        Text(
+            text = "Helios Tracker",
+            style = MaterialTheme.typography.headlineMedium,
+            color = Orange
+        )
+
+        Spacer(modifier = Modifier.height(32.dp))
+
+        val statusText = when {
+            !foregroundGranted -> "Standort-Berechtigung fehlt"
+            !backgroundGranted -> "Hintergrund-Standort fehlt"
+            else -> "Bereit"
+        }
+        val isReady = foregroundGranted && backgroundGranted
+
+        Text(
+            text = "Status: $statusText",
+            style = MaterialTheme.typography.bodyLarge,
+            color = if (isReady) Orange else MaterialTheme.colorScheme.error
+        )
+
+        Spacer(modifier = Modifier.height(24.dp))
+
+        OutlinedTextField(
+            value = listenTopic,
+            onValueChange = onListenTopicChange,
+            label = { Text("Empfangs-Topic (lauschen)") },
+            placeholder = { Text("z.B. mein_geraet_locate") },
+            singleLine = true,
+            modifier = Modifier.fillMaxWidth(),
+            colors = textFieldColors
+        )
+
+        Spacer(modifier = Modifier.height(12.dp))
+
+        OutlinedTextField(
+            value = replyTopic,
+            onValueChange = onReplyTopicChange,
+            label = { Text("Antwort-Topic (senden)") },
+            placeholder = { Text("z.B. mein_geraet_reply") },
+            singleLine = true,
+            modifier = Modifier.fillMaxWidth(),
+            colors = textFieldColors
+        )
+
+        Spacer(modifier = Modifier.height(16.dp))
+
+        Text(
+            text = "Die App lauscht auf ntfy-Nachrichten mit dem Inhalt \"LOCATE\" " +
+                   "auf dem Empfangs-Topic und antwortet mit dem Standort auf dem Antwort-Topic.",
+            style = MaterialTheme.typography.bodyMedium,
+            color = Color.LightGray
+        )
+
+        if (!foregroundGranted) {
+            Spacer(modifier = Modifier.height(24.dp))
+            Button(
+                onClick = onRequestForegroundPermission,
+                colors = ButtonDefaults.buttonColors(containerColor = Orange)
+            ) {
+                Text("Standort-Berechtigung erteilen", color = Color.Black)
+            }
+        } else if (!backgroundGranted) {
+            Spacer(modifier = Modifier.height(24.dp))
+            Button(
+                onClick = onRequestBackgroundPermission,
+                colors = ButtonDefaults.buttonColors(containerColor = Orange)
+            ) {
+                Text("Hintergrund-Standort erlauben", color = Color.Black)
+            }
+            Spacer(modifier = Modifier.height(8.dp))
+            Text(
+                text = "Damit die App auf LOCATE-Anfragen reagieren kann, " +
+                       "muss \"Immer erlauben\" gewaehlt werden.",
+                style = MaterialTheme.typography.bodySmall,
+                color = Color.Gray
+            )
+        }
+    }
+}

app/src/main/java/com/example/helios_location_finder/NtfyReceiver.kt

@@ -0,0 +1,42 @@
+package com.example.helios_location_finder
+
+import android.content.BroadcastReceiver
+import android.content.Context
+import android.content.Intent
+import android.util.Log
+import androidx.work.ExistingWorkPolicy
+import androidx.work.OneTimeWorkRequestBuilder
+import androidx.work.WorkManager
+
+class NtfyReceiver : BroadcastReceiver() {
+
+    companion object {
+        private const val TAG = "NtfyReceiver"
+    }
+
+    override fun onReceive(context: Context, intent: Intent) {
+        val message = intent.getStringExtra("message") ?: return
+        val topic = intent.getStringExtra("topic") ?: ""
+
+        Log.d(TAG, "Received ntfy message on topic '$topic': $message")
+
+        val listenTopic = Prefs.getListenTopic(context)
+        if (listenTopic.isBlank()) {
+            Log.w(TAG, "No listen topic configured, ignoring")
+            return
+        }
+
+        if (topic != listenTopic) {
+            Log.d(TAG, "Topic '$topic' does not match configured '$listenTopic', ignoring")
+            return
+        }
+
+        if (message.trim().equals("LOCATE", ignoreCase = true)) {
+            Log.d(TAG, "LOCATE command received, enqueuing LocationWorker")
+            val workRequest = OneTimeWorkRequestBuilder<LocationWorker>().build()
+            WorkManager.getInstance(context).enqueueUniqueWork(
+                "locate", ExistingWorkPolicy.REPLACE, workRequest
+            )
+        }
+    }
+}

app/src/main/java/com/example/helios_location_finder/Prefs.kt

@@ -0,0 +1,24 @@
+package com.example.helios_location_finder
+
+import android.content.Context
+
+object Prefs {
+    private const val NAME = "helios_prefs"
+    const val KEY_LISTEN_TOPIC = "listen_topic"
+    const val KEY_REPLY_TOPIC = "reply_topic"
+
+    private fun prefs(context: Context) =
+        context.getSharedPreferences(NAME, Context.MODE_PRIVATE)
+
+    fun getListenTopic(context: Context): String =
+        prefs(context).getString(KEY_LISTEN_TOPIC, "") ?: ""
+
+    fun getReplyTopic(context: Context): String =
+        prefs(context).getString(KEY_REPLY_TOPIC, "") ?: ""
+
+    fun setListenTopic(context: Context, topic: String) =
+        prefs(context).edit().putString(KEY_LISTEN_TOPIC, topic).apply()
+
+    fun setReplyTopic(context: Context, topic: String) =
+        prefs(context).edit().putString(KEY_REPLY_TOPIC, topic).apply()
+}

app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@color/black" />
+    <foreground android:drawable="@mipmap/ic_launcher_foreground" />
+</adaptive-icon>

app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@color/black" />
+    <foreground android:drawable="@mipmap/ic_launcher_foreground" />
+</adaptive-icon>

app/src/main/res/values-night/themes.xml

@@ -0,0 +1,9 @@
+<resources>
+    <style name="Theme.Helioslocationfinder" parent="android:Theme.Material.NoActionBar">
+        <item name="android:colorPrimary">@color/orange</item>
+        <item name="android:colorAccent">@color/orange_light</item>
+        <item name="android:windowBackground">@color/black</item>
+        <item name="android:statusBarColor">@color/black</item>
+        <item name="android:navigationBarColor">@color/black</item>
+    </style>
+</resources>

app/src/main/res/values/colors.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <color name="orange">#FFFF6D00</color>
+    <color name="orange_light">#FFFFAB40</color>
+    <color name="orange_dark">#FFCC5500</color>
+    <color name="black">#FF000000</color>
+    <color name="dark_surface">#FF1A1A1A</color>
+    <color name="white">#FFFFFFFF</color>
+    <color name="gray_light">#FFB0B0B0</color>
+</resources>

app/src/main/res/values/strings.xml

@@ -0,0 +1,3 @@
+<resources>
+    <string name="app_name">Helios Tracker</string>
+</resources>

app/src/main/res/values/themes.xml

@@ -0,0 +1,9 @@
+<resources>
+    <style name="Theme.Helioslocationfinder" parent="android:Theme.Material.NoActionBar">
+        <item name="android:colorPrimary">@color/orange</item>
+        <item name="android:colorAccent">@color/orange_light</item>
+        <item name="android:windowBackground">@color/black</item>
+        <item name="android:statusBarColor">@color/black</item>
+        <item name="android:navigationBarColor">@color/black</item>
+    </style>
+</resources>

app/src/main/res/xml/backup_rules.xml

@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?><!--
+   Sample backup rules file; uncomment and customize as necessary.
+   See https://developer.android.com/guide/topics/data/autobackup
+   for details.
+   Note: This file is ignored for devices older than API 31
+   See https://developer.android.com/about/versions/12/backup-restore
+-->
+<full-backup-content>
+    <!--
+   <include domain="sharedpref" path="."/>
+   <exclude domain="sharedpref" path="device.xml"/>
+-->
+</full-backup-content>

app/src/main/res/xml/data_extraction_rules.xml

@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="utf-8"?><!--
+   Sample data extraction rules file; uncomment and customize as necessary.
+   See https://developer.android.com/about/versions/12/backup-restore#xml-changes
+   for details.
+-->
+<data-extraction-rules>
+    <cloud-backup>
+        <!-- TODO: Use <include> and <exclude> to control what is backed up.
+        <include .../>
+        <exclude .../>
+        -->
+    </cloud-backup>
+    <!--
+    <device-transfer>
+        <include .../>
+        <exclude .../>
+    </device-transfer>
+    -->
+</data-extraction-rules>

app/src/test/java/com/example/helios_location_finder/ExampleUnitTest.kt

@@ -0,0 +1,17 @@
+package com.example.helios_location_finder
+
+import org.junit.Test
+
+import org.junit.Assert.*
+
+/**
+ * Example local unit test, which will execute on the development machine (host).
+ *
+ * See [testing documentation](http://d.android.com/tools/testing).
+ */
+class ExampleUnitTest {
+    @Test
+    fun addition_isCorrect() {
+        assertEquals(4, 2 + 2)
+    }
+}

build.gradle.kts

@@ -0,0 +1,5 @@
+// Top-level build file where you can add configuration options common to all sub-projects/modules.
+plugins {
+    alias(libs.plugins.android.application) apply false
+    alias(libs.plugins.kotlin.compose) apply false
+}

gradle.properties

@@ -0,0 +1,23 @@
+# Project-wide Gradle settings.
+# IDE (e.g. Android Studio) users:
+# Gradle settings configured through the IDE *will override*
+# any settings specified in this file.
+# For more details on how to configure your build environment visit
+# http://www.gradle.org/docs/current/userguide/build_environment.html
+# Specifies the JVM arguments used for the daemon process.
+# The setting is particularly useful for tweaking memory settings.
+org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
+# When configured, Gradle will run in incubating parallel mode.
+# This option should only be used with decoupled projects. For more details, visit
+# https://developer.android.com/r/tools/gradle-multi-project-decoupled-projects
+# org.gradle.parallel=true
+# AndroidX package structure to make it clearer which packages are bundled with the
+# Android operating system, and which are packaged with your app's APK
+# https://developer.android.com/topic/libraries/support-library/androidx-rn
+android.useAndroidX=true
+# Kotlin code style for this project: "official" or "obsolete":
+kotlin.code.style=official
+# Enables namespacing of each library's R class so that its R class includes only the
+# resources declared in the library itself and none from the library's dependencies,
+# thereby reducing the size of the R class for that library
+android.nonTransitiveRClass=true

gradle/gradle-daemon-jvm.properties

@@ -0,0 +1,12 @@
+#This file is generated by updateDaemonJvm
+toolchainUrl.FREE_BSD.AARCH64=https\://api.foojay.io/disco/v3.0/ids/ec7520a1e057cd116f9544c42142a16b/redirect
+toolchainUrl.FREE_BSD.X86_64=https\://api.foojay.io/disco/v3.0/ids/4c4f879899012ff0a8b2e2117df03b0e/redirect
+toolchainUrl.LINUX.AARCH64=https\://api.foojay.io/disco/v3.0/ids/ec7520a1e057cd116f9544c42142a16b/redirect
+toolchainUrl.LINUX.X86_64=https\://api.foojay.io/disco/v3.0/ids/4c4f879899012ff0a8b2e2117df03b0e/redirect
+toolchainUrl.MAC_OS.AARCH64=https\://api.foojay.io/disco/v3.0/ids/73bcfb608d1fde9fb62e462f834a3299/redirect
+toolchainUrl.MAC_OS.X86_64=https\://api.foojay.io/disco/v3.0/ids/846ee0d876d26a26f37aa1ce8de73224/redirect
+toolchainUrl.UNIX.AARCH64=https\://api.foojay.io/disco/v3.0/ids/ec7520a1e057cd116f9544c42142a16b/redirect
+toolchainUrl.UNIX.X86_64=https\://api.foojay.io/disco/v3.0/ids/4c4f879899012ff0a8b2e2117df03b0e/redirect
+toolchainUrl.WINDOWS.AARCH64=https\://api.foojay.io/disco/v3.0/ids/9482ddec596298c84656d31d16652665/redirect
+toolchainUrl.WINDOWS.X86_64=https\://api.foojay.io/disco/v3.0/ids/39701d92e1756bb2f141eb67cd4c660e/redirect
+toolchainVersion=21

gradle/libs.versions.toml

@@ -0,0 +1,47 @@
+[versions]
+agp = "9.0.1"
+kotlinCompose = "2.2.10"
+coreKtx = "1.17.0"
+junit = "4.13.2"
+junitVersion = "1.3.0"
+espressoCore = "3.7.0"
+appcompat = "1.7.1"
+material = "1.13.0"
+composeBom = "2025.05.00"
+activityCompose = "1.10.1"
+workRuntime = "2.10.1"
+playServicesLocation = "21.3.0"
+okhttp = "4.12.0"
+coroutinesPlayServices = "1.10.2"
+
+[libraries]
+androidx-core-ktx = { group = "androidx.core", name = "core-ktx", version.ref = "coreKtx" }
+junit = { group = "junit", name = "junit", version.ref = "junit" }
+androidx-junit = { group = "androidx.test.ext", name = "junit", version.ref = "junitVersion" }
+androidx-espresso-core = { group = "androidx.test.espresso", name = "espresso-core", version.ref = "espressoCore" }
+androidx-appcompat = { group = "androidx.appcompat", name = "appcompat", version.ref = "appcompat" }
+material = { group = "com.google.android.material", name = "material", version.ref = "material" }
+
+# Compose
+compose-bom = { group = "androidx.compose", name = "compose-bom", version.ref = "composeBom" }
+compose-ui = { group = "androidx.compose.ui", name = "ui" }
+compose-ui-tooling-preview = { group = "androidx.compose.ui", name = "ui-tooling-preview" }
+compose-ui-tooling = { group = "androidx.compose.ui", name = "ui-tooling" }
+compose-material3 = { group = "androidx.compose.material3", name = "material3" }
+activity-compose = { group = "androidx.activity", name = "activity-compose", version.ref = "activityCompose" }
+
+# WorkManager
+work-runtime-ktx = { group = "androidx.work", name = "work-runtime-ktx", version.ref = "workRuntime" }
+
+# Play Services Location
+play-services-location = { group = "com.google.android.gms", name = "play-services-location", version.ref = "playServicesLocation" }
+
+# OkHttp
+okhttp = { group = "com.squareup.okhttp3", name = "okhttp", version.ref = "okhttp" }
+
+# Coroutines Play Services
+coroutines-play-services = { group = "org.jetbrains.kotlinx", name = "kotlinx-coroutines-play-services", version.ref = "coroutinesPlayServices" }
+
+[plugins]
+android-application = { id = "com.android.application", version.ref = "agp" }
+kotlin-compose = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlinCompose" }

gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,9 @@
+#Mon Feb 16 16:06:48 CET 2026
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionSha256Sum=72f44c9f8ebcb1af43838f45ee5c4aa9c5444898b3468ab3f4af7b6076c5bc3f
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.2.1-bin.zip
+networkTimeout=10000
+validateDistributionUrl=true
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists

gradlew

@@ -0,0 +1,251 @@
+#!/bin/sh
+
+#
+# Copyright © 2015 the original authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# SPDX-License-Identifier: Apache-2.0
+#
+
+##############################################################################
+#
+#   Gradle start up script for POSIX generated by Gradle.
+#
+#   Important for running:
+#
+#   (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
+#       noncompliant, but you have some other compliant shell such as ksh or
+#       bash, then to run this script, type that shell name before the whole
+#       command line, like:
+#
+#           ksh Gradle
+#
+#       Busybox and similar reduced shells will NOT work, because this script
+#       requires all of these POSIX shell features:
+#         * functions;
+#         * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
+#           «${var#prefix}», «${var%suffix}», and «$( cmd )»;
+#         * compound commands having a testable exit status, especially «case»;
+#         * various built-in commands including «command», «set», and «ulimit».
+#
+#   Important for patching:
+#
+#   (2) This script targets any POSIX shell, so it avoids extensions provided
+#       by Bash, Ksh, etc; in particular arrays are avoided.
+#
+#       The "traditional" practice of packing multiple parameters into a
+#       space-separated string is a well documented source of bugs and security
+#       problems, so this is (mostly) avoided, by progressively accumulating
+#       options in "$@", and eventually passing that to Java.
+#
+#       Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
+#       and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
+#       see the in-line comments for details.
+#
+#       There are tweaks for specific operating systems such as AIX, CygWin,
+#       Darwin, MinGW, and NonStop.
+#
+#   (3) This script is generated from the Groovy template
+#       https://github.com/gradle/gradle/blob/HEAD/platforms/jvm/plugins-application/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
+#       within the Gradle project.
+#
+#       You can find Gradle at https://github.com/gradle/gradle/.
+#
+##############################################################################
+
+# Attempt to set APP_HOME
+
+# Resolve links: $0 may be a link
+app_path=$0
+
+# Need this for daisy-chained symlinks.
+while
+    APP_HOME=${app_path%"${app_path##*/}"}  # leaves a trailing /; empty if no leading path
+    [ -h "$app_path" ]
+do
+    ls=$( ls -ld "$app_path" )
+    link=${ls#*' -> '}
+    case $link in             #(
+      /*)   app_path=$link ;; #(
+      *)    app_path=$APP_HOME$link ;;
+    esac
+done
+
+# This is normally unused
+# shellcheck disable=SC2034
+APP_BASE_NAME=${0##*/}
+# Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036)
+APP_HOME=$( cd -P "${APP_HOME:-./}" > /dev/null && printf '%s\n' "$PWD" ) || exit
+
+# Use the maximum available, or set MAX_FD != -1 to use that value.
+MAX_FD=maximum
+
+warn () {
+    echo "$*"
+} >&2
+
+die () {
+    echo
+    echo "$*"
+    echo
+    exit 1
+} >&2
+
+# OS specific support (must be 'true' or 'false').
+cygwin=false
+msys=false
+darwin=false
+nonstop=false
+case "$( uname )" in                #(
+  CYGWIN* )         cygwin=true  ;; #(
+  Darwin* )         darwin=true  ;; #(
+  MSYS* | MINGW* )  msys=true    ;; #(
+  NONSTOP* )        nonstop=true ;;
+esac
+
+CLASSPATH="\\\"\\\""
+
+
+# Determine the Java command to use to start the JVM.
+if [ -n "$JAVA_HOME" ] ; then
+    if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
+        # IBM's JDK on AIX uses strange locations for the executables
+        JAVACMD=$JAVA_HOME/jre/sh/java
+    else
+        JAVACMD=$JAVA_HOME/bin/java
+    fi
+    if [ ! -x "$JAVACMD" ] ; then
+        die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+    fi
+else
+    JAVACMD=java
+    if ! command -v java >/dev/null 2>&1
+    then
+        die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+    fi
+fi
+
+# Increase the maximum file descriptors if we can.
+if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
+    case $MAX_FD in #(
+      max*)
+        # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.
+        # shellcheck disable=SC2039,SC3045
+        MAX_FD=$( ulimit -H -n ) ||
+            warn "Could not query maximum file descriptor limit"
+    esac
+    case $MAX_FD in  #(
+      '' | soft) :;; #(
+      *)
+        # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.
+        # shellcheck disable=SC2039,SC3045
+        ulimit -n "$MAX_FD" ||
+            warn "Could not set maximum file descriptor limit to $MAX_FD"
+    esac
+fi
+
+# Collect all arguments for the java command, stacking in reverse order:
+#   * args from the command line
+#   * the main class name
+#   * -classpath
+#   * -D...appname settings
+#   * --module-path (only if needed)
+#   * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
+
+# For Cygwin or MSYS, switch paths to Windows format before running java
+if "$cygwin" || "$msys" ; then
+    APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
+    CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )
+
+    JAVACMD=$( cygpath --unix "$JAVACMD" )
+
+    # Now convert the arguments - kludge to limit ourselves to /bin/sh
+    for arg do
+        if
+            case $arg in                                #(
+              -*)   false ;;                            # don't mess with options #(
+              /?*)  t=${arg#/} t=/${t%%/*}              # looks like a POSIX filepath
+                    [ -e "$t" ] ;;                      #(
+              *)    false ;;
+            esac
+        then
+            arg=$( cygpath --path --ignore --mixed "$arg" )
+        fi
+        # Roll the args list around exactly as many times as the number of
+        # args, so each arg winds up back in the position where it started, but
+        # possibly modified.
+        #
+        # NB: a `for` loop captures its iteration list before it begins, so
+        # changing the positional parameters here affects neither the number of
+        # iterations, nor the values presented in `arg`.
+        shift                   # remove old arg
+        set -- "$@" "$arg"      # push replacement arg
+    done
+fi
+
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
+
+# Collect all arguments for the java command:
+#   * DEFAULT_JVM_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments,
+#     and any embedded shellness will be escaped.
+#   * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be
+#     treated as '${Hostname}' itself on the command line.
+
+set -- \
+        "-Dorg.gradle.appname=$APP_BASE_NAME" \
+        -classpath "$CLASSPATH" \
+        -jar "$APP_HOME/gradle/wrapper/gradle-wrapper.jar" \
+        "$@"
+
+# Stop when "xargs" is not available.
+if ! command -v xargs >/dev/null 2>&1
+then
+    die "xargs is not available"
+fi
+
+# Use "xargs" to parse quoted args.
+#
+# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
+#
+# In Bash we could simply go:
+#
+#   readarray ARGS < <( xargs -n1 <<<"$var" ) &&
+#   set -- "${ARGS[@]}" "$@"
+#
+# but POSIX shell has neither arrays nor command substitution, so instead we
+# post-process each arg (as a line of input to sed) to backslash-escape any
+# character that might be a shell metacharacter, then use eval to reverse
+# that process (while maintaining the separation between arguments), and wrap
+# the whole thing up as a single "set" statement.
+#
+# This will of course break if any of these variables contains a newline or
+# an unmatched quote.
+#
+
+eval "set -- $(
+        printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
+        xargs -n1 |
+        sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
+        tr '\n' ' '
+    )" '"$@"'
+
+exec "$JAVACMD" "$@"

gradlew.bat

@@ -0,0 +1,94 @@
+@rem
+@rem Copyright 2015 the original author or authors.
+@rem
+@rem Licensed under the Apache License, Version 2.0 (the "License");
+@rem you may not use this file except in compliance with the License.
+@rem You may obtain a copy of the License at
+@rem
+@rem      https://www.apache.org/licenses/LICENSE-2.0
+@rem
+@rem Unless required by applicable law or agreed to in writing, software
+@rem distributed under the License is distributed on an "AS IS" BASIS,
+@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+@rem See the License for the specific language governing permissions and
+@rem limitations under the License.
+@rem
+@rem SPDX-License-Identifier: Apache-2.0
+@rem
+
+@if "%DEBUG%"=="" @echo off
+@rem ##########################################################################
+@rem
+@rem  Gradle startup script for Windows
+@rem
+@rem ##########################################################################
+
+@rem Set local scope for the variables with windows NT shell
+if "%OS%"=="Windows_NT" setlocal
+
+set DIRNAME=%~dp0
+if "%DIRNAME%"=="" set DIRNAME=.
+@rem This is normally unused
+set APP_BASE_NAME=%~n0
+set APP_HOME=%DIRNAME%
+
+@rem Resolve any "." and ".." in APP_HOME to make it shorter.
+for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
+
+@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
+
+@rem Find java.exe
+if defined JAVA_HOME goto findJavaFromJavaHome
+
+set JAVA_EXE=java.exe
+%JAVA_EXE% -version >NUL 2>&1
+if %ERRORLEVEL% equ 0 goto execute
+
+echo. 1>&2
+echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 1>&2
+echo. 1>&2
+echo Please set the JAVA_HOME variable in your environment to match the 1>&2
+echo location of your Java installation. 1>&2
+
+goto fail
+
+:findJavaFromJavaHome
+set JAVA_HOME=%JAVA_HOME:"=%
+set JAVA_EXE=%JAVA_HOME%/bin/java.exe
+
+if exist "%JAVA_EXE%" goto execute
+
+echo. 1>&2
+echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 1>&2
+echo. 1>&2
+echo Please set the JAVA_HOME variable in your environment to match the 1>&2
+echo location of your Java installation. 1>&2
+
+goto fail
+
+:execute
+@rem Setup the command line
+
+set CLASSPATH=
+
+
+@rem Execute Gradle
+"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" -jar "%APP_HOME%\gradle\wrapper\gradle-wrapper.jar" %*
+
+:end
+@rem End local scope for the variables with windows NT shell
+if %ERRORLEVEL% equ 0 goto mainEnd
+
+:fail
+rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
+rem the _cmd.exe /c_ return code!
+set EXIT_CODE=%ERRORLEVEL%
+if %EXIT_CODE% equ 0 set EXIT_CODE=1
+if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE%
+exit /b %EXIT_CODE%
+
+:mainEnd
+if "%OS%"=="Windows_NT" endlocal
+
+:omega

settings.gradle.kts

@@ -0,0 +1,27 @@
+pluginManagement {
+    repositories {
+        google {
+            content {
+                includeGroupByRegex("com\\.android.*")
+                includeGroupByRegex("com\\.google.*")
+                includeGroupByRegex("androidx.*")
+            }
+        }
+        mavenCentral()
+        gradlePluginPortal()
+    }
+}
+plugins {
+    id("org.gradle.toolchains.foojay-resolver-convention") version "1.0.0"
+}
+dependencyResolutionManagement {
+    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
+    repositories {
+        google()
+        mavenCentral()
+    }
+}
+
+rootProject.name = "helios-location-finder"
+include(":app")
+