mirror of
https://github.com/kalarina-bit/Sparkledns.git
synced 2026-11-22 07:36:09 +00:00
Redesign the app
New look based on the SparkleDNS concept: a dark theme, a floating bottom panel with Home, Activity and Settings, and pages for the blocklists, apps and About. - Home: big ON/OFF switch, the current server, 24-hour stats and chart - Activity: requests, blocked, average time and cache share for 24 hours or 7 days, company dominance, and the live log with search and filter - Blocklists: HaGeZi Pro preset next to Pro++ and TIF, lists can be switched off without deleting them, automatic updates (daily or weekly, optionally Wi-Fi only) through JobScheduler - Settings: server list, custom server, server test and per-app DNS - Hourly numbers for the charts are kept on the device, without domains The server list now ships with the app; it is no longer downloaded from the repository.
This commit is contained in:
+4
-22
@@ -9,7 +9,7 @@ Issues and pull requests go to the repository on [Gitea](https://git.skysparkle.
|
||||
## Ways to help
|
||||
|
||||
- **Report a bug** — use the *Bug report* template.
|
||||
- **Add a DoH server** — add one line to [`servers/servers.txt`](servers/servers.txt), see [Adding a DoH server](#adding-a-doh-server).
|
||||
- **Add a DoH server** — open an issue with the *DoH server or blocklist* template, see [Adding a DoH server](#adding-a-doh-server).
|
||||
- **Suggest a blocklist** — use the *DoH server or blocklist* template.
|
||||
- **Suggest a feature** — use the *Feature request* template; check [Out of scope](#out-of-scope) first.
|
||||
- **Fix a translation** — use the *Translation fix* template or send a pull request.
|
||||
@@ -38,27 +38,9 @@ These will not be accepted:
|
||||
|
||||
## Adding a DoH server
|
||||
|
||||
The server list lives in [`servers/servers.txt`](servers/servers.txt). The app downloads it when the user taps **Update server list**, so a new server reaches users without a new release.
|
||||
Servers ship with the app in [`Providers.kt`](app/src/main/java/cc/skysparkle/sparkledns/Providers.kt), so a new server reaches users with the next release. The app never downloads a server list.
|
||||
|
||||
To add a server, open the file on Gitea, click **Edit**, add one line at the end and send it as a pull request:
|
||||
|
||||
```
|
||||
Name | DoH URL | Privacy policy | h3 | Donation page
|
||||
```
|
||||
|
||||
- **Name** — how the server appears in the app, up to 40 characters.
|
||||
- **DoH URL** — the full `https://` address of the DoH endpoint.
|
||||
- **Privacy policy** — an `https://` link to the operator's privacy policy. Lines without one are ignored.
|
||||
- **h3** — optional. Add it only if the server supports HTTP/3.
|
||||
- **Donation page** — optional. An `https://` link to the operator's own page for donations or support. The app shows it as a coin button next to the privacy policy. Only link to a page the operator runs or names on its website — no affiliate or third-party fundraising links.
|
||||
|
||||
Leave out any optional column you don't need; the app recognises them by their content. Examples:
|
||||
|
||||
```
|
||||
Example DNS | https://dns.example.org/dns-query | https://example.org/privacy | h3 | https://example.org/donate
|
||||
Example DNS | https://dns.example.org/dns-query | https://example.org/privacy | https://example.org/donate
|
||||
Example DNS | https://dns.example.org/dns-query | https://example.org/privacy
|
||||
```
|
||||
To suggest a server, open an issue with the *DoH server or blocklist* template, or send a pull request that adds one entry to `Providers.builtIn` with the server's name, DoH URL, privacy policy link, bootstrap IPs, whether it supports HTTP/3 and, optionally, the operator's own donation page.
|
||||
|
||||
The server must:
|
||||
|
||||
@@ -69,7 +51,7 @@ The server must:
|
||||
|
||||
Before sending, check that it works: in the app choose **Custom server**, enter the URL and tap **Test server**.
|
||||
|
||||
Please don't change the lines of the servers that ship with the app (SkySparkle, Quad9, Digitale Gesellschaft, UncensoredDNS, Freifunk München): the app always keeps their built-in addresses and links. To fix one of their links, open an issue instead. If you are unsure whether a server fits, open an issue with the *DoH server or blocklist* template instead.
|
||||
If you are unsure whether a server fits, open an issue with the *DoH server or blocklist* template first.
|
||||
|
||||
## Blocklists
|
||||
|
||||
|
||||
Reference in New Issue
Block a user