Claude
4e020aaa10
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_015g6ECVSKcBG8CJPrqC3G5o
74 lines
2.9 KiB
Markdown
74 lines
2.9 KiB
Markdown
<p align="center">
|
|
<img src="assets/icon-rounded.png" width="128" alt="Sparkledns icon">
|
|
</p>
|
|
|
|
<h1 align="center">SparkleDns</h1>
|
|
|
|
<p align="center">
|
|
<a href="https://github.com/kalarina-bit/Sparkledns/releases"><img src="assets/get-it-on-gitea.png" height="60" alt="Get it on Gitea"></a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<img src="https://img.shields.io/github/downloads/kalarina-bit/Sparkledns/total?label=downloads&color=2e7d32&labelColor=1b1b1b" alt="downloads counter">
|
|
</p>
|
|
|
|
**Lightweight DNS-over-HTTPS client for Android** (Kotlin, Jetpack Compose).
|
|
|
|
The app starts a local VPN that captures only DNS traffic and forwards every query to the selected DoH server (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
|
|
|
|
<p align="center">
|
|
<img src="assets/screenshots/1-your-dns-your-choice.png" width="180" alt="Your DNS, your choice">
|
|
<img src="assets/screenshots/2-protected.png" width="180" alt="Protected via SkySparkle">
|
|
<img src="assets/screenshots/3-stay-informed.png" width="180" alt="Stay informed">
|
|
<img src="assets/screenshots/4-block-your-way.png" width="180" alt="Block your way">
|
|
<img src="assets/screenshots/5-choose-your-own-route.png" width="180" alt="Choose your own route">
|
|
</p>
|
|
|
|
## Installation
|
|
|
|
<img src="assets/icon-install.png" width="36" align="left">
|
|
|
|
1. Download the APK for the version you want from the [Releases page](https://github.com/kalarina-bit/Sparkledns/releases).
|
|
2. On your Android device, allow installs from unknown sources for the app you use to open the file (Settings → Apps → Special access → Install unknown apps).
|
|
3. Open the downloaded `.apk` file and confirm the install.
|
|
|
|
## Verifying a download
|
|
|
|
<img src="assets/icon-verify.png" width="36" align="left">
|
|
|
|
Compare the SHA-256 checksum of the downloaded APK against the value shown for that version on the [Releases page](https://github.com/kalarina-bit/Sparkledns/releases):
|
|
|
|
```sh
|
|
sha256sum Sparkledns-vX.X.X.apk
|
|
```
|
|
|
|
## Repository structure
|
|
|
|
<img src="assets/icon-structure.png" width="36" align="left">
|
|
|
|
```
|
|
.
|
|
├── assets/ # Icon images
|
|
│ └── screenshots/ # App screenshots
|
|
├── LICENSE # GNU GPLv3
|
|
└── README.md
|
|
```
|
|
|
|
APK builds are published as assets on the [Releases page](https://github.com/kalarina-bit/Sparkledns/releases), not stored in this repository.
|
|
|
|
## License
|
|
|
|
This project is licensed under the **GNU General Public License v3.0** — see the [LICENSE](LICENSE) file for details.
|