Metadata-Version: 1.0
Name: adblockd
Version: 0.0.4
Summary: Adblock based application
Home-page: https://github.com/rodrigopmatias/adblockd/issues
Author: <generator object read_authores at 0x7fe56d6bc320>
Author-email: <generator object read_emails at 0x7fe572932aa0>
License: UNKNOWN
Description: 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.
        
Platform: UNKNOWN
