Compare commits

..
6 Commits
Author SHA1 Message Date
Arty Bishop b17ea2d918 v4.4.3 - Added required tweaks to support Android 17 (API 37) 2026-06-27 14:15:05 +01:00
Arty Bishop 976fdfd949 Added Star History graph to README, tweaked AGENTS 2026-06-27 12:31:24 +01:00
dependabot[bot] d8db258bd8 Bump actions/checkout from 6 to 7 (#221)
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-06-24 16:38:32 +01:00
Arty Bishop 7b6fb5eb8f v4.4.2 - Fixed transceivers retention, various minor tweaks 2026-06-21 15:19:47 +01:00
Arty Bishop f4aef4f4f0 Fixed SSTV frequency display and "All" category retention 2026-06-21 15:10:28 +01:00
Arty Bishop 9147323db2 Cleaned up SensorsRepo class, removed deprecated calls 2026-06-21 15:03:45 +01:00
33 changed files with 1008 additions and 239 deletions

No files matched your search

+5
View File
@@ -0,0 +1,5 @@
# GitHub Copilot Instructions
Read `AGENTS.md` first, then `CLAUDE.md`.
`AGENTS.md` contains the architecture, module boundaries, implementation details, conventions, and gotchas.
+3 -3
View File
@@ -16,13 +16,13 @@ jobs:
contents: write
steps:
- name: Checkout Repository
uses: actions/checkout@v6
uses: actions/checkout@v7
- name: Setup Java
uses: actions/setup-java@v5
with:
distribution: 'temurin'
java-version: '17'
java-version: '21'
- name: Setup Gradle
uses: gradle/actions/setup-gradle@v6
@@ -58,7 +58,7 @@ jobs:
- name: Setup Ruby
uses: ruby/setup-ruby@v1
with:
ruby-version: '3.3'
ruby-version: '3.4'
- name: Deploy Bundle to Google Play
run: |
+122
View File
@@ -0,0 +1,122 @@
# Look4Sat AI Agent Instructions
This is the canonical project guide for all AI assistants working on Look4Sat.
All assistant-specific files (`CLAUDE.md`, `.github/copilot-instructions.md`) point here.
---
## Project Overview
Look4Sat is an open-source, fully offline Android satellite tracker and pass predictor. It tracks 9000+ active
satellites using TLE/OMM data from Celestrak/SatNOGS, calculates orbital positions via SGP4/SDP4 models, and displays
passes relative to the user's location. Features include polar radar visualization, SSTV image decoding, satellite
ground track mapping, and pass predictions up to 10 days ahead. No ads, no tracking, no network required after initial
data download.
## Architecture
**MVI (Model-View-Intent)** with unidirectional data flow:
- `State` data class → exposed via `StateFlow` from ViewModel
- `Action` sealed interface → user intents dispatched to ViewModel's `onAction()`
- Jetpack Compose UI observes state and recomposes reactively
**Clean Architecture layers:**
| Module | Responsibility |
|----------------------|---------------------------------------------------------------------|
| `app` | Entry point. Aggregates all modules |
| `core:data` | Android library. Room DB, OkHttp networking, repo implementations |
| `core:domain` | Pure Kotlin (JVM). Orbital math (SGP4/SDP4), models, repo contracts |
| `core:presentation` | Android library. Compose theme, shared UI components, NavKeys |
| `feature:map` | OSMDroid map with ground tracks |
| `feature:passes` | Pass predictions and upcoming events |
| `feature:radar` | Polar radar view of satellite positions, SSTV image decoding |
| `feature:satellites` | Satellite list, filtering, selection |
| `feature:settings` | User preferences |
- `feature:*` modules depend only on `core:domain` + `core:presentation`. Features never depend on each other.
## Build & Run
```shell
# Debug build
./gradlew assembleDebug
# Release build (minified, shrunk resources)
./gradlew assembleRelease
# Run tests
./gradlew test
```
- **Min SDK**: 24 | **Target SDK**: 36 | **JDK**: 17
- **Gradle**: Uses version catalog (`gradle/libs.versions.toml`) + convention plugins in `build-logic/`
## Key Libraries
- **Compose** (BOM 2026.05.01) + Material3 Adaptive
- **Navigation3** (type-safe, uses `@Serializable` NavKeys)
- **Room** (KSP code generation) for local satellite/TLE storage
- **OkHttp** 5.x for TLE downloads
- **OSMDroid** for map rendering
- **Kotlin Serialization** for navigation args and data parsing
- **Coroutines** + `StateFlow` for async/reactive patterns
## Conventions
- **Minimal dependencies**: Avoid adding libraries when a simple manual solution exists. Fewer deps = less maintenance.
- **DI**: Manual — ViewModels use companion `factory()` methods with `IMainContainer` interface.
- **Navigation**: Type-safe Compose Navigation3 with `@Serializable` data classes as nav keys.
- **State naming**: `<Feature>State` data class + `<Feature>Action` sealed interface per feature.
- **No feature-to-feature deps**: All cross-feature communication goes through core layers.
- **Localization**: 7 languages (en, es, ru, si, tr, uk, zh).
## Data Formats & Migration
**TLE vs. OMM/CSV format:**
Look4Sat supports both TLE and OMM (Orbit Mean-Elements Message) formats for backward compatibility:
- **TLE format**: Traditional 3-line element format (deprecated). NORAD catalog numbers are 5-digit integers, which
are running out of space. Celestrak has signaled that TLE format will eventually be phased out.
- **OMM/CSV format**: The future standard. CSV files contain the same orbital parameters as TLE but use ISO 8601
timestamps and support larger NORAD IDs. Celestrak and SatNOGS already provide OMM data in CSV format.
**Current implementation:**
- `DataParser.kt` handles both `parseTLEStream()` and `parseCSVStream()` seamlessly
- TLE data is downloaded from configured sources and stored in Room database
- When downloading satellite data, the app automatically detects format and parses accordingly
- Both formats produce identical `OrbitalData` objects, ensuring transparent format switching
**Migration path:**
As NORAD catalog space becomes constrained, OMM/CSV will become the primary format. Look4Sat is already positioned
to handle this transition without code changes — existing users can continue using TLE files while new sources
transition to OMM/CSV automatically.
## Code Style
- Prefer **short, focused functions** — single responsibility, easy to read.
- **Exceptions**: Composable functions and math-heavy algorithms (SGP4/SDP4) may be longer.
- Strict code style — no dead code, no unused imports, consistent formatting.
## Roadmap
- **KMP migration**: `core:domain` is to become a fully shareable KMM module. Keep it pure Kotlin/JVM.
## Gotchas
- Orbital math lives in `core:domain/predict/` — it's dense vector math (SGP4/SDP4). Tread carefully.
- TLE/OMM data must be refreshed weekly for accurate predictions (satellite orbits decay). TLE format is legacy and
will eventually be deprecated in favor of OMM/CSV as NORAD catalog numbers approach the 5-digit limit.
- SSTV decoding in `feature:radar` is experimental; image quality depends on signal strength during satellite pass.
- `build-logic/convention/` contains all shared Gradle configuration — edit there, not in individual modules.
- ProGuard is enabled for release builds — don't add reflection-based libs or any other dependencies without asking.
## Copilot Working Mode: Code-Only
- Default to code changes only. Provide explanations in chat only.
- If documentation seems useful, ask first before creating files.
- Do NOT create any `.md` documentation files unless explicitly requested.
- Do NOT add README, guides, summaries, migration notes, or how-to files unless asked.
- Prefer minimal diffs focused on requested implementation.
- Default validation is static checks (`get_errors`). Do NOT run Gradle compile/test tasks unless explicitly requested.
+2 -107
View File
@@ -1,110 +1,5 @@
# CLAUDE.md
## Project Overview
Read `AGENTS.md` first, then follow the instructions there.
Look4Sat is an open-source, fully offline Android satellite tracker and pass predictor. It tracks 9000+ active
satellites using TLE/OMM data from Celestrak/SatNOGS, calculates orbital positions via SGP4/SDP4 models, and displays
passes relative to the user's location. Features include polar radar visualization, SSTV image decoding, satellite
ground track mapping, and pass predictions up to 10 days ahead. No ads, no tracking, no network required after initial
data download.
## Architecture
**MVI (Model-View-Intent)** with unidirectional data flow:
- `State` data class → exposed via `StateFlow` from ViewModel
- `Action` sealed interface → user intents dispatched to ViewModel's `onAction()`
- Jetpack Compose UI observes state and recomposes reactively
**Clean Architecture layers:**
| ------------------------ | --------------------------------------------------------------------- |
| Module | Responsibility |
|--------------------------|-----------------------------------------------------------------------|
| `app` | Entry point. Aggregates all modules |
| `core:data` | Android library. Room DB, OkHttp networking, repo implementations |
| `core:domain` | Pure Kotlin (JVM). Orbital math (SGP4/SDP4), models, repo contracts |
| `core:presentation` | Android library. Compose theme, shared UI components, NavKeys |
| `feature:map` | OSMDroid map with ground tracks |
| `feature:passes` | Pass predictions and upcoming events |
| `feature:radar` | Polar radar view of satellite positions, SSTV image decoding |
| `feature:satellites` | Satellite list, filtering, selection |
| `feature:settings` | User preferences |
| ------------------------ | --------------------------------------------------------------------- |
- `feature:*` modules depend only on `core:domain` + `core:presentation`. Features never depend on each other.
## Build & Run
```shell
# Debug build
./gradlew assembleDebug
# Release build (minified, shrunk resources)
./gradlew assembleRelease
# Run tests
./gradlew test
```
- **Min SDK**: 24 | **Target SDK**: 36 | **JDK**: 17
- **Gradle**: Uses version catalog (`gradle/libs.versions.toml`) + convention plugins in `build-logic/`
## Key Libraries
- **Compose** (BOM 2026.05.01) + Material3 Adaptive
- **Navigation3** (type-safe, uses `@Serializable` NavKeys)
- **Room** (KSP code generation) for local satellite/TLE storage
- **OkHttp** 5.x for TLE downloads
- **OSMDroid** for map rendering
- **Kotlin Serialization** for navigation args and data parsing
- **Coroutines** + `StateFlow` for async/reactive patterns
## Conventions
- **Minimal dependencies**: Avoid adding libraries when a simple manual solution exists. Fewer deps = less maintenance.
- **DI**: Manual — ViewModels use companion `factory()` methods with `IMainContainer` interface.
- **Navigation**: Type-safe Compose Navigation3 with `@Serializable` data classes as nav keys.
- **State naming**: `<Feature>State` data class + `<Feature>Action` sealed interface per feature.
- **No feature-to-feature deps**: All cross-feature communication goes through core layers.
- **Localization**: 7 languages (en, es, ru, si, tr, uk, zh).
## Data Formats & Migration
**TLE vs. OMM/CSV format:**
Look4Sat supports both TLE and OMM (Orbit Mean-Elements Message) formats for backward compatibility:
- **TLE format**: Traditional 3-line element format (deprecated). NORAD catalog numbers are 5-digit integers, which
are running out of space. Celestrak has signaled that TLE format will eventually be phased out.
- **OMM/CSV format**: The future standard. CSV files contain the same orbital parameters as TLE but use ISO 8601
timestamps and support larger NORAD IDs. Celestrak and SatNOGS already provide OMM data in CSV format.
**Current implementation:**
- `DataParser.kt` handles both `parseTLEStream()` and `parseCSVStream()` seamlessly
- TLE data is downloaded from configured sources and stored in Room database
- When downloading satellite data, the app automatically detects format and parses accordingly
- Both formats produce identical `OrbitalData` objects, ensuring transparent format switching
**Migration path:**
As NORAD catalog space becomes constrained, OMM/CSV will become the primary format. Look4Sat is already positioned
to handle this transition without code changes—existing users can continue using TLE files while new sources transition
to OMM/CSV automatically.
## Code Style
- Prefer **short, focused functions** — single responsibility, easy to read.
- **Exceptions**: Composable functions and math-heavy algorithms (SGP4/SDP4) may be longer.
- Strict code style — no dead code, no unused imports, consistent formatting.
## Roadmap
- **KMP migration**: `core:domain` is to become a fully shareable KMM module. Keep it pure Kotlin/JVM.
## Gotchas
- Orbital math lives in `core:domain/predict/` — it's dense vector math (SGP4/SDP4). Tread carefully.
- TLE/OMM data must be refreshed weekly for accurate predictions (satellite orbits decay). TLE format is legacy and
will eventually be deprecated in favor of OMM/CSV as NORAD catalog numbers approach the 5-digit limit.
- SSTV decoding in `feature:radar` is experimental; image quality depends on signal strength during satellite pass.
- `build-logic/convention/` contains all shared Gradle configuration — edit there, not in individual modules.
- ProGuard is enabled for release builds — don't add reflection-based libs or any other dependencies without asking.
`AGENTS.md` contains the architecture, module boundaries, implementation details, conventions, and gotchas.
+10
View File
@@ -33,3 +33,13 @@ It is now and always will be completely ad-free and open-source.
* Showing the satellite positional data, footprint and ground track on the map
* Custom TLE satellite data import is available via Three Line Element .txt files
* Offline first: calculations are made offline. Weekly TLE data update is recommended.
## Star History
<a href="https://www.star-history.com/?repos=rt-bishop%2FLook4Sat&type=timeline&legend=top-left">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=rt-bishop/Look4Sat&type=timeline&theme=dark&legend=top-left" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=rt-bishop/Look4Sat&type=timeline&legend=top-left" />
<img alt="Star History Chart" src="https://api.star-history.com/chart?repos=rt-bishop/Look4Sat&type=timeline&legend=top-left" />
</picture>
</a>
+2 -2
View File
@@ -2,6 +2,7 @@
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_LOCAL_NETWORK" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission
@@ -18,8 +19,7 @@
android:allowBackup="false"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:roundIcon="@mipmap/ic_launcher_round"
android:usesCleartextTraffic="true">
android:roundIcon="@mipmap/ic_launcher_round">
<activity
android:name=".MainActivity"
+1
View File
@@ -8,5 +8,6 @@ plugins {
}
tasks.register("clean", Delete::class.java) {
description = "Cleans the build directory"
delete(rootProject.layout.buildDirectory)
}
+1
View File
@@ -2,6 +2,7 @@
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_LOCAL_NETWORK" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission
@@ -17,6 +17,9 @@
*/
package com.rtbishop.look4sat.core.data.framework
import java.util.Locale
import kotlin.math.roundToLong
object Ft817CatProtocol {
const val CMD_SET_FREQ: Byte = 0x01
@@ -50,7 +53,7 @@ object Ft817CatProtocol {
fun encodeFrequencyBcd(frequencyHz: Long): ByteArray {
val freq10Hz = frequencyHz / 10
val bcd = ByteArray(4)
val digits = String.format("%08d", freq10Hz)
val digits = String.format(Locale.US, "%08d", freq10Hz)
for (i in 0 until 4) {
val high = digits[i * 2] - '0'
val low = digits[i * 2 + 1] - '0'
@@ -78,8 +81,8 @@ object Ft817CatProtocol {
* 67.0 Hz → 670 (in 0.1 Hz) → BCD [0x06, 0x70]
*/
fun encodeCtcssToneBcd(toneHz: Double): ByteArray {
val tone01Hz = (toneHz * 10).toLong()
val digits = String.format("%04d", tone01Hz)
val tone01Hz = (toneHz * 10).roundToLong()
val digits = String.format(Locale.US, "%04d", tone01Hz)
val bcd = ByteArray(2)
for (i in 0 until 2) {
val high = digits[i * 2] - '0'
@@ -95,7 +98,7 @@ object Ft817CatProtocol {
}
fun buildSetModeCommand(mode: String): ByteArray? {
val modeByte = MODE_TO_BYTE[mode.uppercase()] ?: return null
val modeByte = MODE_TO_BYTE[mode.uppercase(Locale.US)] ?: return null
return byteArrayOf(modeByte, 0x00, 0x00, 0x00, CMD_SET_MODE)
}
@@ -29,6 +29,7 @@ import kotlinx.coroutines.withContext
import java.io.InputStream
import java.io.OutputStream
import java.util.UUID
import kotlin.time.Duration.Companion.milliseconds
class Ft817Controller(
private val bluetoothManager: BluetoothManager,
@@ -39,10 +40,12 @@ class Ft817Controller(
private val sppId: UUID = UUID.fromString("00001101-0000-1000-8000-00805f9b34fb")
private val ioMutex = Mutex()
private val commandDelayMs = 200L
private val maxAckReadFailures = 3
private var socket: BluetoothSocket? = null
private var outputStream: OutputStream? = null
private var inputStream: InputStream? = null
private var ackReadFailureCount = 0
override var isConnected: Boolean = false
private set
@@ -57,6 +60,7 @@ class Ft817Controller(
socket = btSocket
outputStream = btSocket.outputStream
inputStream = btSocket.inputStream
ackReadFailureCount = 0
isConnected = true
Log.i(tag, "Connected to $deviceAddress")
true
@@ -79,6 +83,7 @@ class Ft817Controller(
inputStream = null
outputStream = null
socket = null
ackReadFailureCount = 0
isConnected = false
Log.i(tag, "Disconnected from $deviceAddress")
}
@@ -112,8 +117,8 @@ class Ft817Controller(
ioMutex.withLock {
val sent = sendCommand(Ft817CatProtocol.buildReadFreqModeCommand())
if (!sent) return@withContext null
delay(commandDelayMs)
val response = readResponse(5) ?: return@withContext null
delay(commandDelayMs.milliseconds)
val response = readResponse() ?: return@withContext null
Ft817CatProtocol.parseReadResponse(response)
}
}
@@ -127,44 +132,76 @@ class Ft817Controller(
}
private suspend fun sendCommand(bytes: ByteArray): Boolean {
return try {
outputStream?.write(bytes) ?: return false
outputStream?.flush()
delay(commandDelayMs)
true
} catch (e: Exception) {
Log.e(tag, "Send error: ${e.message}")
isConnected = false
false
return withContext(Dispatchers.IO) {
try {
outputStream?.write(bytes) ?: return@withContext false
outputStream?.flush()
delay(commandDelayMs.milliseconds)
true
} catch (e: Exception) {
Log.e(tag, "Send error: ${e.message}")
isConnected = false
false
}
}
}
/** Send command and read the 1-byte ACK response (0x00 = OK). */
private suspend fun sendCommandWithAck(bytes: ByteArray): Boolean {
if (!sendCommand(bytes)) return false
return try {
val ack = inputStream?.read() ?: return false
ack == 0x00
} catch (e: Exception) {
Log.e(tag, "ACK read error: ${e.message}")
true // command was sent, ACK read failed - continue anyway
return withContext(Dispatchers.IO) {
try {
val ack = inputStream?.read() ?: run {
ackReadFailureCount = 0
isConnected = false
return@withContext false
}
if (ack < 0) {
ackReadFailureCount = 0
Log.i(tag, "ACK stream closed by remote device")
isConnected = false
return@withContext false
}
ackReadFailureCount = 0
ack == 0x00
} catch (e: Exception) {
ackReadFailureCount += 1
Log.w(tag, "ACK read error (${ackReadFailureCount}/$maxAckReadFailures): ${e.message}")
if (ackReadFailureCount >= maxAckReadFailures) {
Log.e(tag, "Too many ACK read errors, marking radio disconnected")
isConnected = false
false
} else {
true // Command was sent, treat transient ACK read failures as best-effort
}
}
}
}
private fun readResponse(length: Int): ByteArray? {
return try {
val buffer = ByteArray(length)
var read = 0
while (read < length) {
val count = inputStream?.read(buffer, read, length - read) ?: return null
if (count < 0) return null
read += count
private suspend fun readResponse(): ByteArray? {
return withContext(Dispatchers.IO) {
try {
val responseSize = 5
val buffer = ByteArray(responseSize)
var read = 0
while (read < responseSize) {
val count = inputStream?.read(buffer, read, responseSize - read) ?: run {
isConnected = false
return@withContext null
}
if (count < 0) {
Log.i(tag, "Response stream closed by remote device")
isConnected = false
return@withContext null
}
read += count
}
buffer
} catch (e: Exception) {
Log.e(tag, "Read error: ${e.message}")
isConnected = false
null
}
buffer
} catch (e: Exception) {
Log.e(tag, "Read error: ${e.message}")
isConnected = false
null
}
}
}
@@ -19,10 +19,9 @@ package com.rtbishop.look4sat.core.data.injection
import android.bluetooth.BluetoothManager
import android.content.Context
import android.hardware.Sensor
import android.hardware.SensorManager
import android.hardware.display.DisplayManager
import android.location.LocationManager
import android.view.WindowManager
import androidx.room.Room
import com.rtbishop.look4sat.core.data.database.Look4SatDb
import com.rtbishop.look4sat.core.data.framework.BluetoothReporter
@@ -120,9 +119,8 @@ class MainContainer(private val context: Context) : IMainContainer {
override fun provideSensorsRepo(): ISensorsRepo {
val manager = context.getSystemService(Context.SENSOR_SERVICE) as SensorManager
val sensor = manager.getDefaultSensor(Sensor.TYPE_ROTATION_VECTOR)
val window = context.getSystemService(Context.WINDOW_SERVICE) as WindowManager
return SensorsRepo(manager,sensor,window)
val displayManager = context.getSystemService(DisplayManager::class.java)
return SensorsRepo(manager, displayManager)
}
private fun provideDatabaseRepo(): IDatabaseRepo {
@@ -22,8 +22,9 @@ import android.hardware.Sensor
import android.hardware.SensorEvent
import android.hardware.SensorEventListener
import android.hardware.SensorManager
import android.hardware.display.DisplayManager
import android.view.Display
import android.view.Surface
import android.view.WindowManager
import com.rtbishop.look4sat.core.domain.predict.GeoPos
import com.rtbishop.look4sat.core.domain.predict.RAD2DEG
import com.rtbishop.look4sat.core.domain.repository.ISensorsRepo
@@ -31,13 +32,16 @@ import kotlinx.coroutines.flow.MutableStateFlow
import kotlinx.coroutines.flow.StateFlow
import kotlin.math.round
private const val SMOOTHING_FACTOR = 0.15f
private const val SENSOR_RATE_US = 16_000
class SensorsRepo(
private val sensorManager: SensorManager,
private val sensor: Sensor?,
private val windowManager: WindowManager
) : SensorEventListener, ISensorsRepo {
private val displayManager: DisplayManager?
) : ISensorsRepo, SensorEventListener {
private val _orientation = MutableStateFlow(Pair(0f, 0f))
private val _sensorData = MutableStateFlow(Pair(0f, 0f))
private val sensor: Sensor? = sensorManager.getDefaultSensor(Sensor.TYPE_ROTATION_VECTOR)
private val rotationMatrix = FloatArray(9)
private val tempMatrix = FloatArray(9)
private val orientationValues = FloatArray(3)
@@ -45,11 +49,7 @@ class SensorsRepo(
private var smoothPitch = 0f
private var hasInitialReading = false
companion object {
private const val SMOOTHING_FACTOR = 0.15f
}
override val orientation: StateFlow<Pair<Float, Float>> = _orientation
override val sensorData: StateFlow<Pair<Float, Float>> = _sensorData
override fun getMagDeclination(geoPos: GeoPos, time: Long): Float {
return GeomagneticField(
@@ -62,7 +62,7 @@ class SensorsRepo(
override fun enableSensor() {
hasInitialReading = false
sensor?.let { sensorManager.registerListener(this, it, 8000) }
sensor?.let { sensorManager.registerListener(this, it, SENSOR_RATE_US) }
}
override fun disableSensor() = sensorManager.unregisterListener(this)
@@ -70,16 +70,11 @@ class SensorsRepo(
override fun onAccuracyChanged(sensor: Sensor, accuracy: Int) = Unit
override fun onSensorChanged(event: SensorEvent) {
if (event.sensor == sensor) updateOrientation(event.values)
if (event.sensor.type == Sensor.TYPE_ROTATION_VECTOR) handleSensorEvent(event)
}
private fun getDisplayRotation(): Int {
return try {
@Suppress("DEPRECATION")
windowManager.defaultDisplay.rotation
} catch (_: Exception) {
Surface.ROTATION_0
}
return displayManager?.getDisplay(Display.DEFAULT_DISPLAY)?.rotation ?: Surface.ROTATION_0
}
private fun remapForRotation(rotation: Int) {
@@ -101,30 +96,23 @@ class SensorsRepo(
if (remapped) System.arraycopy(tempMatrix, 0, rotationMatrix, 0, 9)
}
private fun updateOrientation(rotationVector: FloatArray) {
SensorManager.getRotationMatrixFromVector(rotationMatrix, rotationVector)
private fun handleSensorEvent(event: SensorEvent) {
SensorManager.getRotationMatrixFromVector(rotationMatrix, event.values)
remapForRotation(getDisplayRotation())
SensorManager.getOrientation(rotationMatrix, orientationValues)
val azimuth = (orientationValues[0] * RAD2DEG).toFloat()
val azimuth = normalizeAzimuth((orientationValues[0] * RAD2DEG).toFloat())
val pitch = (orientationValues[1] * RAD2DEG).toFloat()
val magneticAzimuth = (azimuth + 360f) % 360f
if (!hasInitialReading) {
smoothAzimuth = magneticAzimuth
smoothAzimuth = azimuth
smoothPitch = pitch
hasInitialReading = true
} else {
smoothAzimuth = lowPassAngle(smoothAzimuth, magneticAzimuth)
smoothAzimuth = lowPassAngle(smoothAzimuth, azimuth)
smoothPitch = lowPass(smoothPitch, pitch)
}
_orientation.value = Pair(
round(smoothAzimuth * 10) / 10,
round(smoothPitch * 10) / 10
)
_sensorData.value = Pair(round(smoothAzimuth * 10) / 10, round(smoothPitch * 10) / 10)
}
/** Standard exponential low-pass filter. */
private fun lowPass(previous: Float, current: Float): Float {
return previous + SMOOTHING_FACTOR * (current - previous)
}
@@ -135,9 +123,10 @@ class SensorsRepo(
*/
private fun lowPassAngle(previous: Float, current: Float): Float {
var delta = current - previous
// Normalise delta into the range (-180, 180]
while (delta > 180f) delta -= 360f
while (delta <= -180f) delta += 360f
return (previous + SMOOTHING_FACTOR * delta + 360f) % 360f
return normalizeAzimuth(previous + SMOOTHING_FACTOR * delta)
}
private fun normalizeAzimuth(value: Float): Float = (value + 360f) % 360f
}
@@ -113,8 +113,8 @@ class SettingsRepo(
}
private fun getSelectedTypes(): List<String> {
val typesString = preferences.getString(keySelectedTypes, null)
if (typesString.isNullOrEmpty()) return listOf("Amateur")
val typesString = preferences.getString(keySelectedTypes, "Amateur")
if (typesString.isNullOrEmpty()) return emptyList()
return typesString.split(separatorComma)
}
//endregion
@@ -74,7 +74,6 @@ class LocalSource(private val look4SatDao: Look4SatDao) : ILocalSource {
}
override suspend fun insertRadios(radios: List<SatRadio>) {
look4SatDao.deleteRadios()
look4SatDao.insertRadios(radios.toFrameworkRadios())
}
@@ -24,6 +24,7 @@ import kotlinx.coroutines.CoroutineDispatcher
import kotlinx.coroutines.withContext
import okhttp3.OkHttpClient
import okhttp3.Request
import java.io.ByteArrayInputStream
import java.io.InputStream
class RemoteSource(
@@ -45,7 +46,10 @@ class RemoteSource(
override suspend fun getNetworkStream(url: String): InputStream? = withContext(dispatcher) {
try {
val networkRequest = Request.Builder().url(url).build()
httpClient.newCall(networkRequest).execute().body.byteStream()
httpClient.newCall(networkRequest).execute().use { response ->
if (!response.isSuccessful) return@withContext null
ByteArrayInputStream(response.body.bytes())
}
} catch (exception: Exception) {
println("RemoteSource network stream exception: $exception")
null
@@ -21,7 +21,7 @@ import com.rtbishop.look4sat.core.domain.predict.GeoPos
import kotlinx.coroutines.flow.StateFlow
interface ISensorsRepo {
val orientation: StateFlow<Pair<Float, Float>>
val sensorData: StateFlow<Pair<Float, Float>>
fun getMagDeclination(geoPos: GeoPos, time: Long = System.currentTimeMillis()): Float
fun enableSensor()
fun disableSensor()
@@ -17,7 +17,9 @@
*/
package com.rtbishop.look4sat.core.domain.utility
import com.rtbishop.look4sat.core.domain.predict.GeoPos
import com.rtbishop.look4sat.core.domain.predict.DEG2RAD
import com.rtbishop.look4sat.core.domain.predict.OrbitalPos
import com.rtbishop.look4sat.core.domain.predict.RAD2DEG
import kotlin.math.acos
import kotlin.math.atan2
@@ -85,6 +87,13 @@ fun clipLon(longitude: Double): Double {
return clip(result, MIN_LONGITUDE, MAX_LONGITUDE)
}
fun OrbitalPos.toMapGeoPos(): GeoPos {
return GeoPos(
latitude = clipLat(latitude.toDegrees()),
longitude = clipLon(longitude.toDegrees())
)
}
private fun clip(currentValue: Double, minValue: Double, maxValue: Double): Double {
return min(max(currentValue, minValue), maxValue)
}
@@ -0,0 +1,424 @@
/*
* Look4Sat. Amateur radio satellite tracker and pass predictor.
* Copyright (C) 2019-2026 Arty Bishop and contributors.
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
package com.rtbishop.look4sat.core.presentation
import android.graphics.Paint
import android.graphics.LinearGradient
import android.graphics.RadialGradient
import android.graphics.Shader
import androidx.compose.foundation.Canvas
import androidx.compose.runtime.Composable
import androidx.compose.runtime.Immutable
import androidx.compose.runtime.LaunchedEffect
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableIntStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.setValue
import androidx.compose.runtime.withFrameNanos
import androidx.compose.ui.Modifier
import androidx.compose.ui.geometry.Size
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.graphics.drawscope.DrawScope
import androidx.compose.ui.graphics.nativeCanvas
import androidx.core.graphics.withRotation
import kotlinx.coroutines.isActive
import kotlin.math.atan2
import kotlin.math.cos
import kotlin.math.min
import kotlin.math.sin
import kotlin.math.sqrt
import kotlin.random.Random
@Immutable
data class BubblesStyle(
val bgColor: Color = Color.Black,
val bubbleCount: Int = 16,
val minBubbleCount: Int = 8,
val maxBubbleCount: Int = 16,
val adaptiveBubbleCount: Boolean = true,
val spawnIntervalMs: Long = 800L,
val bubbleRadiusFraction: Float = 0.24f,
val adaptiveSizing: Boolean = true,
val referenceMinSizePx: Float = 360f,
val referenceAreaPx: Float = 360f * 800f,
val minBubbleRadiusPx: Float = 16f,
val maxBubbleRadiusPx: Float = 256f,
val speedScale: Float = 0.99f,
val minVelocity: Float = 0.8f,
val maxVelocity: Float = 3.2f,
val hueRotationSpeedDps: Float = 60f, // degrees per second
)
@Composable
fun BubblesEffect(
modifier: Modifier = Modifier,
isRunning: Boolean = true,
style: BubblesStyle = BubblesStyle(),
) {
val renderer = remember { BubblesRenderer() }
var frameSignal by remember { mutableIntStateOf(0) }
// Animation loop
LaunchedEffect(isRunning, style) {
if (!isRunning) return@LaunchedEffect
var previousNanos = 0L
while (isActive) {
withFrameNanos { now ->
if (previousNanos == 0L) previousNanos = now
val deltaSec = ((now - previousNanos).coerceAtMost(MAX_STEP_NANOS)).toFloat() / NANOS_TO_SECONDS
previousNanos = now
renderer.update(deltaSec, style)
frameSignal++
}
}
}
Canvas(modifier = modifier) {
frameSignal
renderer.ensureLayout(size)
renderer.draw(this, style)
}
}
private const val MAX_STEP_NANOS = 16_666_667L // ~60 FPS
private const val NANOS_TO_SECONDS = 1_000_000_000f
private val SHELL_GRADIENT_STOPS = floatArrayOf(0f, 0.52f, 0.66f, 0.79f, 0.90f, 0.968f, 0.993f, 1f)
private val INNER_GRADIENT_STOPS = floatArrayOf(0f, 0.34f, 0.68f, 1f)
private data class Velocity(var x: Float, var y: Float)
private data class Bubble(
var x: Float,
var y: Float,
val radius: Float,
val velocity: Velocity,
val baseHue: Float, // 0-360, unique for each bubble
)
private class BubblesRenderer {
private var width = 0f
private var height = 0f
private val bubbles = mutableListOf<Bubble>()
private val random = Random(System.currentTimeMillis())
private var globalHueRotation = 0f // degrees, rotates all bubbles hues
private var spawnAccumulatorSec = 0f
private val paint = Paint(Paint.ANTI_ALIAS_FLAG)
private val shellColors = IntArray(8)
private val innerColors = IntArray(4)
fun ensureLayout(size: Size) {
val targetWidth = size.width
val targetHeight = size.height
if (targetWidth <= 0f || targetHeight <= 0f) return
val shouldRebuild = width != targetWidth || height != targetHeight
if (shouldRebuild) {
width = targetWidth
height = targetHeight
bubbles.clear()
spawnAccumulatorSec = 0f
}
}
fun spawnBubble(style: BubblesStyle): Boolean {
if (width <= 0f || height <= 0f) return false
val radius = resolveBubbleRadius(style)
val (velocityMin, velocityMax) = resolveVelocityRange(style)
val bubble = Bubble(
x = radius,
y = height - radius,
radius = radius,
velocity = Velocity(
x = randomInRange(velocityMin, velocityMax),
y = -randomInRange(velocityMin, velocityMax),
),
baseHue = random.nextFloat() * 360f, // Random starting hue for this bubble
)
bubbles.add(bubble)
return true
}
fun update(deltaSeconds: Float, style: BubblesStyle) {
if (width <= 0f || height <= 0f) return
spawnMissingBubbles(deltaSeconds, style)
// Rotate hue for all bubbles
globalHueRotation += style.hueRotationSpeedDps * deltaSeconds
if (globalHueRotation >= 360f) globalHueRotation -= 360f
val frameScale = deltaSeconds * 60f
for (i in bubbles.indices) {
val bubble = bubbles[i]
// Update position
bubble.x += bubble.velocity.x * frameScale
bubble.y += bubble.velocity.y * frameScale
// Bounce off walls
if (bubble.x > width - bubble.radius) {
bubble.x = width - bubble.radius
bubble.velocity.x *= -1
}
if (bubble.x < bubble.radius) {
bubble.x = bubble.radius
bubble.velocity.x *= -1
}
if (bubble.y > height - bubble.radius) {
bubble.y = height - bubble.radius
bubble.velocity.y *= -1
}
if (bubble.y < bubble.radius) {
bubble.y = bubble.radius
bubble.velocity.y *= -1
}
}
// Collision detection and resolution
for (i in bubbles.indices) {
for (j in (i + 1) until bubbles.size) {
val b1 = bubbles[i]
val b2 = bubbles[j]
if (isCollided(b1, b2)) resolveCollision(b1, b2)
}
}
}
private fun spawnMissingBubbles(deltaSeconds: Float, style: BubblesStyle) {
val targetCount = resolveTargetBubbleCount(style)
if (bubbles.size >= targetCount) return
val spawnIntervalSec = style.spawnIntervalMs.coerceAtLeast(1L) / 1_000f
spawnAccumulatorSec += deltaSeconds
while (bubbles.size < targetCount && spawnAccumulatorSec >= spawnIntervalSec) {
if (!spawnBubble(style)) break
spawnAccumulatorSec -= spawnIntervalSec
}
}
fun draw(scope: DrawScope, style: BubblesStyle) {
if (width <= 0f || height <= 0f) return
scope.drawRect(style.bgColor)
val canvas = scope.drawContext.canvas.nativeCanvas
for (i in bubbles.indices) {
drawBubbleWithGradient(canvas, bubbles[i])
}
}
private fun drawBubbleWithGradient(canvas: android.graphics.Canvas, bubble: Bubble) {
val hue = (bubble.baseHue + globalHueRotation) % 360f
val lit = 53.33f + maxOf(0f, (70f - kotlin.math.abs(244f - hue)) / 4f)
val rgb = hueToRgb(hue, lit)
val shellColor = mixWithWhite(rgb, 0.04f)
val innerColor = mixWithWhite(rgb, 0.10f)
val shimmerColor = mixWithWhite(rgb, 0.35f)
// Outer shell
val shellGradient = RadialGradient(
bubble.x, bubble.y, bubble.radius,
buildShellColors(shellColor),
SHELL_GRADIENT_STOPS,
Shader.TileMode.CLAMP
)
paint.style = Paint.Style.FILL
paint.shader = shellGradient
canvas.drawCircle(bubble.x, bubble.y, bubble.radius, paint)
// Subtle thin rim
paint.shader = null
paint.style = Paint.Style.STROKE
paint.strokeWidth = maxOf(1f, bubble.radius * 0.024f)
paint.color = colorWithAlpha(mixWithWhite(shellColor, 0.08f), 0.30f)
canvas.drawCircle(bubble.x, bubble.y, bubble.radius - paint.strokeWidth * 0.5f, paint)
// Top internal bubble
val innerTop = bubble.y - bubble.radius * 0.96f
val innerBottom = bubble.y + bubble.radius * 0.48f
val innerLeft = bubble.x - bubble.radius * 0.84f
val innerRight = bubble.x + bubble.radius * 0.84f
val innerGradient = LinearGradient(
bubble.x,
innerTop,
bubble.x,
innerBottom,
buildInnerColors(innerColor),
INNER_GRADIENT_STOPS,
Shader.TileMode.CLAMP
)
paint.style = Paint.Style.FILL
paint.shader = innerGradient
canvas.drawOval(
innerLeft,
innerTop,
innerRight,
innerBottom,
paint
)
// Top-left shimmer
paint.shader = null
paint.style = Paint.Style.FILL
paint.color = colorWithAlpha(shimmerColor, 0.95f)
val shimmerCx = bubble.x - bubble.radius * 0.40f
val shimmerCy = bubble.y - bubble.radius * 0.72f
val shimmerHalfWidth = bubble.radius * 0.06f
val shimmerHalfHeight = bubble.radius * 0.21f
canvas.withRotation(60f, shimmerCx, shimmerCy) {
drawOval(
shimmerCx - shimmerHalfWidth,
shimmerCy - shimmerHalfHeight,
shimmerCx + shimmerHalfWidth,
shimmerCy + shimmerHalfHeight,
paint
)
}
}
private fun isCollided(bubble1: Bubble, bubble2: Bubble): Boolean {
val dx = bubble1.x - bubble2.x
val dy = bubble1.y - bubble2.y
val radius = (bubble1.radius + bubble2.radius) * 0.9f
return dx * dx + dy * dy < radius * radius
}
private fun resolveCollision(particle: Bubble, otherParticle: Bubble) {
val xVelocityDiff = particle.velocity.x - otherParticle.velocity.x
val yVelocityDiff = particle.velocity.y - otherParticle.velocity.y
val xDist = otherParticle.x - particle.x
val yDist = otherParticle.y - particle.y
// Prevent accidental overlap
if (xVelocityDiff * xDist + yVelocityDiff * yDist >= 0) {
val angle = -atan2(otherParticle.y - particle.y, otherParticle.x - particle.x)
val m1 = 1f
val m2 = 1f
val u1 = rotate(particle.velocity, angle)
val u2 = rotate(otherParticle.velocity, angle)
val v1 = Velocity(
x = (u1.x * (m1 - m2)) / (m1 + m2) + (u2.x * 2 * m2) / (m1 + m2),
y = u1.y,
)
val v2 = Velocity(
x = (u2.x * (m1 - m2)) / (m1 + m2) + (u1.x * 2 * m2) / (m1 + m2),
y = u2.y,
)
val vFinal1 = rotate(v1, -angle)
val vFinal2 = rotate(v2, -angle)
particle.velocity.x = vFinal1.x
particle.velocity.y = vFinal1.y
otherParticle.velocity.x = vFinal2.x
otherParticle.velocity.y = vFinal2.y
}
}
private fun rotate(velocity: Velocity, angle: Float): Velocity {
return Velocity(
x = velocity.x * cos(angle) - velocity.y * sin(angle),
y = velocity.x * sin(angle) + velocity.y * cos(angle),
)
}
private fun buildShellColors(shellColor: Int): IntArray {
shellColors[0] = colorWithAlpha(shellColor, 0f)
shellColors[1] = colorWithAlpha(shellColor, 0f)
shellColors[2] = colorWithAlpha(shellColor, 0.04f)
shellColors[3] = colorWithAlpha(shellColor, 0.12f)
shellColors[4] = colorWithAlpha(shellColor, 0.28f)
shellColors[5] = colorWithAlpha(shellColor, 0.44f)
shellColors[6] = colorWithAlpha(shellColor, 0.58f)
shellColors[7] = colorWithAlpha(shellColor, 0.64f)
return shellColors
}
private fun buildInnerColors(innerColor: Int): IntArray {
innerColors[0] = colorWithAlpha(innerColor, 0.48f)
innerColors[1] = colorWithAlpha(innerColor, 0.36f)
innerColors[2] = colorWithAlpha(innerColor, 0.08f)
innerColors[3] = colorWithAlpha(innerColor, 0f)
return innerColors
}
private fun resolveBubbleRadius(style: BubblesStyle): Float {
val minDimension = min(width, height)
val baseRadius = minDimension * style.bubbleRadiusFraction
val minRadius = style.minBubbleRadiusPx.coerceAtLeast(1f)
val maxRadius = maxOf(minRadius, style.maxBubbleRadiusPx)
if (!style.adaptiveSizing || minDimension <= 0f) {
return baseRadius.coerceIn(minRadius, maxRadius)
}
val reference = style.referenceMinSizePx.coerceAtLeast(1f)
val dampening = sqrt((reference / minDimension).coerceAtMost(1f))
return (baseRadius * dampening).coerceIn(minRadius, maxRadius)
}
private fun resolveTargetBubbleCount(style: BubblesStyle): Int {
val baseCount = style.bubbleCount.coerceAtLeast(1)
if (!style.adaptiveBubbleCount) return baseCount
val area = width * height
val referenceArea = style.referenceAreaPx.coerceAtLeast(1f)
val areaScale = sqrt((area / referenceArea).coerceAtLeast(0.25f))
val scaledCount = (baseCount * areaScale).toInt()
val minCount = style.minBubbleCount.coerceAtLeast(1)
val maxCount = maxOf(minCount, style.maxBubbleCount.coerceAtLeast(1))
return scaledCount.coerceIn(minCount, maxCount)
}
private fun resolveVelocityRange(style: BubblesStyle): Pair<Float, Float> {
val referenceMaxVelocity = maxOf(height / 300f, 1f)
val velocityMin = (style.minVelocity * style.speedScale).coerceAtLeast(0.05f)
val velocityMax = maxOf(velocityMin, min(style.maxVelocity, referenceMaxVelocity) * style.speedScale)
return velocityMin to velocityMax
}
private fun randomInRange(min: Float, max: Float): Float {
return random.nextFloat() * (max - min) + min
}
}
private fun hueToRgb(h: Float, l: Float): Int {
val hNorm = h / 360f
val lNorm = l / 100f
val sNorm = 1f
val c = (1f - kotlin.math.abs(2f * lNorm - 1f)) * sNorm
val hp = hNorm * 6f
val x = c * (1f - kotlin.math.abs((hp % 2f) - 1f))
val m = lNorm - c / 2f
val (r, g, b) = when {
hp < 1f -> Triple(c, x, 0f)
hp < 2f -> Triple(x, c, 0f)
hp < 3f -> Triple(0f, c, x)
hp < 4f -> Triple(0f, x, c)
hp < 5f -> Triple(x, 0f, c)
else -> Triple(c, 0f, x)
}
val r8 = ((r + m) * 255).toInt().coerceIn(0, 255)
val g8 = ((g + m) * 255).toInt().coerceIn(0, 255)
val b8 = ((b + m) * 255).toInt().coerceIn(0, 255)
return (0xFF shl 24) or (r8 shl 16) or (g8 shl 8) or b8
}
private fun colorWithAlpha(color: Int, alpha: Float): Int {
val a = (alpha * 255).toInt().coerceIn(0, 255)
val r = (color shr 16) and 0xFF
val g = (color shr 8) and 0xFF
val b = color and 0xFF
return (a shl 24) or (r shl 16) or (g shl 8) or b
}
private fun mixWithWhite(color: Int, amount: Float): Int {
val t = amount.coerceIn(0f, 1f)
val r = (color shr 16) and 0xFF
val g = (color shr 8) and 0xFF
val b = color and 0xFF
val mixedR = (r + (255 - r) * t).toInt().coerceIn(0, 255)
val mixedG = (g + (255 - g) * t).toInt().coerceIn(0, 255)
val mixedB = (b + (255 - b) * t).toInt().coerceIn(0, 255)
return (0xFF shl 24) or (mixedR shl 16) or (mixedG shl 8) or mixedB
}
@@ -0,0 +1,260 @@
/*
* Look4Sat. Amateur radio satellite tracker and pass predictor.
* Copyright (C) 2019-2026 Arty Bishop and contributors.
*
* This program is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
package com.rtbishop.look4sat.core.presentation
import android.graphics.Paint
import android.graphics.Typeface
import androidx.compose.foundation.Canvas
import androidx.compose.runtime.Composable
import androidx.compose.runtime.Immutable
import androidx.compose.runtime.LaunchedEffect
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableIntStateOf
import androidx.compose.runtime.remember
import androidx.compose.runtime.setValue
import androidx.compose.runtime.withFrameNanos
import androidx.compose.ui.Modifier
import androidx.compose.ui.geometry.Size
import androidx.compose.ui.graphics.Color
import androidx.compose.ui.graphics.nativeCanvas
import androidx.compose.ui.platform.LocalDensity
import androidx.compose.ui.unit.TextUnit
import androidx.compose.ui.unit.sp
import kotlinx.coroutines.isActive
import kotlin.math.floor
import kotlin.math.max
import kotlin.math.min
import kotlin.random.Random
@Immutable
data class MatrixStyle(
val bgColor: Color = Color.Black,
val bodyColor: Color = Color(0xFF29C94A),
val headColor: Color = Color(0xFFC2FFC6),
val tailAlphaFloor: Float = 0.14f, // 0.14f - 0.18f,
val fontSize: TextUnit = 14.sp, // 11.sp - 14.sp
val minStreamLength: Int = 8, // 6 - 8
val maxStreamLength: Int = 28, // 20 - 28
val minSpeedRps: Float = 10f, // 10f - 15f
val maxSpeedRps: Float = 38f, // 38f - 45f
val resetPauseSec: ClosedFloatingPointRange<Float> = 0.1f..1.0f,
)
@Composable
fun MatrixEffect(
modifier: Modifier = Modifier,
isRunning: Boolean = true,
style: MatrixStyle = MatrixStyle(),
symbols: String = DEFAULT_SYMBOLS,
) {
val density = LocalDensity.current
val renderer = remember { MatrixRenderer() }
var frameSignal by remember { mutableIntStateOf(0) }
LaunchedEffect(isRunning, style, symbols) {
if (!isRunning) return@LaunchedEffect
var previousNanos = 0L
while (isActive) {
withFrameNanos { now ->
if (previousNanos == 0L) previousNanos = now
val deltaSec = ((now - previousNanos).coerceAtMost(MAX_STEP_NANOS)).toFloat() / NANOS_TO_SECONDS
previousNanos = now
renderer.update(deltaSec, style)
frameSignal++
}
}
}
Canvas(modifier = modifier) {
frameSignal
renderer.ensureLayout(size, density.density, style, symbols)
renderer.draw(this, style)
}
}
private const val MAX_STEP_NANOS = 33_333_333L
private const val NANOS_TO_SECONDS = 1_000_000_000f
private const val DEFAULT_SYMBOLS = "abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789<>=*+-~:;/[]{}()"
private fun Color.toArgb(): Int {
val a = (alpha.coerceIn(0f, 1f) * 255f + 0.5f).toInt()
val r = (red.coerceIn(0f, 1f) * 255f + 0.5f).toInt()
val g = (green.coerceIn(0f, 1f) * 255f + 0.5f).toInt()
val b = (blue.coerceIn(0f, 1f) * 255f + 0.5f).toInt()
return (a shl 24) or (r shl 16) or (g shl 8) or b
}
private class MatrixRenderer {
private var columns = 0
private var rows = 0
private var width = 0f
private var height = 0f
private var fontSizePx = 0f
private var charWidth = 0f
private var charHeight = 0f
private var baselineOffset = 0f
private var symbolSet = ""
private var symbols = charArrayOf()
private var glyphs = charArrayOf()
private var streams = emptyArray<StreamState>()
private val bodyPaint = Paint(Paint.ANTI_ALIAS_FLAG).apply { typeface = Typeface.MONOSPACE }
private val headPaint = Paint(Paint.ANTI_ALIAS_FLAG).apply { typeface = Typeface.MONOSPACE }
private val charBuffer = CharArray(1)
private val random = Random(System.currentTimeMillis())
fun ensureLayout(size: Size, density: Float, style: MatrixStyle, symbols: String) {
val targetFontPx = style.fontSize.value * density
val targetWidth = size.width
val targetHeight = size.height
val targetSymbols = symbols.ifBlank { DEFAULT_SYMBOLS }
if (targetWidth <= 0f || targetHeight <= 0f) return
val shouldRebuild = width != targetWidth ||
height != targetHeight ||
fontSizePx != targetFontPx ||
symbolSet != targetSymbols
if (!shouldRebuild) return
width = targetWidth
height = targetHeight
fontSizePx = targetFontPx
symbolSet = targetSymbols
this.symbols = targetSymbols.toCharArray()
bodyPaint.textSize = targetFontPx
headPaint.textSize = targetFontPx
charWidth = max(bodyPaint.measureText("W"), 1f)
val metrics = bodyPaint.fontMetrics
charHeight = max(metrics.descent - metrics.ascent, 1f)
baselineOffset = -metrics.ascent
columns = max((width / charWidth).toInt(), 1)
rows = max((height / charHeight).toInt() + 2, 1)
glyphs = CharArray(columns * rows) { randomGlyph() }
streams = Array(columns) { StreamState.random(rows, style, random) }
}
fun update(deltaSeconds: Float, style: MatrixStyle) {
if (columns == 0 || rows == 0 || deltaSeconds <= 0f) return
for (column in streams.indices) {
val stream = streams[column]
stream.pauseSec -= deltaSeconds
if (stream.pauseSec > 0f) continue
val previousHead = floor(stream.headRow).toInt()
stream.headRow += stream.speedRps * deltaSeconds
val newHead = floor(stream.headRow).toInt()
if (newHead > previousHead) {
for (row in (previousHead + 1)..newHead) {
if (row in 0 until rows) {
glyphs[row * columns + column] = randomGlyph()
}
}
}
if (newHead - stream.length > rows) {
stream.reset(rows, style, random)
}
}
}
fun draw(scope: androidx.compose.ui.graphics.drawscope.DrawScope, style: MatrixStyle) {
if (columns == 0 || rows == 0) return
scope.drawRect(style.bgColor)
bodyPaint.color = style.bodyColor.toArgb()
headPaint.color = style.headColor.toArgb()
val tailAlphaFloor = style.tailAlphaFloor.coerceIn(0f, 1f)
val canvas = scope.drawContext.canvas.nativeCanvas
for (column in streams.indices) {
val stream = streams[column]
if (stream.pauseSec > 0f) continue
val head = floor(stream.headRow).toInt()
val startRow = max(0, head - stream.length + 1)
val endRow = min(rows - 1, head)
if (startRow > endRow) continue
for (row in endRow downTo startRow) {
val tailIndex = head - row
val paint = if (tailIndex == 0) headPaint else bodyPaint
if (tailIndex != 0) {
val normalized = ((stream.length - tailIndex).toFloat() / stream.length).coerceIn(0f, 1f)
val alpha = tailAlphaFloor + (1f - tailAlphaFloor) * normalized
paint.alpha = (alpha * 255).toInt()
} else {
paint.alpha = 255
}
val glyph = glyphs[row * columns + column]
charBuffer[0] = glyph
val x = column * charWidth
val y = row * charHeight + baselineOffset
canvas.drawText(charBuffer, 0, 1, x, y, paint)
}
}
}
private fun randomGlyph(): Char = symbols[random.nextInt(symbols.size)]
}
private data class StreamState(
var headRow: Float,
var length: Int,
var speedRps: Float,
var pauseSec: Float,
) {
fun reset(rows: Int, style: MatrixStyle, random: Random) {
val randomOffset = random.nextFloat() * rows
headRow = -randomOffset
length = random.nextInt(
from = style.minStreamLength.coerceAtLeast(2),
until = (style.maxStreamLength.coerceAtLeast(style.minStreamLength + 1) + 1),
)
speedRps = random.nextFloat() * (style.maxSpeedRps - style.minSpeedRps) + style.minSpeedRps
pauseSec = random.nextFloat() * (style.resetPauseSec.endInclusive - style.resetPauseSec.start) +
style.resetPauseSec.start
}
companion object {
fun random(rows: Int, style: MatrixStyle, random: Random): StreamState {
val length = random.nextInt(
from = style.minStreamLength.coerceAtLeast(2),
until = (style.maxStreamLength.coerceAtLeast(style.minStreamLength + 1) + 1),
)
return StreamState(
headRow = -random.nextFloat() * rows,
length = length,
speedRps = random.nextFloat() * (style.maxSpeedRps - style.minSpeedRps) + style.minSpeedRps,
pauseSec = random.nextFloat() * (style.resetPauseSec.endInclusive - style.resetPauseSec.start) +
style.resetPauseSec.start,
)
}
}
}
@@ -132,6 +132,7 @@
<string name="prefs_bt_frequency_device_hint">Id dispositivo</string>
<string name="prefs_bt_frequency_output_hint">Formato de datos</string>
<string name="prefs_bt_perm_error">Revisa los permisos de Bluetooth</string>
<string name="prefs_net_perm_error">Revisa los permisos de red</string>
<string name="prefs_other_title">Otros ajustes</string>
<string name="prefs_other_switch_utc">Mostrar tiempos de pase en UTC</string>
@@ -131,6 +131,7 @@
<string name="prefs_bt_frequency_device_hint">Id устройства</string>
<string name="prefs_bt_frequency_output_hint">Формат</string>
<string name="prefs_bt_perm_error">Нет разрешения использовать bluetooth</string>
<string name="prefs_net_perm_error">Нет разрешения использовать сеть</string>
<string name="prefs_other_title">Другие настройки</string>
<string name="prefs_other_switch_utc">Показывать время по UTC</string>
@@ -132,6 +132,7 @@
<string name="prefs_bt_frequency_device_hint">උපාංග id</string>
<string name="prefs_bt_frequency_output_hint">දත්ත අකාරය</string>
<string name="prefs_bt_perm_error">Bluetooth අවසර පරික්‍ෂා ක°</string>
<string name="prefs_net_perm_error">Network අවසර පරික්‍ෂා කරන්න</string>
<string name="prefs_other_title">වෙනත් සැකසුම්</string>
<string name="prefs_other_switch_utc">පසුකර වේලාවන් UTC මගින්</string>
@@ -175,6 +175,7 @@
<string name="prefs_bt_frequency_device_hint">Cihaz kimliği</string>
<string name="prefs_bt_frequency_output_hint">Veri biçimi</string>
<string name="prefs_bt_perm_error">Bluetooth izninizi kontrol edin</string>
<string name="prefs_net_perm_error">Ağ izninizi kontrol edin</string>
<string name="prefs_other_title">Diğer ayarlar</string>
<string name="prefs_other_switch_utc">Geçiş saatini UTC olarak göster</string>
@@ -132,6 +132,7 @@
<string name="prefs_bt_frequency_device_hint">Id пристрою</string>
<string name="prefs_bt_frequency_output_hint">Формат даних</string>
<string name="prefs_bt_perm_error">Перевірте дозвіл Bluetooth</string>
<string name="prefs_net_perm_error">Перевірте дозвіл мережі</string>
<string name="prefs_other_title">Інші налаштування</string>
<string name="prefs_other_switch_utc">Показувати час в UTC</string>
@@ -124,6 +124,7 @@
<string name="prefs_bt_frequency_device_hint">蓝牙设备 ID</string>
<string name="prefs_bt_frequency_output_hint">数据格式</string>
<string name="prefs_bt_perm_error">请检查蓝牙权限</string>
<string name="prefs_net_perm_error">请检查网络权限</string>
<string name="prefs_other_title">其他设置</string>
<string name="prefs_other_switch_utc">以 UTC 时间显示</string>
@@ -49,9 +49,8 @@
\n\nPlease update the database at least weekly to get accurate predictions.</string>
<string name="pass_whatsnew_title" translatable="false">What\'s new in Look4Sat</string>
<string name="pass_whatsnew_message" translatable="false">
* Enabled continuous SSTV decoding for manually selected types (Play button enables/disables decoding)
\n\n* Added selected transceiver\'s frequency display to SSTV page
\n\n* Fixed Reset/Save/Play buttons behavior and states on SSTV page
* Added required tweaks to support Android 17 (API 37)
\n\n* Added ACCESS_LOCAL_NETWORK permission check to support network data output
</string>
<!-- Radar screen -->
@@ -174,6 +173,7 @@
<string name="prefs_bt_frequency_device_hint">Device id</string>
<string name="prefs_bt_frequency_output_hint">Data format</string>
<string name="prefs_bt_perm_error">Check your bluetooth permission</string>
<string name="prefs_net_perm_error">Check your network permission</string>
<string name="prefs_other_title">Other settings</string>
<string name="prefs_other_switch_utc">Show pass time in UTC</string>
@@ -1,3 +1,2 @@
* Enabled continuous SSTV decoding for manually selected types (Play button enables/disables decoding)
* Added selected transceiver\'s frequency display to SSTV page
* Fixed Reset/Save/Play buttons behavior and states on SSTV page
* Added required tweaks to support Android 17 (API 37)
* Added ACCESS_LOCAL_NETWORK permission check to support network data output
@@ -32,6 +32,7 @@ import com.rtbishop.look4sat.core.domain.repository.ISettingsRepo
import com.rtbishop.look4sat.core.domain.utility.clipLat
import com.rtbishop.look4sat.core.domain.utility.clipLon
import com.rtbishop.look4sat.core.domain.utility.positionToQth
import com.rtbishop.look4sat.core.domain.utility.toMapGeoPos
import com.rtbishop.look4sat.core.domain.utility.toDegrees
import com.rtbishop.look4sat.core.domain.utility.toTimerString
import com.rtbishop.look4sat.core.presentation.getDefaultPass
@@ -166,9 +167,7 @@ class MapViewModel(
var localSelectedPos: OrbitalPos? = null
for (satellite in chunk) {
val satPos = satelliteRepo.getPosition(satellite, pos, date.time)
val osmLat = clipLat(satPos.latitude.toDegrees())
val osmLon = clipLon(satPos.longitude.toDegrees())
localPositions.add(satellite to GeoPos(osmLat, osmLon))
localPositions.add(satellite to satPos.toMapGeoPos())
if (satellite === selected) {
localSelectedPos = satPos
}
@@ -242,9 +241,7 @@ class MapViewModel(
}
val azimuth = satPos.azimuth.toDegrees()
val elevation = satPos.elevation.toDegrees()
val osmLat = clipLat(satPos.latitude.toDegrees())
val osmLon = clipLon(satPos.longitude.toDegrees())
val osmPos = GeoPos(osmLat, osmLon)
val osmPos = satPos.toMapGeoPos()
val qthLoc = positionToQth(osmPos.latitude, osmPos.longitude) ?: "-- --"
val velocity = satPos.getOrbitalVelocity()
val phase = satPos.phase.toDegrees()
@@ -274,18 +271,16 @@ class MapViewModel(
val endDate = Date(date.time + (orbitalObject.data.orbitalPeriod * 2.4 * 60000L).toLong())
var oldLongitude = 0.0
satelliteRepo.getTrack(orbitalObject, pos, date.time, endDate.time).forEach { satPos ->
val osmLat = clipLat(satPos.latitude.toDegrees())
val osmLon = clipLon(satPos.longitude.toDegrees())
val currentPosition = GeoPos(osmLat, osmLon)
val currentPosition = satPos.toMapGeoPos()
if (oldLongitude < -170.0 && currentPosition.longitude > 170.0) {
// adding left terminal position
currentTrack.add(GeoPos(osmLat, -180.0))
currentTrack.add(GeoPos(currentPosition.latitude, -180.0))
val finishedTrack = mutableListOf<GeoPos>().apply { addAll(currentTrack) }
satTracks.add(finishedTrack)
currentTrack.clear()
} else if (oldLongitude > 170.0 && currentPosition.longitude < -170.0) {
// adding right terminal position
currentTrack.add(GeoPos(osmLat, 180.0))
currentTrack.add(GeoPos(currentPosition.latitude, 180.0))
val finishedTrack = mutableListOf<GeoPos>().apply { addAll(currentTrack) }
satTracks.add(finishedTrack)
currentTrack.clear()
@@ -78,7 +78,7 @@ class RadarViewModel(
private val _uiState = MutableStateFlow(
RadarState(
isUtc = settingsRepo.otherSettings.value.stateOfUtc,
orientationValues = sensorsRepo.orientation.value,
orientationValues = sensorsRepo.sensorData.value,
shouldShowSweep = settingsRepo.otherSettings.value.stateOfSweep,
shouldUseCompass = settingsRepo.otherSettings.value.stateOfSensors,
sstv = SstvSubState(selectedMode = settingsRepo.otherSettings.value.sstvMode)
@@ -97,7 +97,7 @@ class RadarViewModel(
if (!settingsRepo.otherSettings.value.stateOfSensors) return
viewModelScope.launch {
sensorsRepo.enableSensor()
sensorsRepo.orientation.collect { data ->
sensorsRepo.sensorData.collect { data ->
val orientationValues = (data.first + magDeclination) to data.second
_uiState.update { it.copy(orientationValues = orientationValues) }
}
@@ -320,10 +320,8 @@ class RadarViewModel(
private suspend fun processRadios(radios: List<SatRadio>, orbitalObject: OrbitalObject, time: Long) {
val transmitters = satelliteRepo.getRadios(orbitalObject, stationPos, radios, time)
val isFreqEnabled =
settingsRepo.rcSettings.value.frequencyState || settingsRepo.rcSettings.value.bluetoothFrequencyState
_uiState.update { state ->
val freq = if (isFreqEnabled && state.transceivers.selectedUuid != null) {
val freq = if (state.transceivers.selectedUuid != null) {
val selectedRadio = transmitters.firstOrNull { it.uuid == state.transceivers.selectedUuid }
selectedRadio?.let { radio ->
val low = radio.downlinkLow
@@ -190,16 +190,14 @@ internal fun SstvPage(
verticalArrangement = Arrangement.spacedBy(2.dp)
) {
// Doppler-corrected downlink frequency hint
if (dopplerFrequency != null) {
OutlinedText(
text = "RX: $dopplerFrequency Hz",
fontSize = 18.sp,
fontWeight = FontWeight.Bold,
fillColor = MaterialTheme.colorScheme.primary,
outlineColor = MaterialTheme.colorScheme.background,
modifier = Modifier.align(Alignment.CenterHorizontally)
)
}
OutlinedText(
text = dopplerFrequency?.let { "RX: $it Hz" } ?: "No transceiver selected",
fontSize = 18.sp,
fontWeight = FontWeight.Bold,
fillColor = MaterialTheme.colorScheme.primary,
outlineColor = MaterialTheme.colorScheme.background,
modifier = Modifier.align(Alignment.CenterHorizontally)
)
Row(
verticalAlignment = Alignment.CenterVertically,
horizontalArrangement = Arrangement.spacedBy(8.dp),
@@ -91,7 +91,8 @@ private fun SettingsScreen(uiState: SettingsState, onAction: (SettingsAction) ->
val dialogs = rememberDialogVisibility()
val permissions = rememberSettingsPermissions(
sendAction = onAction,
onBluetoothGranted = { dialogs.bluetooth = true }
onBluetoothGranted = { dialogs.bluetooth = true },
onNetworkGranted = { dialogs.network = true }
)
// Dialogs
@@ -273,7 +274,7 @@ private fun SettingsScreen(uiState: SettingsState, onAction: (SettingsAction) ->
}
item(span = { GridItemSpan(maxLineSpan) }) {
OutputCard(
onNetworkClick = { dialogs.network = true },
onNetworkClick = permissions.launchNetwork,
onBluetoothClick = permissions.launchBluetooth,
onRadioControlClick = { dialogs.radioControl = true }
)
@@ -651,13 +652,15 @@ private class SettingsPermissions(
val launchLocation: () -> Unit,
val launchTleImport: () -> Unit,
val launchTransceiverImport: () -> Unit,
val launchBluetooth: () -> Unit
val launchBluetooth: () -> Unit,
val launchNetwork: () -> Unit
)
@Composable
private fun rememberSettingsPermissions(
sendAction: (SettingsAction) -> Unit,
onBluetoothGranted: () -> Unit
onBluetoothGranted: () -> Unit,
onNetworkGranted: () -> Unit
): SettingsPermissions {
val locationError = stringResource(R.string.prefs_loc_gps_error)
val locationRequest = rememberLauncherForActivityResult(
@@ -685,6 +688,12 @@ private fun rememberSettingsPermissions(
else sendAction(SettingsAction.ShowToast(bluetoothError))
}
val networkError = stringResource(R.string.prefs_net_perm_error)
val networkRequest = rememberLauncherForActivityResult(ActivityResultContracts.RequestPermission()) { granted ->
if (granted) onNetworkGranted()
else sendAction(SettingsAction.ShowToast(networkError))
}
return remember {
SettingsPermissions(
launchLocation = {
@@ -694,7 +703,14 @@ private fun rememberSettingsPermissions(
},
launchTleImport = { tleRequest.launch("*/*") },
launchTransceiverImport = { transceiversRequest.launch("*/*") },
launchBluetooth = { bluetoothRequest.launch(bluetoothPerm) }
launchBluetooth = { bluetoothRequest.launch(bluetoothPerm) },
launchNetwork = {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.CINNAMON_BUN) {
networkRequest.launch(Manifest.permission.ACCESS_LOCAL_NETWORK)
} else {
onNetworkGranted()
}
}
)
}
}
+11 -11
View File
@@ -1,35 +1,35 @@
[versions]
#noinspection UnusedVersionCatalogEntry
appVersionCode = "441"
appVersionCode = "443"
#noinspection UnusedVersionCatalogEntry
appVersionName = "4.4.1"
#noinspection GradleDependency,UnusedVersionCatalogEntry
compileSdk = "36"
appVersionName = "4.4.3"
#noinspection UnusedVersionCatalogEntry
compileSdk = "37"
#noinspection UnusedVersionCatalogEntry
minSdk = "24"
#noinspection UnusedVersionCatalogEntry
jdkVersion = "17"
jdkVersion = "21"
#noinspection UnusedVersionCatalogEntry
packageName = "com.rtbishop.look4sat"
android-gradle-plugin = "9.2.1"
androidx-core-ktx = "1.18.0"
androidx-core-ktx = "1.19.0"
androidx-core-splashscreen = "1.2.0"
androidx-room = "2.8.4"
compose-bom = "2026.05.01"
compose-bom = "2026.06.00"
compose-activity = "1.13.0"
compose-lifecycle = "2.10.0"
compose-navigation3 = "1.1.2"
compose-lifecycle = "2.11.0"
compose-navigation3 = "1.1.3"
google-ksp = "2.3.7"
google-ksp = "2.3.8"
kotlin = "2.4.0"
kotlin-coroutines = "1.11.0"
kotlin-serialization = "1.11.0"
other-okhttp = "5.3.2"
other-okhttp = "5.4.0"
other-osmdroid = "6.1.20"
test-junit4 = "4.13.2"
+2 -2
View File
@@ -1,7 +1,7 @@
#Mon May 25 11:20:48 BST 2026
#Sat Jun 27 12:51:12 BST 2026
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-9.5.1-bin.zip
distributionUrl=https\://services.gradle.org/distributions/gradle-9.6.1-bin.zip
networkTimeout=10000
validateDistributionUrl=true
zipStoreBase=GRADLE_USER_HOME