Awesome Open Source
Awesome Open Source


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:



  • 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

Install the program:

python install

Getting started

You are now ready to use BeGoneAds:


You should see something like:

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

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

  --help  Show this message and exit.

  install    Install or update BeGoneAds
  uninstall  Uninstall BeGoneAds


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,

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 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

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


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


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

Alternative Project Comparisons
Related Awesome Lists
Top Programming Languages

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Python (893,602
Hosts (17,638
Adblock (854
Adblocker (546
Tqdm (47