Files
Sparkledns/README.md
T

3.6 KiB

SparkleDNS icon

SparkleDNS

A lightweight DNS-over-HTTPS client for Android.

Get it on Gitea

Android 8.0+ GPL-3.0-or-later

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

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
  • 📊 Live query monitor with stats, filters and one-tap blocking
  • 📱 Per-app DNS — chosen apps bypass the tunnel
  • 🚫 Custom blocklists — your own domains plus hosts/domain/AdBlock lists by URL (HaGeZi Pro++ and TIF presets)
  • 🔓 No analytics, no Google Play Services

Screenshots

Your DNS, your choice Protected via SkySparkle Stay informed Block your way Choose your own route

Installation

Requires Android 8.0 (API 26) or newer; HTTP/3 needs Android 14.

  1. Download the latest APK from the Releases page.
  2. Allow installs from unknown sources for the app you open it with (Settings → Apps → Special access → Install unknown apps).
  3. Open the .apk file and confirm the install.

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.6) — F-Droid detects new releases from these tags.

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.

License

GNU General Public License v3.0 or later (GPL-3.0-or-later).