This is your friendly guide to contributing to FreeContributor.
git clone [email protected]:tbds/FreeContributor.git
git fetch origin
git checkout -b my-local-branch origin/master
# make changes
git add ...
git commit -m "Super awesome commit"
You can also contribute by running uBlock Origin in Advanced mode and/or uMatrix.
To change to uBlock Advanced-user mode, go to Click To Open Dashboard and select the checkbox I am an advanced user
| Basic mode | Advanced-user mode |
|---|---|
| Popup user interface | A point-and-click firewall which can be configured on a per-site basis |
 . . |
 Configure as you wish: picture shows 3rd-party scripts and frames blocked by default everywhere |
After reading the uBlock wiki: Dynamic filtering: quick guide, start blocking the bad domanains in the websites you visit.
ATTENTION: make sure that the website works, with the rules you applied in Ublock Origin/uMatrix.
The data is stored in the browser and can be exported to a text file. Go to uBlock dashboard -> My rules and export to file. The same applies to uMatrix.
Finally save the file in FreeContributor/utils and run the script ublock-umatrix-export.sh. Example:
$ ./ublock-umatrix-export.sh dnsmasq my-umatrix.rules
This will export only the blocked domains to dnsmasq formart server=/bad-domain.tld/ to dnsmasq-umatrix.conf. Save it at /etc/dnsmasq.d/
You can send me this bad domains via pull request. See a sample at FreeContributor/data/samples
$ ./ublock-umatrix-export.sh domains my-umatrix.rules
Add the file domains generated by the script.