https://github.com/dhilipsiva/hostscli

hostscli - A CLI tool to block / unblock websites using /etc/hosts. Super simple and easily extendable. Also block Ads, Tracking & Malware sites.
https://github.com/dhilipsiva/hostscli

ad-blocker cli cli-app command-line commandline firewall hosts porn-filter python python-client python-library

Last synced: 3 months ago
JSON representation

hostscli - A CLI tool to block / unblock websites using /etc/hosts. Super simple and easily extendable. Also block Ads, Tracking & Malware sites.

• Host: GitHub
• URL: https://github.com/dhilipsiva/hostscli
• Owner: dhilipsiva
• License: mit
• Created: 2016-12-28T12:58:09.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2017-01-16T05:13:07.000Z (over 8 years ago)
• Last Synced: 2025-03-17T05:11:23.509Z (3 months ago)
• Topics: ad-blocker, cli, cli-app, command-line, commandline, firewall, hosts, porn-filter, python, python-client, python-library
• Language: Python
• Homepage: http://hostscli.readthedocs.io/
• Size: 260 KB
• Stars: 11
• Watchers: 2
• Forks: 6
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
HostsCLI Docs

=============

A CLI tool to block / unblock websites using /etc/hosts. Super simple and easily extendable. Also block Ads, Tracking & Malware sites.

Links

-----

.. list-table::

    :stub-columns: 1

    * - Docs Link

      - http://hostscli.readthedocs.io/

    * - GitHub Link

      - https://github.com/dhilipsiva/hostscli

    * - PyPI Link

      - https://pypi.python.org/pypi/hostscli

Badges

------

.. start-badges

.. list-table::

    :stub-columns: 1

    * - Docs

      - |docs|

    * - GitHub

      - | |gh-issues| |gh-forks| |gh-stars| |gh-license|

    * - Tests

      - | |travis| |requires|  |coverage| |code-climate| |cc-issues|

    * - Thanks

      - |say-thanks|

.. |docs| image:: https://readthedocs.org/projects/hostscli/badge/?version=latest

    :target: http://hostscli.readthedocs.io/?badge=latest

    :alt: Documentation Status

.. |gh-issues| image:: https://img.shields.io/github/issues/dhilipsiva/hostscli.svg

    :target: https://github.com/dhilipsiva/hostscli/issues

    :alt: GitHub Issues

.. |gh-forks| image:: https://img.shields.io/github/forks/dhilipsiva/hostscli.svg

    :target: https://github.com/dhilipsiva/hostscli/network

    :alt: GitHub Forks

.. |gh-stars| image:: https://img.shields.io/github/stars/dhilipsiva/hostscli.svg

    :target: https://github.com/dhilipsiva/hostscli/stargazers

    :alt: GitHub Stars

.. |gh-license| image:: https://img.shields.io/badge/license-MIT-blue.svg

    :target: https://raw.githubusercontent.com/dhilipsiva/hostscli/master/LICENSE

    :alt: GitHub LICENSE

.. |travis| image:: https://travis-ci.org/dhilipsiva/hostscli.svg?branch=master

    :target: https://travis-ci.org/dhilipsiva/hostscli

    :alt: Travis

.. |requires| image:: https://requires.io/github/dhilipsiva/hostscli/requirements.svg?branch=master

    :target: https://requires.io/github/dhilipsiva/hostscli/requirements/?branch=master

    :alt: Requirements Status

.. |coverage| image:: https://codecov.io/gh/dhilipsiva/hostscli/branch/master/graph/badge.svg

    :target: https://codecov.io/gh/dhilipsiva/hostscli

    :alt: Coverage

.. |code-climate| image:: https://codeclimate.com/github/dhilipsiva/hostscli/badges/gpa.svg

    :target: https://codeclimate.com/github/dhilipsiva/hostscli

    :alt: Code Climate

.. |cc-issues| image:: https://codeclimate.com/github/dhilipsiva/hostscli/badges/issue_count.svg

    :target: https://codeclimate.com/github/dhilipsiva/hostscli

    :alt: Issue Count

.. |say-thanks| image:: https://img.shields.io/badge/saythanks.io-%E2%98%BC-1EAEDB.svg

    :target: https://saythanks.io/to/dhilipsiva

    :alt: Say thanks :)

.. end-badges

Docs & Reference

----------------

.. automodule:: hostscli

    :members:

    :undoc-members:

    :show-inheritance:

More websites?

--------------

If you need to add more websites, just create a ``.py`` file in `hostscli/websites/ `_ directory with list of domains declared as variable `DOMAINS`.

Please look at `hostscli/websites/facebook.py `_ file for reference

Credits

-------

Here are some of the list where I borrowed domains from:

https://github.com/jmdugan/blocklists

http://www.malwaredomainlist.com/hostslist/hosts.txt

http://winhelp2002.mvps.org/hosts.txt

http://someonewhocares.org/hosts/hosts

http://pgl.yoyo.org/adservers/serverlist.php?hostformat=hosts&mimetype=plaintext