PeerTube app for YunoHost

Overview

What is PeerTube ?

PeerTube is a federated (ActivityPub) video streaming platform using P2P (BitTorrent) directly in the web browser, using WebTorrent.

Why PeerTube ?

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

So we need to have a decentralized network of servers seeding videos (as Hubzilla YunoHost, Friendica YunoHost,Mastodon YunoHost), Diaspora (Diaspora YunoHost),Funkwhale (Funkwhale YunoHost)). 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, we can make P2P (thus BitTorrent) inside the web browser, as of today.

Why is that cool ?

Servers are run independently by different people and organizations. They can apply wildly different moderation policies, so you can find or make one that fits your taste perfectly.

By watching a video, you help the hosting provider to broadcast it by becoming a broadcaster of the video yourself. Each instance doesn’t need much money to broadcast the videos of its users.

Shipped version: 1.3.1

Screenshots

Demo

Want to see in action?

• Here are the list of instances ran by people around the world. Be a part of it.

Installation

Following command line examples have been updated for ovh virtual machine, according to indications in Chocobozzz/PeerTube#830 (comment)

If you are NOT hosted on OVH virtual machine or experiencing gyp ERR! configure error, please switch back to master branch

Guidelines

1. Require dedicated domain like peertube.domain.tld.

2. No LDAP support (blocked until PeerTube core upstream implements it)

3. URL can not be changed once selected. Choose the domain wisely.

4. You need more then 1GB of ram. If you don't have it, please create a swap memory.

   $ dd if=/dev/zero of=/swapfile bs=1024 count=1048576
   $ mkswap /swapfile
   $ swapon /swapfile
   $ echo "/swapfile swap swap defaults 0 0" >> /etc/fstab
   

5. This app is multi-instance (you can have more then one PeerTube instance running on a YunoHost server)

Installing guide

1. App can be installed by running following commands:

    $ sudo yunohost app install https://github.com/YunoHost-Apps/peertube_ynh/tree/ovh_fix
    $ cd /var/www/peertube && sudo yarn install --production --pure-lockfile
    $ sudo systemctl restart peertube
   

2. Admin username is : root.

3. Admin password will be sent to the email address given at the time of the installation.

4. TLS and starttls are disabled for the outgoing mails. If you intent to use email address not hosted on your local server,it's advised to have a proper SMTP configured with tls and starttls settings by editing /var/www/peertube/config/production.yml.

Update Guide

1. App can be updated with the following commands:

     $ sudo yunohost app upgrade -u https://github.com/YunoHost-Apps/peertube_ynh/tree/ovh_fix peertube
     $ cd /var/www/peertube && sudo yarn install --production --pure-lockfile
     $ sudo systemctl restart peertube
   

Dependencies

• NodeJS, PostgreSQL.
• On Debian Jessie,backport is added for the ffmpeg package.

Documentation

• Official documentation: https://docs.joinpeertube.org/

YunoHost specific features

Supported architectures

• x86-64b -
• ARMv8-A -
• Jessie x86-64b -

Links

• Report a bug: https://github.com/YunoHost-Apps/peertube_ynh/issues
• App website: https://joinpeertube.org/fr/
• GitHub App website: https://github.com/Chocobozzz/PeerTube/
• YunoHost website: https://yunohost.org/

---

Developers info

Only if you want to use a testing branch for coding, instead of merging directly into master. Please do your pull request to the testing branch.

To try the testing branch, please proceed like that.

sudo yunohost app install https://github.com/YunoHost-Apps/peertube_ynh/tree/testing --debug
or
sudo yunohost app upgrade peertube -u https://github.com/YunoHost-Apps/peertube_ynh/tree/testing --debug