TBLOCK(1)

NAME

tblock - an anti-capitalist ad-blocker that uses the hosts file

SYNOPSIS

tblock [operation] [option(s)] [arg(s)]

DESCRIPTION

tblock is one of the various utilities provided by the free and open-source ad-blocker called TBlock. This command can be used to manage the domains to block, as well as the online sources to use in order to have an efficient protection against advertising and tracking.

OPERATIONS

  GENERAL

-1, --init
    Setup TBlock for the first time (will start a command line wizard)

-h, --help
    Show help page

-s, --status
    Show status information, such as: protection status, platform information, daemon status, rules count, active filter lists count, filter list repository version, and hosts hijack warnings.

-v, --version
    Show version and license information

  RULES

-a, --allow DOMAIN [DOMAIN(S)...]
    Allow specified domain(s). Wildcards are supported, for instance: *.example.com to allow any subdomain of example.com (example.com will however not be allowed).

-b, --block DOMAIN [DOMAIN(S)...]
    Block specified domain(s)

-r, --redirect DOMAIN [DOMAIN(S)...] [[-i, --ip] [IP]]
    Redirect specified domain(s)

-d, --delete-rule DOMAIN [DOMAIN(S)...]
    Delete rule(s) for specified domain(s)

  FILTER LISTS

-Y, --sync
    Sync the filter list repository

-S, --subscribe ID [ID(S)...]
    Subscribe to specified filter list(s)

-C, --add-custom ID SOURCE [ID(s) SOURCE(s)...]
    Subscribe to specified custom filter list(s)

-N, --rename ID NEWID [ID(S) NEWID(S)...]
    Rename specified custom filter list(s)

-R, --remove ID [ID(S)...]
    Unsubscribe from specified filter list(s)

-U, --update
    Update all filter lists

-I, --info ID [ID(S)...]
    Get information about specified filter list(s)

  HOSTS

-D, --disable
    Restore default hosts file

-E, --enable
    Enable protection again (without rebuilding hosts file)

-B, --build
    Build hosts file

-G, --gen-hosts
    Generate a default hosts file template, IPv4 and IPv6 compliant, based on the device’s hostname (if there is one, UNIX only). To write the output into the hosts file, use: tblock -G | tee /etc/hosts

  SEARCH

-l, --list-rules
    List rules

-L, --list
    List filter lists

-Q, --search
    Perform a search inside filter lists database

-W --which
    Find which filter list is managing specified domain(s)

OPTIONS

  GENERAL

-n, --no-prompt
    Do not prompt for anything

-q, --quiet
    Be the least verbose possible

  RULES

-i, --ip IP
    Specify the redirection IP address (with --redirect)

  FILTER LISTS

-y, --with-sync
    Also sync filter list repository

-u, --with-update
    Also update all filter lists

-x, --custom-syntax FORMAT
    Specify the syntax of a custom filter list

-f, --force
    Force to update filter lists or repository

  SEARCH

-e, --user
    List user rules only

-t, --standard
    List standard (filter lists) rules only

-m, --from-filters ID [ID(S)...]
    List rules coming from specific filter lists only

-c, --custom
    List custom filter lists only

-w, --on-repo
    List filter lists available on the filter list repository only

-k, --subscribing
    List subscribed filter lists only

-z, --not-subscribing
    List unsubscribed filter lists only

LINKS

•   Homepage: https://tblock.me/

•   Documentation: https://docs.tblock.me/

•   Bug tracker: https://codeberg.org/tblock/tblock/issues/

LICENSE

Copyright (C) 2021-2023 Twann

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/>.

SEE ALSO

tblockc(1), tblockd(1), hosts(5), dnsmasq(8)

AUTHORS

•   Twann