Privacy enhanced BitTorrent client with P2P content discovery
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.
Go to file
Andrei Andreev 87916f705e
Merge pull request #7285 from Tribler/feature/update_ipv8
4 days ago
.github Remove `codacy` check 1 week ago
.sonar Removed six 3 years ago
build Sign windows binaries 7 months ago
doc Add workaround for Apple Silicon 1 week ago
scripts Fixes #7253: Tribler does not run if the state directory does not already exist 2 weeks ago
src Fix `test_item_rank` 4 days ago
.dockerignore Add newline 11 months ago
.gitignore Update the build documentation 4 weeks ago
.pylintrc Refactor watch folder 5 months ago
.readthedocs.yml Add .readthedocs.yml file to use python3.8 1 year ago
COPYING.LESSER Update LGPL license to v3 and have it also apply to TriblerGUI 6 years ago
Dockerfile Change default port from 52194 to 20100 4 months ago
LICENSE Remove the byte-order-mark 4 years ago
README.rst Add the 7.12.1 downloads badge 1 month ago
bandit.yml Tune bandit 10 months ago
binary-LICENSE-postfix.txt Renamed main dirs 3 years ago
codecov.yml Disable status check for the entire project 10 months ago
docker-compose.yml Change default port from 52194 to 20100 4 months ago
pytest.ini Divide unittests into two groups 3 months ago
release_key.gpg Updated gpg release key 3 years ago
requirements-build.txt Bump setuptools from 60.0.2 to 65.5.1 1 month ago
requirements-core.txt Update `ipv8` to the version `2.10` 4 days ago
requirements-test.txt Update `ipv8` to the version `2.10` 4 days ago
requirements.txt Downgrade PyQt5-sip to avoid segmentation fault on macOS 1 week ago
tribler.spec Downgrade PyQt5-sip to avoid segmentation fault on macOS 1 week ago



|Pytest| |docs| |Codacy| |Coverage| |contributors| |pr_closed| |issues_closed|

|python_3_8| |python_3_9|

|downloads_7_0| |downloads_7_1| |downloads_7_2| |downloads_7_3| |downloads_7_4|
|downloads_7_5| |downloads_7_6| |downloads_7_7| |downloads_7_8| |downloads_7_9|
|downloads_7_10| |downloads_7_11| |downloads_7_12|

|doi| |openhub| |discord|

*Towards making Bittorrent anonymous and impossible to shut down.*

We use our own dedicated Tor-like network for anonymous torrent downloading.
We implemented and enhanced the `Tor protocol specifications <>`_.
Tribler includes our own Tor-like onion routing network with hidden services based
seeding and `end-to-end encryption <>`_.

Tribler aims to give anonymous access to content. We are trying to make privacy, strong cryptography, and authentication the Internet norm.

For the past 11 years we have been building a very robust Peer-to-Peer system.
Today Tribler is robust: "the only way to take Tribler down is to take The Internet down" (but a single software bug could end everything).

Obtaining the latest release

Just click `here <>`__ and download the latest package for your OS.

Obtaining support

If you found a bug or have a feature request, please make sure you read `our contributing page <>`_ and then `open an issue <>`_. We will have a look at it ASAP.


Contributions are very welcome!
If you are interested in contributing code or otherwise, please have a look at `our contributing page <>`_.
Have a look at the `issue tracker <>`_ if you are looking for inspiration :).

Running Tribler from the repository

We support development on Linux, macOS and Windows. We have written
documentation that guides you through installing the required packages when
setting up a Tribler development environment.

* `Linux <>`_
* `Windows <>`_
* `macOS <>`_

Packaging Tribler

We have written guides on how to package Tribler for distribution on various systems.

* `Linux <>`_
* `Windows <>`_
* `macOS <>`_

Docker support

Dockerfile is provided with the source code which can be used to build the docker image.

To build the docker image:

.. code-block:: bash

docker build -t triblercore/triblercore:latest .

To run the built docker image:

.. code-block:: bash

docker run -p 20100:20100 --net="host" triblercore/triblercore:latest

Note that by default, the REST API is bound to localhost inside the container so to
access the APIs, network needs to be set to host (--net="host").

The REST APIs are now accessible at: http://localhost:20100/docs

**Docker Compose**

Tribler core can also be started using Docker Compose. For that, a `docker-compose.yml` file is available
on the project root directory.

To run via docker compose:

.. code-block:: bash

docker-compose up

To run in detached mode:

.. code-block:: bash

docker-compose up -d

To stop Tribler:

.. code-block:: bash

docker-compose down

Get in touch!

We like to hear your feedback and suggestions. To reach out to us, you can join `our Discord server <>`_ or create a post on `our forums <>`_.

.. |jenkins_build| image::
:alt: Build status on Jenkins

.. |pr_closed| image::
:alt: Pull Requests

.. |issues_closed| image::
:alt: Issues

.. |openhub| image::

.. |downloads_7_0| image::
:alt: Downloads(7.0.2)

.. |downloads_7_1| image::
:alt: Downloads(7.1.3)

.. |downloads_7_2| image::
:alt: Downloads(7.2.2)

.. |downloads_7_3| image::
:alt: Downloads(7.3.2)

.. |downloads_7_4| image::
:alt: Downloads(7.4.1)

.. |downloads_7_5| image::
:alt: Downloads(7.5.1)

.. |downloads_7_6| image::
:alt: Downloads(7.6.1)

.. |downloads_7_7| image::
:alt: Downloads(7.7.0)

.. |downloads_7_8| image::
:alt: Downloads(7.8.0)

.. |downloads_7_9| image::
:alt: Downloads(7.9.0)

.. |downloads_7_10| image::
:alt: Downloads(7.10.0)

.. |downloads_7_11| image::
:alt: Downloads(7.11.0)

.. |downloads_7_12| image::
:alt: Downloads(7.12.1)

.. |contributors| image::
:alt: Contributors

.. |doi| image::
:alt: DOI number

.. |docs| image::
:alt: Documentation Status

.. |discord| image::
:alt: Join Discord chat

.. |python_3_8| image::

.. |python_3_9| image::

.. |Pytest| image::

.. |Codacy| image::

.. |Coverage| image::