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.
V.G. Bulavintsev b54dc80b2f small change 4 years ago
.github ISSUE_TEMPLATE: reorder sections a bit 5 years ago
.sonar from __future__ import absolute_import, print_function 4 years ago
Tribler small change 4 years ago
TriblerGUI correct tribler not starting 4 years ago
debian Updated documentation 4 years ago
doc Fixed easy flake8 issues 4 years ago
mac Restore names of original author's 6 years ago
systemd Not expanding variable in tunnel helper service 4 years ago
twisted/plugins Removed mainline_dht configuration options 4 years ago
win Updated documentation 4 years ago
.coveragerc Removed Dispersy and related code 4 years ago
.gitignore small fixes 4 years ago
.gitmodules Removed Dispersy and related code 4 years ago
.pylintrc Removed Dispersy and related code 4 years ago
.style.yapf Add yapf config 7 years ago
COPYING.LESSER Update LGPL license to v3 and have it also apply to TriblerGUI 6 years ago
LICENSE Update LGPL license to v3 and have it also apply to TriblerGUI 6 years ago
README.rst Point README.rst badge to stable release 4 years ago Fix Python 3 syntax errors 4 years ago Rework GUI to support GigaChannel 4 years ago
logger.conf Refactor search endpoint 4 years ago
release_key.gpg Update release key 6 years ago Fixed Python 3 compatibility issues 4 years ago Removed pymdht 4 years ago macports 6 years ago
tribler.spec Updated documentation 4 years ago



|jenkins_build| |contributors| |pr_closed| |issues_closed| |downloads_7_0| |downloads_7_1| |doi| |openhub|

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

Developers usually hang out in the official IRC channel #tribler @ FreeNode (click `here <>`_ for direct a webchat window)

We use our own dedicated Tor-like network for anonymous torrent downloading. We implemented and enhanced the *Tor protocol specifications* plus merged them with Bittorrent streaming. More info:
Tribler includes our own Tor-like onion routing network with hidden services based seeding and end-to-end encryption, detailed specs:

The aim of Tribler is giving anonymous access to online (streaming) videos. We are trying to make privacy, strong cryptography and authentication the Internet norm.

Tribler currently offers a Youtube-style service. For instance, Bittorrent-compatible streaming, fast search, thumbnail previews and comments. 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).

**We make use of submodules, so remember using the --recursive argument when cloning this repo.**

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 :).

Setting up your development environment

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. See `our Linux development guide <>`_ for the guide on setting up a development environment on Linux distributions. See `our Windows development guide <>`_ for setting everything up on Windows. See `our OS X development guide <>`_ for the guide to setup the development environment on macOS.

Running Tribler from the repository

First clone the repository:

.. code-block:: none

git clone --recursive

or, if you haven't added your ssh key to your github account:

.. code-block:: none

git clone --recursive

Second, install the `dependencies <doc/development/development_on_linux.rst>`_.

Now you can run tribler by executing the ```` script on the root of the repository:

.. code-block:: none


On Windows, you can use the following command to run Tribler:

.. code-block:: none


Packaging Tribler

We have written guides on how to package Tribler for distribution on various systems. Please take a look `here <>`_.

Submodule notes

- As updated submodules are in detached head state, remember to check out a branch before committing changes on them.
- If you forgot to check out a branch before doing a commit, you should get a warning telling you about it. To get the commit to a branch just check out the branch and do a git cherry-pick of the commit.
- Take care of not accidentally committing a submodule revision change with ``git commit -a``.
- Do not commit a submodule update without running all the tests first and making sure the new code is not breaking Tribler.

.. |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.0)

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

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