Skip to content

BeGoneAds is a script that puts some popular hosts file lists into the systems hosts file as a adblocker measure.

License

Notifications You must be signed in to change notification settings

anned20/begoneads

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BeGoneAds

GitHub code size in bytes GitHub issues GitHub pull requests GitHub made-with-python Awesome Badges

BeGoneAds is a script that puts some popular hosts file lists into the systems hosts file as a adblocker measure.

See it working on asciinema:

asciicast

Requirements

  • Python 3.6 or higher

Installation instructions

From PyPI

To install BeGoneAds from PyPI use the following command:

pip install begoneads

From source

Clone this repository:

git clone https://github.com/anned20/begoneads.git

Install the program:

python setup.py install

Getting started

You are now ready to use BeGoneAds:

begoneads

You should see something like:

Usage: begoneads [OPTIONS] COMMAND [ARGS]...

  Install or uninstall BeGoneAds, the host blocker for the system hosts
  file

Options:
  --help  Show this message and exit.

Commands:
  install    Install or update BeGoneAds
  uninstall  Uninstall BeGoneAds

Usage

To install the hosts to your system hosts file:

begoneads install

To install the hosts to your system hosts file with custom sources:

begoneads install --sources https://www.custom.sources/hosts,http://www.and-another.one/hosts

To install the hosts to your system hosts file with local sources:

begoneads install --local-sources path/to/hosts/file,other/path

The options sources and local-sources can be used together

To uninstall the hosts to your system hosts file:

begoneads uninstall

Sources of hosts data unified in this variant

Updated hosts files from the following locations are always unified and included:

Host file source Home page
Steven Black's ad-hoc list link
Malware Domain List link
add.Dead link
add.Spam link
Dan Pollock link
MVPS hosts file link
yoyo.org link
Mitchell Krog's - Badd Boyz Hosts link
CoinBlocker link
UncheckyAds link
add.2o7Net link
KADhosts link
AdAway link
add.Risk link

TODO for 1.0.0

  • Windows support
  • Custom selection of host files
  • Setuptools
  • Apply own hosts
  • Systemd integration
  • Package it for Debian, Arch, CentOS, Fedora, etc.

Testing

To run the tests you use pytest

Execute them with pytest in the project directory

Built with

  • requests - Getting the webpage
  • click - Parsing command line options
  • tqdm - Showing a fancy progress bar

License

This project is licensed under the MIT License - see the LICENSE.md file for details

About

BeGoneAds is a script that puts some popular hosts file lists into the systems hosts file as a adblocker measure.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published