mirror of
https://github.com/kalarina-bit/Fogwave.git
synced 2026-11-22 08:06:09 +00:00
93 lines
5.1 KiB
Markdown
93 lines
5.1 KiB
Markdown
<p align="center">
|
|
<img src="assets/icon-rounded.png" width="112" alt="Fogwave icon">
|
|
</p>
|
|
|
|
<h1 align="center">Fogwave</h1>
|
|
|
|
<p align="center">
|
|
<b>A calm, open-source internet radio app for Android.</b><br>
|
|
Listen to Lithuania's favorite stations in one tap.
|
|
</p>
|
|
|
|
> [!IMPORTANT]
|
|
> **Fogwave is coming to Google Play!** The app is now in closed testing there ahead of the public release. Ideas, wishes and suggestions for improvement are very welcome — send them wherever is easiest for you: an issue on [Gitea](https://git.skysparkle.cc/kalarina/Fogwave/issues) or [GitHub](https://github.com/kalarina-bit/Fogwave/issues), or an email to [cuken107@proton.me](mailto:cuken107@proton.me).
|
|
|
|
<p align="center">
|
|
<a href="https://github.com/kalarina-bit/Fogwave/releases/latest"><img src="https://img.shields.io/github/v/release/kalarina-bit/Fogwave?style=for-the-badge&label=release&labelColor=1b1b1b&color=2e7d32" alt="Latest release"></a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="https://f-droid.org/packages/cc.skysparkle.fogwave/"><img src="assets/get-it-on%20(1).png" height="56" alt="Get it on F-Droid"></a>
|
|
<a href="https://apps.obtainium.imranr.dev/redirect?r=obtainium://add/https://git.skysparkle.cc/kalarina/Fogwave"><img src="assets/badge_obtainium.png" height="56" alt="Get it on Obtainium"></a>
|
|
<a href="https://github.com/kalarina-bit/Fogwave/releases/latest"><img src="assets/get-it-on-github.png" height="56" alt="Get it on GitHub"></a>
|
|
<a href="https://git.skysparkle.cc/kalarina/Fogwave/releases"><img src="assets/get-it-on-gitea.png" height="56" alt="Get it on Gitea"></a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<img src="assets/screenshots/1-lithuanian-radio-left.png" width="160" alt="Lithuanian radio, live"><img src="assets/screenshots/2-lithuanian-radio-right.png" width="160" alt="Station list">
|
|
<img src="assets/screenshots/3-favorites.png" width="160" alt="Save your favorites">
|
|
<img src="assets/screenshots/4-listen-live.png" width="160" alt="Listen live">
|
|
</p>
|
|
|
|
> [!TIP]
|
|
> If you find Fogwave useful, please consider giving it a ⭐ — it helps others discover the project.
|
|
|
|
## ✨ Features
|
|
|
|
- 📻 **14 stations from Lithuania and Latvia** — ZIP FM, Power Hit Radio, Rock FM, LRT Radijas, Žinių radijas, Latvijas Radio 1 & 2 and more
|
|
- 🎧 **Background playback** with lock-screen, notification, headphone and Bluetooth controls
|
|
- 🚗 **Android Auto** support
|
|
- 🔄 **Auto-reconnect** when the stream drops or the network comes back
|
|
- 🎚️ **Equalizer** with presets, loudness boost and dynamics processing
|
|
- ❤️ **Favorites, recently played and similar stations** matched by genre
|
|
- 🗂️ **Four layouts** — list, table, tiles or icons, with adjustable size
|
|
- 🌙 **Dark theme**
|
|
- 🌍 **Six languages** — English, Russian, German, Japanese, Lithuanian and Chinese
|
|
- 🔓 **No ads, no tracking, no accounts**
|
|
|
|
## <img src="assets/icon-install.png" width="32" alt=""> Installation
|
|
|
|
- **[F-Droid](https://f-droid.org/packages/cc.skysparkle.fogwave/)** — install and update through the F-Droid client.
|
|
- **[Obtainium](https://apps.obtainium.imranr.dev/redirect?r=obtainium://add/https://git.skysparkle.cc/kalarina/Fogwave)** — installs the APK straight from Gitea releases and keeps it up to date.
|
|
- **Manually** — download the latest APK from [GitHub](https://github.com/kalarina-bit/Fogwave/releases/latest) or [Gitea](https://git.skysparkle.cc/kalarina/Fogwave/releases), allow installs from unknown sources for the app you open it with (Settings → Apps → Special access → Install unknown apps), then open the `.apk` and confirm.
|
|
|
|
## <img src="assets/icon-verify.png" width="32" alt=""> Verifying a download
|
|
|
|
Every official APK is signed with the same key. Check it before installing:
|
|
|
|
```sh
|
|
apksigner verify --print-certs Fogwave-v<version>.apk
|
|
```
|
|
|
|
The SHA-256 fingerprint of the signing certificate must be:
|
|
|
|
```
|
|
1A:85:AF:5A:08:23:DE:D1:76:7C:07:55:41:FA:15:87:7F:6E:3B:99:9E:5E:52:CF:2B:C8:03:55:F6:63:12:7F
|
|
```
|
|
|
|
`apksigner` prints the same value in lowercase without colons. On Android you can check it with [AppVerifier](https://github.com/soupslurpr/AppVerifier) (app ID `cc.skysparkle.fogwave`).
|
|
|
|
## <img src="assets/icon-structure.png" width="32" alt=""> Building from source
|
|
|
|
Requires JDK 17+ and Android SDK 37.
|
|
|
|
```sh
|
|
./gradlew assembleDebug
|
|
```
|
|
|
|
Release builds are signed only when a keystore is supplied through the `KEYSTORE_PATH`, `STORE_PASSWORD`, `KEY_ALIAS` and `KEY_PASSWORD` environment variables; otherwise the release build is unsigned, as F-Droid expects. Never commit keystores.
|
|
|
|
### Releasing
|
|
|
|
1. Bump `versionCode` and `versionName` in `app/build.gradle.kts`.
|
|
2. Add `fastlane/metadata/android/<locale>/changelogs/<versionCode>.txt`.
|
|
3. Tag the commit as `v<versionName>` (for example `v1.0.11`).
|
|
|
|
## 🤝 Contributing
|
|
|
|
Bug reports, station suggestions, translation fixes and pull requests are welcome in the [issue tracker](https://git.skysparkle.cc/kalarina/Fogwave/issues). Please read [CONTRIBUTING.md](CONTRIBUTING.md) first — it explains what fits the project and how to send changes. To open an issue or a pull request, [create an account](https://git.skysparkle.cc/user/sign_up) on this Gitea.
|
|
|
|
## 📄 License
|
|
|
|
[GNU General Public License v3.0 only](LICENSE).
|