adblockd 0.0.4

Adblock based application

adblockd
========

This application helps you to get rid of the ads, so that the system redirects the field of ads for localhost.


Attention
---------

1. <div style="color:red">
You should be very careful when using this tool, since attackers can use this same mechanism to fake pages.
</div>
1. <div style="color:red">
Make sure that files are protected hosts.
</div>
1. <div style="color:red">
Always protect /etc/hosts.base with root permissions.
</div>

How install
-----------

<pre><code>$ pip install adbblockd</code></pre>

Or

<pre><code>$ easy_install adbblockd</code></pre>

Configuration
-------------

1. Rename you /etc/hosts for /etc/hosts.base
1. Create in you home .adblockd directory
1. In this directory create config.json
1. Create hosts file in .adbclockd directory
1. Create symbolic link from hosts to /etc/hosts

Now you can configure config.json with content:

<pre><code class="json">{
"hosts": {
"import_files": [
"/etc/hosts.base"
],
"dest": "hosts"
},
"base": [
"http://hosts-file.net/ad_servers.txt",
"http://winhelp2002.mvps.org/hosts.txt",
"https://adaway.org/hosts.txt",
"http://pgl.yoyo.org/adservers/serverlist.php?hostformat=hosts&showintro=0&mimetype=plaintext"
]
}</code></pre>

Running this
------------

<pre><code>$ adblockd -c ~/.adblockd/config.json -u</code></pre>

This command will update hosts base and download all files specified in section base in config.json.

Caveats
-------

You can create config-noblock.json with base section empty for you can activate ads.

You can create others bases if you is developer and need vhost for you applications.

Future Projects
---------------

1. Create mechanism for protect hosts files
1. Create webservice for register new entries
1. Create create pluggin for Google Chrome and Mozilla Firefox for add ads.