🛡️ The independent, comprehensive directory of filter and host lists for advertisements, trackers, malware, and annoyances.
Find a file
2017-01-30 13:32:23 -06:00
.github point to CONTRIBUTING 2017-01-05 12:34:24 -06:00
gs add email notifications on error 2017-01-30 13:32:23 -06:00
imgs add logos 2017-01-29 14:06:39 -06:00
json-data updated lists, beautified all json 2017-01-21 12:04:07 -06:00
json-schema updated lists, beautified all json 2017-01-21 12:04:07 -06:00
CONTRIBUTING.md Update CONTRIBUTING.md 2017-01-23 15:03:15 -06:00
LICENSE Initial commit 2016-12-10 14:28:16 -06:00
README.md add website badge 2017-01-29 19:30:46 -06:00
Start.md fix url 2017-01-29 17:42:02 -06:00

FilterLists

License Website

The NEW FilterLists

filterlists.com

FilterLists is the independent and comprehensive directory of all public filter lists for advertisements, trackers, malware, and annoyances. For more information on its purpose and function, check out Start.

Legacy Site

The legacy site is still live over at v1.filterlists.com. Note that the legacy site is for archival purposes only and will no longer be updated.

Contributions

See CONTRIBUTING.

Directory Structure

/json-data

The data in JSON format for each of the five list types on FilterLists. If you are looking for the core data of FilterLists (information on all of the lists), this is it.

/json-schema

The JSON Schema specification for each of the five list types contained in /json-data. Since all lists do not have values for all supported data properties, these explain all of the possible properties that FilterLists currently supports rather than including a bunch of null values in the .json data files.

/gs/lib

A single GAS library used by all five list type spreadsheets and accessed via /gs/type/Interface.gs

/gs/type

Scripts copied into each of the five list type spreadsheets to workaround the Google Sheets/GAS permissions structure

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.

Google Sheets

Google Sheets is used as a lightweight database for this site. Data is pulled once daily from GitHub to Google Sheets, and then once daily from Google Sheets to FilterLists. Below are links to the production Sheets for reference.