Go to file
Chocobozzz c5a8be2b62 Rename webtorrent files (process/node) 2016-02-06 16:22:39 +01:00
config Make the network auto sufficient (eject bad pods with scores) 2015-11-24 08:33:59 +01:00
controllers Rename webtorrent files (process/node) 2016-02-06 16:22:39 +01:00
helpers Error handling mini refractoring 2016-02-05 19:02:05 +01:00
initializers Split models 2016-02-04 21:10:33 +01:00
lib Rename webtorrent files (process/node) 2016-02-06 16:22:39 +01:00
middlewares Error handling mini refractoring 2016-02-05 19:02:05 +01:00
models Move the creation of requests in lib instead of model for poolrequests 2016-02-05 19:41:22 +01:00
public Finalise the join in a network and add the ability to quit it 2016-01-23 18:31:58 +01:00
scripts Add checks to the scripts (they has to be executed at the root of the 2015-11-24 09:53:27 +01:00
tests Rename webtorrent files (process/node) 2016-02-06 16:22:39 +01:00
views Finalise the join in a network and add the ability to quit it 2016-01-23 18:31:58 +01:00
.gitignore Add test4,5,6 to directories to ignore 2016-01-09 10:41:57 +01:00
.travis.yml update modules AND REMOVE SUPPORT OF NODE 0.12 :'( 2016-01-24 16:41:19 +01:00
ARCHITECTURE.md Spawn 2015-10-29 23:14:54 +01:00
Gruntfile.js New directory organization 2016-01-30 17:05:22 +01:00
LICENSE Initial commit 2015-10-29 23:09:42 +01:00
README.md update modules AND REMOVE SUPPORT OF NODE 0.12 :'( 2016-01-24 16:41:19 +01:00
package.json Update lodash and webtorrent modules 2016-02-06 16:12:08 +01:00
server.js Rename webtorrent files (process/node) 2016-02-06 16:22:39 +01:00

README.md

PeerTube

Build Status Dependencies Status

Prototype of a decentralized video streaming platform using P2P (bittorrent) directly in the web browser with webtorrent.

js-standard-style

Why

We can't build a FOSS video streaming alternatives to YouTube, Dailymotion, Vimeo... with a centralized software. One organization alone cannot have enought money to pay bandwith and video storage of its server.

So we need to have a decentralized network (as Diaspora for example). But it's not enought 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, we can make P2P (thus bittorrent) inside the web browser right now.

Features

  • Frontend
    • Simple frontend (All elements are generated by jQuery)
    • AngularJS frontend
  • Join a network
    • Generate a RSA key
    • Ask for the friend list of other pods and make friend with them
    • Get the list of the videos owned by a pod when making friend with it
    • Post the list of its own videos when making friend with another pod
  • Quit a network
  • Upload a video
    • Seed the video
    • Send the meta data to all other friends
  • Remove the video
  • List the videos
  • Search a video name (local index)
  • View the video in an HTML5 page with webtorrent
  • Manage user accounts
    • Inscription
    • Connection
    • Account rights (upload...)
  • Make the network auto sufficient (eject bad pods etc)
  • Manage API breaks
  • Add "DDOS" security (check if a pod don't send too many requests for example)

Usage

Front compatibility

  • Chromium
  • Firefox (>= 42 for MediaSource support)

Dependencies

  • NodeJS >= 4.2
  • Grunt-cli (npm install -g grunt-cli)
  • OpenSSL (cli)
  • MongoDB
  • xvfb-run libgtk2.0-0 libgconf-2-4 libnss3 libasound2 libxtst6 libxss1 (for electron)

Test It!

$ git clone https://github.com/Chocobozzz/PeerTube
$ cd PeerTube
# npm install -g electron-prebuilt
$ npm install
$ npm start

Test with 3 fresh nodes

$ scripts/clean_test.sh
$ scripts/run_servers.sh

Then you will can access to the three nodes at http://localhost:900{1,2,3}. If you call "make friends" on http://localhost:9002, the pod 2 and 3 will become friends. Then if you call "make friends" on http://localhost:9001 it will become friend with the pod 2 and 3 (check the configuration files). Then the pod will communicate with each others. If you add a video on the pod 3 you'll can see it on the pod 1 and 2 :)

Dockerfile

You can test it inside Docker with the PeerTube-Docker repository. Moreover it can help you to check how to create an environment with the required dependencies for PeerTube on a GNU/Linux distribution.

Architecture

See ARCHITECTURE.md for a more detailed explication.

Backend

  • The backend whould be a REST API
  • Servers would communicate with each others with it
    • Each server of a network has a list of all other servers of the network
    • When a new installed server wants to join a network, it just has to get the list of the servers via one server and tell them "Hi I'm new in the network, communicate with me too please"
    • Each server has its own users who query it (search videos, where the torrent URI of this specific video is...)
    • Server begins to seed and sends to the other servers of the network the video information (name, short description, torrent URI) of a new uploaded video
    • Each server has a RSA key to encrypt and sign communications with other servers
  • 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 where the video was uploaded
  • A server would run webtorrent-hybrid to be a bridge with webrtc/standard bittorrent protocol
  • A network can live and evolve by expelling bad pod (with too many downtimes for example)

See the ARCHITECTURE.md for more informations. Do not hesitate to give your opinion :)

Here are some simple schemes:

Decentralized

Watch a video

Watch a video P2P

Join a network

Many networks

Frontend

There would be a simple frontend (Bootstrap, AngularJS) but since the backend is a REST API anybody could build a frontend (Web application, desktop application...). The backend uses bittorrent protocol, so users could use their favorite bittorrent client to download/play the video after having its torrent URI.