Files
Fogwave/README.md
T

5.5 KiB

Fogwave icon

Fogwave

A calm, open-source internet radio app for Android.
Listen to Lithuania's favorite stations in one tap.

Support me on Ko-fi

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 GitHub, or an email to cuken107@proton.me.

Note

Looking for designers! Fogwave is looking for volunteer designers to help with icons, logos, animations, cover art (store graphics) and UI design. This is unpaid help for an open-source project. If you're interested, write to cuken107@proton.me.

Latest release

Get it on F-Droid Get it on Obtainium Get it on GitHub

Lithuanian radio, liveStation list Save your favorites Listen live

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
  • 🔍 Search to find a station in a tap
  • 🌙 Dark theme
  • 🌍 Six languages — English, Russian, German, Japanese, Lithuanian and Chinese
  • 🔓 No ads, no tracking, no accounts

Installation

  • F-Droid — install and update through the F-Droid client.
  • Obtainium — installs the APK straight from GitHub releases and keeps it up to date.
  • Manually — download the latest APK from GitHub 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.

Verifying a download

Every official APK is signed with the same key. Check it before installing:

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 (app ID cc.skysparkle.fogwave).

Building from source

Requires JDK 17+ and Android SDK 37.

./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. Please read CONTRIBUTING.md first — it explains what fits the project and how to send changes.

☕ Support

Fogwave is free, open source and has no ads. If it is useful to you, you can support the project on Ko-fi — donations pay for the Skysparkle server and the time spent on the apps.

Support me on Ko-fi

📄 License

GNU General Public License v3.0 only.