Skip to content


Repository files navigation



Note: Welcome to FLOSS Weekly viewers! I’m looking for collaborators on Chomper - in particular with creating a GUI, adapting Chomper for OSX, and packaging Chomper with pyinstaller. Reach out to me at the Chomper Gitter channel if you want to work together!

Chomper is a Python command-line program for use on Linux which can either create blacklists of blocked websites or whitelists of allowed websites for specified periods of time. The program is intended to help people with issues being productive on a computer due to Internet distractions.

Most internet blocking programs operate just by modifying the hosts file. This approach only allows for creating blacklists. Additionally, the hosts file approach does not allow you to block particular URLs - it only allows you to block particular domains.

Chomper instead filters outgoing requests through a transparent proxy, which allows for filtering requests at the URL level. This means you can make nuanced blacklists and whitelists, so that you can block websites without sacrificing your ability to do work.

You can read more about my motivation for developing Chomper here.


You can find the installation and usage information at ReadTheDocs.


You can ask questions and join the development discussion on the Chomper Gitter channel.

Please post bug reports and feature requests (only) in GitHub issues.


Chomper is licensed according to the GPLv3. See the COPYING file for more details.


Interested in contributing? Awesome! Start by reading the developer’s walkthrough to the Chomper codebase. For guidelines on making pull requests, please read the file.


Chomper was created and is maintained by Aniket Panjwani. For a full list of contributors, go here.