From 904895b0f1d97fbe58364e08821cb4101f263bd0 Mon Sep 17 00:00:00 2001 From: downlevel Date: Sun, 8 Nov 2026 15:03:27 +0000 Subject: [PATCH] Update README FAQ and feedback log from Reddit thread Add FAQ entries on DNS benefits, manual setup, home screen ads, streaming and install errors. Log new requests and the YouTube and Hotstar ad-blocking reports that still need testing. Co-Authored-By: Claude Opus 5.5 --- FEEDBACK.md | 14 ++++++++++++-- README.md | 15 +++++++++++++++ 2 files changed, 27 insertions(+), 2 deletions(-) diff --git a/FEEDBACK.md b/FEEDBACK.md index 5a9ccc7..4d6cc4d 100644 --- a/FEEDBACK.md +++ b/FEEDBACK.md @@ -9,23 +9,33 @@ Sources: - [ ] **Exclude apps from FireDNS (per-app allowlist)** — [#1](https://github.com/downlevel/firedns/issues/1) — [R1] Let the user pick installed and system apps that keep using the network DNS. Android supports it via `VpnService.Builder.addDisallowedApplication` (today only FireDNS excludes itself, `DnsVpnService.kt`). Needs: an app picker usable with the D-pad, persisted package list, restarting the tunnel on change. - [ ] **Make NextDNS easier to find** — [R1] A user asked to "add NextDNS" without realising custom DoH already supports it. Options: a NextDNS template in *Add DNS* that only asks for the configuration ID, or a clearer hint on the Home screen. +- [ ] **Tell users when an update is available** — [R1] A user asked how to know there is a new version. The app has no update check today: users have to look at GitHub Releases and reinstall the APK. Options: compare the installed version with the latest GitHub release and show a notice in the app, or at least link to the releases page from Settings. ## Compatibility - [ ] **Google TV / Android TV** — [#2](https://github.com/downlevel/firedns/issues/2) — [R1] Asked whether it works on Google TV. The app should work (minSdk 28, `LEANBACK_LAUNCHER`) but it has never been tested. Test on a Google TV device or emulator, then update *Supported devices* in the README. +- [ ] **Other Android TV boxes (Xiaomi Box, KD 9 stick)** — [R1] Asked whether it runs on them. Same status as Google TV: it should work on Android 9+, but it has never been tested. Track together with #2. +- [ ] **Fire TV Stick 4K: install fails** — [R1] A user gets "package damaged or incompatible". Possible causes: Fire OS 6 on the original 2018 model (minSdk is 28, so Fire OS 7+ is required) or an incomplete download. Waiting for the user's Fire OS version. If it is 6.x, state it clearly under *Supported devices* in the README. - [x] **Pi-hole** — [R1] A user confirmed it works with a Pi-hole as a custom DNS. ## Documentation / FAQ -Questions that came up repeatedly. Added to the README FAQ (onboarding still to consider). +Questions that came up repeatedly. Ticked items are in the README FAQ (onboarding still to consider). - [x] **"Does it block YouTube / Prime Video / Hotstar ads?"** — No. Those ads come from the same servers as the video, so no DNS-based blocker can block them. This was the most frequent question. - [x] **"Does it need to run in the background / can I force close it?"** — It must stay running (foreground service, starts on boot). Force stopping it reverts to the network DNS. - [x] **"Fire OS has a forced extra DNS, so DNS blocking doesn't work"** — Explain what FireDNS covers: the network's public DNS servers are routed into the tunnel too (see ARCHITECTURE.md). Also explain what it does not cover: apps with their own built-in DoH, and local DNS addresses (router, Pi-hole), which stay outside the tunnel by design. - [x] **"Can I use it with my VPN?"** — No, Android allows only one VPN at a time. Already in the FAQ; consider mentioning it in onboarding too. - [x] **Pi-hole vs FireDNS** — They are complementary: a Pi-hole can be added as a custom DNS in FireDNS. +- [ ] **Verify the "no DNS blocker can stop YouTube / Hotstar ads" claim** — [R1] Two users report that NextDNS now blocks YouTube ads (one also mentions ControlD), and one says Hotstar ads are blocked once the Fire TV's fallback to 8.8.8.8 or the ISP DNS is disabled. Not confirmed: no official NextDNS source found, and public sources mostly say the opposite. Test on a Fire TV with NextDNS as a custom DoH address, then correct the README FAQ if it holds up. +- [ ] **"Is a DNS address hardcoded by Fire OS covered?"** — [R1] Related to the Hotstar report. FireDNS routes into the tunnel only the public DNS servers reported by the network, so an address that Fire OS uses without reporting it may bypass the profile. Test it and document the result. +- [x] **"What is the difference from entering the DNS manually?"** — [R1] Same DNS, but one click instead of reconfiguring the Wi-Fi by hand, plus DNS-over-HTTPS and automatic fallback. +- [x] **"What do I gain by changing DNS?"** — [R1] Asked twice in plain terms. Privacy, ad and tracker blocking in many apps and websites, malware protection, sometimes faster loading. +- [x] **"Does it help with streaming or ISP throttling?"** — [R1] It does not change the video traffic. It can help when the ISP interferes at the DNS level or DNS picks a poor streaming server, not when the ISP slows the traffic itself. +- [x] **"Does it block Fire TV home screen ads?"** — [R1] Not tested. It depends on the provider's blocklist, and blocking Amazon domains may break parts of the home screen. +- [ ] **"How do I update the app?"** — [R1] Download the latest APK and install it over the current version. See the update notice under *Feature requests*. ## Rejected / out of scope - **Blocking Amazon updates** — [R1] Not a built-in feature: update domains change often and blocking them also blocks security patches. Users who want it can use a custom NextDNS/Pi-hole with their own blocklist. -- **Blocking ads inside streaming apps** — Not technically possible at the DNS level (see FAQ above). +- **Blocking ads inside streaming apps** — Considered not technically possible at the DNS level (see FAQ above). Being rechecked after user reports about NextDNS and Hotstar; any such filtering would come from the DNS provider, not from a FireDNS feature. diff --git a/README.md b/README.md index bcac9dc..5619cff 100644 --- a/README.md +++ b/README.md @@ -60,6 +60,12 @@ Open **FireDNS** from *Your Apps*, press **Continue** and accept Android's VPN p ## FAQ +**What do I gain by changing DNS?** +DNS is how your Fire TV finds the address of a service, and by default it uses your internet provider's. With FireDNS you get encrypted lookups, ad and tracker blocking in many apps and websites (*AdGuard DNS*), malware protection (*Quad9*) and sometimes faster loading, if your provider's DNS is slow. + +**What is the difference from entering the DNS manually?** +The DNS can be the same, but on Fire TV the manual way means forgetting your Wi-Fi, re-entering the password and typing a static IP, gateway and DNS with the remote, every time you want to switch. FireDNS does it in one click and adds encrypted DNS (DoH) and automatic fallback. + **Why does it need VPN permission?** Android does not let apps change the Wi-Fi DNS since Android 10. A local VPN is the only way to redirect DNS without root. FireDNS routes only DNS addresses into it: your streams and downloads never pass through the app. @@ -69,6 +75,12 @@ It needs to stay running: if you force close it, the Fire TV goes back to your n **Does it block ads on YouTube, Prime Video, Hotstar…?** No. Those apps serve ads from the same servers as the video, so no DNS-based blocker (FireDNS, Pi-hole, AdGuard DNS…) can block them without breaking playback. With *AdGuard DNS* FireDNS blocks a lot of ads and trackers in other apps and on websites. +**Does it block the ads on the Fire TV home screen?** +This has not been tested. FireDNS applies whatever your DNS provider blocks, so the result depends on its blocklist. Keep in mind that blocking Amazon domains with a custom blocklist can also break parts of the home screen. + +**Does it help with streaming or ISP throttling?** +It does not touch the video traffic, so it won't improve quality by itself. It can help if your ISP interferes at the DNS level or its DNS sends you to a poor streaming server. It won't help if the ISP slows down the traffic itself. + **Can I use NextDNS or my Pi-hole?** Yes. Press *Add DNS* and enter: - NextDNS: `https://dns.nextdns.io/` (encrypted, uses your NextDNS blocklists) @@ -91,6 +103,9 @@ Only your DNS queries, to the provider you selected (or to your network DNS duri **How do I check it works?** Select *AdGuard DNS* and open a site full of ads, or from a computer run `adb shell ping -c1 doubleclick.net`: with AdGuard it resolves to `0.0.0.0`/`127.0.0.1`, with Cloudflare to a real address. +**Installation fails with "package damaged or incompatible". What can I do?** +Check *Settings → My Fire TV → About → Fire TV OS*. FireDNS needs Fire OS 7 or later: if you see 6.x, look for a system update, because the app cannot be installed on that version. Otherwise the download may be incomplete: delete the file in Downloader and download it again with the full URL above. + ## How it works ```