/adhell

adhell, a free and open-source adblocking alternative for browser-plugins and other misterious stuff.

Primary LanguageShellGNU General Public License v3.0GPL-3.0

adhell

Every single ad belongs to hell!

Description

This script generates a Blacklist for ad- and malwareblocking. Remove those ads without altering your browser-fingerprint, see the web as you like. Let it work on your Router for an adblocking-monster fixing the whole network behind it. Ever seen an ad-free Smartphone?

Since this script needs write-access to the hostfile defined in $ADNAME, it will most likely need root-privileges (sudo).

Installation

  1. Change into the target Git directory
  2. Execute 'git clone https://github.com/adhell-project/adhell.git'
  3. Read 'adhell.conf' carefully!
  4. Edit 'adhell.conf' to your needs
  5. Edit 'CONF' in adhell.sh to '/etc/adhell/adhell.conf' if we forgot it ;)
  6. Place files to the intended destinations
  7. Fetch the blocklist with 'sudo adhell.sh -g'
  8. Enjoy an almost ad-free Internet

Fetched Blocklists (default)

  1. http://pgl.yoyo.org/adservers/serverlist.php?hostformat=hosts&mimetype=plaintext
  2. http://someonewhocares.org/hosts/hosts
  3. http://www.malwaredomainlist.com/hostslist/hosts.txt
  4. http://winhelp2002.mvps.org/hosts.txt
  5. http://hosts-file.net/download/hosts.txt
  6. http://hosts-file.net/hphosts-partial.txt
  7. http://hostsfile.mine.nu/Hosts

Usage

adhell.sh {option}

  • -g || --generate Start to generate the Blacklist in $ADNAME
  • -r || --remove Remove all blocked hosts in $ADNAME
  • -c || --clean Manually start cleaning after the script aborted. Use at your own Risk!
  • -v || --version Print the version
  • -h || --help Print the help message

Contributing

  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Commit your changes: git commit -am 'Add some feature'
  4. Push to the branch: git push origin my-new-feature
  5. Submit a pull request :)

Task List

  • Pull from different adblock lists
  • Work with functions
  • Implement a visual feedback with --generate
  • Clean unnecessary code, make it pretty
  • Put options in /etc/adhell/adhell.conf
  • Implement logging
  • Implement whitelisting (read /etc/adhell/README.txt for further information)
  • Perform a pre-running check

Send us your suggestions for new features!

Credits

Upstream Code from https://github.com/vebenwtickler/macht-sinn

License

GNU General Public License, Version 3