| .github | ||
| data | ||
| gs | ||
| imgs | ||
| scripts | ||
| src | ||
| .gitattributes | ||
| .gitignore | ||
| .travis.yml | ||
| About.md | ||
| FilterLists.sln | ||
| FilterLists.sln.DotSettings | ||
| LICENSE | ||
FilterLists is the independent and comprehensive directory of all public filter and hosts lists for advertisements, trackers, malware, and annoyances. For more information on its purpose and function, check out About.
Links
| Site | API |
|---|---|
| v3 (Alpha) | v1 (Alpha) |
| v2 (Stable) | |
| v1 (Legacy) |
Submitting or Updating Lists
To suggest a new list or update the information of an existing list, create a PR against data or open a new Issue. Provide all of the information in the Properties section below that is available.
Development Notice (Updated November 1, 2017)
FilterLists improvements are slow and tend to be in spurts. I care about this project as both a resource for the community and a learning tool for me. However, my day job comes first which often results in little to no work on the project at times. I happily welcome anyone that wants to contribute.
The immediate projects are converting the data to an actual web application (rather than a Google Sheet back-end and a WordPress front-end), and then exposing the data via a .Net Core API.
Properties
*Asterisks indicate a foreign key relationship.
FilterLists
| Property | Description |
|---|---|
| Description | The list's functionality |
| DescriptionSourceUrl | The list's Description source URL if quoted directly |
| DiscontinuedDate | The list's date of discontinuation as expressed by the maintainer |
| DonateUrl | The list's donation URL |
| EmailAddress | The list's email address |
| ForumUrl | The list's forum URL |
| HomeUrl | The list's home page URL |
| IssuesUrl | The list's GitHub Issues URL |
| *Languages | The list's target languages |
| *License | The list's license (typically CC) |
| *Maintainers | The list's maintainers |
| Name | The list's name (APA Title Case) |
| SubmissionUrl | The list's submission form URL |
| *Syntax | The list's syntax (uBlock Origin, Adblock Plus, hosts, etc.) |
| *UpstreamFilterLists | The list's upstream lists if it is a fork or a merge |
| ViewUrl | The list's view/download URL (typically .txt file) |
Maintainers
| Property | Description |
|---|---|
| EmailAddress | The maintainer's email address |
| HomeUrl | The maintainer's home page URL |
| Name | The maintainer's name |
| TwitterHandle | The maintainer's Twitter handle |
| *FilterLists | The maintainer's lists |