PeerTube Project Homepage
API docs by Redocly

PeerTube (8.3.0)

Download OpenAPI specification:

URL: https://joinpeertube.org License: AGPLv3.0

The PeerTube API is built on HTTP(S) and is RESTful. You can use your favorite HTTP/REST library for your programming language to use PeerTube.

See the REST API quick start for a few examples of using the PeerTube API.

https://docs.joinpeertube.org/api-rest-reference.html

Authentication

When you sign up for an account on a PeerTube instance, you are given the possibility to generate sessions on it, and authenticate there using an access token. Only one access token can currently be used at a time.

Roles

Accounts are given permissions based on their role. There are three roles on PeerTube: Administrator, Moderator, and User. See the roles guide for a detail of their permissions.

Errors

The API uses standard HTTP status codes to indicate the success or failure of the API call, completed by a RFC7807-compliant response body.

HTTP 1.1 404 Not Found
Content-Type: application/problem+json; charset=utf-8

{
  "detail": "Video not found",
  "docs": "https://docs.joinpeertube.org/api-rest-reference.html#operation/getVideo",
  "status": 404,
  "title": "Not Found",
  "type": "about:blank"
}

We provide error type (following RFC7807) and code (internal PeerTube code) values for a growing number of cases, but it is still optional. Types are used to disambiguate errors that bear the same status code and are non-obvious:

HTTP 1.1 403 Forbidden
Content-Type: application/problem+json; charset=utf-8

{
  "detail": "Cannot get this video regarding follow constraints",
  "docs": "https://docs.joinpeertube.org/api-rest-reference.html#operation/getVideo",
  "status": 403,
  "title": "Forbidden",
  "type": "https://docs.joinpeertube.org/api-rest-reference.html#section/Errors/does_not_respect_follow_constraints"
}

Here a 403 error could otherwise mean that the video is private or blocklisted.

Validation errors

Example:

HTTP 1.1 400 Bad Request
Content-Type: application/problem+json; charset=utf-8

{
  "detail": "Incorrect request parameters: id",
  "docs": "https://docs.joinpeertube.org/api-rest-reference.html#operation/getVideo",
  "instance": "/api/v1/videos/9c9de5e8-0a1e-484a-b099-e80766180",
  "invalid-params": {
    "id": {
      "location": "params",
      "msg": "Invalid value",
      "param": "id",
      "value": "9c9de5e8-0a1e-484a-b099-e80766180"
    }
  },
  "status": 400,
  "title": "Bad Request",
  "type": "about:blank"
}

Where id is the name of the field concerned by the error, within the route definition. invalid-params.<field>.location can be either 'params', 'body', 'header', 'query' or 'cookies'. invalid-params.<field>.value reports the value that didn't pass validation whose invalid-params.<field>.msg is about.

max_file_size_reached

The uploaded file exceeds the instance-wide file size limit.

quota_reached

The uploaded file exceeds the user's storage quota.

does_not_respect_follow_constraints

The requested remote resource cannot be accessed because the instance does not follow its origin.

live_not_enabled

Live streaming is not enabled on the instance.

live_not_allowing_replay

Saving live replays is disabled on this instance, so a live cannot be created or updated with saveReplay enabled.

live_conflicting_permanent_and_save_replay

Not returned by PeerTube anymore: permanent lives can save replays.

max_instance_lives_limit_reached

The instance has reached its maximum number of simultaneous live streams.

max_user_lives_limit_reached

The user has reached the maximum number of simultaneous live streams.

incorrect_files_in_torrent

The torrent does not contain exactly one usable video file.

comment_not_associated_to_video

The comment is not associated with the requested video.

invalid_grant

The OAuth grant or refresh token is invalid.

invalid_client

Client authentication failed.

invalid_token

The access token is expired, revoked, malformed, or otherwise invalid.

unauthorized_request

The endpoint requires authentication but no access token was provided.

invalid_request

The authentication or token request is malformed: missing grant_type, malformed Authorization header, access token sent using more than one method, or sent in the query string.

unsupported_grant_type

The grant_type is not supported. PeerTube supports password and refresh_token.

unauthorized_client

The OAuth client is not allowed to use the requested grant_type.

server_error

An unexpected error occurred while checking the access token.

missing_two_factor

The required two-factor authentication header is missing.

too_long_password

The password exceeds the maximum allowed length.

invalid_two_factor

The two-factor authentication code is invalid.

account_blocked

The account is blocked.

email_not_verified

The account email address has not been verified.

account_waiting_for_approval

The account is waiting for administrator approval.

account_approval_rejected

The account approval request was rejected.

runner_job_not_in_processing_state

The runner job is not in the processing state.

runner_job_not_in_pending_state

The runner job is not in the pending state.

unknown_runner_token

The runner token is unknown.

video_requires_password

A password is required to access the video.

incorrect_video_password

The password provided for the video is incorrect.

video_already_being_transcoded

The video is already being transcoded.

video_already_being_transcribed

The video is already being transcribed.

video_already_has_captions

The video already has captions.

max_user_video_quota_exceeded_for_user_export

The user requested an export including video files, but the total size of their videos is above the maximum allowed by the instance for such exports. Request an export without video files instead.

current_password_is_invalid

The current password is invalid.

current_password_is_missing

The action requires a password confirmation but currentPassword is missing.

password_confirmation_unavailable

The action requires a password confirmation but the user authenticates with an external auth plugin (OpenID Connect, SAML...), so PeerTube cannot check their password.

Rate limits

We are rate-limiting all endpoints of PeerTube's API. Custom values can be set by administrators:

