Twann edited this page 5 months ago


Good steps for beginners

If you have never used TBlock before, you should read the project README. You should also check out the wiki to understand more about how to use TBlock and its converter.

You can also check the manpage of TBlock, by running:

man tblock

What are the benefits of using TBlock ?

There are several reasons why you should use TBlock.

  • 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

What is the hosts file ?

TBlock uses it to block ads. In fact, the hosts file is a specific file that is present in every operating system. On GNU/Linux systems, for example, the hosts file is located under /etc/hosts.

If you understand what it means, it does almost the same thing as a DNS server, which means you can redirect any domain name, such as example.org to the IP address of your choice.

Therefore, you can redirect (this is purely theorical, of course) www.microsoft.com to the IP address of the Linux Kernel git repositories (, by adding the following line into your hosts file:    www.microsoft.com

If you do that, every time you want to consult www.microsoft.com, you will see the page of the Linux Kernel git repositories.

But you can also redirect a domain into the localhost (, which is the local address of your system. If you use Apache or nginx, you should already know what this is.

That way, when online websites will try to connect to advertising domains, they will if fact connect to the localhost, and won't be able to load ads.

Is TBlock available on Windows ?

Yes, it is. If you have Python installed, you can simply install the module. Otherwise, you can download the installer. Don't forget to read the post-installation instructions specific to Windows.