An anti-capitalist ad-blocker that uses the hosts file https://tblock.codeberg.page/
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Twann 3ab50d424f
fix codestyle pipeline
1 week ago
.gitea add PR template 2 months ago
assets tblock 2.5.0-beta.1 1 month ago
debian prepare for 2.6.0 1 week ago
docs multiple changes regarding verbosity 2 months ago
scripts prepare for 2.6.0 1 week ago
tblock prepare for 2.6.0 1 week ago
test update tests 2 months ago
.bandit.yml multiple changes 1 year ago
.gitignore remove pandoc from build deps 5 months ago
.gitlab-ci.yml update tests 2 months ago
CHANGELOG.md prepare for 2.6.0 1 week ago
CONTRIBUTING.md update changelog 5 months ago
CONTRIBUTORS.md update CONTRIBUTORS and CHANGELOG 5 months ago
LICENSE Added python code, Makefile and devscripts 2 years ago
MANIFEST.in change repository structure 12 months ago
Makefile reduce Makefile size 1 month ago
README.md update README 1 month ago
VERSIONING.md add SemVer specifications 6 months ago
pyproject.toml setup.py install is deprecated 5 months ago
requirements.txt add support for tblock filter format v2 4 months ago
setup.cfg fix codestyle pipeline 1 week ago
setup.py allow daemon to be launched with python 3 months ago
tblock.spec prepare for 2.6.0 1 week ago

README.md

TBlock logo

TBlock

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

Description

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

Features

  • Blocks ads and trackers system-wide
  • Compatible with most filter list formats
  • Has an online repository to help you find and subscribe to popular blocklists in an easy way
  • Has a built-in filter list converter
  • Has a built-in daemon that regularly updates the filter lists and prevents your hosts file from being modified by other programs and users

Installation

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.

Usage

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.

Roadmap

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

  • Mark filter lists that are included in another list as subscribed when the user subscribes to the list
  • Allow virtual filter lists to exist (would act as a "group", like base-devel does on Arch Linux)*
  • Implement a GUI for TBlock
  • Rewrite the entire code, make a clearer public API and publish release 3.0.0

*This feature is now available as profiles.

Contributing

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.

Support

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.

Credits

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.

Contact

Screenshots

License

GPLv3

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 https://www.gnu.org/licenses/.