Metadata-Version: 2.2
Name: adblockd
Version: 0.0.4
Summary: Adblock based application
Home-page: https://github.com/rodrigopmatias/adblockd/issues
Author: <generator object read_authores at 0x7fbb9c74c5e0>
Author-email: <generator object read_emails at 0x7fbb9c3258a0>
Dynamic: author
Dynamic: author-email
Dynamic: description
Dynamic: home-page
Dynamic: summary

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.
