Files
Sparkledns/README.md
T

5.9 KiB
Raw Permalink Blame History

SparkleDNS icon

SparkleDNS

A lightweight DNS-over-HTTPS client for Android.
A local VPN that captures only DNS traffic and sends every query to the DoH server you choose (RFC 8484). Everything else goes through your normal connection.

Support me on Ko-fi

Important

SparkleDNS 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! SparkleDNS 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

Private DNS in one tapYou're protected See every request Block trackers and malware

Tip

If you find SparkleDNS useful, please consider giving it a ⭐ — it helps others discover the project.

✨ Features

  • 🔌 One-tap connect/disconnect, with a Quick Settings tile
  • 🔄 Switch servers on the fly — the tunnel restarts automatically
  • 🚀 Built-in server test showing protocol and latency
  • 📊 Activity — 24-hour and 7-day charts, share of the biggest companies, and a live log with filters and one-tap blocking. Numbers stay on the device
  • 📱 Per-app DNS — chosen apps bypass the tunnel
  • 🚫 Custom blocklists — your own domains plus hosts/domain/AdBlock lists by URL (HaGeZi Pro, Pro++ and TIF presets), updated automatically every day or week, on Wi-Fi only if you like
  • 🔓 No analytics, no Google Play Services

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 SparkleDNS-v<version>.apk

The SHA-256 fingerprint of the signing certificate must be:

42:F6:30:63:4B:D0:F8:7F:49:17:85:A8:84:87:70:E4:45:96:7B:36:F1:02:8E:FD:16:F8:F9:52:01:27:3A:29

apksigner prints the same value in lowercase without colons. On Android you can check it with AppVerifier (app ID cc.skysparkle.sparkledns).

Building from source

Requires JDK 17+ and Android SDK 36.

./gradlew assembleRelease

Releasing

  1. Bump versionName and versionCode in app/build.gradle.kts (versionCode = major * 10000 + minor * 100 + patch).
  2. Add fastlane/metadata/android/<locale>/changelogs/<versionCode>.txt.
  3. Tag the commit as v<versionName> (for example v1.0.9) — F-Droid detects new releases from these tags, so upload the signed APK to the release right away.

🤝 Contributing

Bug reports, DoH server and blocklist 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.

💙 Sponsor

Skysparkle

SparkleDNS is sponsored and supported by Skysparkle — independent encrypted DNS from Lithuania and the app’s default DoH server.

☕ Support

SparkleDNS 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.