Endpoint (prefix: /api/v1) Calls Time frame
/* 50 10 seconds
POST /users/token 15 5 minutes
POST /users/register 2* 5 minutes
POST /users/ask-send-verify-email 3 5 minutes

Depending on the endpoint, *failed requests are not taken into account. A service limit is announced by a 429 Too Many Requests status code.

You can get details about the current state of your rate limit by reading the following headers:

Header Description
X-RateLimit-Limit Number of max requests allowed in the current time period
X-RateLimit-Remaining Number of remaining requests in the current time period
X-RateLimit-Reset Timestamp of end of current time period as UNIX timestamp
Retry-After Seconds to delay after the first 429 is received

Password confirmation

If the webadmin.password_confirmation.enabled setting is enabled (default), sensitive administrator actions require the user password in the currentPassword field of the request body:

  • Install or update a plugin/theme
  • Change the custom JavaScript or CSS of the instance (instance.customizations of the custom configuration)
  • Create an administrator, or give the administrator role to a user
  • Change the password, email or auth plugin (pluginAuth) of an administrator

After 10 failed password confirmations in 10 minutes (configurable), the user receives a 429 Too Many Requests status code until the end of the time frame, even with the correct password.

CORS

This API features Cross-Origin Resource Sharing (CORS), allowing cross-domain communication from the browser for some routes:

| Endpoint | |------------------------- ---| | /api/* | | /download/* | | /lazy-static/* | | /.well-known/webfinger |

In addition, all routes serving ActivityPub are CORS-enabled for all origins.

Static Video Files

Get public Web Video file

PeerTube >= 6.0

path Parameters
filename
required
string

Filename

Responses

Get private Web Video file

PeerTube >= 6.0

Authorizations:
OAuth2
path Parameters
filename
required
string

Filename

query Parameters
videoFileToken
string

Video file token generated by PeerTube so you don't need to provide an OAuth token in the request header.

Responses

Get public HLS video file

Authorizations:
OAuth2
path Parameters
filename
required
string

Filename

Responses

Get private HLS video file

Authorizations:
OAuth2
path Parameters
filename
required
string

Filename

query Parameters
reinjectVideoFileToken
boolean

Ask the server to reinject videoFileToken in URLs in m3u8 playlist

videoFileToken
string

Video file token generated by PeerTube so you don't need to provide an OAuth token in the request header.

Responses

Video Download

Download video files

Download video file

Generate a mp4 container that contains at most 1 video stream and at most 1 audio stream. Mainly used to merge the HLS audio only video file and the HLS video only resolution file.

path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

Video id or UUID

query Parameters
videoFileIds
required
Array of integers

streams of video files to mux in the output

videoFileToken
string

Video file token generated by PeerTube so you don't need to provide an OAuth token in the request header.

Responses

Video Feeds

Server syndication feeds of videos

Comments on videos feeds

path Parameters
format
required
string
Enum: "xml" "rss" "rss2" "atom" "atom1" "json" "json1"

format expected (we focus on making rss the most feature-rich ; it serves Media RSS)

query Parameters
accountId
string

limit listing comments to videos of a specific account

accountName
string

limit listing comments to videos of a specific account

isLocal
boolean

PeerTube >= 9.0 Display only comments of local or remote accounts

onLocalVideo
boolean

PeerTube >= 9.0 Display only comments of local or remote videos

videoChannelId
string

limit listing comments to videos of a specific video channel

videoChannelName
string

limit listing comments to videos of a specific video channel

videoId
string

limit listing comments to a specific video

Responses

Response samples

Content type
<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom">
    <channel>
        <title>PeerTube Nightly</title>
        <link>https://peertube2.cpy.re</link>
        <description>This instance is a test instance of the PeerTube project. It is updated to the latest commit in the develop branch every business day, 8pm CET.</description>
        <lastBuildDate>Sat, 07 Nov 2026 04:03:47 GMT</lastBuildDate>
        <docs>https://validator.w3.org/feed/docs/rss2.html</docs>
        <generator>PeerTube - https://peertube2.cpy.re</generator>
        <image>
            <title>PeerTube Nightly</title>
            <url>https://peertube2.cpy.re/lazy-static/avatars/82936e50-9560-42e7-9e4b-d96309f5c9c9.png</url>
            <link>https://peertube2.cpy.re</link>
        </image>
        <copyright>All rights reserved, unless otherwise specified in the terms specified at https://peertube2.cpy.re/about and potential licenses granted by each content's rightholder.</copyright>
        <atom:link href="https://peertube2.cpy.re/feeds/video-comments.xml?scope=local" rel="self" type="application/rss+xml"/>
        <item>
            <title><![CDATA[#climateCrisis , #llm s, #emacs ... #symbolics #lisp, #executeableArchaeology Kent Pitman John Hardy #lispyGopherClimate - Achy1les]]></title>
            <link>https://peertube2.cpy.re/w/ogFTHRwVNXm4GXmkNyqg58;threadId=196567</link>
            <guid>https://peertube2.cpy.re/w/ogFTHRwVNXm4GXmkNyqg58;threadId=196567</guid>
            <pubDate>Fri, 06 Nov 2026 22:37:09 GMT</pubDate>
            <content:encoded><![CDATA[<p>@screwtape@toobnix.org Ok. I am not saying that it is a YT link. I just asked how do you use jitsi for live streaming videos in this platform. Because when I paste my rtmp url from my account here, jitsi only accepts rtmp to live stream on YouTube...</p>
]]></content:encoded>
            <dc:creator>Achy1les</dc:creator>
        </item>
        <item>
            <title><![CDATA[#climateCrisis , #llm s, #emacs ... #symbolics #lisp, #executeableArchaeology Kent Pitman John Hardy #lispyGopherClimate - Lispy Gopher Climate w/ screwlisp]]></title>
            <link>https://peertube2.cpy.re/w/ogFTHRwVNXm4GXmkNyqg58;threadId=196567</link>
            <guid>https://peertube2.cpy.re/w/ogFTHRwVNXm4GXmkNyqg58;threadId=196567</guid>
            <pubDate>Fri, 06 Nov 2026 17:30:00 GMT</pubDate>
            <content:encoded><![CDATA[<p>@achy1les@video.hardlimit.com that sign is just a lie, jitsi actually accepts normal rtmp urls. WARNING THIS IS NOT A YOUTUBE LINK</p>
]]></content:encoded>
            <dc:creator>Lispy Gopher Climate w/ screwlisp</dc:creator>
        </item>
        <item>
            <title><![CDATA[Comida a Rex video con la Sony P43 - osr]]></title>
            <link>https://peertube2.cpy.re/w/weTnuKPymnyKS1SjJJFR33;threadId=196509</link>
            <guid>https://peertube2.cpy.re/w/weTnuKPymnyKS1SjJJFR33;threadId=196509</guid>
            <pubDate>Fri, 06 Nov 2026 10:55:22 GMT</pubDate>
            <content:encoded><![CDATA[<p>@abslutebeginner@masto.es Jajajaj! Es un gran compositor! muy inspirador, aunque el autor original sea Vivaldi, Max le da un toque muy cinematográfico.</p>
]]></content:encoded>
            <dc:creator>osr</dc:creator>
        </item>
        <item>
            <title><![CDATA[5 novembre : et maintenant, la grève générale ! - tibo lalu]]></title>
            <link>https://peertube2.cpy.re/w/m8ES1oU2VU1GYNd44jVkTz;threadId=196570</link>
            <guid>https://peertube2.cpy.re/w/m8ES1oU2VU1GYNd44jVkTz;threadId=196570</guid>
            <pubDate>Thu, 05 Nov 2026 22:44:23 GMT</pubDate>
            <content:encoded><![CDATA[<p><span><a href="https://video.blast-info.fr/a/blast/video-channels" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>blast</span></a></span>   </p><p>il manque une seconde sur la durée de votre vidéo</p>]]></content:encoded>
            <dc:creator>tibo lalu</dc:creator>
        </item>
        <item>
            <title><![CDATA[Comida a Rex video con la Sony P43 - Absolute Beginner  🏳️‍⚧️]]></title>
            <link>https://peertube2.cpy.re/w/weTnuKPymnyKS1SjJJFR33;threadId=196509</link>
            <guid>https://peertube2.cpy.re/w/weTnuKPymnyKS1SjJJFR33;threadId=196509</guid>
            <pubDate>Thu, 05 Nov 2026 21:31:13 GMT</pubDate>
            <content:encoded><![CDATA[<p><span><a href="https://tube.tchncs.de/a/osr/video-channels" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>osr</span></a></span> Pues imagínate que con la tontería de descubrir a Max Richter no solo he descubierto a un gran compositor de bandas sonoras y música instrumental, sino también una serie y una película que me han parecido como mínimo curiosas: My Brilliant Friend (La amiga estupenda), 2018-2024, y Spaceman (El astronauta), 2024. Ha sido un descubrimiento muy rentable. 😎 Muchas gracias.</p>]]></content:encoded>
            <dc:creator>Absolute Beginner  🏳️‍⚧️</dc:creator>
        </item>
        <item>
            <title><![CDATA[Comida a Rex video con la Sony P43 - osr]]></title>
            <link>https://peertube2.cpy.re/w/weTnuKPymnyKS1SjJJFR33;threadId=196509</link>
            <guid>https://peertube2.cpy.re/w/weTnuKPymnyKS1SjJJFR33;threadId=196509</guid>
            <pubDate>Thu, 05 Nov 2026 21:16:26 GMT</pubDate>
            <content:encoded><![CDATA[<p>@abslutebeginner@masto.es Si no es por Vivaldi el video no valdría nada jajajaj</p>
]]></content:encoded>
            <dc:creator>osr</dc:creator>
        </item>
        <item>
            <title><![CDATA[#climateCrisis , #llm s, #emacs ... #symbolics #lisp, #executeableArchaeology Kent Pitman John Hardy #lispyGopherClimate - Achy1les]]></title>
            <link>https://peertube2.cpy.re/w/ogFTHRwVNXm4GXmkNyqg58;threadId=196567</link>
            <guid>https://peertube2.cpy.re/w/ogFTHRwVNXm4GXmkNyqg58;threadId=196567</guid>
            <pubDate>Thu, 05 Nov 2026 19:29:00 GMT</pubDate>
            <content:encoded><![CDATA[<p>Hi. Guys... Could you make a video on how do you stream using jitsi-meet? I use jitsi-meet. But, for me, it only accept streaming Youtube sessions and such... Or do you just make your jitsi-meet sessions outside tobnix save it and upload outside tobnix...</p>
]]></content:encoded>
            <dc:creator>Achy1les</dc:creator>
        </item>
        <item>
            <title><![CDATA[hatniX spielt „World of Warcraft Forever“ Release! - starfarer]]></title>
            <link>https://peertube2.cpy.re/w/niW9YT45XNFBvacubNXxwN;threadId=196558</link>
            <guid>https://peertube2.cpy.re/w/niW9YT45XNFBvacubNXxwN;threadId=196558</guid>
            <pubDate>Thu, 05 Nov 2026 14:28:36 GMT</pubDate>
            <content:encoded><![CDATA[<p>@hatnix glaub ich sofort XD</p>
]]></content:encoded>
            <dc:creator>starfarer</dc:creator>
        </item>
        <item>
            <title><![CDATA[hatniX spielt „World of Warcraft Forever“ Release! - hatniX]]></title>
            <link>https://peertube2.cpy.re/w/niW9YT45XNFBvacubNXxwN;threadId=196560</link>
            <guid>https://peertube2.cpy.re/w/niW9YT45XNFBvacubNXxwN;threadId=196560</guid>
            <pubDate>Thu, 05 Nov 2026 13:54:56 GMT</pubDate>
            <content:encoded><![CDATA[<p>@starfarer Das Gewusel am Anfang war zu erwarten, es hätte auch noch dicker kommen können. Das hat sich dann alles aber recht schnell verlaufen.</p>
]]></content:encoded>
            <dc:creator>hatniX</dc:creator>
        </item>
        <item>
            <title><![CDATA[hatniX spielt „World of Warcraft Forever“ Release! - hatniX]]></title>
            <link>https://peertube2.cpy.re/w/niW9YT45XNFBvacubNXxwN;threadId=196558</link>
            <guid>https://peertube2.cpy.re/w/niW9YT45XNFBvacubNXxwN;threadId=196558</guid>
            <pubDate>Thu, 05 Nov 2026 13:52:58 GMT</pubDate>
            <content:encoded><![CDATA[<p>@starfarer Ich hab heute schon Schlimmeres gesehen ^^</p>
]]></content:encoded>
            <dc:creator>hatniX</dc:creator>
        </item>
        <item>
            <title><![CDATA[hatniX spielt „World of Warcraft Forever“ Release! - starfarer]]></title>
            <link>https://peertube2.cpy.re/w/niW9YT45XNFBvacubNXxwN;threadId=196560</link>
            <guid>https://peertube2.cpy.re/w/niW9YT45XNFBvacubNXxwN;threadId=196560</guid>
            <pubDate>Thu, 05 Nov 2026 13:43:33 GMT</pubDate>
            <content:encoded><![CDATA[<p>ich merke schon warum ich Singleplayergames bevorzuge... mir wäre das zu wuselig^^ (aber ich erstelle auch bei Unreal Tournament Botmatches ohne Bots)</p>
]]></content:encoded>
            <dc:creator>starfarer</dc:creator>
        </item>
        <item>
            <title><![CDATA[hatniX spielt „World of Warcraft Forever“ Release! - starfarer]]></title>
            <link>https://peertube2.cpy.re/w/niW9YT45XNFBvacubNXxwN;threadId=196558</link>
            <guid>https://peertube2.cpy.re/w/niW9YT45XNFBvacubNXxwN;threadId=196558</guid>
            <pubDate>Thu, 05 Nov 2026 13:36:23 GMT</pubDate>
            <content:encoded><![CDATA[<p>Loki Thunderfall ist ja mal direkt ein Immersionbreaker XD</p>
]]></content:encoded>
            <dc:creator>starfarer</dc:creator>
        </item>
        <item>
            <title><![CDATA[Changer de Système Installer Linux 4/4 - philippe.lhardy]]></title>
            <link>https://peertube2.cpy.re/w/3rXzBoUnwLymxkk7qaJSBR;threadId=196552</link>
            <guid>https://peertube2.cpy.re/w/3rXzBoUnwLymxkk7qaJSBR;threadId=196552</guid>
            <pubDate>Thu, 05 Nov 2026 11:50:41 GMT</pubDate>
            <content:encoded><![CDATA[<p>@bigpannard@pt.thoteos.synology.me</p>
<p>Dans ce cas les diapos de la présentation sont ici : <a href="https://www4.artisanlogiciel.net/nextcloud/s/eaeiirGAcfGTSM6" target="_blank" rel="noopener noreferrer">https://www4.artisanlogiciel.net/nextcloud/s/eaeiirGAcfGTSM6</a></p>
]]></content:encoded>
            <dc:creator>philippe.lhardy</dc:creator>
        </item>
        <item>
            <title><![CDATA[Changer de Système Installer Linux 4/4 - bigpannard]]></title>
            <link>https://peertube2.cpy.re/w/3rXzBoUnwLymxkk7qaJSBR;threadId=196552</link>
            <guid>https://peertube2.cpy.re/w/3rXzBoUnwLymxkk7qaJSBR;threadId=196552</guid>
            <pubDate>Thu, 05 Nov 2026 09:00:13 GMT</pubDate>
            <content:encoded><![CDATA[<p>Présentation intéressante, je vais m'en inspirer pour une présentation identique dans notre GULL en belgique</p>
]]></content:encoded>
            <dc:creator>bigpannard</dc:creator>
        </item>
        <item>
            <title><![CDATA[Reconnaissance faciale et techniques de surveillance - Noémie Levain de La Quadrature du Net - Marie_Odile_Morandi]]></title>
            <link>https://peertube2.cpy.re/w/jpdnYaV7rGtrfc6VFRLYSw;threadId=196551</link>
            <guid>https://peertube2.cpy.re/w/jpdnYaV7rGtrfc6VFRLYSw;threadId=196551</guid>
            <pubDate>Thu, 05 Nov 2026 07:12:48 GMT</pubDate>
            <content:encoded><![CDATA[<p><span><a href="https://video.lqdn.fr/a/lqdn/video-channels" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>lqdn</span></a></span> 
Transcription par <span><a href="https://pouet.april.org/@aprilorg" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>aprilorg</span></a></span>
<a href="https://www.librealire.org/surveillance-algorithmique-ce-que-peut-et-ne-peut-pas-l-etat" target="_blank" rel="noopener noreferrer"><span>https://www.</span><span>librealire.org/surveillance-al</span><span>gorithmique-ce-que-peut-et-ne-peut-pas-l-etat</span></a>
Bonne lecture !</p>]]></content:encoded>
            <dc:creator>Marie_Odile_Morandi</dc:creator>
        </item>
        <item>
            <title><![CDATA[Ecole Douteuse 2026 - Clara Egger & Raul Magni Berton - Ethique et politique de l'enquête scientifique (2) - Alex Jade]]></title>
            <link>https://peertube2.cpy.re/w/rJkCKp8z5ax31Sf4XG4anh;threadId=196550</link>
            <guid>https://peertube2.cpy.re/w/rJkCKp8z5ax31Sf4XG4anh;threadId=196550</guid>
            <pubDate>Thu, 05 Nov 2026 07:11:26 GMT</pubDate>
            <content:encoded><![CDATA[<p><span><a href="https://skeptikon.fr/a/cortecs/video-channels" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>cortecs</span></a></span>  seuls le Ric et la Sés peuvent nous donner du pouvoir et nous permettre de choisir notre emploi revalorisé <a href="https://loi-ses.org" target="_blank" rel="noopener noreferrer"><span>https://</span><span>loi-ses.org</span><span></span></a></p>]]></content:encoded>
            <dc:creator>Alex Jade</dc:creator>
        </item>
        <item>
            <title><![CDATA[Fukushima mon amour - #DATAGUEULE 32 - tif_inégalitéS.capitalisme.TTdroites.écocide.5g.pub.nuc.gafam-CRIMES]]></title>
            <link>https://peertube2.cpy.re/w/fSKNZNmGE1F9Toz8TQRoAM;threadId=196520</link>
            <guid>https://peertube2.cpy.re/w/fSKNZNmGE1F9Toz8TQRoAM;threadId=196520</guid>
            <pubDate>Wed, 04 Nov 2026 18:25:31 GMT</pubDate>
            <content:encoded><![CDATA[<p>(c) 2015</p>
]]></content:encoded>
            <dc:creator>tif_inégalitéS.capitalisme.TTdroites.écocide.5g.pub.nuc.gafam-CRIMES</dc:creator>
        </item>
        <item>
            <title><![CDATA[John Hardy, Kent M. Pitman, Ramin Honary (and screwlisp) on the #lispyGopherClimate #FP #lisp #CPM - Lispy Gopher Climate w/ screwlisp]]></title>
            <link>https://peertube2.cpy.re/w/s7sKUP8qXMppDHLVk3uksY;threadId=196506</link>
            <guid>https://peertube2.cpy.re/w/s7sKUP8qXMppDHLVk3uksY;threadId=196506</guid>
            <pubDate>Wed, 04 Nov 2026 17:16:10 GMT</pubDate>
            <content:encoded><![CDATA[<p>@me@social.jlamothe.net apparently my uploads haven't been being added to the anonradio archives for the next week either. After next week there should be a return to normalcy.</p>
]]></content:encoded>
            <dc:creator>Lispy Gopher Climate w/ screwlisp</dc:creator>
        </item>
        <item>
            <title><![CDATA[Comida a Rex video con la Sony P43 - Absolute Beginner  🏳️‍⚧️]]></title>
            <link>https://peertube2.cpy.re/w/weTnuKPymnyKS1SjJJFR33;threadId=196509</link>
            <guid>https://peertube2.cpy.re/w/weTnuKPymnyKS1SjJJFR33;threadId=196509</guid>
            <pubDate>Wed, 04 Nov 2026 14:00:04 GMT</pubDate>
            <content:encoded><![CDATA[<p><span><a href="https://tube.tchncs.de/a/osr/video-channels" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>osr</span></a></span> Interesante lo de las New Four Seasons... 😁</p>]]></content:encoded>
            <dc:creator>Absolute Beginner  🏳️‍⚧️</dc:creator>
        </item>
        <item>
            <title><![CDATA[You can run macOS applications on Linux now - terraquad]]></title>
            <link>https://peertube2.cpy.re/w/iz9936NhcYwT3AhwM3p4Ye;threadId=196508</link>
            <guid>https://peertube2.cpy.re/w/iz9936NhcYwT3AhwM3p4Ye;threadId=196508</guid>
            <pubDate>Wed, 04 Nov 2026 09:55:12 GMT</pubDate>
            <content:encoded><![CDATA[<p>Instead of creating yet another project imo they should contribute to <a href="https://github.com/darlinghq/darling" target="_blank" rel="noopener noreferrer">https://github.com/darlinghq/darling</a> .</p>
]]></content:encoded>
            <dc:creator>terraquad</dc:creator>
        </item>
    </channel>
</rss>

Common videos feeds

path Parameters
format
required
string
Enum: "xml" "rss" "rss2" "atom" "atom1" "json" "json1"

format expected (we focus on making rss the most feature-rich ; it serves Media RSS)

query Parameters
accountId
string

limit listing to a specific account

accountName
string

limit listing to a specific account

hasHLSFiles
boolean

PeerTube >= 4.0 Display only videos that have HLS files

hasWebVideoFiles
boolean

PeerTube >= 6.0 Display only videos that have Web Video files

include
integer
Enum: 0 1 2 4 8 16 32

Only administrators and moderators can use this parameter

Include additional videos in results (can be combined using bitwise or operator)

  • 0 NONE
  • 1 NOT_PUBLISHED_STATE
  • 2 BLACKLISTED
  • 4 BLOCKED_OWNER
  • 8 FILES
  • 16 CAPTIONS
  • 32 VIDEO SOURCE
isLocal
boolean

PeerTube >= 4.0 Display only local or remote objects

nsfw
string
Enum: "true" "false"

whether to include nsfw videos, if any

privacyOneOf
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

PeerTube >= 4.0 Display only videos in this specific privacy/privacies

sort
string
Example: sort=-createdAt

Sort column

videoChannelId
string

limit listing to a specific video channel

videoChannelName
string

limit listing to a specific video channel

Responses

Response samples

Content type
<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0" xmlns:podcast="https://podcastindex.org/namespace/1.0" xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:media="http://search.yahoo.com/mrss/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom">
    <channel>
        <title>PeerTube Nightly</title>
        <link>https://peertube2.cpy.re</link>
        <description>This instance is a test instance of the PeerTube project. It is updated to the latest commit in the develop branch every business day, 8pm CET.</description>
        <lastBuildDate>Sat, 07 Nov 2026 04:04:07 GMT</lastBuildDate>
        <docs>https://validator.w3.org/feed/docs/rss2.html</docs>
        <generator>PeerTube - https://peertube2.cpy.re</generator>
        <image>
            <title>PeerTube Nightly</title>
            <url>https://peertube2.cpy.re/lazy-static/avatars/82936e50-9560-42e7-9e4b-d96309f5c9c9.png</url>
            <link>https://peertube2.cpy.re</link>
        </image>
        <copyright>All rights reserved, unless otherwise specified in the terms specified at https://peertube2.cpy.re/about and potential licenses granted by each content's rightholder.</copyright>
        <atom:link href="https://peertube2.cpy.re/feeds/videos.xml?scope=local" rel="self" type="application/rss+xml"/>
        <item>
            <title><![CDATA[L'Heure Kolision - Le vendredi, de 20h à 22h au moins - 06/11/2026 19:00:05]]></title>
            <link>https://peertube2.cpy.re/w/t9sG9GVPcEP4eqb46Gouqk</link>
            <guid>https://peertube2.cpy.re/w/t9sG9GVPcEP4eqb46Gouqk</guid>
            <pubDate>Fri, 06 Nov 2026 22:10:11 GMT</pubDate>
            <description><![CDATA[L'émission l'Heure Kolision, par https://asso.hk sur Jet FM 91.2 à Nantes et alentours !]]></description>
            <content:encoded><![CDATA[<p>L'émission l'Heure Kolision, par <a href="https://asso.hk" target="_blank" rel="noopener noreferrer">https://asso.hk</a> sur Jet FM 91.2 à Nantes et alentours !</p>
]]></content:encoded>
            <dc:creator>L’Heure Kolision</dc:creator>
            <category>Music</category>
            <enclosure length="186782177" type="audio/mp4" url="https://peertube2.cpy.re/download/videos/generate/dbd524c6-d56a-4963-aff6-395182343543?videoFileIds=5980674"/>
            <media:community>
                <media:statistics views="2"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/t9sG9GVPcEP4eqb46Gouqk"/>
            <media:player url="https://peertube2.cpy.re/w/t9sG9GVPcEP4eqb46Gouqk"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/98986dab-5b11-47fb-bf53-c24264fd0755-0-hls.torrent" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="186782177" url="https://www.yiny.org/static/streaming-playlists/hls/dbd524c6-d56a-4963-aff6-395182343543/838d05f6-1848-4a1b-8a66-750360645783-0-fragmented.mp4" framerate="0" duration="11129" isDefault="true"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/1dd6a775-b431-47d4-8d9a-a9e2918b85c9.jpg" height="1400" width="1400"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">L'Heure Kolision - Le vendredi, de 20h à 22h au moins - 06/11/2026 19:00:05</media:title>
            <media:description type="plain">L'émission l'Heure Kolision, par https://asso.hk sur Jet FM 91.2 à Nantes et alentours !</media:description>
        </item>
        <item>
            <title><![CDATA[Le commerce mondial et ses factures - Lettres de crédit, affacturage, chaînes...]]></title>
            <link>https://peertube2.cpy.re/w/b9sc2cs1aBj8kAHJXLPycG</link>
            <guid>https://peertube2.cpy.re/w/b9sc2cs1aBj8kAHJXLPycG</guid>
            <pubDate>Fri, 06 Nov 2026 19:20:25 GMT</pubDate>
            <description><![CDATA[En 2025, le commerce mondial a atteint le record de 35 000 milliards de dollars. Les documents qui le font circuler sont pourtant encore largement sur papier : seuls 11 % environ des connaissements étaient électroniques. Pendant ce temps, les banq...]]></description>
            <content:encoded><![CDATA[<p>En 2025, le commerce mondial a atteint le record de 35 000 milliards de dollars. Les documents qui le font circuler sont pourtant encore largement sur papier : seuls 11 % environ des connaissements étaient électroniques. Pendant ce temps, les banques refusent deux mille cinq cents milliards de dollars de demandes de financement par an, d’abord aux petites entreprises.</p>
<p>Cet épisode explique comment se finance le commerce entre inconnus, de la lettre de crédit à l’affacturage. Il raconte l’enthousiasme de 2019, puis la fermeture des grands consortiums blockchain les uns après les autres, de we.trade à Contour, et dit pourquoi ils ont échoué. Il suit la révolution juridique qui fait enfin reconnaître les documents électroniques, de Londres à Pékin, et le rôle discret de la France, premier marché européen de l’affacturage, où la facture électronique est devenue obligatoire en septembre.</p>
<p>À partir de l’affaire First Brands, il montre comment un registre partagé peut mettre fin au double financement, et comment les premiers jetons arrivent par la porte des factures.</p>
<p>David HUBERT -  realassets.fr</p>
]]></content:encoded>
            <dc:creator>Real Assets 🎙️ RWA podcast</dc:creator>
            <category>Education</category>
            <enclosure length="126929735" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/52297a17-ef35-40d2-92d1-c1fa66a5f99e?videoFileIds=5980592"/>
            <media:community>
                <media:statistics views="1"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/b9sc2cs1aBj8kAHJXLPycG"/>
            <media:player url="https://peertube2.cpy.re/w/b9sc2cs1aBj8kAHJXLPycG"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/a2d90672-6672-436f-bd15-86621ca93d20-0.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/11e6cc87-097d-4c19-a410-ca5d52445b02-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/f80cc587-43a8-468e-8440-90b0c1639595-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/03a6f035-cc05-460e-b7fd-4c24d1f6ced2-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/d072f786-110c-4833-9847-a10807566088-0-hls.torrent" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="33746349" url="https://static.indymotion.fr/web-videos/29a81eff-f056-42f5-8baa-edb867f3d761-0.mp4" framerate="0" duration="2087" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="126929735" url="https://static.indymotion.fr/streaming-playlists/hls/52297a17-ef35-40d2-92d1-c1fa66a5f99e/e8b41063-7ad0-4d43-a461-64184fdfc865-720-fragmented.mp4" framerate="20" duration="2087" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="91937997" url="https://static.indymotion.fr/streaming-playlists/hls/52297a17-ef35-40d2-92d1-c1fa66a5f99e/eed25bb8-05ad-4b0a-ad07-33e1c68c9580-480-fragmented.mp4" framerate="20" duration="2087" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="60939179" url="https://static.indymotion.fr/streaming-playlists/hls/52297a17-ef35-40d2-92d1-c1fa66a5f99e/9a70bd3e-359d-4a7c-82f8-c21e320090a8-240-fragmented.mp4" framerate="20" duration="2087" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="33653112" url="https://static.indymotion.fr/streaming-playlists/hls/52297a17-ef35-40d2-92d1-c1fa66a5f99e/58d3ad0b-1b83-46bf-a1ca-dbaeb05b6264-0-fragmented.mp4" framerate="0" duration="2087" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/8a799a6a-8991-4a15-a6af-6b9cf2848e3e.png" height="1400" width="1400"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Le commerce mondial et ses factures - Lettres de crédit, affacturage, chaînes...</media:title>
            <media:description type="plain">En 2025, le commerce mondial a atteint le record de 35 000 milliards de dollars. Les documents qui le font circuler sont pourtant encore largement sur papier : seuls 11 % environ des connaissements étaient électroniques. Pendant ce temps, les banq...</media:description>
        </item>
        <item>
            <title><![CDATA[Desmu - Il a perdu son pantalon]]></title>
            <link>https://peertube2.cpy.re/w/byttBJkXWY1b3Ev1Jp6xSg</link>
            <guid>https://peertube2.cpy.re/w/byttBJkXWY1b3Ev1Jp6xSg</guid>
            <pubDate>Fri, 06 Nov 2026 19:01:25 GMT</pubDate>
            <description><![CDATA[Si vous retrouvez mon pantalon, vous pouvez le garder. Plus de musiques ici : https://www.desmu.fr/album/]]></description>
            <content:encoded><![CDATA[<p>Si vous retrouvez mon pantalon, vous pouvez le garder.</p>
<p>Plus de musiques ici : <a href="https://www.desmu.fr/album/" target="_blank" rel="noopener noreferrer">https://www.desmu.fr/album/</a></p>
]]></content:encoded>
            <dc:creator>Chez Desmu</dc:creator>
            <category>Music</category>
            <enclosure length="82020269" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/55841eb9-198b-4360-9c02-d55c59e9f0b7?videoFileIds=5980571"/>
            <media:community>
                <media:statistics views="1"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/byttBJkXWY1b3Ev1Jp6xSg"/>
            <media:player url="https://peertube2.cpy.re/w/byttBJkXWY1b3Ev1Jp6xSg"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/4c1f41be-4c0e-4d08-be4a-0a433953d7cc-0.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/34504d6c-6091-4c5b-b5c5-77d6affc1e3a-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/9cff3976-dac7-45ee-81d1-139e31b37bae-720-hls.torrent" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="7786999" url="https://peertube.desmu.fr/static/web-videos/d36bb9c7-1992-4c3f-8ec9-c495781ca502-0.mp4" framerate="0" duration="238" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="82020269" url="https://peertube.desmu.fr/static/streaming-playlists/hls/55841eb9-198b-4360-9c02-d55c59e9f0b7/db961f97-25ff-48c8-849b-96a2799113a4-1080-fragmented.mp4" framerate="26" duration="238" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="36504966" url="https://peertube.desmu.fr/static/streaming-playlists/hls/55841eb9-198b-4360-9c02-d55c59e9f0b7/b48343f5-b68f-4966-be35-1c41d442d961-720-fragmented.mp4" framerate="26" duration="238" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/dbda5bb8-52eb-4640-93c0-8d00c4c6a82d.jpg" height="1400" width="1400"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Desmu - Il a perdu son pantalon</media:title>
            <media:description type="plain">Si vous retrouvez mon pantalon, vous pouvez le garder. Plus de musiques ici : https://www.desmu.fr/album/</media:description>
        </item>
        <item>
            <title><![CDATA[Attal : loser]]></title>
            <link>https://peertube2.cpy.re/w/8fpPSDDP2xXoYEbWNkZAXx</link>
            <guid>https://peertube2.cpy.re/w/8fpPSDDP2xXoYEbWNkZAXx</guid>
            <pubDate>Fri, 06 Nov 2026 17:44:44 GMT</pubDate>
            <description><![CDATA[Soutenez Blast, nouveau média indépendant : https://www.blast-info.fr/soutenir Le macronisme mourant ne s’arrête pas d’en finir : chaque semaine un nouveau scandale, chaque semaine une nouvelle cruauté. Dans cet épisode on va décortiquer à quoi...]]></description>
            <content:encoded><![CDATA[<p>Soutenez Blast, nouveau média indépendant : <a href="https://www.blast-info.fr/soutenir" target="_blank" rel="noopener noreferrer">https://www.blast-info.fr/soutenir</a></p>
<p>Le macronisme mourant ne s’arrête pas d’en finir : chaque semaine un nouveau scandale, chaque semaine une nouvelle cruauté. Dans cet épisode on va décortiquer à quoi sert la candidature d’Attal pour le bloc central, entre appel à l’union et survivance d’un appareil électoral.<br />
Mais on fera aussi un tour du côté de la musique des clips insoumis, pour en proposer une analyse jusqu’ici, inédite.</p>
<p>0:00 Introduction<br />
0:51 Journal de campagne : Hérit(i)er de Macron<br />
23:38 Herméneutique de campagne : le Konbini et l’Hokage</p>
<p>Une vidéo de Camille et Victor-Ulysse Sultra-Chastrusse, Doctorant en droit public,<br />
Réalisation et montage : Guillaume Cage<br />
Son : Baptiste Veilhan, Théo Duchesne<br />
Graphisme : Morgane Sabouret, Margaux Simon<br />
Production : Hicham Tragha<br />
Directeur du développement des collaborations extérieures : Mathias Enthoven<br />
Co-directrice de la rédaction : Soumaya Benaïssa<br />
Directeur de la publication : Denis Robert</p>
<p>Le site : <a href="https://www.blast-info.fr/" target="_blank" rel="noopener noreferrer">https://www.blast-info.fr/</a><br />
Facebook : <a href="https://www.facebook.com/blastofficiel" target="_blank" rel="noopener noreferrer">https://www.facebook.com/blastofficiel</a><br />
Twitter : <a href="https://twitter.com/blast_france" target="_blank" rel="noopener noreferrer">https://twitter.com/blast_france</a><br />
Instagram : <a href="https://www.instagram.com/blastofficiel/" target="_blank" rel="noopener noreferrer">https://www.instagram.com/blastofficiel/</a><br />
Mastodon : <a href="https://mamot.fr/web/@blast_info" target="_blank" rel="noopener noreferrer">https://mamot.fr/web/@blast_info</a><br />
Peertube : <a href="https://video.blast-info.fr/" target="_blank" rel="noopener noreferrer">https://video.blast-info.fr/</a><br />
Twitch : <a href="https://www.twitch.tv/blastinfo" target="_blank" rel="noopener noreferrer">https://www.twitch.tv/blastinfo</a><br />
Bluesky : <a href="https://bsky.app/profile/blast-info.fr" target="_blank" rel="noopener noreferrer">https://bsky.app/profile/blast-info.fr</a></p>
<p>#gabrielattal<br />
#présidentielle2027<br />
#Propaganda</p>
]]></content:encoded>
            <dc:creator>blast, le souffle de l’info</dc:creator>
            <enclosure length="712532913" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/3ab310fa-ad30-4779-847f-e6182d22c9b5?videoFileIds=5980545"/>
            <media:community>
                <media:statistics views="179"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/8fpPSDDP2xXoYEbWNkZAXx"/>
            <media:player url="https://peertube2.cpy.re/w/8fpPSDDP2xXoYEbWNkZAXx"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/3b8bd93d-94b1-4297-9562-dec1bba380b3-0.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/128b6a8b-4bb2-4f98-a3aa-15f9d89d018f-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/4c12a665-1496-4f06-b29f-3a5f43bc5930-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/52aff5fa-62b1-44e4-bd06-c8a33655c547-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/173aec12-35c1-47ad-8262-c82154f96e1e-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/d6ceeb2c-7ca2-4b9d-9dc3-156e29ffc230-0-hls.torrent" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="64557229" url="https://cdn.octos3.fr/peertube-blast/web-videos/b564acee-7bf0-4069-93b1-0b22ba770001-0.mp4" framerate="0" duration="1839" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="712532913" url="https://cdn.octos3.fr/peertube-blast/streaming-playlists/hls/3ab310fa-ad30-4779-847f-e6182d22c9b5/9e62f4ea-62da-4ad9-b4a5-bef27384321c-1080-fragmented.mp4" framerate="25" duration="1839" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="302746616" url="https://cdn.octos3.fr/peertube-blast/streaming-playlists/hls/3ab310fa-ad30-4779-847f-e6182d22c9b5/55b3802b-251a-4f5a-83c6-78d78f77ecdf-720-fragmented.mp4" framerate="25" duration="1839" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="164779747" url="https://cdn.octos3.fr/peertube-blast/streaming-playlists/hls/3ab310fa-ad30-4779-847f-e6182d22c9b5/debdb899-fc20-44ca-a705-cb6066041991-480-fragmented.mp4" framerate="25" duration="1839" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="73294729" url="https://cdn.octos3.fr/peertube-blast/streaming-playlists/hls/3ab310fa-ad30-4779-847f-e6182d22c9b5/0fbc7c20-b8be-4380-81a6-4473ebbd28b1-240-fragmented.mp4" framerate="25" duration="1839" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="30123827" url="https://cdn.octos3.fr/peertube-blast/streaming-playlists/hls/3ab310fa-ad30-4779-847f-e6182d22c9b5/3be88780-a3f1-4fb4-a95d-b12db3960fa2-0-fragmented.mp4" framerate="0" duration="1839" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/e2925177-02ec-4aa2-a88a-625bec9b4571.jpg" height="1400" width="1400"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Attal : loser</media:title>
            <media:description type="plain">Soutenez Blast, nouveau média indépendant : https://www.blast-info.fr/soutenir Le macronisme mourant ne s’arrête pas d’en finir : chaque semaine un nouveau scandale, chaque semaine une nouvelle cruauté. Dans cet épisode on va décortiquer à quoi...</media:description>
        </item>
        <item>
            <title><![CDATA[Champ. Loisir - Lusigny vs Fresnoy-Clerey (05/11/2026)]]></title>
            <link>https://peertube2.cpy.re/w/4q9Fmk7PdD1192E2Cv7gzM</link>
            <guid>https://peertube2.cpy.re/w/4q9Fmk7PdD1192E2Cv7gzM</guid>
            <pubDate>Fri, 06 Nov 2026 16:08:26 GMT</pubDate>
            <description><![CDATA[➡️ Site Internet: https://www.etoiledelusigny.fr ➡️ Chaîne vidéo : https://indymotion.fr/a/etoiledelusigny/video-channels ➡️ Facebook : https://www.facebook.com/etoiledelusignyofficiel ➡️ Instagram : https://www.instagram.com/etoiledelusignyoff...]]></description>
            <content:encoded><![CDATA[<p>➡️ Site Internet: <a href="https://www.etoiledelusigny.fr" target="_blank" rel="noopener noreferrer">https://www.etoiledelusigny.fr</a><br />
➡️ Chaîne vidéo : <a href="https://indymotion.fr/a/etoiledelusigny/video-channels" target="_blank" rel="noopener noreferrer">https://indymotion.fr/a/etoiledelusigny/video-channels</a><br />
➡️ Facebook : <a href="https://www.facebook.com/etoiledelusignyofficiel" target="_blank" rel="noopener noreferrer">https://www.facebook.com/etoiledelusignyofficiel</a><br />
➡️ Instagram : <a href="https://www.instagram.com/etoiledelusignyofficiel/" target="_blank" rel="noopener noreferrer">https://www.instagram.com/etoiledelusignyofficiel/</a></p>
]]></content:encoded>
            <dc:creator>02 - Matchs et Plateaux</dc:creator>
            <category>Sports</category>
            <enclosure length="4207349191" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/1baa9d60-338b-4c90-b95c-aebb0b784543?videoFileIds=5980512"/>
            <media:community>
                <media:statistics views="7"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/4q9Fmk7PdD1192E2Cv7gzM"/>
            <media:player url="https://peertube2.cpy.re/w/4q9Fmk7PdD1192E2Cv7gzM"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/75e12394-1caa-4761-bb91-c22a27394af2-0.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/cab42234-e928-48ef-9e2c-a72b23030c0f-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/5a46df14-ddc1-4ec8-bb7e-17e2a46a9117-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/e56b11bb-0ba8-498b-aed0-c3fb2bf7f55d-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/4a4cad8f-1914-4d2a-a6d7-06c5525dd972-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/f2ccf69b-c31a-4aca-95b8-71a6819f0242-0-hls.torrent" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="90161132" url="https://static.indymotion.fr/web-videos/fc17529b-5c05-4734-ba98-2d38c301110b-0.mp4" framerate="0" duration="5570" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="4207349191" url="https://static.indymotion.fr/streaming-playlists/hls/1baa9d60-338b-4c90-b95c-aebb0b784543/fff75656-9a69-49e3-b86c-8c1cb72710f4-1080-fragmented.mp4" framerate="30" duration="5570" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="1707133697" url="https://static.indymotion.fr/streaming-playlists/hls/1baa9d60-338b-4c90-b95c-aebb0b784543/4bde7deb-fa54-4a21-b616-3518e53777df-720-fragmented.mp4" framerate="30" duration="5570" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="901785406" url="https://static.indymotion.fr/streaming-playlists/hls/1baa9d60-338b-4c90-b95c-aebb0b784543/5528431e-7495-4657-baa2-7525104fda86-480-fragmented.mp4" framerate="30" duration="5570" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="328944719" url="https://static.indymotion.fr/streaming-playlists/hls/1baa9d60-338b-4c90-b95c-aebb0b784543/d1d7a1ec-ee05-44b9-bcad-95ec2c1f6172-240-fragmented.mp4" framerate="30" duration="5570" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="91001241" url="https://static.indymotion.fr/streaming-playlists/hls/1baa9d60-338b-4c90-b95c-aebb0b784543/8a67c8f4-d145-47e3-9267-7de3aa35c981-0-fragmented.mp4" framerate="0" duration="5570" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/5594badc-cb10-4985-a7f8-784c6e46d6a0.jpg" height="1400" width="1400"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Champ. Loisir - Lusigny vs Fresnoy-Clerey (05/11/2026)</media:title>
            <media:description type="plain">➡️ Site Internet: https://www.etoiledelusigny.fr ➡️ Chaîne vidéo : https://indymotion.fr/a/etoiledelusigny/video-channels ➡️ Facebook : https://www.facebook.com/etoiledelusignyofficiel ➡️ Instagram : https://www.instagram.com/etoiledelusignyoff...</media:description>
        </item>
        <item>
            <title><![CDATA[Les buts - Champ. Loisir à 8 - Lusigny vs Fresnoy-Clerey (05/11/2026)]]></title>
            <link>https://peertube2.cpy.re/w/c7qLqyX1n6bHnVw8xrxtKF</link>
            <guid>https://peertube2.cpy.re/w/c7qLqyX1n6bHnVw8xrxtKF</guid>
            <pubDate>Fri, 06 Nov 2026 15:56:48 GMT</pubDate>
            <description><![CDATA[➡️ Site Internet: https://www.etoiledelusigny.fr ➡️ Chaîne vidéo : https://indymotion.fr/a/etoiledelusigny/video-channels ➡️ Facebook : https://www.facebook.com/etoiledelusignyofficiel ➡️ Instagram : https://www.instagram.com/etoiledelusignyoff...]]></description>
            <content:encoded><![CDATA[<p>➡️ Site Internet: <a href="https://www.etoiledelusigny.fr" target="_blank" rel="noopener noreferrer">https://www.etoiledelusigny.fr</a><br />
➡️ Chaîne vidéo : <a href="https://indymotion.fr/a/etoiledelusigny/video-channels" target="_blank" rel="noopener noreferrer">https://indymotion.fr/a/etoiledelusigny/video-channels</a><br />
➡️ Facebook : <a href="https://www.facebook.com/etoiledelusignyofficiel" target="_blank" rel="noopener noreferrer">https://www.facebook.com/etoiledelusignyofficiel</a><br />
➡️ Instagram : <a href="https://www.instagram.com/etoiledelusignyofficiel/" target="_blank" rel="noopener noreferrer">https://www.instagram.com/etoiledelusignyofficiel/</a></p>
]]></content:encoded>
            <dc:creator>02 - Matchs et Plateaux</dc:creator>
            <category>Sports</category>
            <enclosure length="313252390" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/59fa401b-b52b-416d-8ea9-8247f7da3e39?videoFileIds=5980463"/>
            <media:community>
                <media:statistics views="22"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/c7qLqyX1n6bHnVw8xrxtKF"/>
            <media:player url="https://peertube2.cpy.re/w/c7qLqyX1n6bHnVw8xrxtKF"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/a1434ea6-da58-4bd8-acba-d7fd3063948d-0.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/7ddf207c-b9cb-45e7-bb90-bbcfcad61dd1-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/2b62178a-d48c-4799-8bf3-0b910df91572-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/193380ce-bfec-4d22-9e90-1e1e3044a835-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/11fd9ca4-038f-4ee3-9af0-b20794ffce57-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/5c522ab6-0237-41c6-bd3f-08dffa7bc04b-0-hls.torrent" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="7074721" url="https://static.indymotion.fr/web-videos/2c94cc6e-bf21-417d-91aa-2b4e1e9d2c1e-0.mp4" framerate="0" duration="437" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="313252390" url="https://static.indymotion.fr/streaming-playlists/hls/59fa401b-b52b-416d-8ea9-8247f7da3e39/66726ee8-2d69-419a-824d-985c1cd027c2-1080-fragmented.mp4" framerate="32" duration="437" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="130242293" url="https://static.indymotion.fr/streaming-playlists/hls/59fa401b-b52b-416d-8ea9-8247f7da3e39/c4f45dc5-66e7-4b4d-a4fe-cf35ae8ae2c5-720-fragmented.mp4" framerate="32" duration="437" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="69708643" url="https://static.indymotion.fr/streaming-playlists/hls/59fa401b-b52b-416d-8ea9-8247f7da3e39/58d12050-b0c9-4220-ac7c-8e2fbf36500a-480-fragmented.mp4" framerate="30" duration="437" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="26091696" url="https://static.indymotion.fr/streaming-playlists/hls/59fa401b-b52b-416d-8ea9-8247f7da3e39/a0fc6984-5e60-411f-8afd-a3af5b8bd89a-240-fragmented.mp4" framerate="30" duration="437" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="7098125" url="https://static.indymotion.fr/streaming-playlists/hls/59fa401b-b52b-416d-8ea9-8247f7da3e39/e4b4171e-dd52-4728-85c9-7dbe7015dd47-0-fragmented.mp4" framerate="0" duration="437" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/2764a962-895f-46b8-9551-3c0362addbb4.jpg" height="1400" width="1400"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Les buts - Champ. Loisir à 8 - Lusigny vs Fresnoy-Clerey (05/11/2026)</media:title>
            <media:description type="plain">➡️ Site Internet: https://www.etoiledelusigny.fr ➡️ Chaîne vidéo : https://indymotion.fr/a/etoiledelusigny/video-channels ➡️ Facebook : https://www.facebook.com/etoiledelusignyofficiel ➡️ Instagram : https://www.instagram.com/etoiledelusignyoff...</media:description>
        </item>
        <item>
            <title><![CDATA[Construire des communs pour agir ensemble : les enseignements de dix ans de Transiscope]]></title>
            <link>https://peertube2.cpy.re/w/rtMgnnLXcaNAwVDHGsZ6yH</link>
            <guid>https://peertube2.cpy.re/w/rtMgnnLXcaNAwVDHGsZ6yH</guid>
            <pubDate>Fri, 06 Nov 2026 14:45:22 GMT</pubDate>
            <description><![CDATA[Comment décide-t-on ensemble de ce qui a sa place sur une carte des alternatives ? Et une fois les initiatives sur la carte, comment les aider à agir ensemble ? Retrouvez le replay du webinaire du 3 novembre 2026, organisé par le Collectif pour...]]></description>
            <content:encoded><![CDATA[<p>Comment décide-t-on ensemble de ce qui a sa place sur une carte des alternatives ? Et une fois les initiatives sur la carte, comment les aider à agir ensemble ?</p>
<p>Retrouvez le replay du webinaire du 3 novembre 2026, organisé par le Collectif pour une Transition Citoyenne à l’occasion de la parution du livre <em>Alternatives et luttes — Cartographier pour coopérer</em>.</p>
<p>Des co-auteur·ices du livre racontent comment des associations, des réseaux et des collectifs de terrain ont construit Transiscope en reliant leurs cartographies. De l’écriture de la charte aux choix techniques, ils et elles reviennent sur les débats et les compromis qui ont permis de faire vivre ce commun pendant dix ans.</p>
<p>L’échange ouvre aussi sur la suite de Transiscope, avec l’Agenda des transitions et les arpentages du livre, des temps de lecture collective pour prolonger la discussion.</p>
<p>📖 <a href="https://deslivresencommuns.org/publications/alternatives-et-luttes/" target="_blank" rel="noopener noreferrer">Lire ou télécharger gratuitement le livre sur Des livres en communs</a></p>
<p>🔎 <a href="https://transiscope.org/construire-des-communs-pour-agir-ensemble-les-enseignements-de-dix-ans-de-transiscope/" target="_blank" rel="noopener noreferrer">Retrouver la présentation du webinaire sur le site de Transiscope</a></p>
]]></content:encoded>
            <dc:creator>transition_citoyenne</dc:creator>
            <category>Activism</category>
            <enclosure length="270255294" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/ce55719e-4b5a-4845-b3da-b8e0b6557e65?videoFileIds=5980406"/>
            <media:community>
                <media:statistics views="0"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/rtMgnnLXcaNAwVDHGsZ6yH"/>
            <media:player url="https://peertube2.cpy.re/w/rtMgnnLXcaNAwVDHGsZ6yH"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/65116a10-69a1-41aa-908f-e054436fac7c-0.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/d101ac8f-5463-4862-afef-b03267fb5aac-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/98b9e42f-efb8-4d2d-a74d-738cbb842c62-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/b098dcda-fafb-44ff-bea6-a6e2bc69a635-0-hls.torrent" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="103986454" url="https://static.indymotion.fr/web-videos/18c8b186-eb93-4e23-af0c-f1d9d3d0bd5f-0.mp4" framerate="0" duration="5161" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="270255294" url="https://static.indymotion.fr/streaming-playlists/hls/ce55719e-4b5a-4845-b3da-b8e0b6557e65/7a26b06a-4b20-4cc9-9df4-f1815ba27799-480-fragmented.mp4" framerate="15" duration="5161" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="146178379" url="https://static.indymotion.fr/streaming-playlists/hls/ce55719e-4b5a-4845-b3da-b8e0b6557e65/7834099f-99a4-4556-a211-1a8e9c46b58d-240-fragmented.mp4" framerate="15" duration="5161" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="83764589" url="https://static.indymotion.fr/streaming-playlists/hls/ce55719e-4b5a-4845-b3da-b8e0b6557e65/99290224-0eed-4e79-8d50-12c85f6e5879-0-fragmented.mp4" framerate="0" duration="5161" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/57b6ff09-75cb-4706-888e-db6484b107c6.webp" height="1400" width="1400"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Construire des communs pour agir ensemble : les enseignements de dix ans de Transiscope</media:title>
            <media:description type="plain">Comment décide-t-on ensemble de ce qui a sa place sur une carte des alternatives ? Et une fois les initiatives sur la carte, comment les aider à agir ensemble ? Retrouvez le replay du webinaire du 3 novembre 2026, organisé par le Collectif pour...</media:description>
        </item>
        <item>
            <title><![CDATA[Résumé - Champ. D3 - Lusigny 2 vs Portugais Chartreux (25/10/2026)]]></title>
            <link>https://peertube2.cpy.re/w/bgWRwLX3ntzZgoRwhJn7as</link>
            <guid>https://peertube2.cpy.re/w/bgWRwLX3ntzZgoRwhJn7as</guid>
            <pubDate>Fri, 06 Nov 2026 14:40:32 GMT</pubDate>
            <description><![CDATA[➡️ Site Internet: https://www.etoiledelusigny.fr ➡️ Chaîne vidéo : https://indymotion.fr/a/etoiledelusigny/video-channels ➡️ Facebook : https://www.facebook.com/etoiledelusignyofficiel ➡️ Instagram : https://www.instagram.com/etoiledelusignyoff...]]></description>
            <content:encoded><![CDATA[<p>➡️ Site Internet: <a href="https://www.etoiledelusigny.fr" target="_blank" rel="noopener noreferrer">https://www.etoiledelusigny.fr</a><br />
➡️ Chaîne vidéo : <a href="https://indymotion.fr/a/etoiledelusigny/video-channels" target="_blank" rel="noopener noreferrer">https://indymotion.fr/a/etoiledelusigny/video-channels</a><br />
➡️ Facebook : <a href="https://www.facebook.com/etoiledelusignyofficiel" target="_blank" rel="noopener noreferrer">https://www.facebook.com/etoiledelusignyofficiel</a><br />
➡️ Instagram : <a href="https://www.instagram.com/etoiledelusignyofficiel/" target="_blank" rel="noopener noreferrer">https://www.instagram.com/etoiledelusignyofficiel/</a></p>
]]></content:encoded>
            <dc:creator>02 - Matchs et Plateaux</dc:creator>
            <category>Sports</category>
            <enclosure length="97169639" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/5335591d-fa13-4f7c-95fe-94500e3f2ae4?videoFileIds=5980400"/>
            <media:community>
                <media:statistics views="4"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/bgWRwLX3ntzZgoRwhJn7as"/>
            <media:player url="https://peertube2.cpy.re/w/bgWRwLX3ntzZgoRwhJn7as"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/20cae3e7-c5e6-4330-aa43-4e8ae65cdaff-0.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/5a526cd4-af62-4743-bb7f-9816856008be-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/9f199070-06e2-49aa-ae04-67f5033201ef-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/3d1726c6-dda8-4a74-8d6b-d39e3c5d48b8-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/3bd51d8b-925b-4bad-981b-1ea53cfb050a-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/866a4e2b-cfdc-4112-b26f-cc87148122d9-0-hls.torrent" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="4692070" url="https://static.indymotion.fr/web-videos/2c3607cc-9a03-4449-bb90-6bff34e4bad9-0.mp4" framerate="0" duration="194" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="97169639" url="https://static.indymotion.fr/streaming-playlists/hls/5335591d-fa13-4f7c-95fe-94500e3f2ae4/1ead3461-9c4d-4c27-b375-f3413544c68a-1080-fragmented.mp4" framerate="30" duration="194" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="43410650" url="https://static.indymotion.fr/streaming-playlists/hls/5335591d-fa13-4f7c-95fe-94500e3f2ae4/bc0c7413-97d5-40d1-b8be-5666cc00cff1-720-fragmented.mp4" framerate="30" duration="194" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="24260842" url="https://static.indymotion.fr/streaming-playlists/hls/5335591d-fa13-4f7c-95fe-94500e3f2ae4/90dde8c0-7f62-4d61-956e-c82e2e4e16b1-480-fragmented.mp4" framerate="30" duration="194" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="9544087" url="https://static.indymotion.fr/streaming-playlists/hls/5335591d-fa13-4f7c-95fe-94500e3f2ae4/7a396173-1df6-440a-bf18-d7a53e3e764d-240-fragmented.mp4" framerate="30" duration="194" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="3140369" url="https://static.indymotion.fr/streaming-playlists/hls/5335591d-fa13-4f7c-95fe-94500e3f2ae4/056d991c-00e2-42ca-8ee9-d72ec35b2a56-0-fragmented.mp4" framerate="0" duration="194" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/492b2e84-bec9-4411-afb8-0c5877f822b2.jpg" height="1400" width="1400"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Résumé - Champ. D3 - Lusigny 2 vs Portugais Chartreux (25/10/2026)</media:title>
            <media:description type="plain">➡️ Site Internet: https://www.etoiledelusigny.fr ➡️ Chaîne vidéo : https://indymotion.fr/a/etoiledelusigny/video-channels ➡️ Facebook : https://www.facebook.com/etoiledelusignyofficiel ➡️ Instagram : https://www.instagram.com/etoiledelusignyoff...</media:description>
        </item>
        <item>
            <title><![CDATA[Résumé - Champ. D2 - Lusigny vs Chartreux 3 (01/11/2026)]]></title>
            <link>https://peertube2.cpy.re/w/7JLQ9gpmRAovLkrgYH1G92</link>
            <guid>https://peertube2.cpy.re/w/7JLQ9gpmRAovLkrgYH1G92</guid>
            <pubDate>Fri, 06 Nov 2026 14:30:39 GMT</pubDate>
            <description><![CDATA[➡️ Site Internet: https://www.etoiledelusigny.fr ➡️ Chaîne vidéo : https://indymotion.fr/a/etoiledelusigny/video-channels ➡️ Facebook : https://www.facebook.com/etoiledelusignyofficiel ➡️ Instagram : https://www.instagram.com/etoiledelusignyoff...]]></description>
            <content:encoded><![CDATA[<p>➡️ Site Internet: <a href="https://www.etoiledelusigny.fr" target="_blank" rel="noopener noreferrer">https://www.etoiledelusigny.fr</a><br />
➡️ Chaîne vidéo : <a href="https://indymotion.fr/a/etoiledelusigny/video-channels" target="_blank" rel="noopener noreferrer">https://indymotion.fr/a/etoiledelusigny/video-channels</a><br />
➡️ Facebook : <a href="https://www.facebook.com/etoiledelusignyofficiel" target="_blank" rel="noopener noreferrer">https://www.facebook.com/etoiledelusignyofficiel</a><br />
➡️ Instagram : <a href="https://www.instagram.com/etoiledelusignyofficiel/" target="_blank" rel="noopener noreferrer">https://www.instagram.com/etoiledelusignyofficiel/</a></p>
]]></content:encoded>
            <dc:creator>02 - Matchs et Plateaux</dc:creator>
            <category>Sports</category>
            <enclosure length="120153595" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/368fb2a2-bd76-4e69-9c85-1f215e719541?videoFileIds=5980387"/>
            <media:community>
                <media:statistics views="4"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/7JLQ9gpmRAovLkrgYH1G92"/>
            <media:player url="https://peertube2.cpy.re/w/7JLQ9gpmRAovLkrgYH1G92"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/a2ef9828-3874-4b70-ba70-ceab1126adac-0.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/6828b1bf-03e6-443d-9b2f-a09755624e0b-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/da8942e6-e126-4a76-b4ca-31fff37cf230-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/7b49d724-a542-4029-aa91-98c306e8d57b-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/ba3b7b57-ae53-48e3-bde8-2d8ff846f431-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/d531c759-69f2-4f67-8fe6-3b82934dd4f4-0-hls.torrent" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="4821109" url="https://static.indymotion.fr/web-videos/d33af6a9-d42d-4a92-b58c-a4f92fc18fd3-0.mp4" framerate="0" duration="200" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="120153595" url="https://static.indymotion.fr/streaming-playlists/hls/368fb2a2-bd76-4e69-9c85-1f215e719541/479280b7-19ec-4eac-9d48-6036b16335d7-1080-fragmented.mp4" framerate="30" duration="200" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="55590849" url="https://static.indymotion.fr/streaming-playlists/hls/368fb2a2-bd76-4e69-9c85-1f215e719541/0ce22690-315a-4938-abc0-14e80016a272-720-fragmented.mp4" framerate="30" duration="200" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="31613972" url="https://static.indymotion.fr/streaming-playlists/hls/368fb2a2-bd76-4e69-9c85-1f215e719541/01fcf8dc-002c-4949-9ae7-2617a1e7e0c3-480-fragmented.mp4" framerate="30" duration="200" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="11214782" url="https://static.indymotion.fr/streaming-playlists/hls/368fb2a2-bd76-4e69-9c85-1f215e719541/1ddf29de-c501-4fba-b0f8-357a60ab9781-240-fragmented.mp4" framerate="30" duration="200" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="3230065" url="https://static.indymotion.fr/streaming-playlists/hls/368fb2a2-bd76-4e69-9c85-1f215e719541/b54a28d8-a191-4417-a895-cd395aee9083-0-fragmented.mp4" framerate="0" duration="200" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/f403b594-db9b-400f-bbbb-9c0e40d2c3f3.jpg" height="1400" width="1400"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Résumé - Champ. D2 - Lusigny vs Chartreux 3 (01/11/2026)</media:title>
            <media:description type="plain">➡️ Site Internet: https://www.etoiledelusigny.fr ➡️ Chaîne vidéo : https://indymotion.fr/a/etoiledelusigny/video-channels ➡️ Facebook : https://www.facebook.com/etoiledelusignyofficiel ➡️ Instagram : https://www.instagram.com/etoiledelusignyoff...</media:description>
        </item>
        <item>
            <title><![CDATA[Champ. U17D - Lusigny-Bréviandes - Barrissoyes (24/102026)]]></title>
            <link>https://peertube2.cpy.re/w/5NAJEJJn999gUwFtKFbtTE</link>
            <guid>https://peertube2.cpy.re/w/5NAJEJJn999gUwFtKFbtTE</guid>
            <pubDate>Fri, 06 Nov 2026 14:28:30 GMT</pubDate>
            <description><![CDATA[➡️ Site Internet: https://www.etoiledelusigny.fr ➡️ Chaîne vidéo : https://indymotion.fr/a/etoiledelusigny/video-channels ➡️ Facebook : https://www.facebook.com/etoiledelusignyofficiel ➡️ Instagram : https://www.instagram.com/etoiledelusignyoff...]]></description>
            <content:encoded><![CDATA[<p>➡️ Site Internet: <a href="https://www.etoiledelusigny.fr" target="_blank" rel="noopener noreferrer">https://www.etoiledelusigny.fr</a><br />
➡️ Chaîne vidéo : <a href="https://indymotion.fr/a/etoiledelusigny/video-channels" target="_blank" rel="noopener noreferrer">https://indymotion.fr/a/etoiledelusigny/video-channels</a><br />
➡️ Facebook : <a href="https://www.facebook.com/etoiledelusignyofficiel" target="_blank" rel="noopener noreferrer">https://www.facebook.com/etoiledelusignyofficiel</a><br />
➡️ Instagram : <a href="https://www.instagram.com/etoiledelusignyofficiel/" target="_blank" rel="noopener noreferrer">https://www.instagram.com/etoiledelusignyofficiel/</a></p>
]]></content:encoded>
            <dc:creator>02 - Matchs et Plateaux</dc:creator>
            <category>Sports</category>
            <enclosure length="2536395632" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/26e62cb6-f515-419a-9fdb-a1463522d7a0?videoFileIds=5980381"/>
            <media:community>
                <media:statistics views="0"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/5NAJEJJn999gUwFtKFbtTE"/>
            <media:player url="https://peertube2.cpy.re/w/5NAJEJJn999gUwFtKFbtTE"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/bc95382d-f42c-437b-95ab-429951b7bcd6-0.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/faa3ee30-117c-4c10-9446-6e68d3504a0d-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/76aaf658-3177-4d7d-b0cd-6958da358949-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/3e1cc271-c357-450e-8514-2e6087287d53-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/d2d260e1-2f6d-4461-8ce6-8f54a9c09d90-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/1d0851ee-8043-4520-ad86-5f85f1ae462e-0-hls.torrent" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="113168995" url="https://static.indymotion.fr/web-videos/335914af-859a-435f-9146-0b8ca46fc9b4-0.mp4" framerate="0" duration="6991" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="2536395632" url="https://static.indymotion.fr/streaming-playlists/hls/26e62cb6-f515-419a-9fdb-a1463522d7a0/d38f251e-8a7b-453b-82b2-06edc66d99b7-1080-fragmented.mp4" framerate="30" duration="6991" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="1134197462" url="https://static.indymotion.fr/streaming-playlists/hls/26e62cb6-f515-419a-9fdb-a1463522d7a0/5f61c1f6-1f99-4fc8-b060-842029a3f21c-720-fragmented.mp4" framerate="30" duration="6991" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="663107931" url="https://static.indymotion.fr/streaming-playlists/hls/26e62cb6-f515-419a-9fdb-a1463522d7a0/cf77b12a-13c7-4728-a490-60691741cfba-480-fragmented.mp4" framerate="30" duration="6991" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="273818055" url="https://static.indymotion.fr/streaming-playlists/hls/26e62cb6-f515-419a-9fdb-a1463522d7a0/f216d6b5-91f1-4c2c-a1b6-757c24a2c44b-240-fragmented.mp4" framerate="30" duration="6991" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="113984006" url="https://static.indymotion.fr/streaming-playlists/hls/26e62cb6-f515-419a-9fdb-a1463522d7a0/0cb43d26-896a-45c0-b26f-dc2c42404344-0-fragmented.mp4" framerate="0" duration="6991" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/ab14a5de-af77-47b1-92ed-96ea43647755.jpg" height="1400" width="1400"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Champ. U17D - Lusigny-Bréviandes - Barrissoyes (24/102026)</media:title>
            <media:description type="plain">➡️ Site Internet: https://www.etoiledelusigny.fr ➡️ Chaîne vidéo : https://indymotion.fr/a/etoiledelusigny/video-channels ➡️ Facebook : https://www.facebook.com/etoiledelusignyofficiel ➡️ Instagram : https://www.instagram.com/etoiledelusignyoff...</media:description>
        </item>
        <item>
            <title><![CDATA[TOUCH your Blender 👀 Blender Today LIVE #292]]></title>
            <link>https://peertube2.cpy.re/w/ngzGR8tA2Wr9UQUeWyHtGo</link>
            <guid>https://peertube2.cpy.re/w/ngzGR8tA2Wr9UQUeWyHtGo</guid>
            <pubDate>Fri, 06 Nov 2026 14:09:39 GMT</pubDate>
            <description><![CDATA[Hola Community! Pablo here. Let's see what's new in Blender. This is all possible thanks to your donations. If you like what you see, keep it going at fund.blender.org 🧡 What's New Changelog and Q&amp;A: https://devtalk.blender.org/t/touch-your...]]></description>
            <content:encoded><![CDATA[<p>Hola Community! Pablo here. Let's see what's new in Blender.</p>
<p>This is all possible thanks to your donations. If you like what you see, keep it going at fund.blender.org 🧡</p>
What's New Changelog and Q&amp;A: <a href="https://devtalk.blender.org/t/touch-your-blender-blender-today-live-292/46170?sort=old" target="_blank" rel="noopener noreferrer">https://devtalk.blender.org/t/touch-your-blender-blender-today-live-292/46170?sort=old</a>
<p>0:00:00 Intro<br />
0:00:25 Hola!<br />
0:03:30 Animation<br />
0:05:19 Compositor<br />
0:09:52 Core<br />
0:13:44 Cycles<br />
0:18:30 EEVEE<br />
0:20:38 Extensions<br />
0:21:59 I/O<br />
0:23:43 macOS<br />
0:29:01 Modeling<br />
0:29:49 Nodes<br />
0:31:41 Projects<br />
0:35:41 Python<br />
0:36:33 Render<br />
0:38:36 Sculpt<br />
0:41:01 Subdiv<br />
0:43:50 User Interface<br />
0:50:49 Video Sequencer<br />
0:54:07 Q&amp;A<br />
1:04:27 Outro</p>
]]></content:encoded>
            <dc:creator>Blender</dc:creator>
            <enclosure length="577787781" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/ac3cd6e2-c439-4878-86c9-b4eac388015a?videoFileIds=5980377"/>
            <media:community>
                <media:statistics views="34"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/ngzGR8tA2Wr9UQUeWyHtGo"/>
            <media:player url="https://peertube2.cpy.re/w/ngzGR8tA2Wr9UQUeWyHtGo"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/d3162982-da86-401f-8616-809813bb3f2f-1080.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/4565f364-d316-4f56-81d4-13ab3edd7413-480.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/be057c31-ebe3-4b02-8320-f208e64eb8d8-0.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="577787781" url="https://video.blender.org/object-storage/web_videos/c3bd7e49-d68a-427f-98e0-b033721d0103-1080.mp4" framerate="30" duration="4062" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="271464775" url="https://video.blender.org/object-storage/web_videos/13dbed48-b8b6-462e-8e2d-8e215b01efec-480.mp4" framerate="30" duration="4062" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="65694831" url="https://video.blender.org/object-storage/web_videos/bf27d568-42b4-475b-a5d7-7cb2309f113b-0.mp4" framerate="0" duration="4062" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/dc9c6173-098c-4e5a-849e-fb803253844f.jpg" height="1400" width="1400"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">TOUCH your Blender 👀 Blender Today LIVE #292</media:title>
            <media:description type="plain">Hola Community! Pablo here. Let's see what's new in Blender. This is all possible thanks to your donations. If you like what you see, keep it going at fund.blender.org 🧡 What's New Changelog and Q&amp;A: https://devtalk.blender.org/t/touch-your...</media:description>
        </item>
        <item>
            <title><![CDATA[Linux-Fragestunden mit Jean und Hauke (27.10.2026)]]></title>
            <link>https://peertube2.cpy.re/w/qBn5PjunKSYyLNE66f1Snr</link>
            <guid>https://peertube2.cpy.re/w/qBn5PjunKSYyLNE66f1Snr</guid>
            <pubDate>Fri, 06 Nov 2026 13:17:01 GMT</pubDate>
            <description><![CDATA[Jean (@LinuxGuides) und ich beantworten ab 19:30 Eure Fragen zu Linux und OpenSource. Streaming-Kalender:  https://live.linuxguides.de/ Support könnt Ihr bei uns buchen unter: https://goos-habermann.de, https://www.linuxguides.de, Den...]]></description>
            <content:encoded><![CDATA[<p>Jean (@LinuxGuides) und ich beantworten ab 19:30 Eure Fragen zu Linux und OpenSource.</p>
<p>Streaming-Kalender:  <a href="https://live.linuxguides.de/" target="_blank" rel="noopener noreferrer">https://live.linuxguides.de/</a></p>
<p>Support könnt Ihr bei uns buchen unter:</p>
<ul>
<li><a href="https://goos-habermann.de" target="_blank" rel="noopener noreferrer">https://goos-habermann.de</a></li>
<li><a href="https://www.linuxguides.de" target="_blank" rel="noopener noreferrer">https://www.linuxguides.de</a></li>
</ul>
<p>Den Live-Stream gibt es auf:</p>
<ul>
<li><a href="https://www.twitch.tv/linuxguides" target="_blank" rel="noopener noreferrer">https://www.twitch.tv/linuxguides</a></li>
<li><a href="https://www.linuxguides.de/live" target="_blank" rel="noopener noreferrer">https://www.linuxguides.de/live</a></li>
<li><a href="https://www.youtube.com/@LinuxGuides" target="_blank" rel="noopener noreferrer">https://www.youtube.com/@LinuxGuides</a></li>
<li><a href="https://www.youtube.com/@nichtderweisheit" target="_blank" rel="noopener noreferrer">https://www.youtube.com/@nichtderweisheit</a></li>
</ul>
]]></content:encoded>
            <dc:creator>Nicht der Weisheit letzter Schluß</dc:creator>
            <category>Science &amp; Technology</category>
            <enclosure length="648117329" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/c74b5a48-8f96-4742-ae29-d0dd2ae78d23?videoFileIds=5979789"/>
            <media:community>
                <media:statistics views="14"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/qBn5PjunKSYyLNE66f1Snr"/>
            <media:player url="https://peertube2.cpy.re/w/qBn5PjunKSYyLNE66f1Snr"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/0d20a3d8-ab1f-4843-85e3-edc57da8c4f3-1080.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/e55d40fc-5c7f-433f-a57d-f246b5a0fd90-480.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/f4327728-5e2e-467a-95c9-8a86fca35bc2-360.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/5c9db224-e37e-42db-9a8e-655cc3402536-0.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/105ef7e9-a0e9-4060-9d9f-8898502a2308-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/a24bf474-86a7-4a4d-bfc7-833ab349d28c-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/eccecbdb-2650-4eb4-9d44-76e1cac72f22-360-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/ca203615-9925-4151-94e3-1c0ef1855a05-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="648117329" url="https://media.tube.tchncs.de/videos/e8d74048-0755-40ce-85c8-140da99d26f3-1080.mp4" framerate="30" duration="6670" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="366428075" url="https://media.tube.tchncs.de/videos/c06b968d-063d-4072-9784-cc6a6573f77c-480.mp4" framerate="30" duration="6670" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="360" fileSize="317010535" url="https://media.tube.tchncs.de/videos/4aebfd8b-a1aa-42db-a60c-ee0a2517a802-360.mp4" framerate="30" duration="6670" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="204174238" url="https://media.tube.tchncs.de/videos/5b3471e0-3879-4d7a-b550-7f0e41b824f8-0.mp4" framerate="0" duration="6670" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="644369079" url="https://media.tube.tchncs.de/streaming-playlists/hls/c74b5a48-8f96-4742-ae29-d0dd2ae78d23/38a3d305-850e-4c8e-a97a-a5ff72dec52e-1080-fragmented.mp4" framerate="30" duration="6670" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="362560773" url="https://media.tube.tchncs.de/streaming-playlists/hls/c74b5a48-8f96-4742-ae29-d0dd2ae78d23/cab5c88b-5ced-4e29-a43b-3eaec982e4cd-480-fragmented.mp4" framerate="30" duration="6670" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="360" fileSize="313086009" url="https://media.tube.tchncs.de/streaming-playlists/hls/c74b5a48-8f96-4742-ae29-d0dd2ae78d23/8380ebb4-1617-468e-8599-709bff2b302c-360-fragmented.mp4" framerate="30" duration="6670" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="203170116" url="https://media.tube.tchncs.de/streaming-playlists/hls/c74b5a48-8f96-4742-ae29-d0dd2ae78d23/7ade8d4f-797f-465a-ae68-b3385571f0d3-0-fragmented.mp4" framerate="0" duration="6670" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/1e4defe6-9824-4f50-9502-a4ad67b33883.jpg" height="1400" width="1400"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Linux-Fragestunden mit Jean und Hauke (27.10.2026)</media:title>
            <media:description type="plain">Jean (@LinuxGuides) und ich beantworten ab 19:30 Eure Fragen zu Linux und OpenSource. Streaming-Kalender:  https://live.linuxguides.de/ Support könnt Ihr bei uns buchen unter: https://goos-habermann.de, https://www.linuxguides.de, Den...</media:description>
        </item>
        <item>
            <title><![CDATA[Mika and The Witch's Mountain : No Comment Free Roam]]></title>
            <link>https://peertube2.cpy.re/w/qVkKHH4wqkRkNQsnEmp4A8</link>
            <guid>https://peertube2.cpy.re/w/qVkKHH4wqkRkNQsnEmp4A8</guid>
            <pubDate>Fri, 06 Nov 2026 12:45:22 GMT</pubDate>
            <description><![CDATA[J'avais juste envie de relancer le jeu pour une balade tranquille et pour tester le jeu sur une grande télé Il y a des petits « sauts d'images » (pas bien méchant) car il s'agit d'une fusion de 35 clips Switch]]></description>
            <content:encoded><![CDATA[<p>J'avais juste envie de relancer le jeu pour une balade tranquille et pour tester le jeu sur une grande télé</p>
<ul>
<li>Il y a des petits « sauts d'images » (pas bien méchant) car il s'agit d'une fusion de 35 clips Switch</li>
</ul>
]]></content:encoded>
            <dc:creator>Lucilia</dc:creator>
            <category>Gaming</category>
            <enclosure length="369858947" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/c9cdebdd-71f5-4cf5-a2c2-5ebca065b7ff?videoFileIds=5979742"/>
            <media:community>
                <media:statistics views="3"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/qVkKHH4wqkRkNQsnEmp4A8"/>
            <media:player url="https://peertube2.cpy.re/w/qVkKHH4wqkRkNQsnEmp4A8"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/601769ad-a26a-4eb8-b30e-cc000aea5602-0.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/2e8bc346-b25d-49f4-b73c-dc63bf277206-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/1f3001ca-5c17-4aa5-af04-fdd652289fda-480-hls.torrent" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="26476238" url="https://videos.pair2jeux.tube/static/web-videos/3fd0ea45-0590-4bad-b6df-08730c020fa2-0.mp4" framerate="0" duration="659" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="369858947" url="https://videos.pair2jeux.tube/static/streaming-playlists/hls/c9cdebdd-71f5-4cf5-a2c2-5ebca065b7ff/762e854e-96c8-4a64-899c-5e87480c3cc3-720-fragmented.mp4" framerate="30" duration="659" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="109249171" url="https://videos.pair2jeux.tube/static/streaming-playlists/hls/c9cdebdd-71f5-4cf5-a2c2-5ebca065b7ff/29ef105a-8615-4bd0-8c45-45327aa5b065-480-fragmented.mp4" framerate="30" duration="659" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/05e166c1-261b-49bd-9a10-761670f6a4bf.jpg" height="1400" width="1400"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Mika and The Witch's Mountain : No Comment Free Roam</media:title>
            <media:description type="plain">J'avais juste envie de relancer le jeu pour une balade tranquille et pour tester le jeu sur une grande télé Il y a des petits « sauts d'images » (pas bien méchant) car il s'agit d'une fusion de 35 clips Switch</media:description>
        </item>
        <item>
            <title><![CDATA[LeMondeModerne -- Crédit Mutuel - 100 Millions Hack- 2026-11]]></title>
            <link>https://peertube2.cpy.re/w/8drRDcYVUmFipxeqnC3NZr</link>
            <guid>https://peertube2.cpy.re/w/8drRDcYVUmFipxeqnC3NZr</guid>
            <pubDate>Fri, 06 Nov 2026 11:01:28 GMT</pubDate>
            <description><![CDATA[On a pas fini de se marrer .......Vu leurs incompétences et leur acharnement à répéter les mêmes erreurs. C'est pas l'I-A qui va nous sortir de ce merdier !! https://francefuites.com/]]></description>
            <content:encoded><![CDATA[<p>On a pas fini de se marrer .......Vu leurs incompétences et leur acharnement à répéter les mêmes erreurs.</p>
<p>C'est pas l'I-A qui va nous sortir de ce merdier !!</p>
<p><a href="https://francefuites.com/" target="_blank" rel="noopener noreferrer">https://francefuites.com/</a></p>
]]></content:encoded>
            <dc:creator>F4I</dc:creator>
            <category>Science &amp; Technology</category>
            <enclosure length="23258302" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/3a6cd482-8b29-460a-bbce-2bd28143c9ab?videoFileIds=5979718"/>
            <media:community>
                <media:statistics views="2"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/8drRDcYVUmFipxeqnC3NZr"/>
            <media:player url="https://peertube2.cpy.re/w/8drRDcYVUmFipxeqnC3NZr"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/9850c3d5-8dc7-46c1-97c5-939df4f9d3e3-720.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/33d00994-fee9-4216-b37e-428a0c29c300-480.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/d1a455c5-4e66-47a8-bc1c-3fcc8e8141df-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/6ef38fa9-e0e8-4ace-a302-b90f1c704ecf-480-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="23258302" url="https://fightforinfo.com/static/web-videos/28880de7-2b2f-44f2-a7a0-2a14f5b7cbc6-720.mp4" framerate="30" duration="5135" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="17422087" url="https://fightforinfo.com/static/web-videos/fb54e148-4cbb-4c7b-8048-96825b273dee-480.mp4" framerate="30" duration="5135" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="23141092" url="https://fightforinfo.com/static/streaming-playlists/hls/3a6cd482-8b29-460a-bbce-2bd28143c9ab/41fe9cd3-cbb8-402b-9e12-fabdd0bb28d3-720-fragmented.mp4" framerate="30" duration="5135" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="17302869" url="https://fightforinfo.com/static/streaming-playlists/hls/3a6cd482-8b29-460a-bbce-2bd28143c9ab/fa2bd9a1-67ec-4be1-a584-436647f8af99-480-fragmented.mp4" framerate="30" duration="5135" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/86598a01-8898-4fbf-84fe-839e96cbc39f.jpg" height="157" width="280"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/a11aa3a8-69bf-4732-8e8c-4caf8d8cc36a.jpg" height="480" width="850"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">LeMondeModerne -- Crédit Mutuel - 100 Millions Hack- 2026-11</media:title>
            <media:description type="plain">On a pas fini de se marrer .......Vu leurs incompétences et leur acharnement à répéter les mêmes erreurs. C'est pas l'I-A qui va nous sortir de ce merdier !! https://francefuites.com/</media:description>
        </item>
        <item>
            <title><![CDATA[Tux Flash 2026-10-26 PHP2Shell]]></title>
            <link>https://peertube2.cpy.re/w/t497ab6ezXumbWojSpJCBA</link>
            <guid>https://peertube2.cpy.re/w/t497ab6ezXumbWojSpJCBA</guid>
            <pubDate>Fri, 06 Nov 2026 11:00:25 GMT</pubDate>
            <description><![CDATA[Es ist wieder Podcast, meine Kerle 😃 Heute schnacken Micha (@saintofsinner), Jean (@LinuxGuides) und ich ab 19:30 im Tux Flash über verschiedene Themen aus dem Linux- und OpenSource-Bereich. Der Podcast wird live gestreamt auf: https:...]]></description>
            <content:encoded><![CDATA[<p>Es ist wieder Podcast, meine Kerle 😃</p>
<p>Heute schnacken Micha (@saintofsinner), Jean (@LinuxGuides) und ich ab 19:30 im Tux Flash über verschiedene Themen aus dem Linux- und OpenSource-Bereich.</p>
<p>Der Podcast wird live gestreamt auf:</p>
<ul>
<li><a href="https://www.twitch.tv/saintofsinner" target="_blank" rel="noopener noreferrer">https://www.twitch.tv/saintofsinner</a></li>
<li><a href="https://www.linuxguides.de/live" target="_blank" rel="noopener noreferrer">https://www.linuxguides.de/live</a></li>
<li><a href="https://youtube.com/@nichtderweisheit" target="_blank" rel="noopener noreferrer">https://youtube.com/@nichtderweisheit</a></li>
</ul>
<p>Der Tux Flash wird anschließend veröffentlicht auf :</p>
<ul>
<li><a href="https://tube.tchncs.de/c/ndwls/videos" target="_blank" rel="noopener noreferrer">https://tube.tchncs.de/c/ndwls/videos</a></li>
<li><a href="https://www.youtube.com/@Tux-Flash" target="_blank" rel="noopener noreferrer">https://www.youtube.com/@Tux-Flash</a></li>
<li><a href="https://www.youtube.com/playlist?list=PLt-F9X6Bnsjhr3xeScgs4xElpJvaqaCW0" target="_blank" rel="noopener noreferrer">https://www.youtube.com/playlist?list=PLt-F9X6Bnsjhr3xeScgs4xElpJvaqaCW0</a></li>
<li>Archiv mit alten Folgen: <a href="https://www.youtube.com/playlist?list=PLPK5iNo_kpNe0dtNukSwl02w64dKSYBlJ" target="_blank" rel="noopener noreferrer">https://www.youtube.com/playlist?list=PLPK5iNo_kpNe0dtNukSwl02w64dKSYBlJ</a></li>
<li><a href="https://open.spotify.com/show/5j5C5a3nTq2L2Z2RBOvLuE" target="_blank" rel="noopener noreferrer">https://open.spotify.com/show/5j5C5a3nTq2L2Z2RBOvLuE</a></li>
</ul>
]]></content:encoded>
            <dc:creator>Nicht der Weisheit letzter Schluß</dc:creator>
            <category>Science &amp; Technology</category>
            <enclosure length="708299673" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/db16f882-4572-48f1-b468-c663551002e0?videoFileIds=5979724"/>
            <media:community>
                <media:statistics views="7"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/t497ab6ezXumbWojSpJCBA"/>
            <media:player url="https://peertube2.cpy.re/w/t497ab6ezXumbWojSpJCBA"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/c804919f-56f8-4f67-831e-ea643d47c6d9-720.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/c284c8bc-598f-4b44-8e30-cf718b490808-480.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/1f099abf-ecc0-437b-a247-a669337d73c6-360.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/86255534-97ea-4e8c-b07b-b282570ef7f3-0.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/bcdb1477-d852-42be-bdbb-b29d213e8ee3-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/f38c2fe4-b2fa-4d17-b4a4-dc376818fb16-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/8f91fd44-0de2-439f-8a09-d494b7096ad2-360-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/f322d25d-41f9-4427-b45f-798c5cdc46cd-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="708299673" url="https://media.tube.tchncs.de/videos/67ff5f30-789d-4432-8216-9d532054b12d-720.mp4" framerate="60" duration="4495" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="478084483" url="https://media.tube.tchncs.de/videos/5b4fccd8-13bb-4a5f-8af3-b7255204b8b4-480.mp4" framerate="30" duration="4495" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="360" fileSize="347248579" url="https://media.tube.tchncs.de/videos/3509e85a-117d-49e0-817c-1cc87705eaa5-360.mp4" framerate="30" duration="4495" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="122632691" url="https://media.tube.tchncs.de/videos/98151f2c-6ec0-4d57-b2fc-6ae7126c4b56-0.mp4" framerate="0" duration="4495" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="705161159" url="https://media.tube.tchncs.de/streaming-playlists/hls/db16f882-4572-48f1-b468-c663551002e0/11d6168e-4f57-4842-8279-67e76382e2a0-720-fragmented.mp4" framerate="60" duration="4495" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="475213357" url="https://media.tube.tchncs.de/streaming-playlists/hls/db16f882-4572-48f1-b468-c663551002e0/1153f526-8c19-4acc-840a-81ab90ee9822-480-fragmented.mp4" framerate="30" duration="4495" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="360" fileSize="344385925" url="https://media.tube.tchncs.de/streaming-playlists/hls/db16f882-4572-48f1-b468-c663551002e0/7abf0dcb-0a6a-4732-8608-8ec4683a2573-360-fragmented.mp4" framerate="30" duration="4495" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="121967905" url="https://media.tube.tchncs.de/streaming-playlists/hls/db16f882-4572-48f1-b468-c663551002e0/83191c9b-3b70-4f31-9089-e7f9f0755473-0-fragmented.mp4" framerate="0" duration="4495" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/a8b78e9e-51fe-4c4a-b8b4-86b947fb81f8.jpg" height="1400" width="1400"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Tux Flash 2026-10-26 PHP2Shell</media:title>
            <media:description type="plain">Es ist wieder Podcast, meine Kerle 😃 Heute schnacken Micha (@saintofsinner), Jean (@LinuxGuides) und ich ab 19:30 im Tux Flash über verschiedene Themen aus dem Linux- und OpenSource-Bereich. Der Podcast wird live gestreamt auf: https:...</media:description>
        </item>
        <item>
            <title><![CDATA[hatniX spielt „Heavy Cargo - The Truck Simulator“ Heavy Defense DLC]]></title>
            <link>https://peertube2.cpy.re/w/jrRBTY1z22TsNkxBCiyM7h</link>
            <guid>https://peertube2.cpy.re/w/jrRBTY1z22TsNkxBCiyM7h</guid>
            <pubDate>Fri, 06 Nov 2026 07:51:42 GMT</pubDate>
            <description><![CDATA[„Heavy Cargo - The Truck Simulator“ von tox² interactive hat gestern sowohl ein neues großes Update, Version 1.4.0, als auch ein neues DLC, Heavy Defense, erhalten, Genug Gründe für ein Video. Das Spiel steht nur für Windows zur Verfügung, Ich sp...]]></description>
            <content:encoded><![CDATA[<p>„Heavy Cargo - The Truck Simulator“ von tox² interactive hat gestern sowohl ein neues großes Update, Version 1.4.0, als auch ein neues DLC, Heavy Defense, erhalten, Genug Gründe für ein Video.<br />
Das Spiel steht nur für Windows zur Verfügung, Ich spiele es unter Linux (CachyOS, Plasma Desktop) mit Hilfe von Proton 11.0-2.</p>
<p>Steam-Seite: <a href="https://store.steampowered.com/app/1474930" target="_blank" rel="noopener noreferrer">https://store.steampowered.com/app/1474930</a><br />
Heavy Defense DLC: <a href="https://store.steampowered.com/app/5100210" target="_blank" rel="noopener noreferrer">https://store.steampowered.com/app/5100210</a><br />
Changelog: <a href="https://heavy-cargo.aerosoft.com/patches" target="_blank" rel="noopener noreferrer">https://heavy-cargo.aerosoft.com/patches</a><br />
Webseite: <a href="https://tox2-interactive.com/title/coming-soon-heavy-cargo-the-truck-simulator" target="_blank" rel="noopener noreferrer">https://tox2-interactive.com/title/coming-soon-heavy-cargo-the-truck-simulator</a></p>
<p>GOG Dreamlist: <a href="https://www.gog.com/dreamlist/game/heavy-cargo-the-truck-simulator-2024" target="_blank" rel="noopener noreferrer">https://www.gog.com/dreamlist/game/heavy-cargo-the-truck-simulator-2024</a></p>

<p>Meine Webseite: <a href="https://hatnix.net" target="_blank" rel="noopener noreferrer">https://hatnix.net</a></p>
]]></content:encoded>
            <dc:creator>haTube</dc:creator>
            <category>Gaming</category>
            <enclosure length="1791080779" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/9560ab3a-771f-41f9-9512-fd0be4aced90?videoFileIds=5979643"/>
            <media:community>
                <media:statistics views="10"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/jrRBTY1z22TsNkxBCiyM7h"/>
            <media:player url="https://peertube2.cpy.re/w/jrRBTY1z22TsNkxBCiyM7h"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/bbd44cce-13cb-4cb9-b728-a028ec3befdb-1080.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/e91262a4-7e3b-4b2d-a6bd-adde7927e473-480.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/f4248012-ed41-4c01-af2c-3e86bb03c81b-360.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/0c7903f9-ab8d-48e0-b3df-4519f7e7a77f-0.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/82597cd0-2eae-4a7b-b017-960f27cb400c-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/968f1805-769c-4f44-a0b3-1c8575227270-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/a2414346-13c3-4439-9ca9-ecfd138489ed-360-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/1907524c-b5f2-44aa-bf5a-fa91fc6bf42b-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="1791080779" url="https://media.tube.tchncs.de/videos/a2dfbff9-d5db-4d8f-9a5b-66eceeb2aced-1080.mp4" framerate="60" duration="4053" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="476051833" url="https://media.tube.tchncs.de/videos/8fe27a12-78d4-4b86-a8f4-c13eedff7e8f-480.mp4" framerate="30" duration="4053" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="360" fileSize="339515761" url="https://media.tube.tchncs.de/videos/3ae9086b-e6e3-43e8-9e5a-3384b71efcbc-360.mp4" framerate="30" duration="4053" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="98025429" url="https://media.tube.tchncs.de/videos/38729d67-e4fe-4e3d-880d-6821004eb5c6-0.mp4" framerate="0" duration="4053" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="1787287153" url="https://media.tube.tchncs.de/streaming-playlists/hls/9560ab3a-771f-41f9-9512-fd0be4aced90/0062229e-f43b-4b2f-8204-ccbaca231aae-1080-fragmented.mp4" framerate="60" duration="4053" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="474377915" url="https://media.tube.tchncs.de/streaming-playlists/hls/9560ab3a-771f-41f9-9512-fd0be4aced90/cb8ba30b-6314-456d-a1af-837470e7ce18-480-fragmented.mp4" framerate="30" duration="4053" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="360" fileSize="337833107" url="https://media.tube.tchncs.de/streaming-playlists/hls/9560ab3a-771f-41f9-9512-fd0be4aced90/916d411f-64d7-4018-ba76-ba839e74412a-360-fragmented.mp4" framerate="30" duration="4053" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="98182751" url="https://media.tube.tchncs.de/streaming-playlists/hls/9560ab3a-771f-41f9-9512-fd0be4aced90/31d13bca-b7de-4516-9c93-0718c223b493-0-fragmented.mp4" framerate="0" duration="4053" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/60112ee8-3132-46f5-a51c-d4388fa4d5cc.png" height="1400" width="1400"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">hatniX spielt „Heavy Cargo - The Truck Simulator“ Heavy Defense DLC</media:title>
            <media:description type="plain">„Heavy Cargo - The Truck Simulator“ von tox² interactive hat gestern sowohl ein neues großes Update, Version 1.4.0, als auch ein neues DLC, Heavy Defense, erhalten, Genug Gründe für ein Video. Das Spiel steht nur für Windows zur Verfügung, Ich sp...</media:description>
        </item>
        <item>
            <title><![CDATA[ALGORITMO [Corto]]]></title>
            <link>https://peertube2.cpy.re/w/nHvKUJddRN7ouD28Cum8UY</link>
            <guid>https://peertube2.cpy.re/w/nHvKUJddRN7ouD28Cum8UY</guid>
            <pubDate>Fri, 06 Nov 2026 02:51:12 GMT</pubDate>
            <description><![CDATA[La obra traza un paralelismo entre el funcionamiento de la máquina y nuestra relación con internet, que a grandes rasgos replica la estructura del sistema capitalista. ¿Cómo nos relacionamos con todos nuestros procesos corporales? ¿Todo se ve atra...]]></description>
            <content:encoded><![CDATA[<p>La obra traza un paralelismo entre el funcionamiento de la máquina y nuestra relación con internet, que a grandes rasgos replica la estructura del sistema capitalista. ¿Cómo nos relacionamos con todos nuestros procesos corporales? ¿Todo se ve atravesado por la lógica algorítmica de "procesar para capitalizar"? ¿Cómo rompemos este esquema de racionalización dominante? ¿Cómo encontrar otras maneras de procesar nuestra experiencia viviente? ¿Cómo reconectar con nuestra propia manera de sentir que sólo nosotros mismos conocemos? ¿Cómo compartir con otros seres sintientes, si ni siquiera podemos procesar los nuestros? Desconectarse del sistema que nos hemos autoimpuesto, de la auto-observación característica del antropocentrismo, que replica los peores valores de la humanidad: aprovecharse hasta del mínimo recurso energético para generar capital, a costa de la deshidratación absoluta de los cuerpos. Es un llamado a reconectar con la propia naturaleza del cuerpo y del sentir animal, que necesita de los otros para sobrevivir.</p>
<p>Breve descripción de la producción<br />
La idea de la producción fue que sea totalmente realizado por una persona. Cámara, actuación y edición, para reforzar la idea de la ilusión de la búsqueda personal totalmente individualizada. Todo ocurre en silencio. No hay voces, las palabras solo se transmiten visualmente. Los sonidos que se escuchan son de ambiente y por los movimientos e interacciones del personaje.</p>
<p>El plano en el mundo real ocurre siempre con el mismo plano de cámara en la misma habitación. La decisión de que no se vea nada más que esta situación en la vida real, viene a que el personaje está tan subsumido en su propia cabeza que no presta atención a nada de lo que le sucede. Eso, y por medios de producción.</p>
<p>Se utilizó inteligencia artificial para producir algunos elementos de la obra, como la rotoscopia sobre el personaje en los planos en 3D. Tanto por una cuestión de discurso como de tiempos de producción, que fue utilizado a favor. Las escenas en 3D fueron realizadas en el software libre Blender, el cual tuve que aprender a usar prácticamente de 0. Pude hacerlo gracias a su enorme comunidad y los tutoriales, materiales y modelos que publican de forma libre por todo internet, sobretodo los tutoriales de CGMatter / Default Cube, las texturas de PolyHaven y los modelos de Sketchfab.</p>
<p>Muchos elementos fueron descargados y reutilizados de internet, tanto modelos 3D, el aspecto auditivo e incluso detalles como los afiches del Instituto de Trabajo, tomados del archivo histórico gráfico de la Biblioteca Nacional. La música en la escena del espejo es ultratronics 15 de Ryoji Ikeda. También usé sonidos del Half Life 1 para el ambiente y los pasos.</p>
<p>Si llegaste hasta acá te agradezco por prestar atención. Espero que te haya gustado!</p>
<p>Agosto 2023</p>
<p>Paren el mundo me quiero bajar</p>
]]></content:encoded>
            <dc:creator>elgurideltecho</dc:creator>
            <category>Art</category>
            <enclosure length="38616216" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/afdbbeaf-81cd-47ec-855f-b33465b7469c?videoFileIds=5979314"/>
            <media:community>
                <media:statistics views="16"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/nHvKUJddRN7ouD28Cum8UY"/>
            <media:player url="https://peertube2.cpy.re/w/nHvKUJddRN7ouD28Cum8UY"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/f0cf5e21-5242-40b6-a993-17ddbe9bd20a-0.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/410f761d-8424-4001-92d7-d10bd27e8d71-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/f97f456a-7fa6-469f-ba20-28815e7d4f74-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/8545fe00-1763-4621-9db4-af2ff481df8e-360-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/7a7061fc-fe02-47ff-ae75-e2eb44c8ed3a-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/46e69667-06b4-4c98-ada8-dca799417095-144-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/aa839409-9dda-4563-81f4-0239a0792cdc-0-hls.torrent" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="8415558" url="https://tube.undernet.uy/static/web-videos/d084f1ff-71fe-49df-af18-798a368e7daa-0.mp4" framerate="0" duration="345" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="38616216" url="https://tube.undernet.uy/static/streaming-playlists/hls/afdbbeaf-81cd-47ec-855f-b33465b7469c/35e63da1-594f-4a98-9604-7f03c8ad5880-720-fragmented.mp4" framerate="24" duration="345" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="23231498" url="https://tube.undernet.uy/static/streaming-playlists/hls/afdbbeaf-81cd-47ec-855f-b33465b7469c/b5c97dc1-5a81-465a-bb71-79e44e52f4c2-480-fragmented.mp4" framerate="24" duration="345" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="360" fileSize="18314509" url="https://tube.undernet.uy/static/streaming-playlists/hls/afdbbeaf-81cd-47ec-855f-b33465b7469c/63868f29-9416-4a63-ad78-72cd84075b8a-360-fragmented.mp4" framerate="24" duration="345" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="13369144" url="https://tube.undernet.uy/static/streaming-playlists/hls/afdbbeaf-81cd-47ec-855f-b33465b7469c/bb9e05dd-236e-4fc1-960b-6d77d83df4dc-240-fragmented.mp4" framerate="24" duration="345" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="144" fileSize="10688329" url="https://tube.undernet.uy/static/streaming-playlists/hls/afdbbeaf-81cd-47ec-855f-b33465b7469c/2e752eab-02ee-4e3d-ad65-4e3288974b8d-144-fragmented.mp4" framerate="24" duration="345" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="8428460" url="https://tube.undernet.uy/static/streaming-playlists/hls/afdbbeaf-81cd-47ec-855f-b33465b7469c/a4cf3fd9-271d-48ce-ab99-b527218cf57e-0-fragmented.mp4" framerate="0" duration="345" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/df56cdfc-7962-427d-95b1-a7e541c6de01.jpg" height="1400" width="1400"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">ALGORITMO [Corto]</media:title>
            <media:description type="plain">La obra traza un paralelismo entre el funcionamiento de la máquina y nuestra relación con internet, que a grandes rasgos replica la estructura del sistema capitalista. ¿Cómo nos relacionamos con todos nuestros procesos corporales? ¿Todo se ve atra...</media:description>
        </item>
        <item>
            <title><![CDATA[Il veut stopper le mouvement social !]]></title>
            <link>https://peertube2.cpy.re/w/oY9xth5zoL7HQ2jbK4GBoB</link>
            <guid>https://peertube2.cpy.re/w/oY9xth5zoL7HQ2jbK4GBoB</guid>
            <pubDate>Fri, 06 Nov 2026 00:00:00 GMT</pubDate>
            <dc:creator>Info Gaucho</dc:creator>
            <category>News &amp; Politics</category>
            <enclosure length="17277697" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/b9fff758-cc77-4cc0-87f1-1e8bd520e0db?videoFileIds=5980414&amp;videoFileIds=5980413"/>
            <media:community>
                <media:statistics views="16"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/oY9xth5zoL7HQ2jbK4GBoB"/>
            <media:player url="https://peertube2.cpy.re/w/oY9xth5zoL7HQ2jbK4GBoB"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/3775c935-a864-49c0-9d65-7e952663ccfd-0.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/b6aa1b58-b761-44e7-94b5-0f8690e49e9f-1920-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/61e3f6e1-1d4d-4365-816b-be3c03586a91-640-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/8ac0a003-48f0-4de5-af90-0ffc2000f29e-0-hls.torrent" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="1767333" url="https://lostpod.space/static/web-videos/f9a56009-8b8b-4ea9-92ad-f2e97f3c1218-0.mp4" framerate="0" duration="111" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="15510364" url="https://lostpod.space/static/streaming-playlists/hls/b9fff758-cc77-4cc0-87f1-1e8bd520e0db/daff3624-8664-40f1-9e8c-2ab055903b79-1080-fragmented.mp4" framerate="24" duration="111" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="360" fileSize="4863141" url="https://lostpod.space/static/streaming-playlists/hls/b9fff758-cc77-4cc0-87f1-1e8bd520e0db/5398fb29-8e69-4f6d-ba06-44ddf18e9318-360-fragmented.mp4" framerate="24" duration="111" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="1839865" url="https://lostpod.space/static/streaming-playlists/hls/b9fff758-cc77-4cc0-87f1-1e8bd520e0db/9cbd896b-d610-4ca2-a821-78425d9ff71e-0-fragmented.mp4" framerate="0" duration="111" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/4a639e58-2c07-4f10-acac-5a74ad9e00e2.jpg" height="1400" width="1400"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Il veut stopper le mouvement social !</media:title>
        </item>
        <item>
            <title><![CDATA[🌿 Abandoned depot, where nature has taken over. Forgotten, left to rot in a small village. England]]></title>
            <link>https://peertube2.cpy.re/w/8NK4R3zefL7tbvmzA5iNs1</link>
            <guid>https://peertube2.cpy.re/w/8NK4R3zefL7tbvmzA5iNs1</guid>
            <pubDate>Fri, 06 Nov 2026 00:00:00 GMT</pubDate>
            <description><![CDATA[🌿 Nature takes over an old abandoned depot, filling the hallways with ferns and add a splash of green to the walls. Somewhere in England, rotting away in a small village. #Abandoned #Urbex #UrbanExploration #England]]></description>
            <content:encoded><![CDATA[<p>🌿 Nature takes over an old abandoned depot, filling the hallways with ferns and add a splash of green to the walls. Somewhere in England, rotting away in a small village.</p>
<p>#Abandoned #Urbex #UrbanExploration #England</p>
]]></content:encoded>
            <dc:creator>Obsidian Urbex - Abandoned Places Videos</dc:creator>
            <category>Entertainment</category>
            <enclosure length="11426320" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/3f36b97e-e22e-4191-aaba-ca71c4dc8fc4?videoFileIds=5980586&amp;videoFileIds=5980585"/>
            <media:community>
                <media:statistics views="5"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/8NK4R3zefL7tbvmzA5iNs1"/>
            <media:player url="https://peertube2.cpy.re/w/8NK4R3zefL7tbvmzA5iNs1"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/e25560e5-663a-4c0e-9c49-c0a7e994b74d-0.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/880dc2bb-8f6b-475a-abdb-bf7dadc93dbd-1920-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/8ce29aa0-7f89-4e4a-ad59-859b6ee5f005-640-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/f225484c-647c-4653-ad0b-7c8567597e11-0-hls.torrent" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="598797" url="https://lostpod.space/static/web-videos/6cce5b26-1ac3-4fcc-85b2-447120cbbd77-0.mp4" framerate="0" duration="36" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="10827523" url="https://lostpod.space/static/streaming-playlists/hls/3f36b97e-e22e-4191-aaba-ca71c4dc8fc4/6a3b53a7-e7bd-44a3-8bf7-89fe08d9d10e-1080-fragmented.mp4" framerate="60" duration="36" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="360" fileSize="2141975" url="https://lostpod.space/static/streaming-playlists/hls/3f36b97e-e22e-4191-aaba-ca71c4dc8fc4/b23cf52a-2725-47a8-ad41-6c2993d0333b-360-fragmented.mp4" framerate="30" duration="36" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="591809" url="https://lostpod.space/static/streaming-playlists/hls/3f36b97e-e22e-4191-aaba-ca71c4dc8fc4/18909985-9062-4277-9f09-d03f5549349e-0-fragmented.mp4" framerate="0" duration="36" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/9f4599de-f175-45ce-af56-7b38238ea151.jpg" height="1400" width="1400"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">🌿 Abandoned depot, where nature has taken over. Forgotten, left to rot in a small village. England</media:title>
            <media:description type="plain">🌿 Nature takes over an old abandoned depot, filling the hallways with ferns and add a splash of green to the walls. Somewhere in England, rotting away in a small village. #Abandoned #Urbex #UrbanExploration #England</media:description>
        </item>
        <item>
            <title><![CDATA[Le rassemblement réac du maire d'Orléans se retourne contre lui]]></title>
            <link>https://peertube2.cpy.re/w/vtRA1bo33HhWYcNupkhm9f</link>
            <guid>https://peertube2.cpy.re/w/vtRA1bo33HhWYcNupkhm9f</guid>
            <pubDate>Fri, 06 Nov 2026 00:00:00 GMT</pubDate>
            <dc:creator>Info Gaucho</dc:creator>
            <category>News &amp; Politics</category>
            <enclosure length="25791395" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/eebca95b-39a0-4690-9b65-ded7747729be?videoFileIds=5980724&amp;videoFileIds=5980723"/>
            <media:community>
                <media:statistics views="10"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/vtRA1bo33HhWYcNupkhm9f"/>
            <media:player url="https://peertube2.cpy.re/w/vtRA1bo33HhWYcNupkhm9f"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/d2d163fd-b652-4b71-b46a-f8cad67fe53d-0.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/94ba3287-f133-4a8d-b3f8-f972d5f10bd6-1920-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/2489bd67-6933-463d-b768-720db27d0d52-640-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/9dd095ed-796c-41a0-b0c3-edbb84c071b6-0-hls.torrent" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="1332893" url="https://lostpod.space/static/web-videos/36994b03-16e7-4a19-81b1-ff1180455e79-0.mp4" framerate="0" duration="102" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="24458502" url="https://lostpod.space/static/streaming-playlists/hls/eebca95b-39a0-4690-9b65-ded7747729be/77e3a34b-4b79-474d-ab1c-677a00e3b8bf-1080-fragmented.mp4" framerate="30" duration="102" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="360" fileSize="9495067" url="https://lostpod.space/static/streaming-playlists/hls/eebca95b-39a0-4690-9b65-ded7747729be/f6ffb94e-e0ad-41d6-b87a-8ad18feb7057-360-fragmented.mp4" framerate="30" duration="102" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="1670337" url="https://lostpod.space/static/streaming-playlists/hls/eebca95b-39a0-4690-9b65-ded7747729be/43ffee7c-4539-4551-bf91-6f61ee332327-0-fragmented.mp4" framerate="0" duration="102" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/63c0178d-9cb1-4722-ad84-95ff8665b242.jpg" height="1400" width="1400"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Le rassemblement réac du maire d'Orléans se retourne contre lui</media:title>
        </item>
    </channel>
</rss>

Videos of subscriptions feeds

path Parameters
format
required
string
Enum: "xml" "rss" "rss2" "atom" "atom1" "json" "json1"

format expected (we focus on making rss the most feature-rich ; it serves Media RSS)

query Parameters
accountId
required
string

limit listing to a specific account

hasHLSFiles
boolean

PeerTube >= 4.0 Display only videos that have HLS files

hasWebVideoFiles
boolean

PeerTube >= 6.0 Display only videos that have Web Video files

include
integer
Enum: 0 1 2 4 8 16 32

Only administrators and moderators can use this parameter

Include additional videos in results (can be combined using bitwise or operator)

  • 0 NONE
  • 1 NOT_PUBLISHED_STATE
  • 2 BLACKLISTED
  • 4 BLOCKED_OWNER
  • 8 FILES
  • 16 CAPTIONS
  • 32 VIDEO SOURCE
isLocal
boolean

PeerTube >= 4.0 Display only local or remote objects

nsfw
string
Enum: "true" "false"

whether to include nsfw videos, if any

privacyOneOf
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

PeerTube >= 4.0 Display only videos in this specific privacy/privacies

sort
string
Example: sort=-createdAt

Sort column

token
required
string

private token allowing access

Responses

Response samples

Content type
No sample

Videos podcast feed

query Parameters
enclosurePreference
string
Enum: "video-only" "audio-only"

Filter enclosures by type (video-only or audio-only)

playlistId
string

Limit listing to a specific video playlist

videoChannelId
string

Limit listing to a specific video channel

Responses

Video chapters of podcast feeds

PeerTube >= 9.0 Chapters of a video in the Podcasting 2.0 JSON format, referenced by the podcast:chapters tag of podcast feed items. See https://podcasting2.org/docs/podcast-namespace/tags/chapters

query Parameters
videoId
required
string

The video id, uuid or short uuid

Responses

Response samples

Content type
{
  • "version": "1.2.0",
  • "chapters": [
    ]
}

Register

As a visitor, you can use this API to open an account (if registrations are open on that PeerTube instance). As an admin, you should use the dedicated User creation API instead.

Resend user verification link

Request Body schema: application/json
email
required
string

User email

Responses

Request samples

Content type
application/json
{
  • "email": "string"
}

Resend verification link to registration request email

Request Body schema: application/json
email
required
string

Registration email

Responses

Request samples

Content type
application/json
{
  • "email": "string"
}

Verify a user

Following a user registration, the new user will receive an email asking to click a link containing a secret. This endpoint can also be used to verify a new email set in the user account.

path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

Request Body schema: application/json
verificationString
required
string <url>
isPendingEmail
boolean

Responses

Request samples

Content type
application/json
{
  • "verificationString": "string",
  • "isPendingEmail": true
}

Verify a registration email

Following a user registration request, the user will receive an email asking to click a link containing a secret.

path Parameters
registrationId
required
integer (id) >= 1
Example: 42

Registration ID

Request Body schema: application/json
verificationString
required
string <url>

Responses

Request samples

Content type
application/json
{
  • "verificationString": "string"
}

Register a user

Signup has to be enabled and signup approval is not required

Request Body schema: application/json
required
email
required
string <email>

email of the user, used for login or service communications

password
required
string <password> (password) [ 6 .. 50 ] characters
username
required
string [ 1 .. 50 ] characters /^[a-z0-9._]+$/

immutable name of the user, used to find or mention its actor

object

channel base information used to create the first channel of the user

displayName
string [ 1 .. 120 ] characters

editable name of the user, displayed in its representations

signupClient
string
Value: "peertube-app"

PeerTube >= 9.0 Client used to sign up. If set, links of the verification and registration accepted emails make the web client propose to open this client

Responses

Request samples

Content type
application/json
{
  • "username": "chocobozzz",
  • "password": "pa$$word",
  • "email": "user@example.com",
  • "displayName": "string",
  • "channel": {
    },
  • "signupClient": "peertube-app"
}

Response samples

Content type
application/json
{
  • "state": {
    }
}

Request registration

Signup has to be enabled and require approval on the instance

Request Body schema: application/json
email
required
string <email>

email of the user, used for login or service communications

password
required
string <password> (password) [ 6 .. 50 ] characters
registrationReason
required
string

reason for the user to register on the instance

username
required
string [ 1 .. 50 ] characters /^[a-z0-9._]+$/

immutable name of the user, used to find or mention its actor

object

channel base information used to create the first channel of the user

displayName
string [ 1 .. 120 ] characters

editable name of the user, displayed in its representations

signupClient
string
Value: "peertube-app"

PeerTube >= 9.0 Client used to sign up. If set, links of the verification and registration accepted emails make the web client propose to open this client

Responses

Request samples

Content type
application/json
{
  • "username": "chocobozzz",
  • "password": "pa$$word",
  • "email": "user@example.com",
  • "displayName": "string",
  • "channel": {
    },
  • "signupClient": "peertube-app",
  • "registrationReason": "string"
}

Response samples

Content type
application/json
{
  • "state": {
    }
}

Accept registration

Authorizations:
OAuth2
path Parameters
registrationId
required
integer (id) >= 1
Example: 42

Registration ID

Request Body schema: application/json
moderationResponse
required
string

Moderation response to send to the user

preventEmailDelivery
boolean

Set it to true if you don't want PeerTube to send an email to the user

Responses

Request samples

Content type
application/json
{
  • "moderationResponse": "string",
  • "preventEmailDelivery": true
}

Reject registration

Authorizations:
OAuth2
path Parameters
registrationId
required
integer (id) >= 1
Example: 42

Registration ID

Request Body schema: application/json
moderationResponse
required
string

Moderation response to send to the user

preventEmailDelivery
boolean

Set it to true if you don't want PeerTube to send an email to the user

Responses

Request samples

Content type
application/json
{
  • "moderationResponse": "string",
  • "preventEmailDelivery": true
}

Delete registration

Delete the registration entry. It will not remove the user associated with this registration (if any)

Authorizations:
OAuth2
path Parameters
registrationId
required
integer (id) >= 1
Example: 42

Registration ID

Responses

List registrations

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

search
string
sort
string
Enum: "-createdAt" "createdAt" "state" "-state"
start
integer >= 0

Offset used to paginate results

stateOneOf
Array of integers (UserRegistrationState)
Items Enum: 1 2 3

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Login/Logout

Sessions deal with access tokens over time. Only one session token can currently be used at a time.

Login prerequisite

You need to retrieve a client id and secret before logging in.

Responses

Request samples 

API="https://peertube2.cpy.re/api/v1"

## AUTH
curl -s "$API/oauth-clients/local"

Response samples

Content type
application/json
{
  • "client_id": "v1ikx5hnfop4mdpnci8nsqh93c45rldf",
  • "client_secret": "AjWiOapPltI6EnsWQwlFarRtLh4u8tDt"
}

Login

With your client id and secret, you can retrieve an access and refresh tokens.

header Parameters
x-peertube-otp
string

If the user enabled two factor authentication, you need to provide the OTP code in this header

Request Body schema: application/x-www-form-urlencoded
client_id
required
string = 32 characters /^[a-z0-9]$/
client_secret
required
string = 32 characters /^[a-zA-Z0-9]$/
grant_type
required
string
username
required
string [ 1 .. 50 ] characters /^[a-z0-9._]+$/

immutable name of the user, used to find or mention its actor

externalAuthToken
string

If you want to authenticate using an external authentication token you got from an auth plugin (like peertube-plugin-auth-openid-connect for example) instead of a password or a refresh token, provide it here.

password
string <password> (password) [ 6 .. 50 ] characters

Responses

Request samples 

## DEPENDENCIES: jq
API="https://peertube2.cpy.re/api/v1"
USERNAME="<your_username>"
PASSWORD="<your_password>"

## AUTH
client_id=$(curl -s "$API/oauth-clients/local" | jq -r ".client_id")
client_secret=$(curl -s "$API/oauth-clients/local" | jq -r ".client_secret")
curl -s "$API/users/token" \
  --data client_id="$client_id" \
  --data client_secret="$client_secret" \
  --data grant_type=password \
  --data username="$USERNAME" \
  --data-urlencode password="$PASSWORD" \
  | jq -r ".access_token"

Response samples

Content type
application/json
{
  • "token_type": "Bearer",
  • "access_token": "90286a0bdf0f7315d9d3fe8dabf9e1d2be9c97d0",
  • "refresh_token": "2e0d675df9fc96d2e4ec8a3ebbbf45eca9137bb7",
  • "expires_in": 14399,
  • "refresh_token_expires_in": 1209600
}

Logout

Revokes your access token and its associated refresh token, destroying your current session.

Authorizations:
OAuth2

Responses

List token sessions

Authorizations:
OAuth2
path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

List token sessions

Authorizations:
OAuth2
path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

tokenSessionId
required
integer (id) >= 1
Example: 42

Token session Id

Responses

Accounts

Accounts encompass remote accounts discovered across the federation, and correspond to the main Actor, along with video channels a user can create, which are also Actors. When a comment is posted, it is done with your Account's Actor.

Get an account

path Parameters
name
required
string
Example: chocobozzz | chocobozzz@example.org

The username or handle of the account

Responses

Response samples

Content type
application/json
{
  • "id": 42,
  • "url": "string",
  • "name": "chocobozzz",
  • "avatars": [
    ],
  • "host": "example.com",
  • "hostRedundancyAllowed": true,
  • "followingCount": 0,
  • "followersCount": 0,
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "userId": 42,
  • "displayName": "string",
  • "description": "string"
}

List videos of an account

path Parameters
name
required
string
Example: chocobozzz | chocobozzz@example.org

The username or handle of the account

query Parameters
VideoAIUsageSet (integer) or Array of VideoAIUsageSet (integers)

PeerTube >= 9.0 Only list videos with one of these AI usages, declared by video creators. If not provided, the preference of the authenticated user (aiUsagesHidden) is used

string or Array of strings

PeerTube >= 6.2 Admins and moderators only filter on videos that contain one of these automatic tags

VideoCategorySet (integer) or Array of VideoCategorySet (integers)

category id of the video (see /videos/categories)

count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

excludeAlreadyWatched
boolean

Whether or not to exclude videos that are in the user's video history

hasHLSFiles
boolean

PeerTube >= 4.0 Display only videos that have HLS files

hasWebVideoFiles
boolean

PeerTube >= 6.0 Display only videos that have Web Video files

host
string

Find elements owned by this host

include
integer
Enum: 0 1 2 4 8 16 32

Only administrators and moderators can use this parameter

Include additional videos in results (can be combined using bitwise or operator)

  • 0 NONE
  • 1 NOT_PUBLISHED_STATE
  • 2 BLACKLISTED
  • 4 BLOCKED_OWNER
  • 8 FILES
  • 16 CAPTIONS
  • 32 VIDEO SOURCE
includeScheduledLive
boolean

whether or not include live that are scheduled for later

isLive
boolean

whether or not the video is a live

isLocal
boolean

PeerTube >= 4.0 Display only local or remote objects

VideoLanguageSet (string) or Array of VideoLanguageSet (strings)

language id of the video (see /videos/languages). Use _unknown to filter on videos that don't have a video language

VideoLicenceSet (integer) or Array of VideoLicenceSet (integers)

licence id of the video (see /videos/licences)

nsfw
string
Enum: "true" "false"

whether to include nsfw videos, if any

nsfwFlagsExcluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwFlagsIncluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
privacyOneOf
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

PeerTube >= 4.0 Display only videos in this specific privacy/privacies

search
string

Plain text search, applied to various parts of the model depending on endpoint

skipCount
string
Default: "false"
Enum: "true" "false"

if you don't need the total in the response

sort
string
Enum: "name" "-duration" "-createdAt" "-publishedAt" "-views" "-likes" "-comments" "-trending" "-hot" "-best"

Sort videos by criteria (prefixing with - means DESC order):

  • hot - Adaptation of Reddit "hot" algorithm taking into account video views, likes, dislikes and comments and publication date
  • best - Same than hot, but also takes into account user video history
  • trending - Sort videos by recent views ("recent" is defined by the admin)
  • views - Sort videos using their views counter
  • publishedAt - Sort by video publication date (when it became publicly available)
start
integer >= 0

Offset used to paginate results

integer or Array of integers

PeerTube >= 8.2 Admins and moderators only filter on videos that have one of these states

string or Array of strings

tag(s) of the video, where all should be present in the video

string or Array of strings

tag(s) of the video

Responses

Request samples 

fetch('https://peertube2.cpy.re/api/v1/accounts/{name}/videos')
.then(function(response) {
  return response.json()
}).then(function(data) {
  console.log(data)
})

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

List followers of an account

Authorizations:
OAuth2
path Parameters
name
required
string
Example: chocobozzz | chocobozzz@example.org

The username or handle of the account

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

search
string

Plain text search, applied to various parts of the model depending on endpoint

sort
string
Value: "createdAt"

Sort followers by criteria

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

List accounts

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

List playlists of an account

path Parameters
name
required
string
Example: chocobozzz | chocobozzz@example.org

The username or handle of the account

query Parameters
string or Array of strings

PeerTube >= 8.0 Filter on playlists that are published on a channel with one of these names

count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

includeCollaborations
boolean

PeerTube >= 8.0 Include objects from collaborated channels

playlistType
integer (VideoPlaylistTypeSet)
Enum: 1 2

The video playlist type (Regular = 1, Watch Later = 2)

search
string

Plain text search, applied to various parts of the model depending on endpoint

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

List video channels of an account

path Parameters
name
required
string
Example: chocobozzz | chocobozzz@example.org

The username or handle of the account

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

includeCollaborations
boolean

PeerTube >= 8.0 Include objects from collaborated channels

search
string

Plain text search, applied to various parts of the model depending on endpoint

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

statsDays
integer
Default: 30
Enum: 30 90 365 0

number of days of view statistics to include in viewsPerDay when withStats is true (only if authenticated as the account user). 0 means all time (since the channel's earliest recorded stat). viewsPerDay always spans the whole requested range so channels can be compared to each other. Its bucket size is reported in viewsGroupInterval: it is derived from the requested range, narrowed to the channel history so that a young channel on a long range is not aggregated into a single coarse bucket. totalViews is unaffected by this parameter and always reports lifetime views.

withStats
boolean

include view statistics time series and total views (only if authenticated as the account user)

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

List the synchronizations of video channels of an account

path Parameters
name
required
string
Example: chocobozzz | chocobozzz@example.org

The username or handle of the account

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

includeCollaborations
boolean

PeerTube >= 8.0 Include objects from collaborated channels

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

List ratings of an account

Authorizations:
OAuth2
path Parameters
name
required
string
Example: chocobozzz | chocobozzz@example.org

The username or handle of the account

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

rating
string
Enum: "like" "dislike"

Optionally filter which ratings to retrieve

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Users

Using some features of PeerTube require authentication, for which User provide different levels of permission as well as associated user information. Each user has a corresponding local Account for federation.

Create a user

Authorizations:
OAuth2
Request Body schema: application/json
required

If the smtp server is configured, you can leave the password empty and an email will be sent asking the user to set it first.

email
required
string <email>

The user email

password
required
string <password> (password) [ 6 .. 50 ] characters
role
required
integer (UserRole)
Enum: 0 1 2

The user role (Admin = 0, Moderator = 1, User = 2)

username
required
string (username) [ 1 .. 50 ] characters /^[a-z0-9._]+$/

immutable name of the user, used to find or mention its actor

adminFlags
integer (UserAdminFlags)
Enum: 0 1

Admin flags for the user (None = 0, Bypass video blocklist = 1)

channelName
string (usernameChannel) [ 1 .. 50 ] characters /^[a-zA-Z0-9\\-_.:]+$/

immutable name of the channel, used to interact with its actor

currentPassword
string <password>

Required to create an administrator, see password confirmation

videoQuota
integer

The user video quota in bytes

videoQuotaDaily
integer

The user daily video quota in bytes

Responses

Request samples

Content type
application/json
{
  • "username": "chocobozzz",
  • "password": "pa$$word",
  • "email": "user@example.com",
  • "videoQuota": -1,
  • "videoQuotaDaily": -1,
  • "channelName": "framasoft_videos",
  • "role": 2,
  • "adminFlags": 1,
  • "currentPassword": "pa$$word"
}

Response samples

Content type
application/json
{
  • "user": {
    }
}

List users

Authorizations:
OAuth2
query Parameters
blocked
boolean

Filter results down to (un)banned users

count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

role
integer (UserRole)
Enum: 0 1 2
Example: role=2

Filter results down to users with a specific role

search
string

Plain text search that will match with user usernames or emails

sort
string
Enum: "-id" "-username" "-createdAt"

Sort users by criteria

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Delete a user

Authorizations:
OAuth2
path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

Responses

Get a user

Authorizations:
OAuth2
path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

query Parameters
withStats
boolean

include statistics about the user (only available as a moderator/admin)

Responses

Response samples

Content type
application/json
Example
{
  • "id": 42,
  • "username": "chocobozzz",
  • "email": "user@example.com",
  • "emailVerified": true,
  • "nsfwPolicy": "display",
  • "nsfwFlagsDisplayed": 0,
  • "nsfwFlagsHidden": 0,
  • "nsfwFlagsWarned": 0,
  • "nsfwFlagsBlurred": 0,
  • "aiUsagesHidden": [
    ],
  • "adminFlags": 1,
  • "autoPlayNextVideo": true,
  • "autoPlayNextVideoPlaylist": true,
  • "autoPlayVideo": true,
  • "p2pEnabled": true,
  • "videosHistoryEnabled": true,
  • "videoLanguages": [
    ],
  • "videoCategories": [
    ],
  • "videoLive": "true",
  • "language": "string",
  • "videoQuota": -1,
  • "videoQuotaDaily": -1,
  • "role": {
    },
  • "theme": "string",
  • "account": {
    },
  • "notificationSettings": {
    },
  • "videoChannels": [
    ],
  • "blocked": true,
  • "blockedReason": "string",
  • "noInstanceConfigWarningModal": true,
  • "noAccountSetupWarningModal": true,
  • "noWelcomeModal": true,
  • "createdAt": "string",
  • "pluginAuth": "string",
  • "lastLoginDate": "2019-08-24T14:15:22Z",
  • "twoFactorEnabled": true,
  • "newFeaturesInfoRead": 0
}

Update a user

Authorizations:
OAuth2
path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

Request Body schema: application/json
required
adminFlags
integer (UserAdminFlags)
Enum: 0 1

Admin flags for the user (None = 0, Bypass video blocklist = 1)

currentPassword
string <password>

Required to give the administrator role, or to change the password, email or auth plugin of an administrator, see password confirmation

email
string <email>

The updated email of the user

emailVerified
boolean

Set the email as verified

password
string <password> (password) [ 6 .. 50 ] characters
pluginAuth
string or null

The auth plugin to use to authenticate the user

role
integer (UserRole)
Enum: 0 1 2

The user role (Admin = 0, Moderator = 1, User = 2)

videoQuota
integer

The updated video quota of the user in bytes

videoQuotaDaily
integer

The updated daily video quota of the user in bytes

Responses

Request samples

Content type
application/json
{
  • "email": "user@example.com",
  • "emailVerified": true,
  • "videoQuota": 0,
  • "videoQuotaDaily": 0,
  • "pluginAuth": "peertube-plugin-auth-saml2",
  • "role": 2,
  • "adminFlags": 1,
  • "password": "pa$$word",
  • "currentPassword": "pa$$word"
}

Block a user

Prevent a user from logging in and interacting with the instance

Authorizations:
OAuth2
path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

Request Body schema: application/json
reason
string [ 0 .. 500 ] characters

Optional reason for blocking the user

Responses

Request samples

Content type
application/json
{
  • "reason": "string"
}

Unblock a user

Allow a previously blocked user to login and interact with the instance

Authorizations:
OAuth2
path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

Responses

Resend user verification link

Request Body schema: application/json
email
required
string

User email

Responses

Request samples

Content type
application/json
{
  • "email": "string"
}

Verify a user

Following a user registration, the new user will receive an email asking to click a link containing a secret. This endpoint can also be used to verify a new email set in the user account.

path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

Request Body schema: application/json
verificationString
required
string <url>
isPendingEmail
boolean

Responses

Request samples

Content type
application/json
{
  • "verificationString": "string",
  • "isPendingEmail": true
}

Ask to reset password

An email containing a reset password link

Request Body schema: application/json
email
required
string

User email

Responses

Request samples

Content type
application/json
{
  • "email": "string"
}

Reset password

path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

Request Body schema: application/json
password
required
string
verificationString
required
string <url>

Responses

Request samples

Content type
application/json
{
  • "verificationString": "string",
  • "password": "string"
}

Request two factor auth

Request two factor authentication for a user

Authorizations:
OAuth2
path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

Request Body schema: application/json
currentPassword
string

Password of the currently authenticated user

Responses

Request samples

Content type
application/json
{
  • "currentPassword": "string"
}

Response samples

Content type
application/json
[
  • {
    }
]

Confirm two factor auth

Confirm a two factor authentication request

Authorizations:
OAuth2
path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

Request Body schema: application/json
otpToken
required
string

OTP token generated by the app

requestToken
required
string

Token to identify the two factor request

Responses

Request samples

Content type
application/json
{
  • "requestToken": "string",
  • "otpToken": "string"
}

Disable two factor auth

Disable two factor authentication of a user

Authorizations:
OAuth2
path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

Request Body schema: application/json
currentPassword
string

Password of the currently authenticated user. Users of an id and pass auth plugin must use the password they log in with

Responses

Request samples

Content type
application/json
{
  • "currentPassword": "string"
}

User Exports

To create an archive of user data.

Request user export

Request an archive of user data. An email is sent when the archive is ready.

Authorizations:
OAuth2
path Parameters
userId
required
integer (id) >= 1
Example: 42

User id

Request Body schema: application/json
withVideoFiles
boolean

Whether to include video files in the archive

Responses

Request samples

Content type
application/json
{
  • "withVideoFiles": true
}

Response samples

Content type
application/json
{
  • "export": {
    }
}

List user exports

PeerTube >= 6.1

Authorizations:
OAuth2
path Parameters
userId
required
integer (id) >= 1
Example: 42

User id

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "state": {
    },
  • "size": 0,
  • "privateDownloadUrl": "string",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "expiresOn": "2019-08-24T14:15:22Z"
}

Delete a user export

PeerTube >= 6.1

Authorizations:
OAuth2
path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

userId
required
integer (id) >= 1
Example: 42

User id

Responses

User Imports

To import an archive of user data.

Initialize the resumable user import

PeerTube >= 6.1 Uses a resumable protocol to initialize the import of the archive

Authorizations:
OAuth2
path Parameters
userId
required
integer (id) >= 1
Example: 42

User id

header Parameters
X-Upload-Content-Length
required
number
Example: 2469036

Number of bytes that will be uploaded in subsequent requests. Set this value to the size of the file you are uploading.

X-Upload-Content-Type
required
string <mimetype>
Example: video/mp4

MIME type of the file that you are uploading. Depending on your instance settings, acceptable values might vary.

Request Body schema: application/json
filename
string <filename>

Archive filename including extension

Responses

Request samples

Content type
application/json
{
  • "filename": "user-export-6-2024-02-09T10_12_11.682Z"
}

Send chunk for the resumable user import

PeerTube >= 6.1 Uses a resumable protocol to continue, pause or resume the import of the archive

Authorizations:
OAuth2
path Parameters
userId
required
integer (id) >= 1
Example: 42

User id

query Parameters
upload_id
required
string

Created session id to proceed with. If you didn't send chunks in the last hour, it is not valid anymore and you need to initialize a new upload.

header Parameters
Content-Length
required
number
Example: 262144

Size of the chunk that the request is sending.

Remember that larger chunks are more efficient. PeerTube's web client uses chunks varying from 1048576 bytes (~1MB) and increases or reduces size depending on connection health.

Content-Range
required
string
Example: bytes 0-262143/2469036

Specifies the bytes in the file that the request is uploading.

For example, a value of bytes 0-262143/1000000 shows that the request is sending the first 262144 bytes (256 x 1024) in a 2,469,036 byte file.

When the server config client.videos.resumableUpload.minChunkSize (video uploads) or import.users.resumableUpload.minChunkSize (user archive imports) is not 0, every chunk except the last one must be at least that big. It must also be at least 1/10,000 of the file size (the maximum number of object storage multipart upload parts).

Request Body schema: application/octet-stream
string <binary>

Responses

Cancel the resumable user import

PeerTube >= 6.1 Uses a resumable protocol to cancel the resumable user import

Authorizations:
OAuth2
path Parameters
userId
required
integer (id) >= 1
Example: 42

User id

query Parameters
upload_id
required
string

Created session id to proceed with. If you didn't send chunks in the last hour, it is not valid anymore and you need to initialize a new upload.

header Parameters
Content-Length
required
number
Example: 0

Responses

Get latest user import

PeerTube >= 6.1

Authorizations:
OAuth2
path Parameters
userId
required
integer (id) >= 1
Example: 42

User id

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "state": {
    },
  • "createdAt": "2019-08-24T14:15:22Z"
}

My User

Operations related to your own User, when logged-in.

Get my user information

Authorizations:
OAuth2

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Update my user information

Authorizations:
OAuth2
Request Body schema: application/json
required
aiUsagesHidden
Array of integers (VideoAIUsageSet)
Items Enum: 1 2 3 4

PeerTube >= 9.0 Videos with these AI usages are hidden from video lists

autoPlayNextVideo
boolean

new preference regarding playing following videos automatically

autoPlayNextVideoPlaylist
boolean

new preference regarding playing following playlist videos automatically

autoPlayVideo
boolean

new preference regarding playing videos automatically

currentPassword
string <password> (password) [ 6 .. 50 ] characters
displayName
string [ 3 .. 120 ] characters

new name of the user in its representations

email
string <email>

new email used for login and service communications

language
string

default language for this user

noAccountSetupWarningModal
boolean
noInstanceConfigWarningModal
boolean
noWelcomeModal
boolean
nsfwFlagsBlurred
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwFlagsDisplayed
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwFlagsHidden
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwFlagsWarned
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwPolicy
string
Enum: "true" "false" "both"

new NSFW display policy

p2pEnabled
boolean

whether to enable P2P in the player or not

password
string <password> (password) [ 6 .. 50 ] characters
theme
string
videoCategories
Array of integers or null

list of categories to filter videos down to (null means all categories)

videoLanguages
Array of strings

list of languages to filter videos down to

videoLive
string
Enum: "true" "false" "both"

filter videos down to lives (true), VODs (false) or display both

videosHistoryEnabled
boolean

whether to keep track of watched history or not

Responses

Request samples

Content type
application/json
{
  • "password": "pa$$word",
  • "currentPassword": "pa$$word",
  • "email": "user@example.com",
  • "displayName": "string",
  • "nsfwPolicy": "true",
  • "nsfwFlagsDisplayed": 0,
  • "nsfwFlagsHidden": 0,
  • "nsfwFlagsWarned": 0,
  • "nsfwFlagsBlurred": 0,
  • "aiUsagesHidden": [
    ],
  • "p2pEnabled": true,
  • "autoPlayVideo": true,
  • "autoPlayNextVideo": true,
  • "autoPlayNextVideoPlaylist": true,
  • "videosHistoryEnabled": true,
  • "videoLanguages": [
    ],
  • "videoCategories": [
    ],
  • "videoLive": "true",
  • "language": "string",
  • "theme": "string",
  • "noInstanceConfigWarningModal": true,
  • "noAccountSetupWarningModal": true,
  • "noWelcomeModal": true
}

Delete my account

Delete the authenticated user's account and all associated data

Authorizations:
OAuth2

Responses

Get video imports of my user

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

includeCollaborations
boolean

PeerTube >= 8.0 Include objects from collaborated channels

search
string

Search in video names

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

stateOneOf
Array of integers
Items Enum: 1 2 3 4 5 6

Filter on import state

targetUrl
string

Filter on import target URL

videoChannelSyncId
number

Filter on imports created by a specific channel synchronization

videoId
integer

Filter on import video ID

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Get my user used quota

Authorizations:
OAuth2

Responses

Response samples

Content type
application/json
{
  • "videoQuotaUsed": 16810141515,
  • "videoQuotaUsedDaily": 1681014151
}

Get rate of my user for a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

Video id or UUID

Responses

Response samples

Content type
application/json
{
  • "id": 42,
  • "rating": "like"
}

List videos of my user

Authorizations:
OAuth2
query Parameters
VideoAIUsageSet (integer) or Array of VideoAIUsageSet (integers)

PeerTube >= 9.0 Only list videos with one of these AI usages, declared by video creators. If not provided, the preference of the authenticated user (aiUsagesHidden) is used

string or Array of strings

PeerTube >= 6.2 Admins and moderators only filter on videos that contain one of these automatic tags

VideoCategorySet (integer) or Array of VideoCategorySet (integers)

category id of the video (see /videos/categories)

string or Array of strings

PeerTube >= 7.2 Filter on videos that are published by a channel with one of these names

count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

excludeAlreadyWatched
boolean

Whether or not to exclude videos that are in the user's video history

hasHLSFiles
boolean

PeerTube >= 4.0 Display only videos that have HLS files

hasWebVideoFiles
boolean

PeerTube >= 6.0 Display only videos that have Web Video files

host
string

Find elements owned by this host

include
integer
Enum: 0 1 2 4 8 16 32

Only administrators and moderators can use this parameter

Include additional videos in results (can be combined using bitwise or operator)

  • 0 NONE
  • 1 NOT_PUBLISHED_STATE
  • 2 BLACKLISTED
  • 4 BLOCKED_OWNER
  • 8 FILES
  • 16 CAPTIONS
  • 32 VIDEO SOURCE
includeCollaborations
boolean

PeerTube >= 8.0 Include objects from collaborated channels

includeScheduledLive
boolean

whether or not include live that are scheduled for later

isLive
boolean

whether or not the video is a live

isLocal
boolean

PeerTube >= 4.0 Display only local or remote objects

VideoLanguageSet (string) or Array of VideoLanguageSet (strings)

language id of the video (see /videos/languages). Use _unknown to filter on videos that don't have a video language

VideoLicenceSet (integer) or Array of VideoLicenceSet (integers)

licence id of the video (see /videos/licences)

nsfw
string
Enum: "true" "false"

whether to include nsfw videos, if any

nsfwFlagsExcluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwFlagsIncluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
privacyOneOf
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

PeerTube >= 4.0 Display only videos in this specific privacy/privacies

search
string

Plain text search, applied to various parts of the model depending on endpoint

skipCount
string
Default: "false"
Enum: "true" "false"

if you don't need the total in the response

sort
string
Enum: "name" "-duration" "-createdAt" "-publishedAt" "-views" "-likes" "-comments" "-trending" "-hot" "-best"

Sort videos by criteria (prefixing with - means DESC order):

  • hot - Adaptation of Reddit "hot" algorithm taking into account video views, likes, dislikes and comments and publication date
  • best - Same than hot, but also takes into account user video history
  • trending - Sort videos by recent views ("recent" is defined by the admin)
  • views - Sort videos using their views counter
  • publishedAt - Sort by video publication date (when it became publicly available)
start
integer >= 0

Offset used to paginate results

integer or Array of integers

PeerTube >= 8.2 Admins and moderators only filter on videos that have one of these states

string or Array of strings

tag(s) of the video, where all should be present in the video

string or Array of strings

tag(s) of the video

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Mark feature info as read

**PeerTube >= v8.0.0

Authorizations:
OAuth2
Request Body schema: application/json
feature
required
integer (NewFeatureInfoType)
Value: 1

Represent a new feature that can be displayed to inform users. One of the following values:

  • 1 CHANNEL_COLLABORATION

Responses

Request samples

Content type
application/json
{
  • "feature": 1
}

Update my user avatar

Authorizations:
OAuth2
Request Body schema: multipart/form-data
avatarfile
string <binary>

The file to upload

Responses

Response samples

Content type
application/json
{
  • "avatars": [
    ]
}

Delete my avatar

Authorizations:
OAuth2

Responses

List my abuses

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

id
integer

only list the report with this id

sort
string
Enum: "-id" "-createdAt" "-state"

Sort abuses by criteria

start
integer >= 0

Offset used to paginate results

state
integer (AbuseStateSet)
Enum: 1 2 3

The abuse state (Pending = 1, Rejected = 2, Accepted = 3)

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

My Subscriptions

Operations related to your subscriptions to video channels, their new videos, and how to keep up to date with their latest publications!

List my user subscriptions

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Enum: "-id" "-createdAt" "-channelUpdatedAt"
start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Add subscription to my user

Authorizations:
OAuth2
Request Body schema: application/json
uri
required
string <uri>

uri of the video channels to subscribe to

Responses

Request samples

Content type
application/json
{
  • "uri": "008a0e54-375d-49d0-8379-143202e24152@video.lqdn.fr"
}

Get if subscriptions exist for my user

Authorizations:
OAuth2
query Parameters
uris
required
Array of strings <uri> [ items <uri > ]

list of uris to check if each is part of the user subscriptions

Responses

Response samples

Content type
application/json
{ }

List videos of subscriptions of my user

Authorizations:
OAuth2
query Parameters
VideoAIUsageSet (integer) or Array of VideoAIUsageSet (integers)

PeerTube >= 9.0 Only list videos with one of these AI usages, declared by video creators. If not provided, the preference of the authenticated user (aiUsagesHidden) is used

string or Array of strings

PeerTube >= 6.2 Admins and moderators only filter on videos that contain one of these automatic tags

VideoCategorySet (integer) or Array of VideoCategorySet (integers)

category id of the video (see /videos/categories)

count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

excludeAlreadyWatched
boolean

Whether or not to exclude videos that are in the user's video history

hasHLSFiles
boolean

PeerTube >= 4.0 Display only videos that have HLS files

hasWebVideoFiles
boolean

PeerTube >= 6.0 Display only videos that have Web Video files

host
string

Find elements owned by this host

include
integer
Enum: 0 1 2 4 8 16 32

Only administrators and moderators can use this parameter

Include additional videos in results (can be combined using bitwise or operator)

  • 0 NONE
  • 1 NOT_PUBLISHED_STATE
  • 2 BLACKLISTED
  • 4 BLOCKED_OWNER
  • 8 FILES
  • 16 CAPTIONS
  • 32 VIDEO SOURCE
includeScheduledLive
boolean

whether or not include live that are scheduled for later

isLive
boolean

whether or not the video is a live

isLocal
boolean

PeerTube >= 4.0 Display only local or remote objects

VideoLanguageSet (string) or Array of VideoLanguageSet (strings)

language id of the video (see /videos/languages). Use _unknown to filter on videos that don't have a video language

VideoLicenceSet (integer) or Array of VideoLicenceSet (integers)

licence id of the video (see /videos/licences)

nsfw
string
Enum: "true" "false"

whether to include nsfw videos, if any

nsfwFlagsExcluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwFlagsIncluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
privacyOneOf
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

PeerTube >= 4.0 Display only videos in this specific privacy/privacies

search
string

Plain text search, applied to various parts of the model depending on endpoint

skipCount
string
Default: "false"
Enum: "true" "false"

if you don't need the total in the response

sort
string
Enum: "name" "-duration" "-createdAt" "-publishedAt" "-views" "-likes" "-comments" "-trending" "-hot" "-best"

Sort videos by criteria (prefixing with - means DESC order):

  • hot - Adaptation of Reddit "hot" algorithm taking into account video views, likes, dislikes and comments and publication date
  • best - Same than hot, but also takes into account user video history
  • trending - Sort videos by recent views ("recent" is defined by the admin)
  • views - Sort videos using their views counter
  • publishedAt - Sort by video publication date (when it became publicly available)
start
integer >= 0

Offset used to paginate results

integer or Array of integers

PeerTube >= 8.2 Admins and moderators only filter on videos that have one of these states

string or Array of strings

tag(s) of the video, where all should be present in the video

string or Array of strings

tag(s) of the video

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Get subscription of my user

Authorizations:
OAuth2
path Parameters
subscriptionHandle
required
string
Example: my_username | my_username@example.com

The subscription handle

Responses

Response samples

Content type
application/json
{
  • "id": 42,
  • "url": "string",
  • "name": "chocobozzz",
  • "avatars": [
    ],
  • "host": "example.com",
  • "hostRedundancyAllowed": true,
  • "followingCount": 0,
  • "followersCount": 0,
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "displayName": "Videos of Framasoft",
  • "description": "Videos made with <3 by Framasoft",
  • "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
  • "publicEmail": "user@example.com",
  • "isLocal": true,
  • "banners": [
    ],
  • "ownerAccount": {
    },
  • "videosCount": 0,
  • "viewsPerDay": [
    ],
  • "viewsGroupInterval": "day",
  • "totalViews": 0
}

Delete subscription of my user

Authorizations:
OAuth2
path Parameters
subscriptionHandle
required
string
Example: my_username | my_username@example.com

The subscription handle

Responses

My Notifications

Notifications following new videos, follows or reports. They allow you to keep track of the interactions and overall important information that concerns you. You MAY set per-notification type delivery preference, to receive the info either by mail, by in-browser notification or both.

List my notifications

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

typeOneOf
Array of integers (NotificationType)
Items Enum: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34

only list notifications of these types

unread
boolean

only list unread notifications

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Mark notifications as read by their id

Authorizations:
OAuth2
Request Body schema: application/json
ids
required
Array of integers

ids of the notifications to mark as read

Responses

Request samples

Content type
application/json
{
  • "ids": [
    ]
}

Mark all my notification as read

Authorizations:
OAuth2

Responses

Update my notification settings

Authorizations:
OAuth2
Request Body schema: application/json
abuseAsModerator
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
abuseNewMessage
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
abuseStateChange
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
autoInstanceFollowing
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
blacklistOnMyVideo
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
commentMention
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
myVideoImportFinished
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
myVideoPublished
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
myVideoStudioEditionFinished
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
myVideoTranscriptionGenerated
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
newCommentOnMyVideo
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
newFollow
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
newInstanceFollower
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
newPeerTubeVersion
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
newPluginVersion
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
newUserRegistration
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
newVideoFromSubscription
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL
videoAutoBlacklistAsModerator
integer (NotificationSettingValue)

Notification type. One of the following values, or a sum of multiple values:

  • 0 NONE
  • 1 WEB
  • 2 EMAIL

Responses

Request samples

Content type
application/json
{
  • "abuseAsModerator": 0,
  • "videoAutoBlacklistAsModerator": 0,
  • "newUserRegistration": 0,
  • "newVideoFromSubscription": 0,
  • "blacklistOnMyVideo": 0,
  • "myVideoPublished": 0,
  • "myVideoImportFinished": 0,
  • "commentMention": 0,
  • "newCommentOnMyVideo": 0,
  • "newFollow": 0,
  • "newInstanceFollower": 0,
  • "autoInstanceFollowing": 0,
  • "abuseStateChange": 0,
  • "abuseNewMessage": 0,
  • "newPeerTubeVersion": 0,
  • "newPluginVersion": 0,
  • "myVideoStudioEditionFinished": 0,
  • "myVideoTranscriptionGenerated": 0
}

My History

Operations related to your watch history.

List watched videos history

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

search
string

Plain text search, applied to various parts of the model depending on endpoint

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Delete history element

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

Video id or UUID

Responses

Clear video history

Authorizations:
OAuth2
Request Body schema: multipart/form-data
beforeDate
string <date-time>

history before this date will be deleted

Responses

Video

Operations dealing with listing, uploading, fetching or modifying videos.

List videos of an account

path Parameters
name
required
string
Example: chocobozzz | chocobozzz@example.org

The username or handle of the account

query Parameters
VideoAIUsageSet (integer) or Array of VideoAIUsageSet (integers)

PeerTube >= 9.0 Only list videos with one of these AI usages, declared by video creators. If not provided, the preference of the authenticated user (aiUsagesHidden) is used

string or Array of strings

PeerTube >= 6.2 Admins and moderators only filter on videos that contain one of these automatic tags

VideoCategorySet (integer) or Array of VideoCategorySet (integers)

category id of the video (see /videos/categories)

count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

excludeAlreadyWatched
boolean

Whether or not to exclude videos that are in the user's video history

hasHLSFiles
boolean

PeerTube >= 4.0 Display only videos that have HLS files

hasWebVideoFiles
boolean

PeerTube >= 6.0 Display only videos that have Web Video files

host
string

Find elements owned by this host

include
integer
Enum: 0 1 2 4 8 16 32

Only administrators and moderators can use this parameter

Include additional videos in results (can be combined using bitwise or operator)

  • 0 NONE
  • 1 NOT_PUBLISHED_STATE
  • 2 BLACKLISTED
  • 4 BLOCKED_OWNER
  • 8 FILES
  • 16 CAPTIONS
  • 32 VIDEO SOURCE
includeScheduledLive
boolean

whether or not include live that are scheduled for later

isLive
boolean

whether or not the video is a live

isLocal
boolean

PeerTube >= 4.0 Display only local or remote objects

VideoLanguageSet (string) or Array of VideoLanguageSet (strings)

language id of the video (see /videos/languages). Use _unknown to filter on videos that don't have a video language

VideoLicenceSet (integer) or Array of VideoLicenceSet (integers)

licence id of the video (see /videos/licences)

nsfw
string
Enum: "true" "false"

whether to include nsfw videos, if any

nsfwFlagsExcluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwFlagsIncluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
privacyOneOf
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

PeerTube >= 4.0 Display only videos in this specific privacy/privacies

search
string

Plain text search, applied to various parts of the model depending on endpoint

skipCount
string
Default: "false"
Enum: "true" "false"

if you don't need the total in the response

sort
string
Enum: "name" "-duration" "-createdAt" "-publishedAt" "-views" "-likes" "-comments" "-trending" "-hot" "-best"

Sort videos by criteria (prefixing with - means DESC order):

  • hot - Adaptation of Reddit "hot" algorithm taking into account video views, likes, dislikes and comments and publication date
  • best - Same than hot, but also takes into account user video history
  • trending - Sort videos by recent views ("recent" is defined by the admin)
  • views - Sort videos using their views counter
  • publishedAt - Sort by video publication date (when it became publicly available)
start
integer >= 0

Offset used to paginate results

integer or Array of integers

PeerTube >= 8.2 Admins and moderators only filter on videos that have one of these states

string or Array of strings

tag(s) of the video, where all should be present in the video

string or Array of strings

tag(s) of the video

Responses

Request samples 

fetch('https://peertube2.cpy.re/api/v1/accounts/{name}/videos')
.then(function(response) {
  return response.json()
}).then(function(data) {
  console.log(data)
})

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Request video token

Request special tokens that expire quickly to use them in some context (like accessing private static files)

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

header Parameters
x-peertube-video-password
string

Required on password protected video

Responses

Response samples

Content type
application/json
{
  • "files": {
    }
}

Create a studio task

Create a task to edit a video (cut, add intro/outro etc). By default the video is edited in place. Set saveAsNewVideo to keep it untouched and save the result in a new video.

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: multipart/form-data
required
required
Array of cut (object) or add-intro (object) or add-outro (object) or add-watermark (object) or remove-segments (object) (VideoStudioCreateTask)
saveAsNewVideo
boolean
Default: false

Keep the source video untouched: duplicate it, and edit the duplicate. The duplicate is created private, in the same channel as the source video, with the source video metadata. The size of the source video counts towards the user quota.

Responses

Response samples

Content type
application/json
{
  • "video": {
    }
}

Duplicate a video

Create a copy of a local video, in the same channel.

The copy of a blocked video (that only moderators can duplicate) is blocked for the same reason.

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: application/json
name
string [ 3 .. 120 ] characters

Name of the copy. Defaults to the name of the source video followed by "(Copy)"

Responses

Request samples

Content type
application/json
{
  • "name": "string"
}

Response samples

Content type
application/json
{
  • "video": {
    }
}

List videos

query Parameters
VideoAIUsageSet (integer) or Array of VideoAIUsageSet (integers)

PeerTube >= 9.0 Only list videos with one of these AI usages, declared by video creators. If not provided, the preference of the authenticated user (aiUsagesHidden) is used

string or Array of strings

PeerTube >= 6.2 Admins and moderators only filter on videos that contain one of these automatic tags

VideoCategorySet (integer) or Array of VideoCategorySet (integers)

category id of the video (see /videos/categories)

count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

excludeAlreadyWatched
boolean

Whether or not to exclude videos that are in the user's video history

hasHLSFiles
boolean

PeerTube >= 4.0 Display only videos that have HLS files

hasWebVideoFiles
boolean

PeerTube >= 6.0 Display only videos that have Web Video files

host
string

Find elements owned by this host

include
integer
Enum: 0 1 2 4 8 16 32

Only administrators and moderators can use this parameter

Include additional videos in results (can be combined using bitwise or operator)

  • 0 NONE
  • 1 NOT_PUBLISHED_STATE
  • 2 BLACKLISTED
  • 4 BLOCKED_OWNER
  • 8 FILES
  • 16 CAPTIONS
  • 32 VIDEO SOURCE
includeScheduledLive
boolean

whether or not include live that are scheduled for later

isLive
boolean

whether or not the video is a live

isLocal
boolean

PeerTube >= 4.0 Display only local or remote objects

VideoLanguageSet (string) or Array of VideoLanguageSet (strings)

language id of the video (see /videos/languages). Use _unknown to filter on videos that don't have a video language

VideoLicenceSet (integer) or Array of VideoLicenceSet (integers)

licence id of the video (see /videos/licences)

nsfw
string
Enum: "true" "false"

whether to include nsfw videos, if any

nsfwFlagsExcluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwFlagsIncluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
privacyOneOf
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

PeerTube >= 4.0 Display only videos in this specific privacy/privacies

search
string

Plain text search, applied to various parts of the model depending on endpoint

skipCount
string
Default: "false"
Enum: "true" "false"

if you don't need the total in the response

sort
string
Enum: "name" "-duration" "-createdAt" "-publishedAt" "-views" "-likes" "-comments" "-trending" "-hot" "-best"

Sort videos by criteria (prefixing with - means DESC order):

  • hot - Adaptation of Reddit "hot" algorithm taking into account video views, likes, dislikes and comments and publication date
  • best - Same than hot, but also takes into account user video history
  • trending - Sort videos by recent views ("recent" is defined by the admin)
  • views - Sort videos using their views counter
  • publishedAt - Sort by video publication date (when it became publicly available)
start
integer >= 0

Offset used to paginate results

integer or Array of integers

PeerTube >= 8.2 Admins and moderators only filter on videos that have one of these states

string or Array of strings

tag(s) of the video, where all should be present in the video

string or Array of strings

tag(s) of the video

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

List recommended videos

Return videos recommended next to a reference video (or general recommendations if no reference video is given).

PeerTube decides the recommendation algorithm: it currently lists videos sharing tags with the reference video (excluding videos already watched by the authenticated user), then the latest videos. All returned videos are restricted to the scope, which defaults to the recommendationScope of the reference video.

query Parameters
VideoAIUsageSet (integer) or Array of VideoAIUsageSet (integers)

PeerTube >= 9.0 Only list videos with one of these AI usages, declared by video creators. If not provided, the preference of the authenticated user (aiUsagesHidden) is used

count
integer [ 1 .. 30 ]
Default: 10

Number of videos to return

excludeVideoIds
Array of integers (id) <= 50 items [ items >= 1 ]
Example: excludeVideoIds=42

Videos that must not be recommended (the reference video is always excluded)

nsfw
string
Enum: "true" "false"

whether to include nsfw videos, if any

nsfwFlagsExcluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwFlagsIncluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
scope
integer (VideoRecommendationScopeSet)
Enum: 1 2 3 4

Restrict recommended videos. Defaults to the recommendationScope of the reference video, or to 1 (all videos) if no reference video is given

id (integer) or UUIDv4 (string) or shortUUID (string)

Reference video. Required if scope is 3 or 4

header Parameters
x-peertube-video-password
string

Required on password protected video

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

List available video categories

Responses

Response samples

Content type
application/json
{
  • "1": "Music",
  • "2": "Films",
  • "3": "Vehicles",
  • "4": "Art",
  • "5": "Sports",
  • "6": "Travels",
  • "7": "Gaming",
  • "8": "People",
  • "9": "Comedy",
  • "10": "Entertainment",
  • "11": "News & Politics",
  • "12": "How To",
  • "13": "Education",
  • "14": "Activism",
  • "15": "Science & Technology",
  • "16": "Animals",
  • "17": "Kids",
  • "18": "Food"
}

List available video licences

Responses

Response samples

Content type
application/json
{
  • "1": "Attribution",
  • "2": "Attribution - Share Alike",
  • "3": "Attribution - No Derivatives",
  • "4": "Attribution - Non Commercial",
  • "5": "Attribution - Non Commercial - Share Alike",
  • "6": "Attribution - Non Commercial - No Derivatives",
  • "7": "Public Domain Dedication",
  • "8": "Free of known copyright restrictions",
  • "9": "All Rights Reserved"
}

List available video languages

query Parameters
scope
string
Value: "subtitle"

PeerTube >= 8.2 Filter languages by scope. Use subtitle to exclude sign languages and other languages that don't make sense for subtitles.

Responses

Response samples

Content type
application/json
{
  • "aa": "Afar",
  • "ab": "Abkhazian",
  • "af": "Afrikaans",
  • "ak": "Akan",
  • "am": "Amharic",
  • "ar": "Arabic",
  • "an": "Aragonese",
  • "ase": "American Sign Language",
  • "as": "Assamese",
  • "asq": "Austrian Sign Language",
  • "av": "Avaric",
  • "avk": "Kotava",
  • "ay": "Aymara",
  • "az": "Azerbaijani",
  • "ba": "Bashkir",
  • "bm": "Bambara",
  • "be": "Belarusian",
  • "bn": "Bengali",
  • "bfi": "British Sign Language",
  • "bi": "Bislama",
  • "bo": "Tibetan",
  • "bs": "Bosnian",
  • "br": "Breton",
  • "bg": "Bulgarian",
  • "bzs": "Brazilian Sign Language",
  • "ca": "Catalan",
  • "cs": "Czech",
  • "ch": "Chamorro",
  • "ce": "Chechen",
  • "cv": "Chuvash",
  • "kw": "Cornish",
  • "co": "Corsican",
  • "cr": "Cree",
  • "cse": "Czech Sign Language",
  • "csl": "Chinese Sign Language",
  • "cy": "Welsh",
  • "da": "Danish",
  • "de": "German",
  • "dv": "Dhivehi",
  • "dsl": "Danish Sign Language",
  • "dz": "Dzongkha",
  • "el": "Greek",
  • "en": "English",
  • "eo": "Esperanto",
  • "et": "Estonian",
  • "eu": "Basque",
  • "ee": "Ewe",
  • "fo": "Faroese",
  • "fa": "Persian",
  • "fj": "Fijian",
  • "fi": "Finnish",
  • "fr": "French",
  • "fy": "Western Frisian",
  • "fse": "Finnish Sign Language",
  • "fsl": "French Sign Language",
  • "ff": "Fulah",
  • "gcf": "Guadeloupean Creole French",
  • "gd": "Scottish Gaelic",
  • "ga": "Irish",
  • "gl": "Galician",
  • "gv": "Manx",
  • "gn": "Guarani",
  • "gsg": "German Sign Language",
  • "gsw": "Swiss German",
  • "gu": "Gujarati",
  • "ht": "Haitian",
  • "ha": "Hausa",
  • "sh": "Serbo-Croatian",
  • "he": "Hebrew",
  • "hz": "Herero",
  • "hi": "Hindi",
  • "ho": "Hiri Motu",
  • "hr": "Croatian",
  • "hu": "Hungarian",
  • "hy": "Armenian",
  • "ig": "Igbo",
  • "ii": "Sichuan Yi",
  • "iu": "Inuktitut",
  • "id": "Indonesian",
  • "ik": "Inupiaq",
  • "is": "Icelandic",
  • "it": "Italian",
  • "jv": "Javanese",
  • "jbo": "Lojban",
  • "ja": "Japanese",
  • "jsl": "Japanese Sign Language",
  • "kab": "Kabyle",
  • "kl": "Kalaallisut",
  • "kn": "Kannada",
  • "ks": "Kashmiri",
  • "ka": "Georgian",
  • "kr": "Kanuri",
  • "kk": "Kazakh",
  • "km": "Khmer",
  • "ki": "Kikuyu",
  • "rw": "Kinyarwanda",
  • "ky": "Kirghiz",
  • "kv": "Komi",
  • "kg": "Kongo",
  • "ko": "Korean",
  • "kj": "Kuanyama",
  • "ku": "Kurdish",
  • "lo": "Lao",
  • "la": "Latin",
  • "lv": "Latvian",
  • "li": "Limburgan",
  • "ln": "Lingala",
  • "lt": "Lithuanian",
  • "lb": "Luxembourgish",
  • "lu": "Luba-Katanga",
  • "lg": "Ganda",
  • "mh": "Marshallese",
  • "ml": "Malayalam",
  • "mr": "Marathi",
  • "mk": "Macedonian",
  • "mg": "Malagasy",
  • "mt": "Maltese",
  • "mn": "Mongolian",
  • "mi": "Maori",
  • "ms": "Malay (macrolanguage)",
  • "my": "Burmese",
  • "na": "Nauru",
  • "nv": "Navajo",
  • "nr": "South Ndebele",
  • "nd": "North Ndebele",
  • "ng": "Ndonga",
  • "ne": "Nepali (macrolanguage)",
  • "nl": "Dutch",
  • "nn": "Norwegian Nynorsk",
  • "nb": "Norwegian Bokmål",
  • "no": "Norwegian",
  • "ny": "Nyanja",
  • "oc": "Occitan",
  • "oj": "Ojibwa",
  • "or": "Oriya (macrolanguage)",
  • "om": "Oromo",
  • "os": "Ossetian",
  • "pa": "Panjabi",
  • "pks": "Pakistan Sign Language",
  • "pl": "Polish",
  • "pt": "Portuguese",
  • "ps": "Pushto",
  • "qu": "Quechua",
  • "rm": "Romansh",
  • "ro": "Romanian",
  • "rsl": "Russian Sign Language",
  • "rn": "Rundi",
  • "ru": "Russian",
  • "sg": "Sango",
  • "sdl": "Saudi Arabian Sign Language",
  • "sfs": "South African Sign Language",
  • "si": "Sinhala",
  • "sk": "Slovak",
  • "sl": "Slovenian",
  • "se": "Northern Sami",
  • "sm": "Samoan",
  • "sn": "Shona",
  • "sd": "Sindhi",
  • "so": "Somali",
  • "st": "Southern Sotho",
  • "es": "Spanish (Spain)",
  • "sq": "Albanian",
  • "sc": "Sardinian",
  • "sr": "Serbian",
  • "ss": "Swati",
  • "su": "Sundanese",
  • "sw": "Swahili (macrolanguage)",
  • "sv": "Swedish",
  • "swl": "Swedish Sign Language",
  • "ty": "Tahitian",
  • "ta": "Tamil",
  • "tt": "Tatar",
  • "te": "Telugu",
  • "tg": "Tajik",
  • "tl": "Tagalog",
  • "th": "Thai",
  • "ti": "Tigrinya",
  • "tlh": "Klingon",
  • "to": "Tonga (Tonga Islands)",
  • "tn": "Tswana",
  • "ts": "Tsonga",
  • "tk": "Turkmen",
  • "tr": "Turkish",
  • "tw": "Twi",
  • "ug": "Uighur",
  • "uk": "Ukrainian",
  • "ur": "Urdu",
  • "uz": "Uzbek",
  • "ve": "Venda",
  • "vi": "Vietnamese",
  • "wa": "Walloon",
  • "wo": "Wolof",
  • "xh": "Xhosa",
  • "yi": "Yiddish",
  • "yo": "Yoruba",
  • "za": "Zhuang",
  • "zh": "Chinese",
  • "zu": "Zulu",
  • "zxx": "No linguistic content",
  • "tok": "Toki Pona",
  • "pt-BR": "Portuguese (Brazilian)",
  • "pt-PT": "Portuguese (Portugal)",
  • "es-419": "Spanish (Latin America)",
  • "zh-Hans": "Simplified Chinese",
  • "zh-Hant": "Traditional Chinese",
  • "ca-valencia": "Valencian",
  • "rcf": "Réunion Creole French",
  • "gcr": "Guianese Creole French"
}

List available video privacy policies

Responses

Response samples

Content type
application/json
{
  • "1": "Public",
  • "2": "Unlisted",
  • "3": "Private",
  • "4": "Internal",
  • "5": "Password protected"
}

Update a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: multipart/form-data
aiUsage
integer (VideoAIUsageSet)
Enum: 1 2 3 4

PeerTube >= 9.0 Use of AI in the video, declared by the video creator:

  • 1 Not specified
  • 2 No AI-generated content: nothing seen or heard in the video has been generated by AI
  • 3 Contains AI-generated content: some parts of the video have been generated by AI
  • 4 AI-generated: the whole video, or most of it, has been generated by AI
category
integer (VideoCategorySet)

category id of the video (see /videos/categories)

channelId
integer

New channel of the video. The channel must be owned by the same account as the previous one. Use the "change ownership" endpoints to give a video to a channel owned by another account on the local PeerTube instance.

commentsPolicy
integer (VideoCommentsPolicySet)
Enum: 1 2 3

Comments policy of the video (Enabled = 1, Disabled = 2, Requires Approval = 3)

commercialContent
integer (VideoCommercialContentSet)
Enum: 1 2 3

PeerTube >= 9.0 Commercial content in the video, declared by the video creator:

  • 1 None
  • 2 Promotional content: the creator promotes their own products, services or business
  • 3 Paid partnership: a third party paid, or provided goods or services, in exchange for the promotion
description
string

Video description

downloadEnabled
boolean

Enable or disable downloading for this video

language
string (VideoLanguageSet)

language id of the video (see /videos/languages)

licence
integer (VideoLicenceSet)

licence id of the video (see /videos/licences)

name
string [ 3 .. 120 ] characters

Video name

nsfw
boolean

Whether or not this video contains sensitive content

nsfwFlags
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwSummary
any

More information about the sensitive content of the video

originallyPublishedAt
string or null <date-time>

Date when the content was originally published

previewfile
string <binary>
Deprecated

Deprecated in PeerTube v8.1, use thumbnailfile instead

privacy
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

privacy id of the video (see /videos/privacies)

recommendationScope
integer (VideoRecommendationScopeSet)
Enum: 1 2 3 4

Videos that can be recommended next to a video:

  • 1 All videos
  • 2 Only videos of the platform that owns the reference video (or of the current platform if no video is given)
  • 3 Only videos of the account that owns the reference video
  • 4 Only videos of the channel of the reference video

This is a preference of the video owner: applications displaying recommendations may not apply it

object (VideoScheduledUpdate)
support
string

A text tell the audience how to support the video creator

tags
Array of strings [ 1 .. 5 ] items [ items [ 2 .. 30 ] characters ]

Video tags (maximum 5 tags each between 2 and 30 characters)

thumbnailfile
string <binary>

Video thumbnail file

videoPasswords
Array of strings (AddVideoPasswords) unique [ items >= 2 characters ]
waitTranscoding
string

Whether or not we wait transcoding before publish the video

Responses

Get a video

path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

header Parameters
x-peertube-video-password
string

Required on password protected video

Responses

Response samples

Content type
application/json
{
  • "id": 42,
  • "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
  • "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
  • "isLive": true,
  • "liveSchedules": [
    ],
  • "createdAt": "2017-10-01T10:52:46.396Z",
  • "publishedAt": "2018-10-01T10:52:46.396Z",
  • "updatedAt": "2021-05-04T08:01:01.502Z",
  • "originallyPublishedAt": "2010-10-01T10:52:46.396Z",
  • "category": {
    },
  • "licence": {
    },
  • "language": {
    },
  • "privacy": {
    },
  • "truncatedDescription": "**[Want to help to translate this video?](https://weblate.framasoft.org/projects/what-is-peertube-video/)**\\r\\n\\r\\n\n**Take back the control of your videos! [#JoinPeertube](https://joinpeertube.org)**\\r\\n*A decentralized video hosting network, based on fr...\n",
  • "duration": 1419,
  • "aspectRatio": 1.778,
  • "isLocal": true,
  • "name": "What is PeerTube?",
  • "thumbnailPath": "string",
  • "previewPath": "string",
  • "thumbnails": [
    ],
  • "embedPath": "/videos/embed/a65bc12f-9383-462e-81ae-8207e8b434ee",
  • "views": 1337,
  • "likes": 42,
  • "dislikes": 7,
  • "comments": 0,
  • "nsfw": true,
  • "nsfwFlags": 0,
  • "nsfwSummary": "string",
  • "aiUsage": {
    },
  • "commercialContent": {
    },
  • "recommendationScope": {
    },
  • "waitTranscoding": true,
  • "state": {
    },
  • "scheduledUpdate": {
    },
  • "blacklisted": true,
  • "blacklistedReason": "string",
  • "account": {
    },
  • "channel": {
    },
  • "userHistory": {
    },
  • "captionLanguages": [
    ],
  • "viewers": 0,
  • "description": "\"**[Want to help to translate this video?](https://weblate.framasoft.org/projects/what-is-peertube-video/)**\\r\\n\\r\\n\n**Take back the control of your videos! [#JoinPeertube](https://joinpeertube.org)**\\r\\n*A decentralized video hosting network,\nbased on free/libre software!*\\r\\n\\r\\n**Animation Produced by:** [LILA](https://libreart.info) - [ZeMarmot Team](https://film.zemarmot.net)\\r\\n\n*Directed by* Aryeom\\r\\n*Assistant* Jehan\\r\\n**Licence**: [CC-By-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/)\\r\\n\\r\\n\n**Sponsored by** [Framasoft](https://framasoft.org)\\r\\n\\r\\n**Music**: [Red Step Forward](http://play.dogmazic.net/song.php?song_id=52491) - CC-By Ken Bushima\\r\\n\\r\\n\n**Movie Clip**: [Caminades 3: Llamigos](http://www.caminandes.com/) CC-By Blender Institute\\r\\n\\r\\n**Video sources**: https://gitlab.gnome.org/Jehan/what-is-peertube/\"\n",
  • "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
  • "tags": [
    ],
  • "commentsPolicy": {
    },
  • "downloadEnabled": true,
  • "inputFileUpdatedAt": "2019-08-24T14:15:22Z",
  • "trackerUrls": [],
  • "files": [
    ],
  • "streamingPlaylists": [
    ]
}

Delete a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Notify user is watching a video

Call this endpoint regularly (every 5-10 seconds for example) to notify the server the user is watching the video. After a while, PeerTube will increase video's viewers counter. If the user is authenticated, PeerTube will also store the current player time.

path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: application/json
required
currentTime
required
integer <seconds>

timestamp within the video, in seconds

client
string

Client software used to watch the video. For example "Firefox", "PeerTube Approval Android", etc.

device
any
Enum: "console" "embedded" "mobile" "smarttv" "tablet" "wearable" "xr" "desktop"

Device used to watch the video. For example "desktop", "mobile", "smarttv", etc.

operatingSystem
string

Operating system used to watch the video. For example "Windows", "Ubuntu", etc.

sessionId
string

Optional param to represent the current viewer session. Used by the backend to properly count one view per session per video. PeerTube admin can configure the server to not trust this sessionId parameter but use the request IP address instead to identify a viewer.

viewEvent
string
Value: "seek"

Event since last viewing call:

  • seek - If the user seeked the video

Responses

Request samples

Content type
application/json
{
  • "currentTime": 5,
  • "viewEvent": "seek",
  • "sessionId": "string",
  • "client": "string",
  • "device": "console",
  • "operatingSystem": "string"
}

Upload a video

Uses a single request to upload a video.

Authorizations:
OAuth2
Request Body schema: multipart/form-data
channelId
required
integer >= 1

Channel id that will contain this video

name
required
string [ 3 .. 120 ] characters

Video name

videofile
required
string <binary>

Video file

aiUsage
integer (VideoAIUsageSet)
Enum: 1 2 3 4

PeerTube >= 9.0 Use of AI in the video, declared by the video creator:

  • 1 Not specified
  • 2 No AI-generated content: nothing seen or heard in the video has been generated by AI
  • 3 Contains AI-generated content: some parts of the video have been generated by AI
  • 4 AI-generated: the whole video, or most of it, has been generated by AI
category
integer (VideoCategorySet)

category id of the video (see /videos/categories)

commentsPolicy
integer (VideoCommentsPolicySet)
Enum: 1 2 3

Comments policy of the video (Enabled = 1, Disabled = 2, Requires Approval = 3)

commercialContent
integer (VideoCommercialContentSet)
Enum: 1 2 3

PeerTube >= 9.0 Commercial content in the video, declared by the video creator:

  • 1 None
  • 2 Promotional content: the creator promotes their own products, services or business
  • 3 Paid partnership: a third party paid, or provided goods or services, in exchange for the promotion
description
string

Video description

downloadEnabled
boolean

Enable or disable downloading for this video

generateTranscription
boolean

PeerTube >= 6.2 If enabled by the admin, automatically generate a subtitle of the video

language
string (VideoLanguageSet)

language id of the video (see /videos/languages)

licence
integer (VideoLicenceSet)

licence id of the video (see /videos/licences)

nsfw
boolean

Whether or not this video contains sensitive content

nsfwFlags
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwSummary
any

More information about the sensitive content of the video

originallyPublishedAt
string <date-time>

Date when the content was originally published

previewfile
string <binary>
Deprecated

Deprecated in PeerTube v8.1, use thumbnailfile instead

privacy
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

privacy id of the video (see /videos/privacies)

recommendationScope
integer (VideoRecommendationScopeSet)
Enum: 1 2 3 4

Videos that can be recommended next to a video:

  • 1 All videos
  • 2 Only videos of the platform that owns the reference video (or of the current platform if no video is given)
  • 3 Only videos of the account that owns the reference video
  • 4 Only videos of the channel of the reference video

This is a preference of the video owner: applications displaying recommendations may not apply it

object (VideoScheduledUpdate)
support
string

A text tell the audience how to support the video creator

tags
Array of strings [ 1 .. 5 ] items unique [ items [ 2 .. 30 ] characters ]

Video tags (maximum 5 tags each between 2 and 30 characters)

thumbnailfile
string <binary>

Video thumbnail file

videoPasswords
Array of strings (AddVideoPasswords) unique [ items >= 2 characters ]
waitTranscoding
boolean

Whether or not we wait transcoding before publish the video

Responses

Request samples 

## DEPENDENCIES: jq
USERNAME="<your_username>"
PASSWORD="<your_password>"
FILE_PATH="<your_file_path>"
CHANNEL_ID="<your_channel_id>"
NAME="<video_name>"
API="https://peertube2.cpy.re/api/v1"

## AUTH
client_id=$(curl -s "$API/oauth-clients/local" | jq -r ".client_id")
client_secret=$(curl -s "$API/oauth-clients/local" | jq -r ".client_secret")
token=$(curl -s "$API/users/token" \
  --data client_id="$client_id" \
  --data client_secret="$client_secret" \
  --data grant_type=password \
  --data username="$USERNAME" \
  --data password="$PASSWORD" \
  | jq -r ".access_token")

## VIDEO UPLOAD
curl -s "$API/videos/upload" \
  -H "Authorization: Bearer $token" \
  --max-time 600 \
  --form videofile=@"$FILE_PATH" \
  --form channelId=$CHANNEL_ID \
  --form name="$NAME"

Response samples

Content type
application/json
{
  • "video": {
    }
}

Initialize the resumable upload of a video

Uses a resumable protocol to initialize the upload of a video

Authorizations:
OAuth2
header Parameters
X-Upload-Content-Length
required
number
Example: 2469036

Number of bytes that will be uploaded in subsequent requests. Set this value to the size of the file you are uploading.

X-Upload-Content-Type
required
string <mimetype>
Example: video/mp4

MIME type of the file that you are uploading. Depending on your instance settings, acceptable values might vary.

Request Body schema: application/json
channelId
required
integer >= 1

Channel id that will contain this video

filename
required
string <filename>

Video filename including extension

name
required
string [ 3 .. 120 ] characters

Video name

aiUsage
integer (VideoAIUsageSet)
Enum: 1 2 3 4

PeerTube >= 9.0 Use of AI in the video, declared by the video creator:

  • 1 Not specified
  • 2 No AI-generated content: nothing seen or heard in the video has been generated by AI
  • 3 Contains AI-generated content: some parts of the video have been generated by AI
  • 4 AI-generated: the whole video, or most of it, has been generated by AI
category
integer (VideoCategorySet)

category id of the video (see /videos/categories)

commentsPolicy
integer (VideoCommentsPolicySet)
Enum: 1 2 3

Comments policy of the video (Enabled = 1, Disabled = 2, Requires Approval = 3)

commercialContent
integer (VideoCommercialContentSet)
Enum: 1 2 3

PeerTube >= 9.0 Commercial content in the video, declared by the video creator:

  • 1 None
  • 2 Promotional content: the creator promotes their own products, services or business
  • 3 Paid partnership: a third party paid, or provided goods or services, in exchange for the promotion
description
string

Video description

downloadEnabled
boolean

Enable or disable downloading for this video

generateTranscription
boolean

PeerTube >= 6.2 If enabled by the admin, automatically generate a subtitle of the video

language
string (VideoLanguageSet)

language id of the video (see /videos/languages)

licence
integer (VideoLicenceSet)

licence id of the video (see /videos/licences)

nsfw
boolean

Whether or not this video contains sensitive content

nsfwFlags
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwSummary
any

More information about the sensitive content of the video

originallyPublishedAt
string <date-time>

Date when the content was originally published

previewfile
string <binary>
Deprecated

Deprecated in PeerTube v8.1, use thumbnailfile instead

privacy
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

privacy id of the video (see /videos/privacies)

recommendationScope
integer (VideoRecommendationScopeSet)
Enum: 1 2 3 4

Videos that can be recommended next to a video:

  • 1 All videos
  • 2 Only videos of the platform that owns the reference video (or of the current platform if no video is given)
  • 3 Only videos of the account that owns the reference video
  • 4 Only videos of the channel of the reference video

This is a preference of the video owner: applications displaying recommendations may not apply it

object (VideoScheduledUpdate)
support
string

A text tell the audience how to support the video creator

tags
Array of strings [ 1 .. 5 ] items unique [ items [ 2 .. 30 ] characters ]

Video tags (maximum 5 tags each between 2 and 30 characters)

thumbnailfile
string <binary>

Video thumbnail file

videoPasswords
Array of strings (AddVideoPasswords) unique [ items >= 2 characters ]
waitTranscoding
boolean

Whether or not we wait transcoding before publish the video

Responses

Request samples

Content type
application/json
{
  • "name": "What is PeerTube?",
  • "channelId": 3,
  • "privacy": 1,
  • "category": 15,
  • "licence": 2,
  • "language": "en",
  • "description": "**[Want to help to translate this video?](https://weblate.framasoft.org/projects/what-is-peertube-video/)**\\r\\n\\r\\n**Take back the control of your videos! [#JoinPeertube](https://joinpeertube.org)**\n",
  • "waitTranscoding": true,
  • "generateTranscription": true,
  • "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
  • "nsfw": true,
  • "nsfwSummary": null,
  • "nsfwFlags": 0,
  • "tags": [
    ],
  • "commentsPolicy": 1,
  • "recommendationScope": 1,
  • "aiUsage": 1,
  • "commercialContent": 1,
  • "downloadEnabled": true,
  • "originallyPublishedAt": "2019-08-24T14:15:22Z",
  • "scheduleUpdate": {
    },
  • "thumbnailfile": "string",
  • "previewfile": "string",
  • "videoPasswords": [
    ],
  • "filename": "what_is_peertube.mp4"
}

Send chunk for the resumable upload of a video

Uses a resumable protocol to continue, pause or resume the upload of a video

Authorizations:
OAuth2
query Parameters
upload_id
required
string

Created session id to proceed with. If you didn't send chunks in the last hour, it is not valid anymore and you need to initialize a new upload.

header Parameters
Content-Length
required
number
Example: 262144

Size of the chunk that the request is sending.

Remember that larger chunks are more efficient. PeerTube's web client uses chunks varying from 1048576 bytes (~1MB) and increases or reduces size depending on connection health.

Content-Range
required
string
Example: bytes 0-262143/2469036

Specifies the bytes in the file that the request is uploading.

For example, a value of bytes 0-262143/1000000 shows that the request is sending the first 262144 bytes (256 x 1024) in a 2,469,036 byte file.

When the server config client.videos.resumableUpload.minChunkSize (video uploads) or import.users.resumableUpload.minChunkSize (user archive imports) is not 0, every chunk except the last one must be at least that big. It must also be at least 1/10,000 of the file size (the maximum number of object storage multipart upload parts).

Request Body schema: application/octet-stream
string <binary>

Responses

Response samples

Content type
application/json
{
  • "video": {
    }
}

Cancel the resumable upload of a video, deleting any data uploaded so far

Uses a resumable protocol to cancel the upload of a video

Authorizations:
OAuth2
query Parameters
upload_id
required
string

Created session id to proceed with. If you didn't send chunks in the last hour, it is not valid anymore and you need to initialize a new upload.

header Parameters
Content-Length
required
number
Example: 0

Responses

Create a live

Authorizations:
OAuth2
Request Body schema: multipart/form-data
channelId
required
integer

Channel id that will contain this live video

name
required
string [ 3 .. 120 ] characters

Live video/replay name

aiUsage
integer (VideoAIUsageSet)
Enum: 1 2 3 4

PeerTube >= 9.0 Use of AI in the video, declared by the video creator:

  • 1 Not specified
  • 2 No AI-generated content: nothing seen or heard in the video has been generated by AI
  • 3 Contains AI-generated content: some parts of the video have been generated by AI
  • 4 AI-generated: the whole video, or most of it, has been generated by AI
category
integer (VideoCategorySet)

category id of the video (see /videos/categories)

commentsPolicy
integer (VideoCommentsPolicySet)
Enum: 1 2 3

Comments policy of the video (Enabled = 1, Disabled = 2, Requires Approval = 3)

commercialContent
integer (VideoCommercialContentSet)
Enum: 1 2 3

PeerTube >= 9.0 Commercial content in the video, declared by the video creator:

  • 1 None
  • 2 Promotional content: the creator promotes their own products, services or business
  • 3 Paid partnership: a third party paid, or provided goods or services, in exchange for the promotion
description
string

Live video/replay description

downloadEnabled
boolean

Enable or disable downloading for the replay of this live video

language
string (VideoLanguageSet)

language id of the video (see /videos/languages)

latencyMode
integer
Enum: 1 2 3

User can select live latency mode if enabled by the instance

licence
integer (VideoLicenceSet)

licence id of the video (see /videos/licences)

nsfw
boolean

Whether or not this live video/replay contains sensitive content

nsfwFlags
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwSummary
any

More information about the sensitive content of the video

permanentLive
boolean

User can stream multiple times in a permanent live

previewfile
string <binary>
Deprecated

Deprecated in PeerTube v8.1, use thumbnailfile instead

privacy
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

privacy id of the video (see /videos/privacies)

recommendationScope
integer (VideoRecommendationScopeSet)
Enum: 1 2 3 4

Videos that can be recommended next to a video:

  • 1 All videos
  • 2 Only videos of the platform that owns the reference video (or of the current platform if no video is given)
  • 3 Only videos of the account that owns the reference video
  • 4 Only videos of the channel of the reference video

This is a preference of the video owner: applications displaying recommendations may not apply it

object (LiveVideoReplaySettings)
saveReplay
boolean
Array of objects (LiveSchedule)
support
string

A text tell the audience how to support the creator

tags
Array of strings [ 1 .. 5 ] items [ items [ 2 .. 30 ] characters ]

Live video/replay tags (maximum 5 tags each between 2 and 30 characters)

thumbnailfile
string <binary>

Live video/replay thumbnail file

Responses

Response samples

Content type
application/json
{
  • "video": {
    }
}

Get information about a live

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Response samples

Content type
application/json
{
  • "rtmpUrl": "string",
  • "rtmpsUrl": "string",
  • "streamKey": "string",
  • "saveReplay": true,
  • "replaySettings": {
    },
  • "permanentLive": true,
  • "latencyMode": 1,
  • "schedules": [
    ]
}

Update information about a live

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: application/json
latencyMode
integer
Enum: 1 2 3

User can select live latency mode if enabled by the instance

permanentLive
boolean

User can stream multiple times in a permanent live

object (LiveVideoReplaySettings)
saveReplay
boolean
Array of objects (LiveSchedule)

Responses

Request samples

Content type
application/json
{
  • "saveReplay": true,
  • "replaySettings": {
    },
  • "permanentLive": true,
  • "latencyMode": 1,
  • "schedules": [
    ]
}

Get video source file metadata

Get metadata and download link of original video file

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Response samples

Content type
application/json
{
  • "inputFilename": "string",
  • "fileDownloadUrl": "string",
  • "resolution": {
    },
  • "size": 0,
  • "fps": 0,
  • "width": 0,
  • "height": 0,
  • "createdAt": "2019-08-24T14:15:22Z"
}

Delete video source file

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Initialize the resumable replacement of a video

PeerTube >= 6.0 Uses a resumable protocol to initialize the replacement of a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

header Parameters
X-Upload-Content-Length
required
number
Example: 2469036

Number of bytes that will be uploaded in subsequent requests. Set this value to the size of the file you are uploading.

X-Upload-Content-Type
required
string <mimetype>
Example: video/mp4

MIME type of the file that you are uploading. Depending on your instance settings, acceptable values might vary.

Request Body schema: application/json
filename
string <filename>

Video filename including extension

Responses

Request samples

Content type
application/json
{
  • "filename": "what_is_peertube.mp4"
}

Send chunk for the resumable replacement of a video

PeerTube >= 6.0 Uses a resumable protocol to continue, pause or resume the replacement of a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

query Parameters
upload_id
required
string

Created session id to proceed with. If you didn't send chunks in the last hour, it is not valid anymore and you need to initialize a new upload.

header Parameters
Content-Length
required
number
Example: 262144

Size of the chunk that the request is sending.

Remember that larger chunks are more efficient. PeerTube's web client uses chunks varying from 1048576 bytes (~1MB) and increases or reduces size depending on connection health.

Content-Range
required
string
Example: bytes 0-262143/2469036

Specifies the bytes in the file that the request is uploading.

For example, a value of bytes 0-262143/1000000 shows that the request is sending the first 262144 bytes (256 x 1024) in a 2,469,036 byte file.

When the server config client.videos.resumableUpload.minChunkSize (video uploads) or import.users.resumableUpload.minChunkSize (user archive imports) is not 0, every chunk except the last one must be at least that big. It must also be at least 1/10,000 of the file size (the maximum number of object storage multipart upload parts).

Request Body schema: application/octet-stream
string <binary>

Responses

Cancel the resumable replacement of a video

PeerTube >= 6.0 Uses a resumable protocol to cancel the replacement of a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

query Parameters
upload_id
required
string

Created session id to proceed with. If you didn't send chunks in the last hour, it is not valid anymore and you need to initialize a new upload.

header Parameters
Content-Length
required
number
Example: 0

Responses

List storyboards of a video

PeerTube >= 6.0

path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Response samples

Content type
application/json
{
  • "storyboards": [
    ]
}

List videos of a video channel

path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

query Parameters
VideoAIUsageSet (integer) or Array of VideoAIUsageSet (integers)

PeerTube >= 9.0 Only list videos with one of these AI usages, declared by video creators. If not provided, the preference of the authenticated user (aiUsagesHidden) is used

string or Array of strings

PeerTube >= 6.2 Admins and moderators only filter on videos that contain one of these automatic tags

VideoCategorySet (integer) or Array of VideoCategorySet (integers)

category id of the video (see /videos/categories)

count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

excludeAlreadyWatched
boolean

Whether or not to exclude videos that are in the user's video history

hasHLSFiles
boolean

PeerTube >= 4.0 Display only videos that have HLS files

hasWebVideoFiles
boolean

PeerTube >= 6.0 Display only videos that have Web Video files

host
string

Find elements owned by this host

include
integer
Enum: 0 1 2 4 8 16 32

Only administrators and moderators can use this parameter

Include additional videos in results (can be combined using bitwise or operator)

  • 0 NONE
  • 1 NOT_PUBLISHED_STATE
  • 2 BLACKLISTED
  • 4 BLOCKED_OWNER
  • 8 FILES
  • 16 CAPTIONS
  • 32 VIDEO SOURCE
includeScheduledLive
boolean

whether or not include live that are scheduled for later

isLive
boolean

whether or not the video is a live

isLocal
boolean

PeerTube >= 4.0 Display only local or remote objects

VideoLanguageSet (string) or Array of VideoLanguageSet (strings)

language id of the video (see /videos/languages). Use _unknown to filter on videos that don't have a video language

VideoLicenceSet (integer) or Array of VideoLicenceSet (integers)

licence id of the video (see /videos/licences)

nsfw
string
Enum: "true" "false"

whether to include nsfw videos, if any

nsfwFlagsExcluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwFlagsIncluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
privacyOneOf
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

PeerTube >= 4.0 Display only videos in this specific privacy/privacies

search
string

Plain text search, applied to various parts of the model depending on endpoint

skipCount
string
Default: "false"
Enum: "true" "false"

if you don't need the total in the response

sort
string
Enum: "name" "-duration" "-createdAt" "-publishedAt" "-views" "-likes" "-comments" "-trending" "-hot" "-best"

Sort videos by criteria (prefixing with - means DESC order):

  • hot - Adaptation of Reddit "hot" algorithm taking into account video views, likes, dislikes and comments and publication date
  • best - Same than hot, but also takes into account user video history
  • trending - Sort videos by recent views ("recent" is defined by the admin)
  • views - Sort videos using their views counter
  • publishedAt - Sort by video publication date (when it became publicly available)
start
integer >= 0

Offset used to paginate results

integer or Array of integers

PeerTube >= 8.2 Admins and moderators only filter on videos that have one of these states

string or Array of strings

tag(s) of the video, where all should be present in the video

string or Array of strings

tag(s) of the video

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Search videos

query Parameters
VideoAIUsageSet (integer) or Array of VideoAIUsageSet (integers)

PeerTube >= 9.0 Only list videos with one of these AI usages, declared by video creators. If not provided, the preference of the authenticated user (aiUsagesHidden) is used

string or Array of strings

PeerTube >= 6.2 Admins and moderators only filter on videos that contain one of these automatic tags

VideoCategorySet (integer) or Array of VideoCategorySet (integers)

category id of the video (see /videos/categories)

count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

durationMax
integer

Get videos that have this maximum duration

durationMin
integer

Get videos that have this minimum duration

endDate
string <date-time>

Get videos that are published before this date

excludeAlreadyWatched
boolean

Whether or not to exclude videos that are in the user's video history

hasHLSFiles
boolean

PeerTube >= 4.0 Display only videos that have HLS files

hasWebVideoFiles
boolean

PeerTube >= 6.0 Display only videos that have Web Video files

host
string

Find elements owned by this host

include
integer
Enum: 0 1 2 4 8 16 32

Only administrators and moderators can use this parameter

Include additional videos in results (can be combined using bitwise or operator)

  • 0 NONE
  • 1 NOT_PUBLISHED_STATE
  • 2 BLACKLISTED
  • 4 BLOCKED_OWNER
  • 8 FILES
  • 16 CAPTIONS
  • 32 VIDEO SOURCE
includeScheduledLive
boolean

whether or not include live that are scheduled for later

isLive
boolean

whether or not the video is a live

isLocal
boolean

PeerTube >= 4.0 Display only local or remote objects

VideoLanguageSet (string) or Array of VideoLanguageSet (strings)

language id of the video (see /videos/languages). Use _unknown to filter on videos that don't have a video language

VideoLicenceSet (integer) or Array of VideoLicenceSet (integers)

licence id of the video (see /videos/licences)

nsfw
string
Enum: "true" "false"

whether to include nsfw videos, if any

nsfwFlagsExcluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwFlagsIncluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
originallyPublishedEndDate
string <date-time>

Get videos that are originally published before this date

originallyPublishedStartDate
string <date-time>

Get videos that are originally published after this date

privacyOneOf
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

PeerTube >= 4.0 Display only videos in this specific privacy/privacies

search
required
string

String to search. If the user can make a remote URI search, and the string is an URI then the PeerTube instance will fetch the remote object and add it to its database. Then, you can use the REST API to fetch the complete video information and interact with it.

searchTarget
string
Enum: "local" "search-index"

If the administrator enabled search index support, you can override the default search target.

Warning: If you choose to make an index search, PeerTube will get results from a third party service. It means the instance may not yet know the objects you fetched. If you want to load video/channel information:

  • If the current user has the ability to make a remote URI search (this information is available in the config endpoint), then reuse the search API to make a search using the object URI so PeerTube instance fetches the remote object and fill its database. After that, you can use the classic REST API endpoints to fetch the complete object or interact with it
  • If the current user doesn't have the ability to make a remote URI search, then redirect the user on the origin instance or fetch the data from the origin instance API
skipCount
string
Default: "false"
Enum: "true" "false"

if you don't need the total in the response

sort
string
Enum: "name" "-duration" "-createdAt" "-publishedAt" "-views" "-likes" "-comments" "-trending" "-hot" "-best"

Sort videos by criteria (prefixing with - means DESC order):

  • hot - Adaptation of Reddit "hot" algorithm taking into account video views, likes, dislikes and comments and publication date
  • best - Same than hot, but also takes into account user video history
  • trending - Sort videos by recent views ("recent" is defined by the admin)
  • views - Sort videos using their views counter
  • publishedAt - Sort by video publication date (when it became publicly available)
start
integer >= 0

Offset used to paginate results

startDate
string <date-time>

Get videos that are published after this date

integer or Array of integers

PeerTube >= 8.2 Admins and moderators only filter on videos that have one of these states

string or Array of strings

tag(s) of the video, where all should be present in the video

string or Array of strings

tag(s) of the video

uuids
Array of strings

Find elements with specific UUIDs

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Video Upload

Operations dealing with adding video or audio. PeerTube supports two upload modes, and three import modes.

Upload

  • legacy, where the video file is sent in a single request
  • resumable, where the video file is sent in chunks

You can upload videos more reliably by using the resumable variant. Its protocol lets you resume an upload operation after a network interruption or other transmission failure, saving time and bandwidth in the event of network failures.

Favor using resumable uploads in any of the following cases:

  • You are transferring large files
  • The likelihood of a network interruption is high
  • Uploads are originating from a device with a low-bandwidth or unstable Internet connection, such as a mobile device

Import

  • URL-based: where the URL points to any service supported by youtube-dl
  • magnet-based: where the URI resolves to a BitTorrent resource containing a single supported video file
  • torrent-based: where the metainfo file resolves to a BitTorrent resource containing a single supported video file

The import function is practical when the desired video/audio is available online. It makes PeerTube download it for you, saving you as much bandwidth and avoiding any instability or limitation your network might have.

Upload a video

Uses a single request to upload a video.

Authorizations:
OAuth2
Request Body schema: multipart/form-data
channelId
required
integer >= 1

Channel id that will contain this video

name
required
string [ 3 .. 120 ] characters

Video name

videofile
required
string <binary>

Video file

aiUsage
integer (VideoAIUsageSet)
Enum: 1 2 3 4

PeerTube >= 9.0 Use of AI in the video, declared by the video creator:

  • 1 Not specified
  • 2 No AI-generated content: nothing seen or heard in the video has been generated by AI
  • 3 Contains AI-generated content: some parts of the video have been generated by AI
  • 4 AI-generated: the whole video, or most of it, has been generated by AI
category
integer (VideoCategorySet)

category id of the video (see /videos/categories)

commentsPolicy
integer (VideoCommentsPolicySet)
Enum: 1 2 3

Comments policy of the video (Enabled = 1, Disabled = 2, Requires Approval = 3)

commercialContent
integer (VideoCommercialContentSet)
Enum: 1 2 3

PeerTube >= 9.0 Commercial content in the video, declared by the video creator:

  • 1 None
  • 2 Promotional content: the creator promotes their own products, services or business
  • 3 Paid partnership: a third party paid, or provided goods or services, in exchange for the promotion
description
string

Video description

downloadEnabled
boolean

Enable or disable downloading for this video

generateTranscription
boolean

PeerTube >= 6.2 If enabled by the admin, automatically generate a subtitle of the video

language
string (VideoLanguageSet)

language id of the video (see /videos/languages)

licence
integer (VideoLicenceSet)

licence id of the video (see /videos/licences)

nsfw
boolean

Whether or not this video contains sensitive content

nsfwFlags
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwSummary
any

More information about the sensitive content of the video

originallyPublishedAt
string <date-time>

Date when the content was originally published

previewfile
string <binary>
Deprecated

Deprecated in PeerTube v8.1, use thumbnailfile instead

privacy
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

privacy id of the video (see /videos/privacies)

recommendationScope
integer (VideoRecommendationScopeSet)
Enum: 1 2 3 4

Videos that can be recommended next to a video:

  • 1 All videos
  • 2 Only videos of the platform that owns the reference video (or of the current platform if no video is given)
  • 3 Only videos of the account that owns the reference video
  • 4 Only videos of the channel of the reference video

This is a preference of the video owner: applications displaying recommendations may not apply it

object (VideoScheduledUpdate)
support
string

A text tell the audience how to support the video creator

tags
Array of strings [ 1 .. 5 ] items unique [ items [ 2 .. 30 ] characters ]

Video tags (maximum 5 tags each between 2 and 30 characters)

thumbnailfile
string <binary>

Video thumbnail file

videoPasswords
Array of strings (AddVideoPasswords) unique [ items >= 2 characters ]
waitTranscoding
boolean

Whether or not we wait transcoding before publish the video

Responses

Request samples 

## DEPENDENCIES: jq
USERNAME="<your_username>"
PASSWORD="<your_password>"
FILE_PATH="<your_file_path>"
CHANNEL_ID="<your_channel_id>"
NAME="<video_name>"
API="https://peertube2.cpy.re/api/v1"

## AUTH
client_id=$(curl -s "$API/oauth-clients/local" | jq -r ".client_id")
client_secret=$(curl -s "$API/oauth-clients/local" | jq -r ".client_secret")
token=$(curl -s "$API/users/token" \
  --data client_id="$client_id" \
  --data client_secret="$client_secret" \
  --data grant_type=password \
  --data username="$USERNAME" \
  --data password="$PASSWORD" \
  | jq -r ".access_token")

## VIDEO UPLOAD
curl -s "$API/videos/upload" \
  -H "Authorization: Bearer $token" \
  --max-time 600 \
  --form videofile=@"$FILE_PATH" \
  --form channelId=$CHANNEL_ID \
  --form name="$NAME"

Response samples

Content type
application/json
{
  • "video": {
    }
}

Initialize the resumable upload of a video

Uses a resumable protocol to initialize the upload of a video

Authorizations:
OAuth2
header Parameters
X-Upload-Content-Length
required
number
Example: 2469036

Number of bytes that will be uploaded in subsequent requests. Set this value to the size of the file you are uploading.

X-Upload-Content-Type
required
string <mimetype>
Example: video/mp4

MIME type of the file that you are uploading. Depending on your instance settings, acceptable values might vary.

Request Body schema: application/json
channelId
required
integer >= 1

Channel id that will contain this video

filename
required
string <filename>

Video filename including extension

name
required
string [ 3 .. 120 ] characters

Video name

aiUsage
integer (VideoAIUsageSet)
Enum: 1 2 3 4

PeerTube >= 9.0 Use of AI in the video, declared by the video creator:

  • 1 Not specified
  • 2 No AI-generated content: nothing seen or heard in the video has been generated by AI
  • 3 Contains AI-generated content: some parts of the video have been generated by AI
  • 4 AI-generated: the whole video, or most of it, has been generated by AI
category
integer (VideoCategorySet)

category id of the video (see /videos/categories)

commentsPolicy
integer (VideoCommentsPolicySet)
Enum: 1 2 3

Comments policy of the video (Enabled = 1, Disabled = 2, Requires Approval = 3)

commercialContent
integer (VideoCommercialContentSet)
Enum: 1 2 3

PeerTube >= 9.0 Commercial content in the video, declared by the video creator:

  • 1 None
  • 2 Promotional content: the creator promotes their own products, services or business
  • 3 Paid partnership: a third party paid, or provided goods or services, in exchange for the promotion
description
string

Video description

downloadEnabled
boolean

Enable or disable downloading for this video

generateTranscription
boolean

PeerTube >= 6.2 If enabled by the admin, automatically generate a subtitle of the video

language
string (VideoLanguageSet)

language id of the video (see /videos/languages)

licence
integer (VideoLicenceSet)

licence id of the video (see /videos/licences)

nsfw
boolean

Whether or not this video contains sensitive content

nsfwFlags
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwSummary
any

More information about the sensitive content of the video

originallyPublishedAt
string <date-time>

Date when the content was originally published

previewfile
string <binary>
Deprecated

Deprecated in PeerTube v8.1, use thumbnailfile instead

privacy
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

privacy id of the video (see /videos/privacies)

recommendationScope
integer (VideoRecommendationScopeSet)
Enum: 1 2 3 4

Videos that can be recommended next to a video:

  • 1 All videos
  • 2 Only videos of the platform that owns the reference video (or of the current platform if no video is given)
  • 3 Only videos of the account that owns the reference video
  • 4 Only videos of the channel of the reference video

This is a preference of the video owner: applications displaying recommendations may not apply it

object (VideoScheduledUpdate)
support
string

A text tell the audience how to support the video creator

tags
Array of strings [ 1 .. 5 ] items unique [ items [ 2 .. 30 ] characters ]

Video tags (maximum 5 tags each between 2 and 30 characters)

thumbnailfile
string <binary>

Video thumbnail file

videoPasswords
Array of strings (AddVideoPasswords) unique [ items >= 2 characters ]
waitTranscoding
boolean

Whether or not we wait transcoding before publish the video

Responses

Request samples

Content type
application/json
{
  • "name": "What is PeerTube?",
  • "channelId": 3,
  • "privacy": 1,
  • "category": 15,
  • "licence": 2,
  • "language": "en",
  • "description": "**[Want to help to translate this video?](https://weblate.framasoft.org/projects/what-is-peertube-video/)**\\r\\n\\r\\n**Take back the control of your videos! [#JoinPeertube](https://joinpeertube.org)**\n",
  • "waitTranscoding": true,
  • "generateTranscription": true,
  • "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
  • "nsfw": true,
  • "nsfwSummary": null,
  • "nsfwFlags": 0,
  • "tags": [
    ],
  • "commentsPolicy": 1,
  • "recommendationScope": 1,
  • "aiUsage": 1,
  • "commercialContent": 1,
  • "downloadEnabled": true,
  • "originallyPublishedAt": "2019-08-24T14:15:22Z",
  • "scheduleUpdate": {
    },
  • "thumbnailfile": "string",
  • "previewfile": "string",
  • "videoPasswords": [
    ],
  • "filename": "what_is_peertube.mp4"
}

Send chunk for the resumable upload of a video

Uses a resumable protocol to continue, pause or resume the upload of a video

Authorizations:
OAuth2
query Parameters
upload_id
required
string

Created session id to proceed with. If you didn't send chunks in the last hour, it is not valid anymore and you need to initialize a new upload.

header Parameters
Content-Length
required
number
Example: 262144

Size of the chunk that the request is sending.

Remember that larger chunks are more efficient. PeerTube's web client uses chunks varying from 1048576 bytes (~1MB) and increases or reduces size depending on connection health.

Content-Range
required
string
Example: bytes 0-262143/2469036

Specifies the bytes in the file that the request is uploading.

For example, a value of bytes 0-262143/1000000 shows that the request is sending the first 262144 bytes (256 x 1024) in a 2,469,036 byte file.

When the server config client.videos.resumableUpload.minChunkSize (video uploads) or import.users.resumableUpload.minChunkSize (user archive imports) is not 0, every chunk except the last one must be at least that big. It must also be at least 1/10,000 of the file size (the maximum number of object storage multipart upload parts).

Request Body schema: application/octet-stream
string <binary>

Responses

Response samples

Content type
application/json
{
  • "video": {
    }
}

Cancel the resumable upload of a video, deleting any data uploaded so far

Uses a resumable protocol to cancel the upload of a video

Authorizations:
OAuth2
query Parameters
upload_id
required
string

Created session id to proceed with. If you didn't send chunks in the last hour, it is not valid anymore and you need to initialize a new upload.

header Parameters
Content-Length
required
number
Example: 0

Responses

Import a video

Import a torrent or magnetURI or HTTP resource (if enabled by the instance administrator)

Authorizations:
OAuth2
Request Body schema: multipart/form-data
One of
channelId
required
integer >= 1

Channel id that will contain this video

name
required
string [ 3 .. 120 ] characters

Video name

targetUrl
required
string <url>

remote URL where to find the import's source video

aiUsage
integer (VideoAIUsageSet)
Enum: 1 2 3 4

PeerTube >= 9.0 Use of AI in the video, declared by the video creator:

  • 1 Not specified
  • 2 No AI-generated content: nothing seen or heard in the video has been generated by AI
  • 3 Contains AI-generated content: some parts of the video have been generated by AI
  • 4 AI-generated: the whole video, or most of it, has been generated by AI
category
integer (VideoCategorySet)

category id of the video (see /videos/categories)

commentsPolicy
integer (VideoCommentsPolicySet)
Enum: 1 2 3

Comments policy of the video (Enabled = 1, Disabled = 2, Requires Approval = 3)

commercialContent
integer (VideoCommercialContentSet)
Enum: 1 2 3

PeerTube >= 9.0 Commercial content in the video, declared by the video creator:

  • 1 None
  • 2 Promotional content: the creator promotes their own products, services or business
  • 3 Paid partnership: a third party paid, or provided goods or services, in exchange for the promotion
description
string

Video description

downloadEnabled
boolean

Enable or disable downloading for this video

generateTranscription
boolean

PeerTube >= 6.2 If enabled by the admin, automatically generate a subtitle of the video

language
string (VideoLanguageSet)

language id of the video (see /videos/languages)

licence
integer (VideoLicenceSet)

licence id of the video (see /videos/licences)

nsfw
boolean

Whether or not this video contains sensitive content

nsfwFlags
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwSummary
any

More information about the sensitive content of the video

originallyPublishedAt
string <date-time>

Date when the content was originally published

previewfile
string <binary>
Deprecated

Deprecated in PeerTube v8.1, use thumbnailfile instead

privacy
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

privacy id of the video (see /videos/privacies)

recommendationScope
integer (VideoRecommendationScopeSet)
Enum: 1 2 3 4

Videos that can be recommended next to a video:

  • 1 All videos
  • 2 Only videos of the platform that owns the reference video (or of the current platform if no video is given)
  • 3 Only videos of the account that owns the reference video
  • 4 Only videos of the channel of the reference video

This is a preference of the video owner: applications displaying recommendations may not apply it

object (VideoScheduledUpdate)
support
string

A text tell the audience how to support the video creator

tags
Array of strings [ 1 .. 5 ] items unique [ items [ 2 .. 30 ] characters ]

Video tags (maximum 5 tags each between 2 and 30 characters)

thumbnailfile
string <binary>

Video thumbnail file

videoPasswords
Array of strings (AddVideoPasswords) unique [ items >= 2 characters ]
waitTranscoding
boolean

Whether or not we wait transcoding before publish the video

Responses

Response samples

Content type
application/json
{
  • "video": {
    }
}

Initialize the resumable replacement of a video

PeerTube >= 6.0 Uses a resumable protocol to initialize the replacement of a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

header Parameters
X-Upload-Content-Length
required
number
Example: 2469036

Number of bytes that will be uploaded in subsequent requests. Set this value to the size of the file you are uploading.

X-Upload-Content-Type
required
string <mimetype>
Example: video/mp4

MIME type of the file that you are uploading. Depending on your instance settings, acceptable values might vary.

Request Body schema: application/json
filename
string <filename>

Video filename including extension

Responses

Request samples

Content type
application/json
{
  • "filename": "what_is_peertube.mp4"
}

Send chunk for the resumable replacement of a video

PeerTube >= 6.0 Uses a resumable protocol to continue, pause or resume the replacement of a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

query Parameters
upload_id
required
string

Created session id to proceed with. If you didn't send chunks in the last hour, it is not valid anymore and you need to initialize a new upload.

header Parameters
Content-Length
required
number
Example: 262144

Size of the chunk that the request is sending.

Remember that larger chunks are more efficient. PeerTube's web client uses chunks varying from 1048576 bytes (~1MB) and increases or reduces size depending on connection health.

Content-Range
required
string
Example: bytes 0-262143/2469036

Specifies the bytes in the file that the request is uploading.

For example, a value of bytes 0-262143/1000000 shows that the request is sending the first 262144 bytes (256 x 1024) in a 2,469,036 byte file.

When the server config client.videos.resumableUpload.minChunkSize (video uploads) or import.users.resumableUpload.minChunkSize (user archive imports) is not 0, every chunk except the last one must be at least that big. It must also be at least 1/10,000 of the file size (the maximum number of object storage multipart upload parts).

Request Body schema: application/octet-stream
string <binary>

Responses

Cancel the resumable replacement of a video

PeerTube >= 6.0 Uses a resumable protocol to cancel the replacement of a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

query Parameters
upload_id
required
string

Created session id to proceed with. If you didn't send chunks in the last hour, it is not valid anymore and you need to initialize a new upload.

header Parameters
Content-Length
required
number
Example: 0

Responses

Video Imports

Operations dealing with listing, adding and removing video imports.

Import a video

Import a torrent or magnetURI or HTTP resource (if enabled by the instance administrator)

Authorizations:
OAuth2
Request Body schema: multipart/form-data
One of
channelId
required
integer >= 1

Channel id that will contain this video

name
required
string [ 3 .. 120 ] characters

Video name

targetUrl
required
string <url>

remote URL where to find the import's source video

aiUsage
integer (VideoAIUsageSet)
Enum: 1 2 3 4

PeerTube >= 9.0 Use of AI in the video, declared by the video creator:

  • 1 Not specified
  • 2 No AI-generated content: nothing seen or heard in the video has been generated by AI
  • 3 Contains AI-generated content: some parts of the video have been generated by AI
  • 4 AI-generated: the whole video, or most of it, has been generated by AI
category
integer (VideoCategorySet)

category id of the video (see /videos/categories)

commentsPolicy
integer (VideoCommentsPolicySet)
Enum: 1 2 3

Comments policy of the video (Enabled = 1, Disabled = 2, Requires Approval = 3)

commercialContent
integer (VideoCommercialContentSet)
Enum: 1 2 3

PeerTube >= 9.0 Commercial content in the video, declared by the video creator:

  • 1 None
  • 2 Promotional content: the creator promotes their own products, services or business
  • 3 Paid partnership: a third party paid, or provided goods or services, in exchange for the promotion
description
string

Video description

downloadEnabled
boolean

Enable or disable downloading for this video

generateTranscription
boolean

PeerTube >= 6.2 If enabled by the admin, automatically generate a subtitle of the video

language
string (VideoLanguageSet)

language id of the video (see /videos/languages)

licence
integer (VideoLicenceSet)

licence id of the video (see /videos/licences)

nsfw
boolean

Whether or not this video contains sensitive content

nsfwFlags
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwSummary
any

More information about the sensitive content of the video

originallyPublishedAt
string <date-time>

Date when the content was originally published

previewfile
string <binary>
Deprecated

Deprecated in PeerTube v8.1, use thumbnailfile instead

privacy
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

privacy id of the video (see /videos/privacies)

recommendationScope
integer (VideoRecommendationScopeSet)
Enum: 1 2 3 4

Videos that can be recommended next to a video:

  • 1 All videos
  • 2 Only videos of the platform that owns the reference video (or of the current platform if no video is given)
  • 3 Only videos of the account that owns the reference video
  • 4 Only videos of the channel of the reference video

This is a preference of the video owner: applications displaying recommendations may not apply it

object (VideoScheduledUpdate)
support
string

A text tell the audience how to support the video creator

tags
Array of strings [ 1 .. 5 ] items unique [ items [ 2 .. 30 ] characters ]

Video tags (maximum 5 tags each between 2 and 30 characters)

thumbnailfile
string <binary>

Video thumbnail file

videoPasswords
Array of strings (AddVideoPasswords) unique [ items >= 2 characters ]
waitTranscoding
boolean

Whether or not we wait transcoding before publish the video

Responses

Response samples

Content type
application/json
{
  • "video": {
    }
}

Cancel video import

Cancel a pending video import

Authorizations:
OAuth2
path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

Responses

Retry video import

PeerTube >= 8.0 Retry a failed or cancelled (PeerTube >= 8.3) video import.

Authorizations:
OAuth2
path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

Responses

Retry the import of a video

PeerTube >= 9.0 Retry the failed or cancelled import of a video, without having to know the video import id.

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Delete video import

Delete ended video import

Authorizations:
OAuth2
path Parameters
id
required
integer (id) >= 1
Example: 42

Entity id

Responses

Video Captions

Operations dealing with listing, adding and removing closed captions of a video.

List captions of a video

path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

header Parameters
x-peertube-video-password
string

Required on password protected video

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Generate a video caption

PeerTube >= 6.2 This feature has to be enabled by the administrator

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: application/json
forceTranscription
boolean
Default: false

Responses

Request samples

Content type
application/json
{
  • "forceTranscription": false
}

Add or replace a video caption

Authorizations:
OAuth2
path Parameters
captionLanguage
required
string (VideoLanguageSet)
Example: en

The caption language

required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: multipart/form-data
captionfile
string <binary>

The file to upload.

Responses

Delete a video caption

Authorizations:
OAuth2
path Parameters
captionLanguage
required
string (VideoLanguageSet)
Example: en

The caption language

required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Video Chapters

Operations dealing with managing chapters of a video.

Get chapters of a video

PeerTube >= 6.0

path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

header Parameters
x-peertube-video-password
string

Required on password protected video

Responses

Response samples

Content type
application/json
{
  • "chapters": {
    }
}

Replace video chapters

PeerTube >= 6.0

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: application/json
Array of objects

Responses

Request samples

Content type
application/json
{
  • "chapters": [
    ]
}

Video Channels

Operations dealing with the creation, modification and listing of videos within a channel.

List video channels

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Create a video channel

Authorizations:
OAuth2
Request Body schema: application/json
displayName
required
any

Channel display name

name
required
string [ 1 .. 50 ] characters /^[a-zA-Z0-9\\-_.:]+$/

username of the channel to create

description
any

Channel description

publicEmail
string or null <email>

Public email visible in podcast RSS feeds

support
any

How to support/fund the channel

Responses

Request samples

Content type
application/json
{
  • "displayName": null,
  • "description": null,
  • "support": null,
  • "publicEmail": "user@example.com",
  • "name": "framasoft_videos"
}

Response samples

Content type
application/json
{
  • "videoChannel": {
    }
}

Get a video channel

path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

Responses

Response samples

Content type
application/json
{
  • "id": 42,
  • "url": "string",
  • "name": "chocobozzz",
  • "avatars": [
    ],
  • "host": "example.com",
  • "hostRedundancyAllowed": true,
  • "followingCount": 0,
  • "followersCount": 0,
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "displayName": "Videos of Framasoft",
  • "description": "Videos made with <3 by Framasoft",
  • "support": "Please support our work on https://soutenir.framasoft.org/en/ <3",
  • "publicEmail": "user@example.com",
  • "isLocal": true,
  • "banners": [
    ],
  • "ownerAccount": {
    },
  • "videosCount": 0,
  • "viewsPerDay": [
    ],
  • "viewsGroupInterval": "day",
  • "totalViews": 0
}

Update a video channel

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

Request Body schema: application/json
bulkVideosSupportUpdate
boolean

Update the support field for all videos of this channel

description
any

Channel description

displayName
any

Channel display name

publicEmail
string or null <email>

Public email visible in podcast RSS feeds

support
any

How to support/fund the channel

Responses

Request samples

Content type
application/json
{
  • "displayName": null,
  • "description": null,
  • "support": null,
  • "publicEmail": "user@example.com",
  • "bulkVideosSupportUpdate": true
}

Delete a video channel

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

Responses

List videos of a video channel

path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

query Parameters
VideoAIUsageSet (integer) or Array of VideoAIUsageSet (integers)

PeerTube >= 9.0 Only list videos with one of these AI usages, declared by video creators. If not provided, the preference of the authenticated user (aiUsagesHidden) is used

string or Array of strings

PeerTube >= 6.2 Admins and moderators only filter on videos that contain one of these automatic tags

VideoCategorySet (integer) or Array of VideoCategorySet (integers)

category id of the video (see /videos/categories)

count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

excludeAlreadyWatched
boolean

Whether or not to exclude videos that are in the user's video history

hasHLSFiles
boolean

PeerTube >= 4.0 Display only videos that have HLS files

hasWebVideoFiles
boolean

PeerTube >= 6.0 Display only videos that have Web Video files

host
string

Find elements owned by this host

include
integer
Enum: 0 1 2 4 8 16 32

Only administrators and moderators can use this parameter

Include additional videos in results (can be combined using bitwise or operator)

  • 0 NONE
  • 1 NOT_PUBLISHED_STATE
  • 2 BLACKLISTED
  • 4 BLOCKED_OWNER
  • 8 FILES
  • 16 CAPTIONS
  • 32 VIDEO SOURCE
includeScheduledLive
boolean

whether or not include live that are scheduled for later

isLive
boolean

whether or not the video is a live

isLocal
boolean

PeerTube >= 4.0 Display only local or remote objects

VideoLanguageSet (string) or Array of VideoLanguageSet (strings)

language id of the video (see /videos/languages). Use _unknown to filter on videos that don't have a video language

VideoLicenceSet (integer) or Array of VideoLicenceSet (integers)

licence id of the video (see /videos/licences)

nsfw
string
Enum: "true" "false"

whether to include nsfw videos, if any

nsfwFlagsExcluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwFlagsIncluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
privacyOneOf
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

PeerTube >= 4.0 Display only videos in this specific privacy/privacies

search
string

Plain text search, applied to various parts of the model depending on endpoint

skipCount
string
Default: "false"
Enum: "true" "false"

if you don't need the total in the response

sort
string
Enum: "name" "-duration" "-createdAt" "-publishedAt" "-views" "-likes" "-comments" "-trending" "-hot" "-best"

Sort videos by criteria (prefixing with - means DESC order):

  • hot - Adaptation of Reddit "hot" algorithm taking into account video views, likes, dislikes and comments and publication date
  • best - Same than hot, but also takes into account user video history
  • trending - Sort videos by recent views ("recent" is defined by the admin)
  • views - Sort videos using their views counter
  • publishedAt - Sort by video publication date (when it became publicly available)
start
integer >= 0

Offset used to paginate results

integer or Array of integers

PeerTube >= 8.2 Admins and moderators only filter on videos that have one of these states

string or Array of strings

tag(s) of the video, where all should be present in the video

string or Array of strings

tag(s) of the video

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

List activities of a video channel

PeerTube >= 8.0

path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

List playlists of a channel

path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

playlistType
integer (VideoPlaylistTypeSet)
Enum: 1 2

The video playlist type (Regular = 1, Watch Later = 2)

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Reorder channel playlists

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

Request Body schema: application/json
insertAfterPosition
required
integer >= 0

New position for the block to reorder, to add the block before the first element

startPosition
required
integer >= 1

Start position of the element to reorder

reorderLength
integer >= 1

How many element from startPosition to reorder

Responses

Request samples

Content type
application/json
{
  • "startPosition": 1,
  • "insertAfterPosition": 0,
  • "reorderLength": 1
}

List followers of a video channel

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

search
string

Plain text search, applied to various parts of the model depending on endpoint

sort
string
Value: "createdAt"

Sort followers by criteria

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Update channel avatar

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

Request Body schema: multipart/form-data
avatarfile
string <binary>

The file to upload.

Responses

Response samples

Content type
application/json
{
  • "avatars": [
    ]
}

Delete channel avatar

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

Responses

Update channel banner

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

Request Body schema: multipart/form-data
bannerfile
string <binary>

The file to upload.

Responses

Response samples

Content type
application/json
{
  • "banners": [
    ]
}

Delete channel banner

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

Responses

Import videos in channel

Import a remote channel/playlist videos into a channel

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

Request Body schema: application/json
externalChannelUrl
required
string
videoChannelSyncId
integer

If part of a channel sync process, specify its id to assign video imports to this channel synchronization

Responses

Request samples

Content type
application/json
{}

List video channels of an account

path Parameters
name
required
string
Example: chocobozzz | chocobozzz@example.org

The username or handle of the account

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

includeCollaborations
boolean

PeerTube >= 8.0 Include objects from collaborated channels

search
string

Plain text search, applied to various parts of the model depending on endpoint

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

statsDays
integer
Default: 30
Enum: 30 90 365 0

number of days of view statistics to include in viewsPerDay when withStats is true (only if authenticated as the account user). 0 means all time (since the channel's earliest recorded stat). viewsPerDay always spans the whole requested range so channels can be compared to each other. Its bucket size is reported in viewsGroupInterval: it is derived from the requested range, narrowed to the channel history so that a young channel on a long range is not aggregated into a single coarse bucket. totalViews is unaffected by this parameter and always reports lifetime views.

withStats
boolean

include view statistics time series and total views (only if authenticated as the account user)

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

List the synchronizations of video channels of an account

path Parameters
name
required
string
Example: chocobozzz | chocobozzz@example.org

The username or handle of the account

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

includeCollaborations
boolean

PeerTube >= 8.0 Include objects from collaborated channels

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Search channels

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

handles
Array of strings

Find elements with these handles

host
string

Find elements owned by this host

search
required
string

String to search. If the user can make a remote URI search, and the string is an URI then the PeerTube instance will fetch the remote object and add it to its database. Then, you can use the REST API to fetch the complete channel information and interact with it.

searchTarget
string
Enum: "local" "search-index"

If the administrator enabled search index support, you can override the default search target.

Warning: If you choose to make an index search, PeerTube will get results from a third party service. It means the instance may not yet know the objects you fetched. If you want to load video/channel information:

  • If the current user has the ability to make a remote URI search (this information is available in the config endpoint), then reuse the search API to make a search using the object URI so PeerTube instance fetches the remote object and fill its database. After that, you can use the classic REST API endpoints to fetch the complete object or interact with it
  • If the current user doesn't have the ability to make a remote URI search, then redirect the user on the origin instance or fetch the data from the origin instance API
sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

List channel collaborators

PeerTube >= 8.0

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Invite a collaborator

PeerTube >= 8.0 Invite a local user to collaborate on the specified video channel.

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

Request Body schema: application/json
required
accountHandle
string

Local user username to invite

Responses

Request samples

Content type
application/json
{
  • "accountHandle": "string"
}

Response samples

Content type
application/json
{
  • "collaborator": {
    }
}

Accept a collaboration invitation

PeerTube >= 8.0

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

collaboratorId
required
integer (id) >= 1
Example: 42

The collaborator id

Responses

Reject a collaboration invitation

PeerTube >= 8.0

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

collaboratorId
required
integer (id) >= 1
Example: 42

The collaborator id

Responses

Remove a channel collaborator

PeerTube >= 8.0 Only the channel owner or the collaborator themselves can remove a collaborator from a channel

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

collaboratorId
required
integer (id) >= 1
Example: 42

The collaborator id

Responses

Video Comments

Operations dealing with comments to a video. Comments are organized in threads: adding a comment in response to the video starts a thread, adding a reply to a comment adds it to its root comment thread.

List comments on user's videos

PeerTube >= 6.2

Authorizations:
OAuth2
query Parameters
string or Array of strings

PeerTube >= 6.2 filter on comments that contain one of these automatic tags

includeCollaborations
boolean

PeerTube >= 8.0 Include objects from collaborated channels

isHeldForReview
boolean

only display comments that are held for review

search
string

Plain text search, applied to various parts of the model depending on endpoint

searchAccount
string

Filter comments by searching on the account

searchVideo
string

Filter comments by searching on the video

videoChannelId
integer

Limit results on this specific video channel

videoId
integer

Limit results on this specific video

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

List threads of a video

path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Enum: "-createdAt" "-totalReplies"

Sort comments by criteria

start
integer >= 0

Offset used to paginate results

header Parameters
x-peertube-video-password
string

Required on password protected video

Responses

Response samples

Content type
application/json
{
  • "total": 0,
  • "totalNotDeletedComments": 0,
  • "data": [
    ]
}

Create a thread

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: application/json
text
required
string <html> [ 1 .. 10000 ] characters

Text of the comment

Responses

Request samples

Content type
application/json
{
  • "text": "This video is wonderful!"
}

Response samples

Content type
application/json
{
  • "comment": {
    }
}

Get a thread

Since PeerTube 8.3 the returned tree is truncated: only the first replies of each comment are included, and only down to maxDepth nesting levels. Use GET /api/v1/videos/{id}/comments/{commentId}/replies to fetch the replies that are missing, comparing children and totalChildren of each node of the tree.

path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

threadId
required
integer

The thread id (root comment id)

query Parameters
maxDepth
integer [ 1 .. 10 ]
Default: 5

Number of nesting levels to include below the requested comment. Bounded by repliesPerLevel and count, see the note on repliesPerLevel

repliesPerLevel
integer [ 1 .. 30 ]
Default: 10

Number of direct replies to include for each comment of the tree. Does not apply to the first level of GET /api/v1/videos/{id}/comments/{commentId}/replies, which is paginated using start and count. A tree can make the server walk through count * (repliesPerLevel ^ maxDepth - 1) / (repliesPerLevel - 1) comments, which grows exponentially. Combinations above 2000000 are rejected A deep tree has to be narrow and a wide tree has to be shallow.

header Parameters
x-peertube-video-password
string

Required on password protected video

Responses

Response samples

Content type
application/json
{
  • "comment": {
    },
  • "children": [
    ],
  • "totalChildren": 0
}

List replies of a comment

PeerTube >= 8.3 List the direct replies of a comment, each of them nested up to maxDepth levels. Used to unfold the parts of a thread that GET /api/v1/videos/{id}/comment-threads/{threadId} truncated.

path Parameters
commentId
required
integer >= 1
Example: 42

The comment id

required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

maxDepth
integer [ 1 .. 10 ]
Default: 5

Number of nesting levels to include below the requested comment. Bounded by repliesPerLevel and count, see the note on repliesPerLevel

repliesPerLevel
integer [ 1 .. 30 ]
Default: 10

Number of direct replies to include for each comment of the tree. Does not apply to the first level of GET /api/v1/videos/{id}/comments/{commentId}/replies, which is paginated using start and count. A tree can make the server walk through count * (repliesPerLevel ^ maxDepth - 1) / (repliesPerLevel - 1) comments, which grows exponentially. Combinations above 2000000 are rejected A deep tree has to be narrow and a wide tree has to be shallow.

sort
string
Default: "createdAt"
Enum: "createdAt" "-createdAt"

Sort the direct replies of the comment. Deeper levels of the tree are always sorted the same way. Defaults to createdAt so the replies are appended to the thread tree in the order it was built

start
integer >= 0

Offset used to paginate results

header Parameters
x-peertube-video-password
string

Required on password protected video

Responses

Response samples

Content type
application/json
{
  • "total": 13,
  • "data": [
    ]
}

List instance comments

Authorizations:
OAuth2
query Parameters
string or Array of strings

PeerTube >= 6.2 filter on comments that contain one of these automatic tags

includeMuted
boolean

PeerTube >= 8.2 Include comments from muted accounts

isLocal
boolean

PeerTube >= 4.0 Display only local or remote objects

onLocalVideo
boolean

Display only objects of local or remote videos

search
string

Plain text search, applied to various parts of the model depending on endpoint

searchAccount
string

Filter comments by searching on the account

searchVideo
string

Filter comments by searching on the video

videoChannelId
integer

Limit results on this specific video channel

videoId
integer

Limit results on this specific video

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Reply to a thread of a video

Authorizations:
OAuth2
path Parameters
commentId
required
integer >= 1
Example: 42

The comment id

required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

header Parameters
x-peertube-video-password
string

Required on password protected video

Request Body schema: application/json
text
required
string <html> [ 1 .. 10000 ] characters

Text of the comment

Responses

Request samples

Content type
application/json
{
  • "text": "This video is wonderful!"
}

Response samples

Content type
application/json
{
  • "comment": {
    }
}

Delete a comment or a reply

Authorizations:
OAuth2
path Parameters
commentId
required
integer >= 1
Example: 42

The comment id

required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Approve a comment

PeerTube >= 6.2 Approve a comment that requires a review

Authorizations:
OAuth2
path Parameters
commentId
required
integer >= 1
Example: 42

The comment id

required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Video Rates

Like/dislike a video.

Get rate of my user for a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

Video id or UUID

Responses

Response samples

Content type
application/json
{
  • "id": 42,
  • "rating": "like"
}

Like/dislike a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

header Parameters
x-peertube-video-password
string

Required on password protected video

Request Body schema: application/json
rating
required
string
Enum: "like" "dislike"

Responses

Request samples

Content type
application/json
{
  • "rating": "like"
}

Video Playlists

Operations dealing with playlists of videos. Playlists are bound to users and/or channels.

List playlists of a channel

path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

playlistType
integer (VideoPlaylistTypeSet)
Enum: 1 2

The video playlist type (Regular = 1, Watch Later = 2)

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Reorder channel playlists

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

Request Body schema: application/json
insertAfterPosition
required
integer >= 0

New position for the block to reorder, to add the block before the first element

startPosition
required
integer >= 1

Start position of the element to reorder

reorderLength
integer >= 1

How many element from startPosition to reorder

Responses

Request samples

Content type
application/json
{
  • "startPosition": 1,
  • "insertAfterPosition": 0,
  • "reorderLength": 1
}

List available playlist privacy policies

Responses

Response samples

Content type
application/json
{
  • "1": "Public",
  • "2": "Unlisted",
  • "3": "Private"
}

List video playlists

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

playlistType
integer (VideoPlaylistTypeSet)
Enum: 1 2

The video playlist type (Regular = 1, Watch Later = 2)

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Create a video playlist

If the video playlist is set as public, videoChannelId is mandatory.

Authorizations:
OAuth2
Request Body schema: multipart/form-data
displayName
required
string [ 1 .. 120 ] characters

Video playlist display name

description
string [ 3 .. 1000 ] characters

Video playlist description

privacy
integer (VideoPlaylistPrivacySet)
Enum: 1 2 3

Video playlist privacy policy (see /video-playlists/privacies)

thumbnailfile
string <binary>

Video playlist thumbnail file

videoChannelId
integer >= 1

Video channel in which the playlist will be published

Responses

Response samples

Content type
application/json
{
  • "videoPlaylist": {
    }
}

Get a video playlist

path Parameters
playlistId
required
integer >= 1
Example: 42

Playlist id

Responses

Response samples

Content type
application/json
{
  • "id": 42,
  • "uuid": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
  • "shortUUID": "2y84q2MQUMWPbiEcxNXMgC",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "description": "string",
  • "displayName": "string",
  • "isLocal": true,
  • "videoLength": 0,
  • "thumbnailPath": "string",
  • "thumbnails": [
    ],
  • "privacy": {
    },
  • "type": {
    },
  • "ownerAccount": {
    },
  • "videoChannel": {
    },
  • "videoChannelPosition": 1
}

Update a video playlist

If the video playlist is set as public, the playlist must have a assigned channel.

Authorizations:
OAuth2
path Parameters
playlistId
required
integer >= 1
Example: 42

Playlist id

Request Body schema: multipart/form-data
description
string

Video playlist description

displayName
string [ 1 .. 120 ] characters

Video playlist display name

privacy
integer (VideoPlaylistPrivacySet)
Enum: 1 2 3

Video playlist privacy policy (see /video-playlists/privacies)

thumbnailfile
string <binary>

Video playlist thumbnail file

videoChannelId
integer >= 1

Video channel in which the playlist will be published

Responses

Delete a video playlist

Authorizations:
OAuth2
path Parameters
playlistId
required
integer >= 1
Example: 42

Playlist id

Responses

List videos of a playlist

path Parameters
playlistId
required
integer >= 1
Example: 42

Playlist id

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Add a video in a playlist

Authorizations:
OAuth2
path Parameters
playlistId
required
integer >= 1
Example: 42

Playlist id

Request Body schema: application/json
required
string or integer

Video to add in the playlist

startTimestamp
integer <seconds>

Start the video at this specific timestamp

stopTimestamp
integer <seconds>

Stop the video at this specific timestamp

Responses

Request samples

Content type
application/json
{
  • "videoId": "9c9de5e8-0a1e-484a-b099-e80766180a6d",
  • "startTimestamp": 0,
  • "stopTimestamp": 0
}

Response samples

Content type
application/json
{
  • "videoPlaylistElement": {
    }
}

Reorder playlist elements

Authorizations:
OAuth2
path Parameters
playlistId
required
integer >= 1
Example: 42

Playlist id

Request Body schema: application/json
insertAfterPosition
required
integer >= 0

New position for the block to reorder, to add the block before the first element

startPosition
required
integer >= 1

Start position of the element to reorder

reorderLength
integer >= 1

How many element from startPosition to reorder

Responses

Request samples

Content type
application/json
{
  • "startPosition": 1,
  • "insertAfterPosition": 0,
  • "reorderLength": 1
}

Update a playlist element

Authorizations:
OAuth2
path Parameters
playlistElementId
required
integer (id) >= 1
Example: 42

Playlist element id

playlistId
required
integer >= 1
Example: 42

Playlist id

Request Body schema: application/json
startTimestamp
integer <seconds>

Start the video at this specific timestamp

stopTimestamp
integer <seconds>

Stop the video at this specific timestamp

Responses

Request samples

Content type
application/json
{
  • "startTimestamp": 0,
  • "stopTimestamp": 0
}

Delete an element from a playlist

Authorizations:
OAuth2
path Parameters
playlistElementId
required
integer (id) >= 1
Example: 42

Playlist element id

playlistId
required
integer >= 1
Example: 42

Playlist id

Responses

Check video exists in my playlists

Authorizations:
OAuth2
query Parameters
videoIds
required
Array of integers[ items >= 1 ]
Example: videoIds=42

The video ids to check

Responses

Response samples

Content type
application/json
{
  • "videoId": [
    ]
}

List playlists of an account

path Parameters
name
required
string
Example: chocobozzz | chocobozzz@example.org

The username or handle of the account

query Parameters
string or Array of strings

PeerTube >= 8.0 Filter on playlists that are published on a channel with one of these names

count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

includeCollaborations
boolean

PeerTube >= 8.0 Include objects from collaborated channels

playlistType
integer (VideoPlaylistTypeSet)
Enum: 1 2

The video playlist type (Regular = 1, Watch Later = 2)

search
string

Plain text search, applied to various parts of the model depending on endpoint

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Search playlists

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

host
string

Find elements owned by this host

search
required
string

String to search. If the user can make a remote URI search, and the string is an URI then the PeerTube instance will fetch the remote object and add it to its database. Then, you can use the REST API to fetch the complete playlist information and interact with it.

searchTarget
string
Enum: "local" "search-index"

If the administrator enabled search index support, you can override the default search target.

Warning: If you choose to make an index search, PeerTube will get results from a third party service. It means the instance may not yet know the objects you fetched. If you want to load video/channel information:

  • If the current user has the ability to make a remote URI search (this information is available in the config endpoint), then reuse the search API to make a search using the object URI so PeerTube instance fetches the remote object and fill its database. After that, you can use the classic REST API endpoints to fetch the complete object or interact with it
  • If the current user doesn't have the ability to make a remote URI search, then redirect the user on the origin instance or fetch the data from the origin instance API
sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

uuids
Array of strings

Find elements with specific UUIDs

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Video Stats

Video statistics

Get overall stats of a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

query Parameters
endDate
string <date-time>

Filter stats by end date

startDate
string <date-time>

Filter stats by start date

Responses

Response samples

Content type
application/json
{
  • "averageWatchTime": 0,
  • "totalWatchTime": 0,
  • "viewersPeak": 0,
  • "totalViewers": 0,
  • "viewersPeakDate": "2019-08-24T14:15:22Z",
  • "countries": [
    ],
  • "subdivisions": [
    ]
}

Get user agent stats of a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

query Parameters
endDate
string <date-time>

Filter stats by end date

startDate
string <date-time>

Filter stats by start date

Responses

Response samples

Content type
application/json
{
  • "clients": [
    ],
  • "devices": [
    ],
  • "operatingSystem": [
    ]
}

Get retention stats of a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

Get timeserie stats of a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

metric
required
string
Enum: "viewers" "aggregateWatchTime"

The metric to get

query Parameters
endDate
string <date-time>

Filter stats by end date

startDate
string <date-time>

Filter stats by start date

Responses

Response samples

Content type
application/json
{
  • "data": [
    ]
}

Ownership Change

List video ownership changes

List ownership change requests received by the authenticated user and requests sent by a channel managed by the authenticated user

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Enum: "-createdAt" "createdAt"
start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Accept ownership change request

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: application/json
required
channelId
required
integer

Target channel id owned by the authenticated user

Responses

Request samples

Content type
application/json
{
  • "channelId": 0
}

Refuse ownership change request

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Delete ownership change request

Delete an ownership change request. Only users who can manage the video can delete the request.

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

List ownership change requests for a video

List all ownership change requests for a specific video. The authenticated user must be able to manage the video.

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

Video id or UUID

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Enum: "-createdAt" "createdAt"
start
integer >= 0

Offset used to paginate results

state
integer (ChangeOwnershipState)
Enum: 1 2 3

Filter by ownership change state

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Request ownership change

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

Video id or UUID

Request Body schema: application/json
required
username
required
string

Responses

Request samples

Content type
application/json
{
  • "username": "string"
}

List channel ownership changes

List ownership change requests received by the authenticated user and requests sent by channels managed by the authenticated user

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Enum: "-createdAt" "createdAt"
start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Accept channel ownership change request

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Refuse channel ownership change request

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Delete channel ownership change request

Delete a channel ownership change request. Only channel owners can delete the request.

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

List ownership change requests for a channel

List all ownership change requests for a specific channel. The authenticated user must be able to manage the channel.

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Enum: "-createdAt" "createdAt"
start
integer >= 0

Offset used to paginate results

state
integer (ChangeOwnershipState)
Enum: 1 2 3

Filter by ownership change state

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Request channel ownership change

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

Request Body schema: application/json
required
username
required
string

Responses

Request samples

Content type
application/json
{
  • "username": "string"
}

Video Mirroring

PeerTube instances can mirror videos from one another, and help distribute some videos.

For importing videos as your own, refer to video imports.

List videos being mirrored

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Value: "name"

Sort abuses by criteria

start
integer >= 0

Offset used to paginate results

target
required
string
Enum: "my-videos" "remote-videos"

direction of the mirror

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Mirror a video

Authorizations:
OAuth2
Request Body schema: application/json
videoId
required
integer >= 1

object id for the video

Responses

Request samples

Content type
application/json
{
  • "videoId": 42
}

Delete a mirror done on a video

Authorizations:
OAuth2
path Parameters
redundancyId
required
string

id of an existing redundancy on a video

Responses

Video Files

Operations on video files

Delete video HLS files

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Delete video Web Video files

PeerTube >= 6.0

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Video Transcoding

Video transcoding related operations

Create a studio task

Create a task to edit a video (cut, add intro/outro etc). By default the video is edited in place. Set saveAsNewVideo to keep it untouched and save the result in a new video.

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: multipart/form-data
required
required
Array of cut (object) or add-intro (object) or add-outro (object) or add-watermark (object) or remove-segments (object) (VideoStudioCreateTask)
saveAsNewVideo
boolean
Default: false

Keep the source video untouched: duplicate it, and edit the duplicate. The duplicate is created private, in the same channel as the source video, with the source video metadata. The size of the source video counts towards the user quota.

Responses

Response samples

Content type
application/json
{
  • "video": {
    }
}

Create a transcoding job

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: application/json
transcodingType
required
string
Enum: "hls" "web-video"
forceTranscoding
boolean
Default: false

If the video is stuck in transcoding state, do it anyway

Responses

Request samples

Content type
application/json
{
  • "transcodingType": "hls",
  • "forceTranscoding": false
}

Live Videos

Create a live

Authorizations:
OAuth2
Request Body schema: multipart/form-data
channelId
required
integer

Channel id that will contain this live video

name
required
string [ 3 .. 120 ] characters

Live video/replay name

aiUsage
integer (VideoAIUsageSet)
Enum: 1 2 3 4

PeerTube >= 9.0 Use of AI in the video, declared by the video creator:

  • 1 Not specified
  • 2 No AI-generated content: nothing seen or heard in the video has been generated by AI
  • 3 Contains AI-generated content: some parts of the video have been generated by AI
  • 4 AI-generated: the whole video, or most of it, has been generated by AI
category
integer (VideoCategorySet)

category id of the video (see /videos/categories)

commentsPolicy
integer (VideoCommentsPolicySet)
Enum: 1 2 3

Comments policy of the video (Enabled = 1, Disabled = 2, Requires Approval = 3)

commercialContent
integer (VideoCommercialContentSet)
Enum: 1 2 3

PeerTube >= 9.0 Commercial content in the video, declared by the video creator:

  • 1 None
  • 2 Promotional content: the creator promotes their own products, services or business
  • 3 Paid partnership: a third party paid, or provided goods or services, in exchange for the promotion
description
string

Live video/replay description

downloadEnabled
boolean

Enable or disable downloading for the replay of this live video

language
string (VideoLanguageSet)

language id of the video (see /videos/languages)

latencyMode
integer
Enum: 1 2 3

User can select live latency mode if enabled by the instance

licence
integer (VideoLicenceSet)

licence id of the video (see /videos/licences)

nsfw
boolean

Whether or not this live video/replay contains sensitive content

nsfwFlags
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwSummary
any

More information about the sensitive content of the video

permanentLive
boolean

User can stream multiple times in a permanent live

previewfile
string <binary>
Deprecated

Deprecated in PeerTube v8.1, use thumbnailfile instead

privacy
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

privacy id of the video (see /videos/privacies)

recommendationScope
integer (VideoRecommendationScopeSet)
Enum: 1 2 3 4

Videos that can be recommended next to a video:

  • 1 All videos
  • 2 Only videos of the platform that owns the reference video (or of the current platform if no video is given)
  • 3 Only videos of the account that owns the reference video
  • 4 Only videos of the channel of the reference video

This is a preference of the video owner: applications displaying recommendations may not apply it

object (LiveVideoReplaySettings)
saveReplay
boolean
Array of objects (LiveSchedule)
support
string

A text tell the audience how to support the creator

tags
Array of strings [ 1 .. 5 ] items [ items [ 2 .. 30 ] characters ]

Live video/replay tags (maximum 5 tags each between 2 and 30 characters)

thumbnailfile
string <binary>

Live video/replay thumbnail file

Responses

Response samples

Content type
application/json
{
  • "video": {
    }
}

Get information about a live

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Response samples

Content type
application/json
{
  • "rtmpUrl": "string",
  • "rtmpsUrl": "string",
  • "streamKey": "string",
  • "saveReplay": true,
  • "replaySettings": {
    },
  • "permanentLive": true,
  • "latencyMode": 1,
  • "schedules": [
    ]
}

Update information about a live

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: application/json
latencyMode
integer
Enum: 1 2 3

User can select live latency mode if enabled by the instance

permanentLive
boolean

User can stream multiple times in a permanent live

object (LiveVideoReplaySettings)
saveReplay
boolean
Array of objects (LiveSchedule)

Responses

Request samples

Content type
application/json
{
  • "saveReplay": true,
  • "replaySettings": {
    },
  • "permanentLive": true,
  • "latencyMode": 1,
  • "schedules": [
    ]
}

List live sessions

List all sessions created in a particular live

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

query Parameters
sort
string
Example: sort=-createdAt

Sort column

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Get live session of a replay

If the video is a replay of a live, you can find the associated live session using this endpoint

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

header Parameters
x-peertube-video-password
string

Required on password protected video

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "startDate": "2019-08-24T14:15:22Z",
  • "endDate": "2019-08-24T14:15:22Z",
  • "error": 1,
  • "replayVideo": {
    }
}

Channels Sync

Operations dealing with synchronizing PeerTube user's channel with channels of other platforms

Import videos in channel

Import a remote channel/playlist videos into a channel

Authorizations:
OAuth2
path Parameters
channelHandle
required
string
Example: my_username | my_username@example.com

The video channel handle

Request Body schema: application/json
externalChannelUrl
required
string
videoChannelSyncId
integer

If part of a channel sync process, specify its id to assign video imports to this channel synchronization

Responses

Request samples

Content type
application/json
{}

Create a synchronization for a video channel

Authorizations:
OAuth2
Request Body schema: application/json
externalChannelUrl
string
videoChannelId
integer (id) >= 1
videoPrivacy
integer

Privacy of imported videos (1 = PUBLIC, 2 = UNLISTED, 3 = PRIVATE, 4 = INTERNAL). Password protected privacy is not supported

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "videoChannelSync": {
    }
}

Delete a video channel synchronization

Authorizations:
OAuth2
path Parameters
channelSyncId
required
integer >= 1
Example: 42

Channel Sync id

Responses

Triggers the channel synchronization job, fetching all the videos from the remote channel

Authorizations:
OAuth2
path Parameters
channelSyncId
required
integer >= 1
Example: 42

Channel Sync id

Responses

List the synchronizations of video channels of an account

path Parameters
name
required
string
Example: chocobozzz | chocobozzz@example.org

The username or handle of the account

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

includeCollaborations
boolean

PeerTube >= 8.0 Include objects from collaborated channels

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Video Passwords

Operations on video passwords.

List video passwords

PeerTube >= 6.0

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Update video passwords

PeerTube >= 6.0

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: application/json
passwords
Array of strings (AddVideoPasswords) unique [ items >= 2 characters ]

Responses

Request samples

Content type
application/json
{
  • "passwords": [
    ]
}

Add a video password

PeerTube >= 8.0

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: application/json
password
string

Responses

Request samples

Content type
application/json
{
  • "password": "string"
}

Delete a video password

PeerTube >= 6.0

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

passwordId
required
integer (id) >= 1
Example: 42

The video password id

Responses

Video Embed Privacy

Get video embed privacy

PeerTube >= 8.1

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

Response samples

Content type
application/json
{
  • "policy": {
    },
  • "domains": [
    ]
}

Update video embed privacy

PeerTube >= 8.1

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: application/json
domains
Array of strings
policy
integer (VideoEmbedPrivacy)
Enum: 1 2 3 4

The video embed privacy level:

  • 1 All allowed: anyone can embed the video
  • 2 Allowlist: only the domains in the allowlist can embed the video
  • 3 Remote restrictions: the remote instance has restrictions on where the video can be embedded
  • 4 Nobody can embed this video

Responses

Request samples

Content type
application/json
{
  • "policy": 1,
  • "domains": [
    ]
}

Check if embed is allowed

PeerTube >= 8.1 Check if video embed is allowed on a specific domain according to the video embed privacy settings

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

query Parameters
domain
required
string

The domain to check if embed is allowed

Responses

Response samples

Content type
application/json
{
  • "domainAllowed": true,
  • "userBypassAllowed": true
}

Search

The search helps to find videos or channels from within the instance and beyond. Videos from other instances federated by the instance (that is, instances followed by the instance) can be found via keywords and other criteria of the advanced search.

Administrators can also enable the use of a remote search system, indexing videos and channels that may not be federated by the instance.

Search videos

query Parameters
VideoAIUsageSet (integer) or Array of VideoAIUsageSet (integers)

PeerTube >= 9.0 Only list videos with one of these AI usages, declared by video creators. If not provided, the preference of the authenticated user (aiUsagesHidden) is used

string or Array of strings

PeerTube >= 6.2 Admins and moderators only filter on videos that contain one of these automatic tags

VideoCategorySet (integer) or Array of VideoCategorySet (integers)

category id of the video (see /videos/categories)

count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

durationMax
integer

Get videos that have this maximum duration

durationMin
integer

Get videos that have this minimum duration

endDate
string <date-time>

Get videos that are published before this date

excludeAlreadyWatched
boolean

Whether or not to exclude videos that are in the user's video history

hasHLSFiles
boolean

PeerTube >= 4.0 Display only videos that have HLS files

hasWebVideoFiles
boolean

PeerTube >= 6.0 Display only videos that have Web Video files

host
string

Find elements owned by this host

include
integer
Enum: 0 1 2 4 8 16 32

Only administrators and moderators can use this parameter

Include additional videos in results (can be combined using bitwise or operator)

  • 0 NONE
  • 1 NOT_PUBLISHED_STATE
  • 2 BLACKLISTED
  • 4 BLOCKED_OWNER
  • 8 FILES
  • 16 CAPTIONS
  • 32 VIDEO SOURCE
includeScheduledLive
boolean

whether or not include live that are scheduled for later

isLive
boolean

whether or not the video is a live

isLocal
boolean

PeerTube >= 4.0 Display only local or remote objects

VideoLanguageSet (string) or Array of VideoLanguageSet (strings)

language id of the video (see /videos/languages). Use _unknown to filter on videos that don't have a video language

VideoLicenceSet (integer) or Array of VideoLicenceSet (integers)

licence id of the video (see /videos/licences)

nsfw
string
Enum: "true" "false"

whether to include nsfw videos, if any

nsfwFlagsExcluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
nsfwFlagsIncluded
integer (NSFWFlag)
Enum: 0 1 2 4

NSFW flags (can be combined using bitwise or operator)

  • 0 NONE
  • 1 VIOLENT
  • 2 EXPLICIT_SEX
originallyPublishedEndDate
string <date-time>

Get videos that are originally published before this date

originallyPublishedStartDate
string <date-time>

Get videos that are originally published after this date

privacyOneOf
integer (VideoPrivacySet)
Enum: 1 2 3 4 5

PeerTube >= 4.0 Display only videos in this specific privacy/privacies

search
required
string

String to search. If the user can make a remote URI search, and the string is an URI then the PeerTube instance will fetch the remote object and add it to its database. Then, you can use the REST API to fetch the complete video information and interact with it.

searchTarget
string
Enum: "local" "search-index"

If the administrator enabled search index support, you can override the default search target.

Warning: If you choose to make an index search, PeerTube will get results from a third party service. It means the instance may not yet know the objects you fetched. If you want to load video/channel information:

  • If the current user has the ability to make a remote URI search (this information is available in the config endpoint), then reuse the search API to make a search using the object URI so PeerTube instance fetches the remote object and fill its database. After that, you can use the classic REST API endpoints to fetch the complete object or interact with it
  • If the current user doesn't have the ability to make a remote URI search, then redirect the user on the origin instance or fetch the data from the origin instance API
skipCount
string
Default: "false"
Enum: "true" "false"

if you don't need the total in the response

sort
string
Enum: "name" "-duration" "-createdAt" "-publishedAt" "-views" "-likes" "-comments" "-trending" "-hot" "-best"

Sort videos by criteria (prefixing with - means DESC order):

  • hot - Adaptation of Reddit "hot" algorithm taking into account video views, likes, dislikes and comments and publication date
  • best - Same than hot, but also takes into account user video history
  • trending - Sort videos by recent views ("recent" is defined by the admin)
  • views - Sort videos using their views counter
  • publishedAt - Sort by video publication date (when it became publicly available)
start
integer >= 0

Offset used to paginate results

startDate
string <date-time>

Get videos that are published after this date

integer or Array of integers

PeerTube >= 8.2 Admins and moderators only filter on videos that have one of these states

string or Array of strings

tag(s) of the video, where all should be present in the video

string or Array of strings

tag(s) of the video

uuids
Array of strings

Find elements with specific UUIDs

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Search channels

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

handles
Array of strings

Find elements with these handles

host
string

Find elements owned by this host

search
required
string

String to search. If the user can make a remote URI search, and the string is an URI then the PeerTube instance will fetch the remote object and add it to its database. Then, you can use the REST API to fetch the complete channel information and interact with it.

searchTarget
string
Enum: "local" "search-index"

If the administrator enabled search index support, you can override the default search target.

Warning: If you choose to make an index search, PeerTube will get results from a third party service. It means the instance may not yet know the objects you fetched. If you want to load video/channel information:

  • If the current user has the ability to make a remote URI search (this information is available in the config endpoint), then reuse the search API to make a search using the object URI so PeerTube instance fetches the remote object and fill its database. After that, you can use the classic REST API endpoints to fetch the complete object or interact with it
  • If the current user doesn't have the ability to make a remote URI search, then redirect the user on the origin instance or fetch the data from the origin instance API
sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Search playlists

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

host
string

Find elements owned by this host

search
required
string

String to search. If the user can make a remote URI search, and the string is an URI then the PeerTube instance will fetch the remote object and add it to its database. Then, you can use the REST API to fetch the complete playlist information and interact with it.

searchTarget
string
Enum: "local" "search-index"

If the administrator enabled search index support, you can override the default search target.

Warning: If you choose to make an index search, PeerTube will get results from a third party service. It means the instance may not yet know the objects you fetched. If you want to load video/channel information:

  • If the current user has the ability to make a remote URI search (this information is available in the config endpoint), then reuse the search API to make a search using the object URI so PeerTube instance fetches the remote object and fill its database. After that, you can use the classic REST API endpoints to fetch the complete object or interact with it
  • If the current user doesn't have the ability to make a remote URI search, then redirect the user on the origin instance or fetch the data from the origin instance API
sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

uuids
Array of strings

Find elements with specific UUIDs

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Abuses

Abuses deal with reports of local or remote videos/comments/accounts alike.

List my abuses

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

id
integer

only list the report with this id

sort
string
Enum: "-id" "-createdAt" "-state"

Sort abuses by criteria

start
integer >= 0

Offset used to paginate results

state
integer (AbuseStateSet)
Enum: 1 2 3

The abuse state (Pending = 1, Rejected = 2, Accepted = 3)

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

List abuses

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

filter
string
Enum: "video" "comment" "account"

only list account, comment or video reports

id
integer

only list the report with this id

predefinedReason
Array of strings (PredefinedAbuseReasons) <= 8 items
Items Enum: "violentOrAbusive" "hatefulOrAbusive" "spamOrMisleading" "privacy" "rights" "serverRules" "thumbnails" "captions"

predefined reason the listed reports should contain

search
string

plain search that will match with video titles, reporter names and more

searchReportee
string

only list reports of a specific reportee

searchReporter
string

only list reports of a specific reporter

searchVideo
string

only list reports of a specific video

searchVideoChannel
string

only list reports of a specific video channel

sort
string
Enum: "-id" "-createdAt" "-state"

Sort abuses by criteria

start
integer >= 0

Offset used to paginate results

state
integer (AbuseStateSet)
Enum: 1 2 3

The abuse state (Pending = 1, Rejected = 2, Accepted = 3)

videoIs
string
Enum: "deleted" "blacklisted"

only list deleted or blocklisted videos

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Report an abuse

You cannot report a video that you own or on which you are a collaborator (video channel editor).

Authorizations:
OAuth2
Request Body schema: application/json
required
reason
required
string [ 2 .. 3000 ] characters

Reason why the user reports this video

object
object
predefinedReasons
Array of strings (PredefinedAbuseReasons) <= 8 items
Items Enum: "violentOrAbusive" "hatefulOrAbusive" "spamOrMisleading" "privacy" "rights" "serverRules" "thumbnails" "captions"

Reason categories that help triage reports

object

Responses

Request samples

Content type
application/json
{
  • "reason": "string",
  • "predefinedReasons": [
    ],
  • "video": {
    },
  • "comment": {
    },
  • "account": {
    }
}

Response samples

Content type
application/json
{
  • "abuse": {
    }
}

Update an abuse

Authorizations:
OAuth2
path Parameters
abuseId
required
integer >= 1
Example: 42

Abuse id

Request Body schema: application/json
moderationComment
string [ 2 .. 3000 ] characters

Update the report comment visible only to the moderation team

state
integer (AbuseStateSet)
Enum: 1 2 3

The abuse state (Pending = 1, Rejected = 2, Accepted = 3)

Responses

Request samples

Content type
application/json
{
  • "state": 1,
  • "moderationComment": "string"
}

Delete an abuse

Authorizations:
OAuth2
path Parameters
abuseId
required
integer >= 1
Example: 42

Abuse id

Responses

List messages of an abuse

Authorizations:
OAuth2
path Parameters
abuseId
required
integer >= 1
Example: 42

Abuse id

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Add message to an abuse

Authorizations:
OAuth2
path Parameters
abuseId
required
integer >= 1
Example: 42

Abuse id

Request Body schema: application/json
required
message
required
string [ 2 .. 3000 ] characters

Message to send

Responses

Request samples

Content type
application/json
{
  • "message": "string"
}

Delete an abuse message

Authorizations:
OAuth2
path Parameters
abuseId
required
integer >= 1
Example: 42

Abuse id

abuseMessageId
required
integer >= 1
Example: 42

Abuse message id

Responses

Video Blocks

Operations dealing with blocking videos (removing them from view and preventing interactions).

Block a video

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: application/json
internalNote
string

Internal note for moderators/admins

reason
string

Reason for the block (public)

unfederate
boolean

Whether to unfederate the video

Responses

Request samples

Content type
application/json
{
  • "reason": "string",
  • "unfederate": true,
  • "internalNote": "string"
}

Update a video block

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Request Body schema: application/json
internalNote
string

Internal note for moderators/admins

reason
string

Reason for the block (displayed publicly)

Responses

Request samples

Content type
application/json
{
  • "reason": "string",
  • "internalNote": "string"
}

Unblock a video by its id

Authorizations:
OAuth2
path Parameters
required
id (integer) or UUIDv4 (string) or shortUUID (string)

The object id, uuid or short uuid

Responses

List video blocks

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

search
string

plain search that will match with video titles, and more

sort
string
Enum: "-id" "name" "-duration" "-views" "-likes" "-dislikes" "-uuid" "-createdAt"

Sort blocklists by criteria

start
integer >= 0

Offset used to paginate results

type
integer
Enum: 1 2

list only blocks that match this type:

  • 1: manual block
  • 2: automatic block that needs review

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Account Blocklist

Get block status of accounts/hosts

query Parameters
accounts
Array of strings
Example: accounts=goofy@example.com&accounts=donald@example.com

Check if these accounts are blocked

hosts
Array of strings
Example: hosts=example.com

Check if these hosts are blocked

Responses

Response samples

Content type
application/json
{
  • "accounts": {
    },
  • "hosts": {
    }
}

List accounts blocked by my account

Get the list of accounts that the authenticated user has blocked

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

search
string

Search query string

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Block an account by my account

Add an account to the authenticated user's blocklist

Authorizations:
OAuth2
Request Body schema: application/json
required
accountName
required
string

Account name to block (format: name@host)

Responses

Request samples

Content type
application/json
{
  • "accountName": "user@example.com"
}

Unblock an account by my account

Remove an account from the authenticated user's blocklist

Authorizations:
OAuth2
path Parameters
accountName
required
string
Example: user@example.com

Account name to unblock (format: name@host)

Responses

List servers blocked by my account

Get the list of servers that the authenticated user has blocked

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

search
string

Search query string

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Block a server by my account

Add a server to the authenticated user's blocklist

Authorizations:
OAuth2
Request Body schema: application/json
required
host
required
string

Server host to block

Responses

Request samples

Content type
application/json
{
  • "host": "example.com"
}

Unblock a server by my account

Remove a server from the authenticated user's blocklist

Authorizations:
OAuth2
path Parameters
host
required
string
Example: example.com

Server host to unblock

Responses

Server Blocklist

Get block status of accounts/hosts

query Parameters
accounts
Array of strings
Example: accounts=goofy@example.com&accounts=donald@example.com

Check if these accounts are blocked

hosts
Array of strings
Example: hosts=example.com

Check if these hosts are blocked

Responses

Response samples

Content type
application/json
{
  • "accounts": {
    },
  • "hosts": {
    }
}

List blocked accounts by server

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

subscriptionName
string

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Block an account by server

Authorizations:
OAuth2
Request Body schema: application/json
accountName
required
string

account to block, in the form username@domain

Responses

Request samples

Content type
application/json
{
  • "accountName": "chocobozzz@example.org"
}

Unblock an account by server

Authorizations:
OAuth2
path Parameters
accountName
required
string

account to unblock, in the form username@domain

Responses

List blocked servers by server

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

subscriptionName
string

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Block a server by server

Authorizations:
OAuth2
Request Body schema: application/json
host
required
string <hostname>

server domain to block

Responses

Request samples

Content type
application/json
{
  • "host": "example.com"
}

Unblock a server by server

Authorizations:
OAuth2
path Parameters
host
required
string <hostname>

server domain to unblock

Responses

List server blocklist subscriptions

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

search
string

Plain text search, applied to various parts of the model depending on endpoint

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Add a server blocklist subscription

Authorizations:
OAuth2
Request Body schema: application/json
url
required
string <url>

Responses

Request samples

Content type
application/json
{
  • "url": "string"
}

Response samples

Content type
application/json
{
  • "id": 42,
  • "name": "string",
  • "url": "string",
  • "mutedAccountsCount": 0,
  • "mutedServersCount": 0,
  • "lastSyncAt": "2019-08-24T14:15:22Z",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z"
}

Delete a server blocklist subscription

Authorizations:
OAuth2
path Parameters
id
required
integer

Responses

List publicly shared server blocklist log entries

query Parameters
startDate
required
string <date-time>

Responses

Response samples

Content type
application/json
{
  • "name": "string",
  • "actions": [
    ]
}

Automatic Tags

Automatic tags set on objects (like comments or videos) by specific rules (external link, watched words, etc.)

Get account auto tag policies on comments

PeerTube >= 6.2

Authorizations:
OAuth2
path Parameters
accountName
required
string

account name to get auto tag policies

Responses

Response samples

Content type
application/json
{
  • "review": [
    ]
}

Update account auto tag policies on comments

PeerTube >= 6.2

Authorizations:
OAuth2
path Parameters
accountName
required
string

account name to update auto tag policies

Request Body schema: application/json
review
Array of strings

Auto tags that automatically set the comment in review state

Responses

Request samples

Content type
application/json
{
  • "review": [
    ]
}

Get account available auto tags

PeerTube >= 6.2

Authorizations:
OAuth2
path Parameters
accountName
required
string

account name to get auto tag policies

Responses

Response samples

Content type
application/json
{
  • "available": [
    ]
}

Get server available auto tags

PeerTube >= 6.2

Authorizations:
OAuth2

Responses

Response samples

Content type
application/json
{
  • "available": [
    ]
}

Get server auto tag policies for videos

PeerTube >= 8.3

Authorizations:
OAuth2

Responses

Response samples

Content type
application/json
{
  • "autoBlock": [
    ]
}

Update server auto tag policies for videos

PeerTube >= 8.3

Authorizations:
OAuth2
Request Body schema: application/json
autoBlock
Array of strings

Auto tags that will automatically block videos matching these tags

Responses

Request samples

Content type
application/json
{
  • "autoBlock": [
    ]
}

Watched Words

Manage list of watched words to detect patterns on objects (like comments of videos)

List account watched words

PeerTube >= 6.2

Authorizations:
OAuth2
path Parameters
accountName
required
string

account name to list watched words

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Add account watched words

PeerTube >= 6.2

Authorizations:
OAuth2
path Parameters
accountName
required
string
Request Body schema: application/json
listName
string
words
Array of strings

Responses

Request samples

Content type
application/json
{
  • "listName": "string",
  • "words": [
    ]
}

Response samples

Content type
application/json
{
  • "watchedWordsList": {
    }
}

Update account watched words

PeerTube >= 6.2

Authorizations:
OAuth2
path Parameters
accountName
required
string
listId
required
string

list of watched words to update

Request Body schema: application/json
listName
string
words
Array of strings

Responses

Request samples

Content type
application/json
{
  • "listName": "string",
  • "words": [
    ]
}

Delete account watched words

PeerTube >= 6.2

Authorizations:
OAuth2
path Parameters
accountName
required
string
listId
required
string

list of watched words to delete

Responses

List server watched words

PeerTube >= 6.2

Authorizations:
OAuth2

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Add server watched words

PeerTube >= 6.2

Authorizations:
OAuth2
Request Body schema: application/json
listName
string
words
Array of strings

Responses

Request samples

Content type
application/json
{
  • "listName": "string",
  • "words": [
    ]
}

Response samples

Content type
application/json
{
  • "watchedWordsList": {
    }
}

Update server watched words

PeerTube >= 6.2

Authorizations:
OAuth2
path Parameters
listId
required
string

list of watched words to update

Request Body schema: application/json
listName
string
words
Array of strings

Responses

Request samples

Content type
application/json
{
  • "listName": "string",
  • "words": [
    ]
}

Delete server watched words

PeerTube >= 6.2

Authorizations:
OAuth2
path Parameters
listId
required
string

list of watched words to delete

Responses

List account watched words subscriptions

Authorizations:
OAuth2
path Parameters
accountName
required
string

account name to list watched words subscriptions

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

search
string

Plain text search, applied to various parts of the model depending on endpoint

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Add account watched words subscription

Authorizations:
OAuth2
path Parameters
accountName
required
string
Request Body schema: application/json
url
required
string <url>

Responses

Request samples

Content type
application/json
{
  • "url": "string"
}

Response samples

Content type
application/json
{
  • "id": 42,
  • "name": "string",
  • "url": "string",
  • "importedWordsCount": 0,
  • "lastSyncAt": "2021-05-04T08:01:01.502Z",
  • "state": {
    },
  • "updatedAt": "2021-05-04T08:01:01.502Z",
  • "createdAt": "2021-05-04T08:01:01.502Z"
}

Delete account watched words subscription

Authorizations:
OAuth2
path Parameters
accountName
required
string
id
required
integer

Responses

List server watched words subscriptions

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

search
string

Plain text search, applied to various parts of the model depending on endpoint

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Add server watched words subscription

Authorizations:
OAuth2
Request Body schema: application/json
url
required
string <url>

Responses

Request samples

Content type
application/json
{
  • "url": "string"
}

Response samples

Content type
application/json
{
  • "id": 42,
  • "name": "string",
  • "url": "string",
  • "importedWordsCount": 0,
  • "lastSyncAt": "2021-05-04T08:01:01.502Z",
  • "state": {
    },
  • "updatedAt": "2021-05-04T08:01:01.502Z",
  • "createdAt": "2021-05-04T08:01:01.502Z"
}

Delete server watched words subscription

Authorizations:
OAuth2
path Parameters
id
required
integer

Responses

Config

Each server exposes public information regarding supported videos and options.

Get instance public configuration

Responses

Response samples

Content type
application/json
{
  • "client": {
    },
  • "defaults": {
    },
  • "webadmin": {
    },
  • "instance": {},
  • "search": {
    },
  • "plugin": {
    },
  • "theme": {
    },
  • "email": {
    },
  • "contactForm": {
    },
  • "serverVersion": "8.3.2-nightly-2026-11-06",
  • "serverCommit": "",
  • "transcoding": {
    },
  • "live": {
    },
  • "videoStudio": {
    },
  • "videoFile": {
    },
  • "videoTranscription": {
    },
  • "import": {
    },
  • "export": {
    },
  • "autoBlacklist": {
    },
  • "avatar": {
    },
  • "banner": {
    },
  • "logo": {
    },
  • "video": {
    },
  • "videoCaption": {
    },
  • "user": {
    },
  • "videoChannels": {
    },
  • "trending": {
    },
  • "tracker": {
    },
  • "followings": {},
  • "blocklist": {
    },
  • "federation": {
    },
  • "broadcastMessage": {
    },
  • "homepage": {
    },
  • "openTelemetry": {
    },
  • "views": {
    },
  • "storyboards": {
    },
  • "webrtc": {
    },
  • "nsfwFlagsSettings": {
    },
  • "fieldsConstraints": {
    },
  • "signup": {
    }
}

Get instance "About" information

Translatable information is returned in the language of the request, using the x-peertube-language header or the Accept-Language header. If the instance has no translation for this language, the default information is returned.

header Parameters
x-peertube-language
string

Locale of the web interface (fr-FR, pt-BR...) used to translate the instance information

Responses

Response samples

Content type
application/json
{}

Get instance runtime configuration

Authorizations:
OAuth2

Responses

Response samples

Content type
application/json
{
  • "instance": {
    },
  • "theme": {
    },
  • "services": {
    },
  • "cache": {
    },
  • "signup": {
    },
  • "admin": {
    },
  • "contactForm": {
    },
  • "user": {
    },
  • "transcoding": {
    },
  • "import": {
    },
  • "autoBlacklist": {
    },
  • "blocklist": {
    },
  • "followers": {
    },
  • "storyboard": {
    },
  • "defaults": {
    }
}

Set instance runtime configuration

Changing instance.customizations.javascript or instance.customizations.css requires a password confirmation: set currentPassword at the root of the request body.

Authorizations:
OAuth2

Responses

Delete instance runtime configuration

Authorizations:
OAuth2

Responses

Update instance banner

Authorizations:
OAuth2
Request Body schema: multipart/form-data
bannerfile
string <binary>

The file to upload.

Responses

Delete instance banner

Authorizations:
OAuth2

Responses

Update instance avatar

Authorizations:
OAuth2
Request Body schema: multipart/form-data
avatarfile
string <binary>

The file to upload.

Responses

Delete instance avatar

Authorizations:
OAuth2

Responses

Update instance logo

Authorizations:
OAuth2
path Parameters
logoType
required
string
Enum: "favicon" "header-wide" "header-square" "opengraph"
Request Body schema: multipart/form-data
logofile
string <binary>

The file to upload.

Responses

Delete instance logo

Authorizations:
OAuth2
path Parameters
logoType
required
string
Enum: "favicon" "header-wide" "header-square" "opengraph"

Responses

Client Config

Configuration of the web client.

Update client language Deprecated

Set a cookie so that the next time the client refreshes the HTML of the web interface, PeerTube uses the selected language.

Request Body schema: application/json
required
language
required
string or null

Language code to set

Responses

Request samples

Content type
application/json
{
  • "language": "en-US"
}

Update client language

Set a cookie so that the next time the client refreshes the HTML of the web interface, PeerTube uses the selected language.

Request Body schema: application/json
required
language
required
string or null

Language code to set, or null to clear the preference

Responses

Request samples

Content type
application/json
{
  • "language": "en-US"
}

Homepage

Get and update the custom homepage

Get instance custom homepage

Responses

Response samples

Content type
application/json
{
  • "content": "string"
}

Set instance custom homepage

Authorizations:
OAuth2
Request Body schema: application/json
content
string

content of the homepage, that will be injected in the client

Responses

Request samples

Content type
application/json
{
  • "content": "string"
}

Instance Follows

Managing servers which the instance interacts with is crucial to the concept of federation in PeerTube and external video indexation. The PeerTube server then deals with inter-server ActivityPub operations and propagates information across its social graph by posting activities to actors' inbox endpoints.

https://docs.joinpeertube.org/admin/following-instances#instances-follows

List instances following the server

query Parameters
actorType
string
Enum: "Person" "Application" "Group" "Service" "Organization"
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

state
string
Enum: "pending" "accepted"

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Remove or reject a follower to your server

Authorizations:
OAuth2
path Parameters
handle
required
string <email>

The remote actor handle to remove from your followers

Responses

Reject a pending follower to your server

Authorizations:
OAuth2
path Parameters
handle
required
string <email>

The remote actor handle to remove from your followers

Responses

Accept a pending follower to your server

Authorizations:
OAuth2
path Parameters
handle
required
string <email>

The remote actor handle to remove from your followers

Responses

List instances followed by the server

query Parameters
actorType
string
Enum: "Person" "Application" "Group" "Service" "Organization"
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

state
string
Enum: "pending" "accepted"

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Follow a list of actors (PeerTube instance, channel or account)

Authorizations:
OAuth2
Request Body schema: application/json
handles
Array of strings unique
hosts
Array of strings <hostname> unique [ items <hostname > ]

Responses

Request samples

Content type
application/json
{
  • "hosts": [
    ],
  • "handles": [
    ]
}

Unfollow an actor (PeerTube instance, channel or account)

Authorizations:
OAuth2
path Parameters
hostOrHandle
required
string

The hostOrHandle to unfollow

Responses

Instance Redundancy

Redundancy is part of the inter-server solidarity that PeerTube fosters. Manage the list of instances you wish to help by seeding their videos according to the policy of video selection of your choice. Note that you have a similar functionality to mirror individual videos, see video mirroring.

https://docs.joinpeertube.org/admin/following-instances#instances-redundancy

Update a server redundancy policy

Authorizations:
OAuth2
path Parameters
host
required
string <hostname>

server domain to mirror

Request Body schema: application/json
redundancyAllowed
required
boolean

allow mirroring of the host's local videos

Responses

Request samples

Content type
application/json
{
  • "redundancyAllowed": true
}

Plugins

Managing plugins installed from a local path or from NPM, or search for new ones.

https://docs.joinpeertube.org/api/plugins

List plugins

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

pluginType
integer
sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

uninstalled
boolean

Responses

Response samples

Content type
application/json
{}

List available plugins

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

currentPeerTubeEngine
string
pluginType
integer
search
string
sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{}

Install a plugin

Authorizations:
OAuth2
Request Body schema: application/json
One of
npmName
required
string
currentPassword
string <password> (currentPassword)

Password of the authenticated user, required if password confirmation is enabled

Responses

Request samples

Content type
application/json
{
  • "path": "string",
  • "currentPassword": "pa$$word"
}

Update a plugin

Authorizations:
OAuth2
Request Body schema: application/json
One of
npmName
required
string
currentPassword
string <password> (currentPassword)

Password of the authenticated user, required if password confirmation is enabled

Responses

Request samples

Content type
application/json
{
  • "path": "string",
  • "currentPassword": "pa$$word"
}

Uninstall a plugin

Authorizations:
OAuth2
Request Body schema: application/json
npmName
required
string

name of the plugin/theme in its package.json

Responses

Request samples

Content type
application/json
{
  • "npmName": "peertube-plugin-auth-ldap"
}

Get a plugin

Authorizations:
OAuth2
path Parameters
npmName
required
string
Example: peertube-plugin-auth-ldap

name of the plugin/theme on npmjs.com or in its package.json

Responses

Response samples

Content type
application/json
{}

Set a plugin's settings

Authorizations:
OAuth2
path Parameters
npmName
required
string
Example: peertube-plugin-auth-ldap

name of the plugin/theme on npmjs.com or in its package.json

Request Body schema: application/json
object

Responses

Request samples

Content type
application/json
{
  • "settings": { }
}

Get a plugin's public settings

path Parameters
npmName
required
string
Example: peertube-plugin-auth-ldap

name of the plugin/theme on npmjs.com or in its package.json

Responses

Response samples

Content type
application/json
{ }

Get a plugin's registered settings

Authorizations:
OAuth2
path Parameters
npmName
required
string
Example: peertube-plugin-auth-ldap

name of the plugin/theme on npmjs.com or in its package.json

Responses

Response samples

Content type
application/json
{ }

Stats

Statistics

Get instance stats

Get instance public statistics. This endpoint is cached.

Responses

Response samples

Content type
application/json
{
  • "totalUsers": 0,
  • "totalDailyActiveUsers": 0,
  • "totalWeeklyActiveUsers": 0,
  • "totalMonthlyActiveUsers": 0,
  • "totalModerators": 0,
  • "totalAdmins": 0,
  • "totalLocalVideos": 0,
  • "totalLocalVideoViews": 0,
  • "totalLocalVideoDownloads": 0,
  • "totalLocalVideoComments": 0,
  • "totalLocalVideoFilesSize": 0,
  • "totalVideos": 0,
  • "totalVideoComments": 0,
  • "totalLocalVideoChannels": 0,
  • "totalLocalDailyActiveVideoChannels": 0,
  • "totalLocalWeeklyActiveVideoChannels": 0,
  • "totalLocalMonthlyActiveVideoChannels": 0,
  • "totalLocalPlaylists": 0,
  • "totalInstanceFollowers": 0,
  • "totalInstanceFollowing": 0,
  • "videosRedundancy": [
    ],
  • "totalActivityPubMessagesProcessed": 0,
  • "totalActivityPubMessagesSuccesses": 0,
  • "totalActivityPubMessagesErrors": 0,
  • "activityPubMessagesProcessedPerSecond": 0,
  • "totalActivityPubMessagesWaiting": 0,
  • "averageRegistrationRequestResponseTimeMs": 0,
  • "totalRegistrationRequestsProcessed": 0,
  • "totalRegistrationRequests": 0,
  • "averageAbuseResponseTimeMs": 0,
  • "totalAbusesProcessed": 0,
  • "totalAbuses": 0
}

Create playback metrics

These metrics are exposed by OpenTelemetry metrics exporter if enabled.

Request Body schema: application/json
downloadedBytesHTTP
required
number

How many bytes were downloaded with HTTP since the last metric creation

downloadedBytesP2P
required
number

How many bytes were downloaded with P2P since the last metric creation

errors
required
number

How many errors occurred since the last metric creation

p2pEnabled
required
boolean
playerMode
required
string
Enum: "p2p-media-loader" "web-video"
resolutionChanges
required
number

How many resolution changes occurred since the last metric creation

uploadedBytesP2P
required
number

How many bytes were uploaded with P2P since the last metric creation

required
id (integer) or UUIDv4 (string) or shortUUID (string)
bufferStalled
number

How many times buffer has been stalled since the last metric creation

fps
number

Current player video fps

p2pPeers
number

P2P peers connected (doesn't include WebSeed peers)

resolution
number

Current player video resolution

Responses

Request samples

Content type
application/json
{
  • "playerMode": "p2p-media-loader",
  • "resolution": 0,
  • "fps": 0,
  • "p2pEnabled": true,
  • "p2pPeers": 0,
  • "resolutionChanges": 0,
  • "bufferStalled": 0,
  • "errors": 0,
  • "downloadedBytesP2P": 0,
  • "downloadedBytesHTTP": 0,
  • "uploadedBytesP2P": 0,
  • "videoId": 42
}

Logs

Operations dealing with client, server and audit logs.

Send client log

Request Body schema: application/json
level
required
any
Enum: "error" "warn"
message
required
string
url
required
string

URL of the current user page

meta
string

Additional information regarding this log

stackTrace
string

Stack trace of the error if there is one

userAgent
string

User agent of the web browser that sends the message

Responses

Request samples

Content type
application/json
{
  • "message": "string",
  • "url": "string",
  • "level": "error",
  • "stackTrace": "string",
  • "userAgent": "string",
  • "meta": "string"
}

Get instance logs

Authorizations:
OAuth2

Responses

Response samples

Content type
application/json
[
  • "string"
]

Get instance audit logs

User, administration and moderation actions recorded by all the PeerTube processes of the instance.

By default (format=array), returns an array of at most the 10,000 most recent entries of the requested date range, oldest first. startDate is then required and pagination parameters are ignored.

With format=list, returns a paginated list.

Authorizations:
OAuth2
query Parameters
action
string (AuditLogAction)
Enum: "create" "update" "delete"
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

endDate
string <date-time>
entityId
integer
entityType
string (AuditLogEntityType)
Enum: "video" "video-import" "video-live" "video-source" "video-file" "video-caption" "video-chapters" "video-password" "video-embed-privacy" "video-transcoding" "video-transcription" "video-studio-edition" "video-player-settings" "ownership-change" "comment" "channel" "channel-sync" "channel-videos-import" "channel-collaborator" "channel-player-settings" "channel-playlists-order" "playlist" "playlist-element" "playlist-elements-order" "user" "registration" "password-reset" "token-session" "failed-login" "scoped-token" "user-export" "user-import" "abuse" "abuse-message" "video-block" "account-block" "server-block" "blocklist-subscription" "watched-words-list" "watched-words-subscription" "automatic-tag-policy" "config" "instance-image" "instance-homepage" "instance-host" "plugin" "follow" "server-redundancy" "video-redundancy" "job-queue" "job" "runner" "runner-registration-token" "debug-command" "storage-prune"
format
string
Default: "array"
Enum: "array" "list"
search
string

Search in usernames, IP addresses and audited entities

sort
string
Enum: "-createdAt" "createdAt"
start
integer >= 0

Offset used to paginate results

startDate
string <date-time>

Required with the default array format

Responses

Response samples

Content type
application/json
Example
[ ]

Job

Jobs are long-running tasks enqueued and processed by the instance itself. No additional worker registration is currently available.

Pause job queue

Authorizations:
OAuth2
Request Body schema: application/json
processRoles
Array of strings non-empty
Items Enum: "primary" "secondary"

Roles of the PeerTube processes that must pause their job queue. Defaults to all the roles. Other processes are notified asynchronously.

Responses

Request samples

Content type
application/json
{
  • "processRoles": [
    ]
}

Resume job queue

Authorizations:
OAuth2
Request Body schema: application/json
processRoles
Array of strings non-empty
Items Enum: "primary" "secondary"

Roles of the PeerTube processes that must resume their job queue. Defaults to all the roles. Other processes are notified asynchronously.

Responses

Request samples

Content type
application/json
{
  • "processRoles": [
    ]
}

List instance jobs

Authorizations:
OAuth2
path Parameters
state
required
string
Enum: "" "active" "completed" "failed" "waiting" "delayed"

The state of the job ('' for for no filter)

query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

jobType
string (JobType)
Enum: "activitypub-cleaner" "activitypub-follow" "activitypub-http-broadcast" "activitypub-http-broadcast-parallel" "activitypub-http-fetcher" "activitypub-http-unicast" "activitypub-refresher" "actor-keys" "after-video-channel-import" "build-automatic-tags" "build-object-automatic-tags" "create-user-export" "email" "federate-video" "generate-video-storyboard" "import-user-archive" "manage-video-torrent" "move-to-file-system" "move-to-object-storage" "notify" "transcoding-job-builder" "video-channel-import" "video-file-import" "video-files-lifecycle" "video-import" "video-live-ending" "video-redundancy" "video-studio-edition" "video-transcoding" "video-transcription" "videos-stats"

job type

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Cancel a job

Abort a running job and its underlying ffmpeg/child process. Only active jobs that support cancellation can be cancelled.

Authorizations:
OAuth2
path Parameters
jobId
required
string

The id of the job to cancel

jobType
required
string (JobType)
Enum: "activitypub-cleaner" "activitypub-follow" "activitypub-http-broadcast" "activitypub-http-broadcast-parallel" "activitypub-http-fetcher" "activitypub-http-unicast" "activitypub-refresher" "actor-keys" "after-video-channel-import" "build-automatic-tags" "build-object-automatic-tags" "create-user-export" "email" "federate-video" "generate-video-storyboard" "import-user-archive" "manage-video-torrent" "move-to-file-system" "move-to-object-storage" "notify" "transcoding-job-builder" "video-channel-import" "video-file-import" "video-files-lifecycle" "video-import" "video-live-ending" "video-redundancy" "video-studio-edition" "video-transcoding" "video-transcription" "videos-stats"

The type of the job to cancel

Responses

Runner Registration Token

Manage runner registration tokens.

Generate registration token

Generate a new runner registration token

Authorizations:
OAuth2

Responses

Remove registration token

Remove a registration token. Runners that used this token for their registration are automatically removed.

Authorizations:
OAuth2
path Parameters
registrationTokenId
required
integer

Responses

List registration tokens

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Value: "createdAt"

Sort registration tokens by criteria

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Runner Jobs

Manage runner jobs and runner-side job execution.

Request a new job

API used by PeerTube runners

Request Body schema: application/json
runnerToken
required
string
jobTypes
Array of strings

Filter jobs depending on their types

Responses

Request samples

Content type
application/json
{
  • "runnerToken": "string",
  • "jobTypes": [
    ]
}

Response samples

Content type
application/json
{
  • "availableJobs": [
    ]
}

Accept job

API used by PeerTube runners

path Parameters
jobUUID
required
string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...
Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d
Request Body schema: application/json
runnerToken
required
string

Responses

Request samples

Content type
application/json
{
  • "runnerToken": "string"
}

Response samples

Content type
application/json
{
  • "job": {
    }
}

Abort job

API used by PeerTube runners

path Parameters
jobUUID
required
string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...
Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d
Request Body schema: application/json
jobToken
required
string
reason
required
string

Why the runner aborts this job

runnerToken
required
string

Responses

Request samples

Content type
application/json
{
  • "runnerToken": "string",
  • "jobToken": "string",
  • "reason": "string"
}

Update job

API used by PeerTube runners

path Parameters
jobUUID
required
string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...
Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d
Request Body schema: application/json
jobToken
required
string
runnerToken
required
string
object
progress
integer

Update job progression percentage (optional)

Responses

Request samples

Content type
application/json
{
  • "runnerToken": "string",
  • "jobToken": "string",
  • "progress": 0,
  • "payload": {
    }
}

Post job error

API used by PeerTube runners

path Parameters
jobUUID
required
string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...
Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d
Request Body schema: application/json
jobToken
required
string
message
required
string

Why the runner failed to process this job

runnerToken
required
string

Responses

Request samples

Content type
application/json
{
  • "runnerToken": "string",
  • "jobToken": "string",
  • "message": "string"
}

Post job success

API used by PeerTube runners

path Parameters
jobUUID
required
string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...
Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d
Request Body schema: application/json
jobToken
required
string
required
VOD web video transcoding (object) or VOD HLS transcoding (object) or VOD audio merge transcoding (object) or Live RTMP to HLS transcoding (object)
runnerToken
required
string

Responses

Request samples

Content type
application/json
{
  • "runnerToken": "string",
  • "jobToken": "string",
  • "payload": {
    }
}

Download the max-quality audio file for a job video

API used by PeerTube runners.

path Parameters
jobUUID
required
string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...
Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d
required
id (integer) or UUIDv4 (string) or shortUUID (string)

Video id or UUID

Request Body schema: application/json
required
jobToken
required
string
runnerToken
required
string

Responses

Request samples

Content type
application/json
{
  • "runnerToken": "string",
  • "jobToken": "string"
}

Download the max-quality video file for a job video

API used by PeerTube runners.

path Parameters
jobUUID
required
string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...
Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d
required
id (integer) or UUIDv4 (string) or shortUUID (string)

Video id or UUID

Request Body schema: application/json
required
jobToken
required
string
runnerToken
required
string

Responses

Request samples

Content type
application/json
{
  • "runnerToken": "string",
  • "jobToken": "string"
}

Download the max-quality thumbnail for a job video

API used by PeerTube runners.

path Parameters
jobUUID
required
string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...
Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d
required
id (integer) or UUIDv4 (string) or shortUUID (string)

Video id or UUID

Request Body schema: application/json
required
jobToken
required
string
runnerToken
required
string

Responses

Request samples

Content type
application/json
{
  • "runnerToken": "string",
  • "jobToken": "string"
}

Download the max-quality preview for a job video

API used by PeerTube runners.

path Parameters
jobUUID
required
string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...
Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d
required
id (integer) or UUIDv4 (string) or shortUUID (string)

Video id or UUID

Request Body schema: application/json
required
jobToken
required
string
runnerToken
required
string

Responses

Request samples

Content type
application/json
{
  • "runnerToken": "string",
  • "jobToken": "string"
}

Download a video studio task file for a job video

API used by PeerTube runners.

path Parameters
filename
required
string

Name of the task file to download

jobUUID
required
string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...
Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d
required
id (integer) or UUIDv4 (string) or shortUUID (string)

Video id or UUID

Request Body schema: application/json
required
jobToken
required
string
runnerToken
required
string

Responses

Request samples

Content type
application/json
{
  • "runnerToken": "string",
  • "jobToken": "string"
}

Cancel a job

Authorizations:
OAuth2
path Parameters
jobUUID
required
string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...
Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d

Responses

Delete a job

The endpoint will first cancel the job if needed, and then remove it from the database. Children jobs will also be removed

Authorizations:
OAuth2
path Parameters
jobUUID
required
string <uuid> (UUIDv4) = 36 characters ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]...
Example: 9c9de5e8-0a1e-484a-b099-e80766180a6d

Responses

List jobs

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

search
string

Plain text search, applied to various parts of the model depending on endpoint

sort
string
Enum: "updatedAt" "createdAt" "priority" "state" "progress"

Sort runner jobs by criteria

start
integer >= 0

Offset used to paginate results

stateOneOf
Array of integers (RunnerJobState)
Items Enum: 1 2 3 4 5 6 7 8
typeOneOf
Array of strings (RunnerJobType)
Items Enum: "vod-web-video-transcoding" "vod-hls-transcoding" "vod-audio-merge-transcoding" "live-rtmp-hls-transcoding"

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}

Runners

Register, list and remove remote runners.

Register a new runner

API used by PeerTube runners

Request Body schema: application/json
name
required
string
registrationToken
required
string
description
string

Responses

Request samples

Content type
application/json
{
  • "registrationToken": "string",
  • "name": "string",
  • "description": "string"
}

Response samples

Content type
application/json
{
  • "id": 0,
  • "runnerToken": "string"
}

Unregister a runner

API used by PeerTube runners

Request Body schema: application/json
runnerToken
required
string

Responses

Request samples

Content type
application/json
{
  • "runnerToken": "string"
}

Delete a runner

Authorizations:
OAuth2
path Parameters
runnerId
required
integer
Request Body schema: application/json
runnerToken
required
string

Responses

Request samples

Content type
application/json
{
  • "runnerToken": "string"
}

List runners

Authorizations:
OAuth2
query Parameters
count
integer [ 1 .. 100 ]
Default: 15

Number of items to return

sort
string
Value: "createdAt"

Sort runners by criteria

start
integer >= 0

Offset used to paginate results

Responses

Response samples

Content type
application/json
{
  • "total": 1,
  • "data": [
    ]
}