🛡️ The independent, comprehensive directory of filter and host lists for advertisements, trackers, malware, and annoyances.
Find a file
2017-02-09 17:26:18 -06:00
data re-org, add stub of software.json 2017-02-09 17:26:18 -06:00
gs re-org, add stub of software.json 2017-02-09 17:26:18 -06:00
imgs create large logo for meta og:image 2017-02-03 20:09:53 -06:00
.gitignore major refactor 2017-02-05 17:50:03 -06:00
About.md rename Start to About 2017-02-09 13:23:42 -06:00
LICENSE Initial commit 2016-12-10 14:28:16 -06:00
README.md remove guide and changelog 2017-02-09 13:44:55 -06:00

FilterLists

License Website

filterlists.com

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.

Properties

Property Description
list The name of the list as stated by the list maintainer(s) in title case.
descr A brief description of the list's functionality. Preferably, this is quoted (if non-English, translate to English via translator or Google Translate for consistency) from the list's documentation or composed by a maintainer of the list. If neither are available, a generic description should be composed by the FilterLists contributor.
descrSourceUrl The URL to the list's documentation page from which the description was quoted if applicable.
viewUrl The URL to the list in raw text format. zip files and other formats are acceptable if no text format is available.
homeUrl The URL to the list's home page. Preferably, this is stated in the header of the list. Alternatively, it could be a custom domain, GitHub page, blog post, forum post, etc. that serves as a primary source of information for the list.
forumUrl The URL to the list's forum where issues, change requests, etc. are discussed.
issuesUrl The URL to the list's GitHub Issues.
email The email address of the list's maintainer(s) if publicly available.
donateUrl The URL to the list's donation page. This could be a custom PayPal or similar link, or a link to a web page discussing various donation options. Pull requests that include changes to this link will undergo further verification to prevent fraud.
related List names that are directly related to the list. For example, if a list is a combination of other lists, its master lists would be considered "related". Sorted alphabetically by convention.
tagLang Array of ISO 639-1 language codes targeted by the list.

Building

Essentially, for now, you "can't". As it stands, FilterLists is only pseudo-open-sourced, built on WordPress and Google Sheets. The data is all contained in this repository in .json form. The Google Apps Scripts used to parse the data are also maintained here. To build the production setup, though, requires creating custom Google Sheets, installing the apps scripts, and installing WordPress. In the future, it would be great to have the entire site open-sourced; but, it is what it is for now.