mckero
a654735337
Merges rt-bishop/Look4Sat main (a42a5f1f, 18 commits: AMSAT status page,
customizable data sources, Doppler calculator, radar compass offset, per-sat
offset memory, localized date formats) into the fork's 30-commit audit
baseline.
Conflict resolution policy (user-directed):
- AMSAT feature (AmSatRepository, SatStatusScreen/ViewModel, SatStatus model):
upstream version, which the user judged better built. MainScreen routes
Screen.AmSat through SatStatusDestination().
- Localization: our values-zh/values-tr restored (upstream's merge dropped the
fork-only strings); new upstream strings (sat_group counts, compass offset,
frequency offset help) added in EN + ZH.
- fork-only features kept (CW decoder, Mutual/Roaming, WaveLog, APRS, Log tab,
custom TLE/transceiver source switches): ours.
- Both sides' additions merged where independent: radar compass offset fields
(Settings/SettingsRepo/RadarState), calculatorOffsetKHz action, wider linear
transponder detection, deduplicateTransponders + its tests, sunrise/sunset
tests merged with the moon hour-angle test.
- Sources kept as the fork's map structure (DatabaseRepo depends on it);
satelliteModes list re-added for SelectionRepo. getSatelliteTypesIds /
setSatelliteTypeIds re-added to ISettingsRepo+SettingsRepo; SharedDialog
re-added to Components; providePairedBluetoothDevices added to
IMainContainer/MainContainer.
- Icons renamed upstream (ic_satellites->ic_sputnik, ic_radar->ic_satellite)
applied to Navigation/MutualScreen.
Build verified: all modules compileReleaseKotlin + unit tests
(core:domain, core:data, feature:map, feature:roaming) green.
61 lines
3.4 KiB
Markdown
61 lines
3.4 KiB
Markdown
# Look4Sat: Satellite tracker
|
|
|
|
[](https://github.com/rt-bishop/Look4Sat/actions/workflows/release.yml)
|
|
|
|
[<img src="https://play.google.com/intl/en_gb/badges/static/images/badges/en_badge_web_generic.png" alt="Get it on Google Play" height="80">](https://play.google.com/store/apps/details?id=com.rtbishop.look4sat)
|
|
[<img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png" alt="Get it on F-Droid" height="80">](https://f-droid.org/packages/com.rtbishop.look4sat/)
|
|
|
|
### Radio satellite tracker and pass predictor for Android, inspired by Gpredict
|
|
|
|
<p float="left">
|
|
<img src="fastlane/metadata/android/en-US/images/phoneScreenshots/1.png" width="192"/>
|
|
<img src="fastlane/metadata/android/en-US/images/phoneScreenshots/2.png" width="192"/>
|
|
<img src="fastlane/metadata/android/en-US/images/phoneScreenshots/3.png" width="192"/>
|
|
<img src="fastlane/metadata/android/en-US/images/phoneScreenshots/4.png" width="192">
|
|
</p>
|
|
|
|
### Track satellite passes with ease!
|
|
|
|
Thanks to [Celestrak](https://celestrak.com/) and [SatNOGS](https://satnogs.org/) you have access to over 9000 active satellites.\
|
|
You can search the entire database by NORAD Catalog Number or the satellite's name.
|
|
|
|
Orbital positions and passes are calculated relative to your location.\
|
|
To get reliable data make sure to set the station position via the app Settings.
|
|
|
|
The application is built using Kotlin, Coroutines, Jetpack Compose and Navigation.\
|
|
It is now and always will be completely ad-free and open-source.
|
|
|
|
## Main features:
|
|
|
|
* Predicting satellite positions and passes for up to 10 days
|
|
* Showing the list of currently active and upcoming satellite passes
|
|
* Showing the active pass progress, polar trajectory and transceivers info
|
|
* 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.
|
|
|
|
## License
|
|
|
|
The Look4Sat application code is licensed under the GNU General Public License v3.0.
|
|
|
|
The CW decoder in `feature/cw` bundles the [DeepCW](https://github.com/e04/deepcw-engine)
|
|
neural decoding model, licensed under the GNU Affero General Public License v3.0 only
|
|
(AGPL-3.0-only). Because the combined work incorporates an AGPL-3.0 component, the
|
|
combined work is distributed under the
|
|
[GNU Affero General Public License v3.0](LICENSE) — GPL-3.0 Section 13 permits the
|
|
combination, and AGPL-3.0 Section 13 applies to the combined work as a whole.
|
|
Model provenance and attribution are documented in
|
|
[`feature/cw/licenses/NOTICE.md`](feature/cw/licenses/NOTICE.md); the original GPL-3.0
|
|
text is preserved at `feature/cw/licenses/Look4Sat-GPL-3.0.txt`. The CW model runs
|
|
locally on-device and does not provide services over a network.
|
|
|
|
## Star History
|
|
|
|
<a href="https://star-history.dera.page/#rt-bishop/Look4Sat&type=timeline&legend=top-left">
|
|
<picture>
|
|
<source media="(prefers-color-scheme: dark)" srcset="https://star-history.dera.page/svg?repos=rt-bishop/Look4Sat&type=timeline&theme=dark&legend=top-left" />
|
|
<source media="(prefers-color-scheme: light)" srcset="https://star-history.dera.page/svg?repos=rt-bishop/Look4Sat&type=timeline&legend=top-left" />
|
|
<img alt="Star History Chart" src="https://star-history.dera.page/svg?repos=rt-bishop/Look4Sat&type=timeline&legend=top-left" />
|
|
</picture>
|
|
</a>
|