An anti-capitalist ad-blocker that uses the hosts file
Go to file
Twann 55aac48f01
testing / test-unit (push) Successful in 6s Details
testing / lint (push) Successful in 5s Details
testing / test-integrity (push) Successful in 4s Details
tblock 2.7.3
2023-12-01 22:53:11 +01:00
.forgejo/workflows enforce file owner check for custom filter lists 2023-12-01 14:49:33 +01:00
.gitea update pr template 2023-06-07 14:12:54 +02:00
debian tblock 2.7.3 2023-12-01 22:53:11 +01:00
extra add zsh completion and refactor repo 2023-06-09 01:48:13 +02:00
scripts update package changelogs 2023-11-25 21:32:37 +01:00
tblock tblock 2.7.3 2023-12-01 22:53:11 +01:00
test enforce file owner check for custom filter lists 2023-12-01 14:49:33 +01:00
.bandit.yml fix workflow 2023-11-30 23:44:37 +01:00
.gitignore add .weblate to .gitignore 2023-06-09 02:06:00 +02:00 tblock 2.7.3 2023-12-01 22:53:11 +01:00 add code of conduct 2022-12-13 23:27:29 +01:00 add custom emails 2023-01-04 18:21:25 +01:00 update CONTRIBUTORS and CHANGELOG 2022-07-12 18:04:47 +02:00
LICENSE Added python code, Makefile and devscripts 2021-04-19 00:36:03 +02:00 change repository structure 2021-12-22 15:37:48 +01:00
Makefile update spec & makefile 2023-07-31 19:03:27 +02:00 update readme 2023-06-09 01:48:56 +02:00 add custom emails 2023-01-04 18:21:25 +01:00
pyproject.toml install is deprecated 2022-07-13 00:58:48 +02:00
requirements.txt update requirements,txt; fixes #58 2022-12-11 13:43:44 +01:00
setup.cfg update makefile 2023-07-06 15:10:01 +02:00 add option to not download filter lists 2023-03-07 23:45:49 +01:00
tblock.spec tblock 2.7.3 2023-12-01 22:53:11 +01:00


Awesome Humane Tech Pipeline status Please don't upload to GitHub


TBlock is a free and open-source system-wide ad-blocker that is compatible with most filter list formats.

To view the repository for the graphical user interface, click here.


You can easily install TBlock with:

pipx install tblock

More installation methods — such as Windows installer and packages for Linux distributions — can be found on the website.


After installing, you need to setup TBlock in order to enable protection against ads and trackers:

tblock --init

You can learn more by reading the documentation.




Here is a list of the upcoming changes in TBlock code. Suggestions are, of course, welcome.

  • Implement a GUI for TBlock
  • Rewrite the entire code, make a clearer public API and publish release 3.0.0


Everyone is welcome to contribute to TBlock in different ways. Bug reports can be made directly from the Gitea issue tracker, by sending an email to the team or in our Matrix room.

If you want to suggest a modification in the code, you can open a pull request or send your patch using email or Matrix.

If you want to be a beta-tester, you can install the latest beta version from our release page and contact us to give a feedback.

You can find more information on how to contribute here.


The best way to support is to contribute. If you want, you can also make a donation.

Authors and acknowledgment

TBlock is currently mainained by Twann, who is also its creator. A big thank you to all the people who contribute(d) to the project.


Here is a list of all libraries used in the project:

Name Author License
colorama Jonathan Hartley BSD
requests Kenneth Reitz Apache 2.0
urllib3 Andrey Petrov MIT
argumentor Twann LGPLv3

It is also worth mentioning pacman, from which TBlock's command-line design is highly inspired.




This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see