{"id":13512277,"url":"https://github.com/anned20/begoneads","last_synced_at":"2025-03-30T22:32:24.062Z","repository":{"id":34925223,"uuid":"171749239","full_name":"anned20/begoneads","owner":"anned20","description":"BeGoneAds is a script that puts some popular hosts file lists into the systems hosts file as a adblocker measure.","archived":false,"fork":false,"pushed_at":"2023-07-30T15:42:15.000Z","size":23,"stargazers_count":311,"open_issues_count":2,"forks_count":15,"subscribers_count":10,"default_branch":"master","last_synced_at":"2024-04-26T14:45:23.417Z","etag":null,"topics":["adblock","adblocker","automation","click","python","requests","tqdm"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/anned20.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-02-20T21:06:31.000Z","updated_at":"2024-08-01T04:47:31.534Z","dependencies_parsed_at":"2024-08-01T04:57:28.688Z","dependency_job_id":null,"html_url":"https://github.com/anned20/begoneads","commit_stats":{"total_commits":26,"total_committers":4,"mean_commits":6.5,"dds":"0.46153846153846156","last_synced_commit":"fd4f8ff2327d89d3c133abeab4a181e83d590fcb"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anned20%2Fbegoneads","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anned20%2Fbegoneads/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anned20%2Fbegoneads/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anned20%2Fbegoneads/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/anned20","download_url":"https://codeload.github.com/anned20/begoneads/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246390883,"owners_count":20769475,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adblock","adblocker","automation","click","python","requests","tqdm"],"created_at":"2024-08-01T03:01:40.742Z","updated_at":"2025-03-30T22:32:20.240Z","avatar_url":"https://github.com/anned20.png","language":"Python","funding_links":[],"categories":["Python","Network"],"sub_categories":["DNS"],"readme":"# BeGoneAds\n\n![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/anned20/begoneads.svg)\n![GitHub issues](https://img.shields.io/github/issues/anned20/begoneads.svg)\n![GitHub pull requests](https://img.shields.io/github/issues-pr/anned20/begoneads.svg)\n![GitHub](https://img.shields.io/github/license/anned20/begoneads.svg)\n[![made-with-python](https://img.shields.io/badge/Made%20with-Python-1f425f.svg)](https://www.python.org/)\n![Awesome Badges](https://img.shields.io/badge/badges-awesome-green.svg)\n\nBeGoneAds is a script that puts some popular hosts file lists into the systems hosts file as a adblocker measure.\n\nSee it working on asciinema:\n\n[![asciicast](https://asciinema.org/a/weDJ7SZw49HBdTl7iB0nWIYgI.svg)](https://asciinema.org/a/weDJ7SZw49HBdTl7iB0nWIYgI)\n\n## Requirements\n\n- Python 3.6 or higher\n\n## Installation instructions\n\n### From PyPI\n\nTo install BeGoneAds from PyPI use the following command:\n\n```shell\npip install begoneads\n```\n\n### From source\n\nClone this repository:\n\n```shell\ngit clone https://github.com/anned20/begoneads.git\n```\n\nInstall the program:\n\n```shell\npython setup.py install\n```\n\n## Getting started\n\nYou are now ready to use BeGoneAds:\n\n```shell\nbegoneads\n```\n\nYou should see something like:\n\n```\nUsage: begoneads [OPTIONS] COMMAND [ARGS]...\n\n  Install or uninstall BeGoneAds, the host blocker for the system hosts\n  file\n\nOptions:\n  --help  Show this message and exit.\n\nCommands:\n  install    Install or update BeGoneAds\n  uninstall  Uninstall BeGoneAds\n```\n\n## Usage\n\nTo install the hosts to your system hosts file: \n\n```shell\nbegoneads install\n```\n\nTo install the hosts to your system hosts file with custom sources: \n\n```shell\nbegoneads install --sources https://www.custom.sources/hosts,http://www.and-another.one/hosts\n```\n\nTo install the hosts to your system hosts file with local sources: \n\n```shell\nbegoneads install --local-sources path/to/hosts/file,other/path\n```\n\nThe options `sources` and `local-sources` can be used together\n\nTo uninstall the hosts to your system hosts file: \n\n```shell\nbegoneads uninstall\n```\n\n## Sources of hosts data unified in this variant\n\nUpdated `hosts` files from the following locations are always unified and\nincluded:\n\nHost file source                  | Home page   |\n-----------------                 | :---------: |\nSteven Black's ad-hoc list        | [link](https://github.com/StevenBlack/hosts/blob/master/data/StevenBlack/hosts) |\nMalware Domain List               | [link](https://www.malwaredomainlist.com/) |\nadd.Dead                          | [link](https://github.com/FadeMind/hosts.extras) |\nadd.Spam                          | [link](https://github.com/FadeMind/hosts.extras) |\nDan Pollock                       | [link](https://someonewhocares.org/hosts/) |\nMVPS hosts file                   | [link](http://winhelp2002.mvps.org/) |\nyoyo.org                          | [link](https://pgl.yoyo.org/adservers/) |\nMitchell Krog's - Badd Boyz Hosts | [link](https://github.com/mitchellkrogza/Badd-Boyz-Hosts) |\nCoinBlocker                       | [link](https://gitlab.com/ZeroDot1/CoinBlockerLists) |\nUncheckyAds                       | [link](https://github.com/FadeMind/hosts.extras) |\nadd.2o7Net                        | [link](https://github.com/FadeMind/hosts.extras) |\nKADhosts                          | [link](https://github.com/azet12/KADhosts) |\nAdAway                            | [link](https://adaway.org/) |\nadd.Risk                          | [link](https://github.com/FadeMind/hosts.extras) |\n\n## TODO for 1.0.0\n\n- [X] Windows support\n- [X] Custom selection of host files\n- [X] Setuptools\n- [X] Apply own hosts\n- [ ] Systemd integration\n- [ ] Package it for Debian, Arch, CentOS, Fedora, etc.\n\n## Testing\n\nTo run the tests you use [pytest](https://pytest.org)\n\nExecute them with `pytest` in the project directory\n\n## Built with\n\n- [requests](http://docs.python-requests.org/en/master/) - Getting the webpage\n- [click](https://github.com/mitsuhiko/click) - Parsing command line options\n- [tqdm](https://github.com/tqdm/tqdm) - Showing a fancy progress bar\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanned20%2Fbegoneads","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fanned20%2Fbegoneads","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanned20%2Fbegoneads/lists"}