hufilter-dev
hufilter-dev copied to clipboard
Hufilter - The Hungarian Adblock Filter List.
The Hungarian Adblock Filter List
Supported Adblockers:
AdGuard |
uBlock Origin |
Adblock Plus |
AdBlocker Ultimate |
AdBlock
Hufilter developer documentation
Please read this short documentation if you would like to contribute to the hufilter project! Thank you!
First of all, the project is being developed in this repository. The another repository, called hufilter, is only the result of the build process and its content are overwritten after each build.
Sections
Filter rule categories can be found in sections directory. Currently available filter categories:
| Filename | Description | Syntax |
|---|---|---|
| ads.txt | Filtering rules that blocks ads only. | |
| trackers.txt | Filtering rules that blocks trackers and analytics systems. | |
| annoyances.txt | Filtering rules that blocks annoying elements, such as cookie popups, intrusive notifications, recommendations, floating elements, etc. | |
| antiadblock.txt | Filtering rules that bypasses anti-adblock scripts, only if this can be solved with ABP capabilities. | |
| selfpromo.txt | Filtering rules that blocks self-promitions. | |
| other.txt | Anything that does not fall into the categories listed above. | |
| abp-specific.txt | ABP scriptlet rules. | |
| ublock-specific.txt | Mixed rules that requires uBlock Origin capabilities. | |
| adguard-specific.txt | Mixed rules that requires AdGuard capabilities. |
* Both of Adguard and uBlock Origin are able to interpret the syntax of Adblock Plus.
References
Useful links to documentations.
Adblock Plus:
uBlock Origin:
AdGuard:
- Scriptlets compatibility table (by AdGuard)
- Redirects compatibility table
- CSS selectors (MDN)
Build process
The build process is executed automatically if a push event is triggered in this repository.
Recommended environment
We recommend using Visual Studio Code for development. Please install recommended extensions in order to work with syntax highlight and automatic rule ordering. Node.js is also required for automatic ordering!
Contact
- E-mail: [email protected]
- Forum: Discussions
- Issue management: Please use this form (GitHub account required).
Licensing
The project hufilter is distributed under the "Creative Commons Attribution 4.0" license. Contributors are licensing their work under the very same terms and conditions.