Skip to main content

An anticapitalist ad-blocker that uses the hosts file

Project description

TBlock Logo

Copr build status PyPI Version PyPI Downloads License AUR Votes Remote repository filters count Syntax supported count Mastodon Follow

Summary

About

TBlock is a free and open-source ad-blocker, written in Python. It uses the hosts file to block advertising and tracking domains, which means it protects your whole system against these domains. TBlock is compatible with most of filter formats, and also has a built-in filter converter, to help you share your custom filters with people that are using different ad-blockers.

Features

  • Free and open-source software
  • Easy to install
  • Does not cost any money
  • Does not track your personal data
  • Does not make you fingerprintable, unlike some ad-blocking browser extensions
  • Fast rules parsing
  • Blocks ads for your whole operating system
  • Compatible with most filter formats
  • Has an online filter repository to help you find and subscribe to filters in an easier way
  • Has a built-in filter converter

Installation

There are various methods to install TBlock. You need to install TBlock as root, since superuser privileges are required to edit the hosts file.

With python

This is the fastest and easiest way to install TBlock on your machine. Simply run the following command:

$ sudo pip install tblock

Other installation methods

More installation methods can be found on our website:

More installation methods

Manually

To build and install TBlock manually, run the following:

$ git clone https://codeberg.org/tblock/tblock.git
$ cd tblock
$ make
$ sudo make install

Post-installation

After the installation and after each update of TBlock, you should update your local version of the remote filter repository, by running:

$ sudo tblock -Y

Usage

Blocking a domain with TBlock

To show the help page of TBlock, simply run:

$ tblock -h

To show the help page of the built-in converter, simply run:

$ tblockc -h

You can find more help about usage on TBlock's wiki.

Copyright

TBlock and its converter are released under GPLv3.

Libraries used

TBlock uses the external libraries:

Name Author License Homepage
colorama Jonathan Hartley BSD https://github.com/tartley/colorama
requests Kenneth Reitz Apache 2.0 https://requests.readthedocs.io
urllib3 Andrey Petrov MIT https://urllib3.readthedocs.io/

Contact

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tblock-1.1.0.tar.gz (45.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

tblock-1.1.0-py3-none-any.whl (48.4 kB view details)

Uploaded Python 3

File details

Details for the file tblock-1.1.0.tar.gz.

File metadata

  • Download URL: tblock-1.1.0.tar.gz
  • Upload date:
  • Size: 45.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/3.10.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.5

File hashes

Hashes for tblock-1.1.0.tar.gz
Algorithm Hash digest
SHA256 224449a528c36b5b651d0b355e162ef0e2b307e404959c561ae125e52f5a4663
MD5 8a4981b14aab97d070256cf81c40d65e
BLAKE2b-256 2aa4fedc88201ae746c526bc02c0883303e1b0dbc8350ee460cdaa57d9479786

See more details on using hashes here.

File details

Details for the file tblock-1.1.0-py3-none-any.whl.

File metadata

  • Download URL: tblock-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 48.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/3.10.0 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.59.0 CPython/3.9.5

File hashes

Hashes for tblock-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 67f84a4fe7092383fb9798bdfa9d35bc3730d7d6240ae8ca4bbf8882cba0c451
MD5 9b7d3690d2de63eb3f70141036f0b7dd
BLAKE2b-256 295fdc9ded64c835571a343eefa05eafcd86507c6aab9c7ad41e046d6d9e2d0c

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page