{"id":13399352,"url":"https://github.com/julian-klode/dns66","last_synced_at":"2025-05-15T11:07:56.392Z","repository":{"id":37978733,"uuid":"70996010","full_name":"julian-klode/dns66","owner":"julian-klode","description":"DNS-based Host Blocker (and lightweight ad blocker) for Android","archived":false,"fork":false,"pushed_at":"2022-11-10T20:09:41.000Z","size":821,"stargazers_count":2174,"open_issues_count":98,"forks_count":202,"subscribers_count":75,"default_branch":"main","last_synced_at":"2025-04-14T19:58:14.639Z","etag":null,"topics":["ad-blocker","adblock","android","blocker","fdroid","gplv3","gradle","java"],"latest_commit_sha":null,"homepage":"https://jak-linux.org/projects/dns66/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/julian-klode.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"COPYING","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-10-15T15:27:17.000Z","updated_at":"2025-04-08T07:27:11.000Z","dependencies_parsed_at":"2022-07-12T15:20:55.912Z","dependency_job_id":null,"html_url":"https://github.com/julian-klode/dns66","commit_stats":null,"previous_names":[],"tags_count":29,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/julian-klode%2Fdns66","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/julian-klode%2Fdns66/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/julian-klode%2Fdns66/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/julian-klode%2Fdns66/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/julian-klode","download_url":"https://codeload.github.com/julian-klode/dns66/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254328384,"owners_count":22052632,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ad-blocker","adblock","android","blocker","fdroid","gplv3","gradle","java"],"created_at":"2024-07-30T19:00:36.677Z","updated_at":"2025-05-15T11:07:56.351Z","avatar_url":"https://github.com/julian-klode.png","language":"Java","funding_links":[],"categories":["Ad Blockers","Java","Ad blockers"],"sub_categories":["Notable Mentions","Reddit"],"readme":"DNS-Based Host Blocking for Android\n===================================\nThis is a DNS-based host blocker for Android. In the default configuration,\nseveral widely-respected host files are used to block ads, malware, and other\nweird stuff.\n\n[![codecov](https://codecov.io/gh/julian-klode/dns66/branch/master/graph/badge.svg)](https://codecov.io/gh/julian-klode/dns66)\n[![Build Status](https://travis-ci.com/julian-klode/dns66.svg?branch=master)](https://travis-ci.com/julian-klode/dns66)\n\nInstalling\n----------\n[\u003cimg src=\"https://f-droid.org/badge/get-it-on.png\"\n      alt=\"Get it on F-Droid\"\n      height=\"80\"\u003e](https://f-droid.org/app/org.jak_linux.dns66)\n\nYou can either install it via F-Droid, using the official F-Droid repository, or you can use my personal repository at https://jak-linux.org/fdroid/repo which gets updates ASAP.\n\nYou can also download apk files in GitHub's download section. Currently, these are the same files as in my personal F-Droid repository, but that might change in the future.\n\nXDA: Discussions and preview builds\n-----------------------------------\nThere is a thread at XDA, where DNS66 can be discussed and I occasionaly post\npreview builts of the git repository:\n\nhttps://forum.xda-developers.com/android/apps-games/app-dns66-source-host-ad-blocker-root-t3487497\n\nUsing it\n---------\nOn the first start, you must manually update the hosts files (using the\nrefresh button) before the service can work correctly (issue #1); and you\nmust also update the hosts files yourself regularly for now (issue #2).\n\nItems in the hosts and DNS servers lists can be moved around and removed)\nof the list using standard RecyclerView interactions (long press makes the\nentry movable, swipe to either side removes it). For hosts, a later entry\noverrides a previous entry; for DNS servers, the first server is preferred.\n\nCurrently, there are some minor usability issues:\n\n* If you change a setting, you must manually restart the vpn service (issue #3)\n* IPv6 servers are not supported (issue #4)\n\nThere's also no validation of input, so DNS servers that are not valid IPv4\naddresses are not rejected, neither are URLs for DNS server entries (we intend\nto support URLs in the future, so you can point the app to a remote list of\nservers).\n\nHow it works\n------------\nThe app establishes a VPN service, with routes for all DNS servers diverted to\nit. The VPN service then intercepts the packages for the servers and forwards\nany DNS queries that are not blacklisted.\n\nCustom upstream DNS can be configured. If the feature is turned off, the\ncurrent connection's DNS servers are used. The app ships are pre-defined\nlist of well known (mostly German) non-logging servers courtesy of the\nChaos Computer Club.\n\n\nPrivacy Guarantee\n-----------------\nPrivacy is the most important aspect of DNS66. Currently, DNS66 is strictly\ndata reducing: Running it can only reduce the amount of data leaving your\ndevice, not increase it (except for fetching hosts files, obviously), as for\neach request, we will either allow it to leave your device or not - we will\nnot send other requests or add other information to the request.\n\nWhile not yet implemented, future versions of DNS66 might have additional\nfeatures that might share more data than your phone normally would. Among\nthese features are:\n\n1. Automatic updates. Your phone might periodically contact servers to query\n   for new upstream versions and new host lists. DNS66 will only include as\n   much data as necessary to complete the request.\n\n2. Debugging. We hope to have a better way to debug program failures than\n   manually running logcat. Such a feature by definition requires sharing\n   debug logs. Debug logs (including logcat) may include personal information,\n   and you should review them before sharing them publicly.\n\nIf such a feature is added, you will be presented with the choice to enable\nit (it will be disabled by default). No such feature will be turned on without\nyour explicit consent (for example, clicking yes in a dialog asking whether you\nwant to have automatic updates).\n\nContributing\n------------\nSee [CONTRIBUTING.md](CONTRIBUTING.md)\n\nLicense\n-------\nThis program is free software: you can redistribute it and/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation, either version 3 of the License, or\n(at your option) any later version.\n\nParts of the program are licensed under only version 3 of the license, and\nsome parts might be licensed under the terms of other compatible licenses. See\nthe file [copyright](app/src/main/assets/copyright) for further (machine-readable) information.\n\nBinaries also bundle external libraries. To the best of our knowledge those\nare licensed under the Apache license, version 2.0, except for pcap4j, which\nis licensed under the MIT license, and dnsjava, which uses a 3 clause BSD\nlicense. See\nthe file [copyright.libraries](app/src/main/assets/copyright.libraries) for further (machine-readable) information.\n\nCode of Conduct\n---------------\nPlease note that this project is released with a Contributor Code of\nConduct. By participating in this project you agree to abide by its terms.\n\nAuthors\n-------\nJulian Andres Klode \u003cjak@jak-linux.org\u003e\n\nParts are derived from https://github.com/dbrodie/AdBuster by Daniel Brodie.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjulian-klode%2Fdns66","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjulian-klode%2Fdns66","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjulian-klode%2Fdns66/lists"}