Definition:
PeerTube is free and open-source video hosting and playback software that lets organizations and communities run their own platforms and connect them through open protocols. It is not one website or a centralized service: each server, known as an instance, has its own operator, rules and catalogue.
Instances can federate to exchange information about channels, videos, subscriptions and comments. PeerTube belongs to the fediverse and uses ActivityPub to communicate with other compatible servers and applications.
The project combines conventional HTTP delivery with optional peer-to-peer mechanisms and video mirroring between servers. It is designed to support distributed video infrastructure without turning PeerTube into a single provider equivalent to YouTube.
Índice de contenidos
How a PeerTube instance works
An instance is a server running PeerTube. Its administration decides whether registration is open, how much storage each account receives, which content is accepted, which features are enabled and which servers it connects to. The experience can therefore differ between two platforms using the same software.
People create an account on a particular instance and publish videos in one or more channels. The server stores the files and metadata, processes the required versions and provides the web player. It may also support live streaming when its administrator enables and configures that feature.
An account is not required to watch all public content. Uploading videos, commenting where permitted or managing subscriptions from PeerTube normally requires one. The official documentation explains how to choose a platform and create an account.
Federation through ActivityPub
PeerTube uses ActivityPub to communicate activities between servers. One instance can follow another and display some of its videos, while accounts and channels can also be followed from compatible services.
Federation expands discovery without copying the entire global catalogue into a central database. Each administrator decides which instances to follow, which to block and which remote content to display. Search results and recommendations can therefore vary according to the server from which they are viewed.
Compatibility with other fediverse applications does not mean that all of them provide the same features. A Mastodon account may follow certain PeerTube channels and receive their posts, but video playback, management and publishing still depend on PeerTube and the origin instance.
Video delivery and P2P technology
Video can be delivered over HTTP from the server and, when enabled, through P2P exchanges between browsers. PeerTube uses technologies related to WebTorrent and WebRTC so that some people watching a video can share segments with other viewers during playback.
This mechanism can reduce some of the server’s bandwidth use, particularly when many people watch the same content at once. It does not remove the need for hosting, storage, transcoding or network capacity, and users or administrators can restrict or disable P2P participation.
An instance can also keep redundant copies of videos hosted elsewhere. This server redundancy can distribute load and improve availability, but it consumes storage and requires an explicit administrative policy. It does not mean that every instance automatically stores all federated content.
Features for viewers and creators
Available functions depend on the version, plugins and configuration of each instance. The project supplies common video publishing and viewing tools without imposing one community or funding model.
- Publishing: Uploading, importing, scheduling and organizing videos in channels and playlists.
- Playback: Multiple qualities, speed controls, full-screen mode, captions and downloads when permitted.
- Live streaming: One-off or recurring streams through compatible software and RTMP configuration.
- Accessibility: Captions, synchronized transcripts and chapters when supplied with the content.
- Distribution: Direct links, an embeddable player, RSS and following through federated applications.
- Customization: Themes, plugins, registration policies, quotas and moderation options managed by each server.
An official mobile app also provides discovery, playback, downloads and video management across the network. The app does not make the ecosystem a centralized service: accounts and files remain associated with the instances that host them.
Origins and development
PeerTube was started in 2015 by the developer known as Chocobozzz. The French non-profit association Framasoft later took responsibility for its development and ran funding campaigns to turn the prototype into a publicly maintained tool.
The code is released under a free software licence and developed openly. Its name combines peer-to-peer networking with video, although the current system does not rely exclusively on P2P delivery.
The JoinPeerTube website explains the project and helps people discover platforms. Framasoft develops the software, but it does not administer every instance or control content published by independent operators.
Differences from YouTube and limitations
YouTube is a platform operated by one company. PeerTube is deployable software that distributes decisions, costs and moderation among many operators. It can be used without behavioural advertising, but each instance determines its funding, terms and data practices.
Decentralization provides autonomy and diversity but introduces complexity. Users must choose a server, catalogues are not identical, an instance may close, and the resources available for storage, transcoding and moderation depend on its operator. Federation also does not guarantee that a video is visible from every server.
PeerTube does not provide anonymity, end-to-end encryption or freedom from moderation by itself. The origin server receives technical data needed to provide the service and can enforce restrictions. Before registering or publishing, users should review the operator, rules, privacy policy, backups and export options of the chosen instance.