PeerTube

Federated (ActivityPub) video streaming platform using P2P (BitTorrent) directly in the web browser with WebTorrent.

We are running a crowdfunding campaign to pave the road to version 1.0 of PeerTube!

Client
Dependency Status devDependency Status

Server
Build Status Dependencies Status devDependency Status JavaScript Style Guide PeerTube Freenode IRC


screenshot

## Getting Started * **[Website](https://joinpeertube.org)** * **[Instances list](https://instances.joinpeertube.org)** ## Demonstration Want to see it in action? * Demonstration servers: * [peertube.cpy.re](https://peertube.cpy.re) * [peertube2.cpy.re](https://peertube2.cpy.re) * [peertube3.cpy.re](https://peertube3.cpy.re) * [Video](https://framatube.org/videos/watch/217eefeb-883d-45be-b7fc-a788ad8507d3) What is PeerTube? * [Video](https://peertube.cpy.re/videos/watch/f78a97f8-a142-4ce1-a5bd-154bf9386504) to see what the "decentralization feature" looks like * [Video](https://peertube.cpy.re/videos/watch/da2b08d4-a242-4170-b32a-4ec8cbdca701) to see the communication between PeerTube and [Mastodon](https://github.com/tootsuite/mastodon) ## Why We can't build a FOSS video streaming alternatives to YouTube, Dailymotion, Vimeo... with a centralized software. One organization alone may not have enough money to pay for bandwidth and video storage of its servers. So we need to have a decentralized network of servers seeding videos (as [Diaspora](https://github.com/diaspora/diaspora) for example). But it's not enough because one video could become famous and overload the server. It's the reason why we need to use a P2P protocol to limit the server load. Thanks to [WebTorrent](https://github.com/feross/webtorrent), we can make P2P (thus BitTorrent) inside the web browser, as of today. ## Dependencies * nginx * PostgreSQL * Redis * **NodeJS >= 8.x** * yarn * OpenSSL (cli) * **FFmpeg >= 3.x** ## Run using Docker See the [docker guide](/support/doc/docker.md) ## Run on YunoHost [![Install Peertube with YunoHost](https://install-app.yunohost.org/install-with-yunohost.png)](https://install-app.yunohost.org/?app=peertube) Peertube app for [YunoHost](https://yunohost.org). See [here](https://github.com/YunoHost-Apps/peertube_ynh) ## Production See the [production guide](/support/doc/production.md). ## Contribute/Translate/Test See the [contributing guide](/.github/CONTRIBUTING.md) to see how to test or contribute to PeerTube (write documentation, translate, develop...). Spoiler alert: you don't need to be a coder to help! ## API REST documentation Quick Start: [/support/doc/api/quickstart.md](/support/doc/api/quickstart.md) Endpoints documentation: * HTML version: [/support/doc/api/html/index.html](https://htmlpreview.github.io/?https://github.com/Chocobozzz/PeerTube/blob/develop/support/doc/api/html/index.html) * Swagger/OpenAPI schema: [/support/doc/api/openapi.yaml](/support/doc/api/openapi.yaml) ## Tools * [Import videos (YouTube, Dailymotion, Vimeo...)](/support/doc/tools.md) * [Upload videos from the CLI](/support/doc/tools.md) ## FAQ If you have a question, please try to find the answer in the [FAQ](/FAQ.md) first. ## Architecture See [ARCHITECTURE.md](/ARCHITECTURE.md) for a more detailed explanation. ### Backend * The backend is a REST API. * Servers communicate with each others with [Activity Pub](https://www.w3.org/TR/activitypub/). * Each server has its own users who query it (search videos, query where the torrent URI of this specific video is...). * If a user uploads a video, the server seeds it and sends its followers some metadata (name, short description, torrent URI...). * A server is a tracker responsible for all the videos uploaded in it. * Even if nobody watches a video, it is seeded by the server (through [WebSeed protocol](http://www.bittorrent.org/beps/bep_0019.html)) where the video was uploaded. Here are some simple schemes:

Decentralized Watch a video Watch a P2P video

## License Copyright (C) 2018 PeerTube Contributors This program is free software: you can redistribute it and/or modify it under the terms of the GNU Affero 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 Affero General Public License for more details. You should have received a copy of the GNU Affero General Public License along with this program. If not, see .