diff --git a/dist/README.md b/dist/README.md index 63d2e12..a2d9647 100644 --- a/dist/README.md +++ b/dist/README.md @@ -30,23 +30,31 @@ This list is an inventory of every `somestring.website1.com` found to allow non ## List variants -### First-party trackers (recommended) +### First-party trackers + +**Recommended for hostfiles-based ad blockers, such as [Pi-hole](https://pi-hole.net/).** +**Recommended for Android ad blockers as applications, such ad [Blokada](https://blokada.org/).** - Hosts file: - Raw list: This list contains every hostname redirecting to [a hand-picked list of first-party trackers](https://git.frogeye.fr/geoffrey/eulaurarien/src/branch/master/rules/first-party.list). It should be safe from false-positives. +It also contains all tracking hostnames under company domains (e.g. `website1.trackercompany.com`), +useful for ad blockers that don't support mass regex blocking, +while still preventing fallback to third-party trackers. Don't be afraid of the size of the list, as this is due to the nature of first-party trackers: a single tracker generates at least one hostname per client (typically two). ### First-party only trackers +**Recommended for ad blockers as web browser extensions, such as [uBlock Origin](https://pi-hole.net/).** + - Hosts file: - Raw list: This is the same list as above, albeit not containing the hostnames under the tracking company domains (e.g. `website1.trackercompany.com`). -While those are technically third-party trackers, they cannot be blocked at once by some ad blockers (e.g. Pi-hole). -Use only with ad blocker able to import regular expressions and in conjuction with other block lists. +This allows for reducing the size of the list for ad-blockers that already block those third-party trackers with their support of regex blocking. +Use in conjunction with other block lists used in regex-mode, such as [Peter Lowe's](https://pgl.yoyo.org/adservers/) ### Multi-party trackers @@ -55,7 +63,7 @@ Use only with ad blocker able to import regular expressions and in conjuction wi As first-party trackers usually evolve from third-party trackers, this list contains every hostname redirecting to trackers found in existing lists of third-party trackers (see next section). Since the latter were not designed with first-party trackers in mind, they are likely to contain false-positives. -In the other hand, they might protect against first-party tracker that we're not aware of / have not yet confirmed. +On the other hand, they might protect against first-party tracker that we're not aware of / have not yet confirmed. #### Source of third-party trackers @@ -69,8 +77,8 @@ In the other hand, they might protect against first-party tracker that we're not - Raw list: This is the same list as above, albeit not containing the hostnames under the tracking company domains (e.g. `website1.trackercompany.com`). -While those are technically third-party trackers, they cannot be blocked at once by some ad blockers (e.g. Pi-hole). -Use only with ad blocker able to import regular expressions and in conjuction with other block lists, especially the ones in the previous section. +This allows for reducing the size of the list for ad-blockers that already block those third-party trackers with their support of regex blocking. +Use in conjunction with other block lists used in regex-mode, such as the ones in the previous section. ## Meta diff --git a/export_lists.sh b/export_lists.sh index f2b2762..56c8b1c 100755 --- a/export_lists.sh +++ b/export_lists.sh @@ -42,7 +42,7 @@ do then trackerness_flags="" else - trackerness_flags="--end-chain --no-dupplicates" + trackerness_flags="--no-dupplicates" fi file_list="dist/${partyness}party-${trackerness}.txt" file_host="dist/${partyness}party-${trackerness}-hosts.txt"