PeerTube (7.1.0)

Download OpenAPI specification:

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.

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

Each parameter is evaluated on its own against a set of rules before the route validator proceeds with potential testing involving parameter combinations. Errors coming from validation errors appear earlier and benefit from a more detailed error description:

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', and invalid-params.<field>.value reports the value that didn't pass validation whose invalid-params.<field>.msg is about.

Deprecated error fields

Some fields could be included with previous versions. They are still included but their use is deprecated:

  • error: superseded by detail

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

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
videoId
required
integer >= 1
Example: 42

The video id

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

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>Thu, 23 Oct 2025 03:03:38 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/177f70c4-ddef-4bb6-bc96-b00d5e2a0e05.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[On ne naît pas mort, on le devient (MFMR ep. 10) - L'amant d'Ragore]]></title>
            <link>https://peertube2.cpy.re/w/mAhJGNFUZbCwUAbLk3bc1s;threadId=166300</link>
            <guid>https://peertube2.cpy.re/w/mAhJGNFUZbCwUAbLk3bc1s;threadId=166300</guid>
            <pubDate>Wed, 22 Oct 2025 23:06:18 GMT</pubDate>
            <content:encoded><![CDATA[<p>@funkypou Salut camarade !! En fait, les yes men l'ont déjà conceptualisé et mis en expérimentation... Enfin, presque... !! C'est aussi avec de la matière organique d'origine humaine.<br />
<a href="https://fr.wikipedia.org/wiki/The_Yes_Men" target="_blank" rel="noopener noreferrer">https://fr.wikipedia.org/wiki/The_Yes_Men</a><br />
Des films trouvables sur le net, mais faut chercher. Laisser l'article the pour tenter de limiter les réponses "yes man" qui ne correspondent pas à ce qu'ils ont fait.</p>
]]></content:encoded>
            <dc:creator>L'amant d'Ragore</dc:creator>
        </item>
        <item>
            <title><![CDATA[Comment gagner la bataille culturelle - Gruik]]></title>
            <link>https://peertube2.cpy.re/w/tAgJ2VZeNQT6PfB64qa6ro;threadId=182255</link>
            <guid>https://peertube2.cpy.re/w/tAgJ2VZeNQT6PfB64qa6ro;threadId=182255</guid>
            <pubDate>Wed, 22 Oct 2025 19:41:10 GMT</pubDate>
            <content:encoded><![CDATA[<p><span><a href="https://video.blast-info.fr/accounts/blast" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>blast</span></a></span> tout a fait d'accord avec la madame</p>]]></content:encoded>
            <dc:creator>Gruik</dc:creator>
        </item>
        <item>
            <title><![CDATA[L'IA ne va pas nous remplacer : elle va nous exploiter - Quentin]]></title>
            <link>https://peertube2.cpy.re/w/iWq6ze3hEw3AUmbsV5so86;threadId=182254</link>
            <guid>https://peertube2.cpy.re/w/iWq6ze3hEw3AUmbsV5so86;threadId=182254</guid>
            <pubDate>Wed, 22 Oct 2025 19:06:17 GMT</pubDate>
            <content:encoded><![CDATA[<p><span><a href="https://video.blast-info.fr/accounts/blast" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>blast</span></a></span> merci pour la mise en perspective historique 👏</p>]]></content:encoded>
            <dc:creator>Quentin</dc:creator>
        </item>
        <item>
            <title><![CDATA[L'IA ne va pas nous remplacer : elle va nous exploiter - 𝕂oneko]]></title>
            <link>https://peertube2.cpy.re/w/iWq6ze3hEw3AUmbsV5so86;threadId=182253</link>
            <guid>https://peertube2.cpy.re/w/iWq6ze3hEw3AUmbsV5so86;threadId=182253</guid>
            <pubDate>Wed, 22 Oct 2025 17:44:17 GMT</pubDate>
            <content:encoded><![CDATA[<p><span><a href="https://video.blast-info.fr/accounts/blast" class="u-url mention" rel="noopener noreferrer" target="_blank">@<span>blast</span></a></span> RIP Denis Robert 🙏</p>]]></content:encoded>
            <dc:creator>𝕂oneko</dc:creator>
        </item>
        <item>
            <title><![CDATA[Et oui, un portable de 2014 sous Archlinux, c'est possible ! - Yrrusajywo]]></title>
            <link>https://peertube2.cpy.re/w/1iVNX4QEzgQ1fMZNNzk32Y;threadId=182252</link>
            <guid>https://peertube2.cpy.re/w/1iVNX4QEzgQ1fMZNNzk32Y;threadId=182252</guid>
            <pubDate>Wed, 22 Oct 2025 17:35:47 GMT</pubDate>
            <content:encoded><![CDATA[<p><span><a href="https://peertube.pcservice46.fr/accounts/clashoffredo" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>clashoffredo</span></a></span> Celui de ma compagne ASUS PRO5JIJ de 2008 sous Lubuntu. Il s'allume en 7 ou 8 secondes. C'est incroyable de vivacité ce Core2Duo</p>]]></content:encoded>
            <dc:creator>Yrrusajywo</dc:creator>
        </item>
        <item>
            <title><![CDATA[KDE Plasma 6.5 refines every part of the Linux Desktop! - Artem Anufrij]]></title>
            <link>https://peertube2.cpy.re/w/8wq2JpBVmuijNSmZa76AUo;threadId=182250</link>
            <guid>https://peertube2.cpy.re/w/8wq2JpBVmuijNSmZa76AUo;threadId=182250</guid>
            <pubDate>Wed, 22 Oct 2025 15:49:19 GMT</pubDate>
            <content:encoded><![CDATA[<p><span><a href="https://tilvids.com/accounts/thelinuxexperiment" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>thelinuxexperiment</span></a></span> 
Thank you <span><a href="https://floss.social/@kde" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>kde</span></a></span> for the great work! I use <a href="https://social.anufrij.de/tags/Plasma" class="mention hashtag" rel="noopener noreferrer" target="_blank">#<span>Plasma</span></a> every day for work, and I’m very happy with it.</p>]]></content:encoded>
            <dc:creator>Artem Anufrij</dc:creator>
        </item>
        <item>
            <title><![CDATA[Et oui, un portable de 2014 sous Archlinux, c'est possible ! - Ange des ténèbres 🐈]]></title>
            <link>https://peertube2.cpy.re/w/1iVNX4QEzgQ1fMZNNzk32Y;threadId=182249</link>
            <guid>https://peertube2.cpy.re/w/1iVNX4QEzgQ1fMZNNzk32Y;threadId=182249</guid>
            <pubDate>Wed, 22 Oct 2025 15:02:40 GMT</pubDate>
            <content:encoded><![CDATA[<p><span><a href="https://peertube.pcservice46.fr/accounts/clashoffredo" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>clashoffredo</span></a></span> Un PC de 2014 tourne encore très bien sous Linux pour un usage bureautique, web, multimédia de base et quelques vieux jeux.</p><p>Et encore, tu as pris Gnome qui n'est pas le DE le plus léger et tu as encore un HDD. Avec un SSD, il va tourner comme un charme.</p>]]></content:encoded>
            <dc:creator>Ange des ténèbres 🐈</dc:creator>
        </item>
        <item>
            <title><![CDATA[KDE Plasma 6.5 refines every part of the Linux Desktop! - Dariusmiles2123]]></title>
            <link>https://peertube2.cpy.re/w/8wq2JpBVmuijNSmZa76AUo;threadId=182248</link>
            <guid>https://peertube2.cpy.re/w/8wq2JpBVmuijNSmZa76AUo;threadId=182248</guid>
            <pubDate>Wed, 22 Oct 2025 10:27:03 GMT</pubDate>
            <content:encoded><![CDATA[<p>I've always been really tempted by the customability of KDE, but I also love how easy it is to use Gnome with a touchpad and how you just swipe between workspaces. Maybe Cosmic will be my perfect middle ground?</p>
]]></content:encoded>
            <dc:creator>Dariusmiles2123</dc:creator>
        </item>
        <item>
            <title><![CDATA[IA, Philosophie du Libre et Féminisme - Khrys - JdLL2025 - Khrys]]></title>
            <link>https://peertube2.cpy.re/w/cKZQqzVxRfC9suiynb2yKt;threadId=182240</link>
            <guid>https://peertube2.cpy.re/w/cKZQqzVxRfC9suiynb2yKt;threadId=182240</guid>
            <pubDate>Wed, 22 Oct 2025 09:23:11 GMT</pubDate>
            <content:encoded><![CDATA[<p><span><a href="https://mamot.fr/@ligaturerecords" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>ligaturerecords</span></a></span> 🤣 <span><a href="https://videos-libr.es/accounts/orga_jdll" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>orga_jdll</span></a></span></p>]]></content:encoded>
            <dc:creator>Khrys</dc:creator>
        </item>
        <item>
            <title><![CDATA[KDE Plasma 6.5 refines every part of the Linux Desktop! - Basil Disco]]></title>
            <link>https://peertube2.cpy.re/w/8wq2JpBVmuijNSmZa76AUo;threadId=182242</link>
            <guid>https://peertube2.cpy.re/w/8wq2JpBVmuijNSmZa76AUo;threadId=182242</guid>
            <pubDate>Tue, 21 Oct 2025 16:46:52 GMT</pubDate>
            <content:encoded><![CDATA[<p>KDE is how Windows should have evolved tbh.</p>
]]></content:encoded>
            <dc:creator>Basil Disco</dc:creator>
        </item>
        <item>
            <title><![CDATA[KDE Plasma 6.5 refines every part of the Linux Desktop! - shortwavesurfer2009]]></title>
            <link>https://peertube2.cpy.re/w/8wq2JpBVmuijNSmZa76AUo;threadId=182241</link>
            <guid>https://peertube2.cpy.re/w/8wq2JpBVmuijNSmZa76AUo;threadId=182241</guid>
            <pubDate>Tue, 21 Oct 2025 14:16:00 GMT</pubDate>
            <content:encoded><![CDATA[<p><span><a href="https://tilvids.com/accounts/thelinuxexperiment" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>thelinuxexperiment</span></a></span> I was not aware of KDE, even had a screen reader. I knew it had magnification, but I was not at all aware that they had screen reader functionality. I was always under the impression that Gnome was the only possible one.</p>]]></content:encoded>
            <dc:creator>shortwavesurfer2009</dc:creator>
        </item>
        <item>
            <title><![CDATA[IA, Philosophie du Libre et Féminisme - Khrys - JdLL2025 - Ligature]]></title>
            <link>https://peertube2.cpy.re/w/cKZQqzVxRfC9suiynb2yKt;threadId=182240</link>
            <guid>https://peertube2.cpy.re/w/cKZQqzVxRfC9suiynb2yKt;threadId=182240</guid>
            <pubDate>Tue, 21 Oct 2025 12:38:44 GMT</pubDate>
            <content:encoded><![CDATA[<p><span><a href="https://videos-libr.es/accounts/orga_jdll" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>orga_jdll</span></a></span> incroyable kamikaze dans les commentaires de la vidéo qui veut pas se taper une heure de vidéo là dessus mais enchaîne avec 5000 caractères qu'il pense que nous on va se taper ??</p>]]></content:encoded>
            <dc:creator>Ligature</dc:creator>
        </item>
        <item>
            <title><![CDATA[MNT Pocket Reform Assembly and First Impressions - Fedi.Video on PeerTube]]></title>
            <link>https://peertube2.cpy.re/w/nSxvPvLXUrSXjDrcxzA9nP;threadId=182239</link>
            <guid>https://peertube2.cpy.re/w/nSxvPvLXUrSXjDrcxzA9nP;threadId=182239</guid>
            <pubDate>Tue, 21 Oct 2025 11:56:01 GMT</pubDate>
            <content:encoded><![CDATA[<p>Thank you for this, a lot of talk about MNT laptops right now so it's great to see some detailed videos. It does look like such a cute device 😃</p>
]]></content:encoded>
            <dc:creator>Fedi.Video on PeerTube</dc:creator>
        </item>
        <item>
            <title><![CDATA[loose booping - snowdusk]]></title>
            <link>https://peertube2.cpy.re/w/dPUEKLckMtQLtt5ZuCLYjn;threadId=182238</link>
            <guid>https://peertube2.cpy.re/w/dPUEKLckMtQLtt5ZuCLYjn;threadId=182238</guid>
            <pubDate>Tue, 21 Oct 2025 08:53:14 GMT</pubDate>
            <content:encoded><![CDATA[<p>This is so cool!!!</p>
]]></content:encoded>
            <dc:creator>snowdusk</dc:creator>
        </item>
        <item>
            <title><![CDATA[La gauche américaine face au lobby pro-israélien et aux dérives fascistes de Trump - InternetDev-Anti-Communicant🍉]]></title>
            <link>https://peertube2.cpy.re/w/8raFsGCP58jniFkF6FMSSS;threadId=182237</link>
            <guid>https://peertube2.cpy.re/w/8raFsGCP58jniFkF6FMSSS;threadId=182237</guid>
            <pubDate>Tue, 21 Oct 2025 04:34:05 GMT</pubDate>
            <content:encoded><![CDATA[<p><span><a href="https://video.blast-info.fr/accounts/blast" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>blast</span></a></span> 
<a href="https://mastodon.social/tags/CodePink" class="mention hashtag" rel="noopener noreferrer" target="_blank">#<span>CodePink</span></a></p>]]></content:encoded>
            <dc:creator>InternetDev-Anti-Communicant🍉</dc:creator>
        </item>
        <item>
            <title><![CDATA[loose booping - pizzapal]]></title>
            <link>https://peertube2.cpy.re/w/dPUEKLckMtQLtt5ZuCLYjn;threadId=182236</link>
            <guid>https://peertube2.cpy.re/w/dPUEKLckMtQLtt5ZuCLYjn;threadId=182236</guid>
            <pubDate>Tue, 21 Oct 2025 04:15:14 GMT</pubDate>
            <content:encoded><![CDATA[<p>i really wish i had saved that patch program on the micraKoorg bc its a little hard to reproduce that certain je ne sais quoi (is the decay on the filter engulope 10 or 12?)</p>
]]></content:encoded>
            <dc:creator>pizzapal</dc:creator>
        </item>
        <item>
            <title><![CDATA[Windows 10 is done, and this is a bad thing for everyone (not just Windows users) - The Wonkmistress ]]></title>
            <link>https://peertube2.cpy.re/w/ar4jienrr64mjpcbvpKt88;threadId=182235</link>
            <guid>https://peertube2.cpy.re/w/ar4jienrr64mjpcbvpKt88;threadId=182235</guid>
            <pubDate>Mon, 20 Oct 2025 23:42:51 GMT</pubDate>
            <content:encoded><![CDATA[<p>This end of life thing wouldn't be so bad if Microsoft made something like a modern-day Windows Embedded for Legacy Systems just like what they did back  in 2006 when Windows 98 got end of lifed and the entire Windows 9x ecosystem was left unsupported.</p>
]]></content:encoded>
            <dc:creator>The Wonkmistress </dc:creator>
        </item>
        <item>
            <title><![CDATA[Madagascar : face à la Gen z, le président exfiltré par la France - Hélène Collon ⏚]]></title>
            <link>https://peertube2.cpy.re/w/ryKFuUsqnxRo4pEkYVr8sd;threadId=182232</link>
            <guid>https://peertube2.cpy.re/w/ryKFuUsqnxRo4pEkYVr8sd;threadId=182232</guid>
            <pubDate>Mon, 20 Oct 2025 21:58:27 GMT</pubDate>
            <content:encoded><![CDATA[<p><span><a href="https://piaille.fr/@rosalux" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>rosalux</span></a></span> <span><a href="https://video.blast-info.fr/accounts/blast" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>blast</span></a></span> Tant que c’est pas un remake de 47…</p>]]></content:encoded>
            <dc:creator>Hélène Collon ⏚</dc:creator>
        </item>
        <item>
            <title><![CDATA[S12 E26: Gaza Ceasefire & Bari Weiss: 10/12/25: Last Week Tonight with John Oliver - Custom Epoch]]></title>
            <link>https://peertube2.cpy.re/w/fW6HcFwxRXicBRFvzPgZfY;threadId=182233</link>
            <guid>https://peertube2.cpy.re/w/fW6HcFwxRXicBRFvzPgZfY;threadId=182233</guid>
            <pubDate>Mon, 20 Oct 2025 19:19:07 GMT</pubDate>
            <content:encoded><![CDATA[<p>OK that was pretty good</p>
]]></content:encoded>
            <dc:creator>Custom Epoch</dc:creator>
        </item>
        <item>
            <title><![CDATA[Madagascar : face à la Gen z, le président exfiltré par la France - Diane Gastellu]]></title>
            <link>https://peertube2.cpy.re/w/ryKFuUsqnxRo4pEkYVr8sd;threadId=182232</link>
            <guid>https://peertube2.cpy.re/w/ryKFuUsqnxRo4pEkYVr8sd;threadId=182232</guid>
            <pubDate>Mon, 20 Oct 2025 18:54:58 GMT</pubDate>
            <content:encoded><![CDATA[<p><span><a href="https://video.blast-info.fr/accounts/blast" class="u-url mention" target="_blank" rel="noopener noreferrer">@<span>blast</span></a></span> comme un remake de 1973 🙄</p>]]></content:encoded>
            <dc:creator>Diane Gastellu</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>Thu, 23 Oct 2025 03:03:38 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/177f70c4-ddef-4bb6-bc96-b00d5e2a0e05.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[La France ingouvernable ? Ce que le monde pense du chaos politique français]]></title>
            <link>https://peertube2.cpy.re/w/cCoSKEjyYL8VeJ5qSMm2rs</link>
            <guid>https://peertube2.cpy.re/w/cCoSKEjyYL8VeJ5qSMm2rs</guid>
            <pubDate>Wed, 22 Oct 2025 18:00:02 GMT</pubDate>
            <description><![CDATA[Soutenez Blast, nouveau média indépendant : https://www.blast-info.fr/soutenir Crises à répétition, renversements d’alliances et jeu de chaises musicales au sommet de l’État : c’est un véritable feuilleton politique que connait la France depuis...]]></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>Crises à répétition, renversements d’alliances et jeu de chaises musicales au sommet de l’État : c’est un véritable feuilleton politique que connait la France depuis la dissolution de l’Assemblée en juin 2024. Plus d’un an d’instabilité politique qui intrigue et interroge au-delà de nos frontières. Président "monarchique", pays "ingouvernable", "fin d’un modèle" : Blast a recueilli les regards de journalistes européens et américains sur la France d’Emmanuel Macron.</p>
<p>Journaliste : Thibault Izoret<br />
Montage : Céline Cochelin<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>#Macron<br />
#France<br />
#Politique</p>
]]></content:encoded>
            <dc:creator>blast, le souffle de l’info</dc:creator>
            <enclosure length="473676426" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/5e2965f2-550d-409d-9c4c-d66514332b18?videoFileIds=5514273&amp;videoFileIds=5514277"/>
            <media:community>
                <media:statistics views="73"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/cCoSKEjyYL8VeJ5qSMm2rs"/>
            <media:player url="https://peertube2.cpy.re/w/cCoSKEjyYL8VeJ5qSMm2rs"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/317c5dae-06dc-43c9-9570-86ad43dd4577-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/35254fee-d5db-4736-9183-048afbd3f5ae-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/98296406-4b6a-43ad-b7b7-4019af71f810-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/d8b6c47e-3612-4dad-ac2d-898aa3e9854b-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/e17d99ce-3415-454a-8930-859ec6ef5a09-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="448289677" url="https://cdn.octos3.fr/peertube-blast/streaming-playlists/hls/5e2965f2-550d-409d-9c4c-d66514332b18/9aca1e55-c718-4d39-9532-b356003b5253-1080-fragmented.mp4" framerate="25" duration="1567" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="211490061" url="https://cdn.octos3.fr/peertube-blast/streaming-playlists/hls/5e2965f2-550d-409d-9c4c-d66514332b18/b0495c40-da8b-49c2-9ae8-2700e4d229c7-720-fragmented.mp4" framerate="25" duration="1567" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="109601191" url="https://cdn.octos3.fr/peertube-blast/streaming-playlists/hls/5e2965f2-550d-409d-9c4c-d66514332b18/8adf6edc-e81b-447d-9272-058406251424-480-fragmented.mp4" framerate="25" duration="1567" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="36888643" url="https://cdn.octos3.fr/peertube-blast/streaming-playlists/hls/5e2965f2-550d-409d-9c4c-d66514332b18/7cecfea6-a417-483c-b2cd-c69b61c8bce0-240-fragmented.mp4" framerate="25" duration="1567" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="25386749" url="https://cdn.octos3.fr/peertube-blast/streaming-playlists/hls/5e2965f2-550d-409d-9c4c-d66514332b18/41a9d00d-3f50-4ef2-b0ae-861f17daca73-0-fragmented.mp4" framerate="0" duration="1567" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/864d90ed-ae81-45e5-a0c3-29b6c7ae79ab.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/21e43a98-a172-400b-aed9-6357f7760abc.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">La France ingouvernable ? Ce que le monde pense du chaos politique français</media:title>
            <media:description type="plain">Soutenez Blast, nouveau média indépendant : https://www.blast-info.fr/soutenir Crises à répétition, renversements d’alliances et jeu de chaises musicales au sommet de l’État : c’est un véritable feuilleton politique que connait la France depuis...</media:description>
        </item>
        <item>
            <title><![CDATA[L'IA ne va pas nous remplacer : elle va nous exploiter]]></title>
            <link>https://peertube2.cpy.re/w/iWq6ze3hEw3AUmbsV5so86</link>
            <guid>https://peertube2.cpy.re/w/iWq6ze3hEw3AUmbsV5so86</guid>
            <pubDate>Wed, 22 Oct 2025 16:00:02 GMT</pubDate>
            <description><![CDATA[Soutenez Blast, nouveau média indépendant : https://www.blast-info.fr/soutenir Au bureau, dans les entrepôts, sur nos postes de travail : Big Brother a pris le pouvoir dans les entreprises. IA, management algorithmique et logiciels de surveilla...]]></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>Au bureau, dans les entrepôts, sur nos postes de travail : Big Brother a pris le pouvoir dans les entreprises. IA, management algorithmique et logiciels de surveillance, nous travaillons déjà sous leur contrôle. Et si les nouvelles technologies n’allaient pas prendre notre place mais devenir nos nouveaux contremaîtres ?</p>
<p>Auteurs et réalisateurs : Benjamin Patinaud et le Fils de Pub, en collaboration avec Anthony Galluzzo (Le mythe de l’entrepreneur, La fabrique du consommateur)<br />
Illustrations : Tienstiens<br />
Chargée de production et cadre : RED POP - Kathleen Brun<br />
Montage : Le Coin du Bis<br />
Fond 3D : Charly Hopp<br />
Son : Baptiste Veilhan<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>#IA<br />
#Corporate<br />
#technologie</p>
]]></content:encoded>
            <dc:creator>blast, le souffle de l’info</dc:creator>
            <enclosure length="386414856" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/91445edb-a2ab-4304-afa8-c6892f32f8a3?videoFileIds=5514254&amp;videoFileIds=5514258"/>
            <media:community>
                <media:statistics views="467"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/iWq6ze3hEw3AUmbsV5so86"/>
            <media:player url="https://peertube2.cpy.re/w/iWq6ze3hEw3AUmbsV5so86"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/65d582a1-4c0e-4448-a13a-bfdf0dcb478a-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/eee5f070-f564-4c28-91ec-8f0b261fa0fa-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/dcda0c44-1e7d-44c8-9b8e-2b958ad1f912-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/2a780f74-427d-4025-bbc4-bd693d5cb0a4-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/e3132b5c-63d2-4764-8f94-24832da02a04-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="362417735" url="https://cdn.octos3.fr/peertube-blast/streaming-playlists/hls/91445edb-a2ab-4304-afa8-c6892f32f8a3/4834621e-0fc8-4232-9924-fc44c8dddbca-1080-fragmented.mp4" framerate="25" duration="1451" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="183823035" url="https://cdn.octos3.fr/peertube-blast/streaming-playlists/hls/91445edb-a2ab-4304-afa8-c6892f32f8a3/cc1e726c-e356-40d9-80e9-2422d1731e3a-720-fragmented.mp4" framerate="25" duration="1451" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="98511311" url="https://cdn.octos3.fr/peertube-blast/streaming-playlists/hls/91445edb-a2ab-4304-afa8-c6892f32f8a3/a804c72c-627c-415f-a860-ba96cf1fcb43-480-fragmented.mp4" framerate="25" duration="1451" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="35208389" url="https://cdn.octos3.fr/peertube-blast/streaming-playlists/hls/91445edb-a2ab-4304-afa8-c6892f32f8a3/d4ec67fa-e993-43d5-ac9a-6a9d2278c17f-240-fragmented.mp4" framerate="25" duration="1451" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="23997121" url="https://cdn.octos3.fr/peertube-blast/streaming-playlists/hls/91445edb-a2ab-4304-afa8-c6892f32f8a3/64041ea6-dbc0-4c6e-94e9-1537b627980b-0-fragmented.mp4" framerate="0" duration="1451" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/bc3ffbea-8c1d-46c3-a349-622e0fbb6268.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/179ccdd4-9100-461a-8ed6-9e3ddbc406de.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">L'IA ne va pas nous remplacer : elle va nous exploiter</media:title>
            <media:description type="plain">Soutenez Blast, nouveau média indépendant : https://www.blast-info.fr/soutenir Au bureau, dans les entrepôts, sur nos postes de travail : Big Brother a pris le pouvoir dans les entreprises. IA, management algorithmique et logiciels de surveilla...</media:description>
        </item>
        <item>
            <title><![CDATA[Comprendre les Nouveaux Penseurs de l’islam : introduction]]></title>
            <link>https://peertube2.cpy.re/w/m7uqC6NekTwPNk3KeKETSz</link>
            <guid>https://peertube2.cpy.re/w/m7uqC6NekTwPNk3KeKETSz</guid>
            <pubDate>Wed, 22 Oct 2025 14:48:58 GMT</pubDate>
            <description><![CDATA[🎥 Cette vidéo propose un résumé d’introduction au livre Les Nouveaux Penseurs de l’islam de Rachid Benzine, réalisé par l’IA Notebook à partir du texte original. 📚 Ce contenu ne remplace en aucun cas la lecture complète de l’ouvrage, mais vise ...]]></description>
            <content:encoded><![CDATA[<p>🎥 Cette vidéo propose un résumé d’introduction au livre Les Nouveaux Penseurs de l’islam de Rachid Benzine, réalisé par l’IA Notebook à partir du texte original.<br />
📚 Ce contenu ne remplace en aucun cas la lecture complète de l’ouvrage, mais vise à en offrir une synthèse critique accessible.</p>
<p>🔔 Abonnez-vous à la chaîne pour ne rien manquer !<br />
🗨️ Vos réflexions sont les bienvenues — commentez, partagez, débattez !<br />
🔄 Un épisode à partager — chaque clic compte.</p>
<p>📩 Mails : <a target="_blank" rel="noopener noreferrer">jackl0don2.0@gmail.com</a><br />
📡 Flux RSS : <a href="https://feed.ausha.co/mVj4XUMQYpJY" target="_blank" rel="noopener noreferrer">https://feed.ausha.co/mVj4XUMQYpJY</a></p>
<p>📖 Sources : <a href="https://www.chasse-aux-livres.fr/prix/2226178589/les-nouveaux-penseurs-de-l-islam-rachid-benzine?query=les%20nouveaux%20penseur%20de%20l%27islam" target="_blank" rel="noopener noreferrer">https://www.chasse-aux-livres.fr/prix/2226178589/les-nouveaux-penseurs-de-l-islam-rachid-benzine?query=les nouveaux penseur de l'islam</a></p>
<p>🔗 Retrouvez-moi sur les réseaux :</p>
<p>❤️ Soutenir sur Tipeee : <a href="https://urls.fr/9kge68" target="_blank" rel="noopener noreferrer">https://urls.fr/9kge68</a><br />
📸 Suivez-moi sur Insta : <a href="https://urls.fr/RjSnjq" target="_blank" rel="noopener noreferrer">https://urls.fr/RjSnjq</a><br />
💬 Suivez-moi sur Threads : <a href="https://urls.fr/klvXbv" target="_blank" rel="noopener noreferrer">https://urls.fr/klvXbv</a><br />
🌌 Suivez-moi sur Bluesky : <a href="https://urls.fr/HZr95j" target="_blank" rel="noopener noreferrer">https://urls.fr/HZr95j</a><br />
🤝 Suivez moi sur Linkedin : <a href="https://urls.fr/u0z1Tl" target="_blank" rel="noopener noreferrer">https://urls.fr/u0z1Tl</a><br />
🐘 Suivez moi sur Mastodon : <a href="https://urls.fr/qxDi0O" target="_blank" rel="noopener noreferrer">https://urls.fr/qxDi0O</a><br />
📘 Suis-moi aussi sur Facebook : <a href="https://urls.fr/SfFyIM" target="_blank" rel="noopener noreferrer">https://urls.fr/SfFyIM</a></p>
]]></content:encoded>
            <dc:creator>La Biblio de Martin Eden</dc:creator>
            <category>News &amp; Politics</category>
            <enclosure length="18842043" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/a2dec0c8-3bc1-4a1c-a3bd-e93b95465321?videoFileIds=5514242"/>
            <media:community>
                <media:statistics views="3"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/m7uqC6NekTwPNk3KeKETSz"/>
            <media:player url="https://peertube2.cpy.re/w/m7uqC6NekTwPNk3KeKETSz"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/4a42bfc4-056a-47f3-ac7b-703017a14979-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/b70ec759-0873-46cf-9c9d-d1cbf013276e-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/d9b9ad86-0045-4201-93c5-887fc1df0786-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/2e504e89-1cad-482a-9b62-e0cee75a6c1e-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="18842043" url="https://www.yiny.org/static/streaming-playlists/hls/a2dec0c8-3bc1-4a1c-a3bd-e93b95465321/27437ce9-d337-4146-84e5-b936732b50cd-720-fragmented.mp4" framerate="24" duration="330" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="13476756" url="https://www.yiny.org/static/streaming-playlists/hls/a2dec0c8-3bc1-4a1c-a3bd-e93b95465321/c9ed97e4-34ef-4798-983a-7d7427fb051a-480-fragmented.mp4" framerate="24" duration="330" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="8392612" url="https://www.yiny.org/static/streaming-playlists/hls/a2dec0c8-3bc1-4a1c-a3bd-e93b95465321/6a057518-b641-40c4-bc63-dc83d88003ac-240-fragmented.mp4" framerate="24" duration="330" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="5188302" url="https://www.yiny.org/static/streaming-playlists/hls/a2dec0c8-3bc1-4a1c-a3bd-e93b95465321/067ae25c-8c33-4d76-b46c-3f6ea21bfd39-0-fragmented.mp4" framerate="0" duration="330" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/82dbe2ed-41f0-44e3-8fa3-83997e7f6bb6.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/7f73ebeb-ba08-4558-9c62-c104a57905c5.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Comprendre les Nouveaux Penseurs de l’islam : introduction</media:title>
            <media:description type="plain">🎥 Cette vidéo propose un résumé d’introduction au livre Les Nouveaux Penseurs de l’islam de Rachid Benzine, réalisé par l’IA Notebook à partir du texte original. 📚 Ce contenu ne remplace en aucun cas la lecture complète de l’ouvrage, mais vise ...</media:description>
        </item>
        <item>
            <title><![CDATA[Les FACHOS se prennent pour des ÉCOLOS ? Entretien avec Antoine Dubiau (Écofascismes)]]></title>
            <link>https://peertube2.cpy.re/w/roRW6qZGm4v7eAvK8hJUgq</link>
            <guid>https://peertube2.cpy.re/w/roRW6qZGm4v7eAvK8hJUgq</guid>
            <pubDate>Wed, 22 Oct 2025 13:25:11 GMT</pubDate>
            <description><![CDATA[Entretien avec Antoine Dubiau, doctorant en géogaphie à l’Université de Génève et auteur de l’essai politique «Écofascismes» ! Sommaire : 00:00 Intro (extraits) 1:08 Présentation Antoine Dubiau 3:16 Rassemblement antifa de Montargis 9:02 L'Écofa...]]></description>
            <content:encoded><![CDATA[<p>Entretien avec Antoine Dubiau, doctorant en géogaphie à l’Université de Génève et auteur de l’essai politique «Écofascismes» !</p>
<p>Sommaire :<br />
00:00 Intro (extraits)<br />
1:08 Présentation Antoine Dubiau<br />
3:16 Rassemblement antifa de Montargis<br />
9:02 L'Écofascisme c'est quoi ?<br />
16:04 Qui sont les écofascistes ?<br />
18:12 Capitalisme, écofascisme et déclassement<br />
23:30 Histoire intellectuelle de l'écofascisme<br />
31:55 Écologisation du FN<br />
33:29 L'écologie est de gauche ?<br />
36:00 Écofascisme vs Carbofascisme<br />
46:15 La frontière : argument écologique ?<br />
48:49 Les Colibris et Pierre Rahbi<br />
53:36 AntiTech Résistance<br />
58:42 Survivalisme<br />
1:03:19 La science doit s'engager plus ?<br />
1:13:51 Engagement militant d'Antoine<br />
1:17:20 Agir contre l'écofascisme<br />
1:19:25 Recommandations Adrien<br />
1:22:18 Recommandations Antoine<br />
1:26:24 Engagement collectif + fin</p>
<p>Visio réalisée début septembre, provoquée par notre rencontre au grand rassemblement antifasciste à Montargis le 9 juin 2025 auquel Antoine avait participé pour une table ronde sur l’écologie et l’extrême droite animée par Adrien.</p>
<p>Nos réseaux :<br />
<a href="https://www.instagram.com/infogaucho/" target="_blank" rel="noopener noreferrer">https://www.instagram.com/infogaucho/</a><br />
<a href="https://www.tiktok.com/@info.gaucho" target="_blank" rel="noopener noreferrer">https://www.tiktok.com/@info.gaucho</a><br />
<a href="https://www.facebook.com/Infogaucho/" target="_blank" rel="noopener noreferrer">https://www.facebook.com/Infogaucho/</a><br />
<a href="https://www.twitch.tv/infogaucho" target="_blank" rel="noopener noreferrer">https://www.twitch.tv/infogaucho</a><br />
X : <a href="https://x.com/Info_gauchO" target="_blank" rel="noopener noreferrer">https://x.com/Info_gauchO</a><br />
Bluesky : <a href="https://bsky.app/profile/infogaucho.bsky.social" target="_blank" rel="noopener noreferrer">https://bsky.app/profile/infogaucho.bsky.social</a><br />
Mastodon : <a href="https://piaille.fr/@infogauchO" target="_blank" rel="noopener noreferrer">https://piaille.fr/@infogauchO</a><br />
Peertube : <a href="https://lostpod.space/c/chaine_infogaucho/videos" target="_blank" rel="noopener noreferrer">https://lostpod.space/c/chaine_infogaucho/videos</a></p>
<p>Page de doctorant d’Antoine, Université de Génève :<br />
<a href="https://www.unige.ch/sciences-societe/geo/membres/assistants/dubiau-antoine" target="_blank" rel="noopener noreferrer">https://www.unige.ch/sciences-societe/geo/membres/assistants/dubiau-antoine</a></p>
<p>Son interview France Inter sur le localisme identitaire :<br />
<a href="https://www.radiofrance.fr/franceinter/podcasts/zoom-zoom-zen/zoom-zoom-zen-du-vendredi-05-janvier-2024-1958633" target="_blank" rel="noopener noreferrer">https://www.radiofrance.fr/franceinter/podcasts/zoom-zoom-zen/zoom-zoom-zen-du-vendredi-05-janvier-2024-1958633</a></p>
<p>Son parti politique, Solidarités :<br />
<a href="https://www.instagram.com/solidaritesge/" target="_blank" rel="noopener noreferrer">https://www.instagram.com/solidaritesge/</a><br />
site internet : <a href="http://solidarites.ch" target="_blank" rel="noopener noreferrer">solidarites.ch</a><br />
Le périodique : <a href="https://solidarites.ch/numeros/" target="_blank" rel="noopener noreferrer">https://solidarites.ch/numeros/</a></p>
<p>Mathieu Burgalassi :<br />
<a href="https://www.youtube.com/@mathieuburgalassi" target="_blank" rel="noopener noreferrer">https://www.youtube.com/@mathieuburgalassi</a><br />
<a href="https://www.instagram.com/mathieu.burgalassi/" target="_blank" rel="noopener noreferrer">https://www.instagram.com/mathieu.burgalassi/</a><br />
La Peur et la haine – Enquête chez les survivalistes</p>
<p>Interview de Charles Fournier, député écologiste sur info gauchO :<br />
<a href="https://www.youtube.com/watch?v=ZyeTSCxVC24" target="_blank" rel="noopener noreferrer">https://www.youtube.com/watch?v=ZyeTSCxVC24</a></p>
<p>Interview d’Aurore Koechlin, sociologue et militante NPA sur info gauchO :<br />
<a href="https://www.youtube.com/watch?v=6KmNEphG4ss&amp;t=74s" target="_blank" rel="noopener noreferrer">https://www.youtube.com/watch?v=6KmNEphG4ss&amp;t=74s</a></p>
<p>Recommandations Adrien :</p>
<ul>
<li>Le Monde sans fin – Christophe Blain, Jean-Marc Jancovici</li>
<li>Cafardman – L’Abbé</li>
<li>1984 – Georges Orwell</li>
<li>Urbania FR : <a href="https://www.youtube.com/@URBANIAFR" target="_blank" rel="noopener noreferrer">https://www.youtube.com/@URBANIAFR</a></li>
<li>La Résistible Ascension, Institut La Boetie</li>
</ul>
<ul>
<li>conférence de présentation La Résistible ascension : <a href="https://www.youtube.com/watch?v=96ZXqeqHa3M&amp;pp=ygUhbGEgcmVzaXN0aWJsZSBhc2NlbnNpb24gTEEgQk9FVElF" target="_blank" rel="noopener noreferrer">https://www.youtube.com/watch?v=96ZXqeqHa3M&amp;pp=ygUhbGEgcmVzaXN0aWJsZSBhc2NlbnNpb24gTEEgQk9FVElF</a></li>
</ul>
<p>Recommandations Antoine :</p>
<ul>
<li>Minuit dans le siècle, podcast de Ugo Palheta : <a href="https://spectremedia.org/minuit-dans-le-siecle/" target="_blank" rel="noopener noreferrer">https://spectremedia.org/minuit-dans-le-siecle/</a></li>
<li>Sortir du capitalisme, podcast de Armand Paris : <a href="https://spectremedia.org/sortir-du-capitalisme/" target="_blank" rel="noopener noreferrer">https://spectremedia.org/sortir-du-capitalisme/</a></li>
<li>10 questions sur l’antifascisme, La Horde</li>
<li>Manifeste Terres et Libertés encadré par Fatima Ouassak</li>
<li>Fatima Ouassak <a href="https://www.instagram.com/fatima_ouassak/" target="_blank" rel="noopener noreferrer">https://www.instagram.com/fatima_ouassak/</a></li>
<li>Vietnam Dioxine : <a href="https://www.instagram.com/collectifvietnamdioxine/" target="_blank" rel="noopener noreferrer">https://www.instagram.com/collectifvietnamdioxine/</a><br />
<a href="http://vietnamdioxine.org/" target="_blank" rel="noopener noreferrer">http://vietnamdioxine.org/</a></li>
<li>Ainsi l’animal est nous - Kaoutar Harchi <a href="https://www.instagram.com/kaoutarharchi/" target="_blank" rel="noopener noreferrer">https://www.instagram.com/kaoutarharchi/</a></li>
</ul>
<p>Nous sommes très content de ce nouveau format, abonnez-vous pour plus d’épisodes et suivez nous sur nos réseaux !</p>
<p>#ecologie #ecofascisme #extremedroite #france #science #gauche #carbofascisme #capitalisme #entretien #interview #trump #dubiau #collapsologie #effondrement #survivalisme #bardella #burgalassi</p>
]]></content:encoded>
            <dc:creator>Info Gaucho</dc:creator>
            <category>News &amp; Politics</category>
            <enclosure length="414052331" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/cda599fd-bcb6-4f1b-998a-81fddd59e2fe?videoFileIds=5514236&amp;videoFileIds=5514237"/>
            <media:community>
                <media:statistics views="0"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/roRW6qZGm4v7eAvK8hJUgq"/>
            <media:player url="https://peertube2.cpy.re/w/roRW6qZGm4v7eAvK8hJUgq"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/0e014183-4a96-424c-88ce-91b129c63bc0-684-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/3d64f96c-c686-45b1-b3b8-eb70e62b210e-360-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/b5a64b48-108e-47b0-8c02-818fe37335ad-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="684" fileSize="340010680" url="https://lostpod.space/static/streaming-playlists/hls/cda599fd-bcb6-4f1b-998a-81fddd59e2fe/88725103-71cd-4f1f-bc63-aa238d2cd265-684-fragmented.mp4" framerate="30" duration="5292" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="360" fileSize="139284152" url="https://lostpod.space/static/streaming-playlists/hls/cda599fd-bcb6-4f1b-998a-81fddd59e2fe/4ed8d427-bb7d-4014-9edd-8f0d4ef99914-360-fragmented.mp4" framerate="30" duration="5292" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="74041651" url="https://lostpod.space/static/streaming-playlists/hls/cda599fd-bcb6-4f1b-998a-81fddd59e2fe/302b62a0-519d-4c45-94f9-3ac6dd805b8c-0-fragmented.mp4" framerate="0" duration="5292" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/cf7e8c8b-8e9b-433d-a651-29c90679aeb6.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/ac5f7fac-d8cf-4db0-bec9-fd51089410cb.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Les FACHOS se prennent pour des ÉCOLOS ? Entretien avec Antoine Dubiau (Écofascismes)</media:title>
            <media:description type="plain">Entretien avec Antoine Dubiau, doctorant en géogaphie à l’Université de Génève et auteur de l’essai politique «Écofascismes» ! Sommaire : 00:00 Intro (extraits) 1:08 Présentation Antoine Dubiau 3:16 Rassemblement antifa de Montargis 9:02 L'Écofa...</media:description>
        </item>
        <item>
            <title><![CDATA[La masterclass de Jancovici qui détruit la croissance verte !]]></title>
            <link>https://peertube2.cpy.re/w/stH84CFVZwYvysaSJy91Tv</link>
            <guid>https://peertube2.cpy.re/w/stH84CFVZwYvysaSJy91Tv</guid>
            <pubDate>Wed, 22 Oct 2025 10:21:35 GMT</pubDate>
            <description><![CDATA[Dans cette intervention marquante Jean Marc Jancovici associé chez Carbone 4 et président de The Shift Project prend la parole lors d’une conférence organisée par la chaîne YouTube de emlyon business school. Il y développe une réflexion approfondi...]]></description>
            <content:encoded><![CDATA[<p>Dans cette intervention marquante Jean Marc Jancovici associé chez Carbone 4 et président de The Shift Project prend la parole lors d’une conférence organisée par la chaîne YouTube de emlyon business school. Il y développe une réflexion approfondie sur la croissance économique l’inflation la transformation des ressources naturelles et les limites physiques de la croissance verte. Il montre comment chaque production humaine transforme des ressources naturelles et augmente inévitablement le désordre dans l’environnement ce que la physique appelle l’entropie. Jancovici explique pourquoi la croissance verte ne peut pas fonctionner physiquement et analyse les conséquences économiques sociales et politiques de la contraction énergétique déjà à l’œuvre en Europe. Il aborde aussi la montée des inégalités la décroissance matérielle et les défis d’un monde où il y a de moins en moins à partager. Une conférence claire et percutante qui éclaire les liens entre physique économie et écologie.<br />
#croissance #écologie #économie #environnement #transition</p>
<p>Pensez à réduire la qualité de la vidéo.</p>
<p>Pour changer le système :<br />
Réclamer le RIC constituant : <a href="https://petitions.assemblee-nationale.fr/initiatives/i-2491" target="_blank" rel="noopener noreferrer">https://petitions.assemblee-nationale.fr/initiatives/i-2491</a><br />
Changer de banque: <a href="https://www.lanef.com/" target="_blank" rel="noopener noreferrer">https://www.lanef.com/</a> <a href="https://change-de-banque.org/particulier/" target="_blank" rel="noopener noreferrer">https://change-de-banque.org/particulier/</a><br />
Passer à l'action militante: <a href="https://extinctionrebellion.fr/" target="_blank" rel="noopener noreferrer">https://extinctionrebellion.fr/</a> <a href="https://ripostealimentaire.fr/" target="_blank" rel="noopener noreferrer">https://ripostealimentaire.fr/</a><br />
Changer de travail : <a href="https://jobs.makesense.org/fr" target="_blank" rel="noopener noreferrer">https://jobs.makesense.org/fr</a></p>
<p>Source:</p>
<p>Vidéo: <a href="https://www.youtube.com/watch?v=-f2x2_ZX83s" target="_blank" rel="noopener noreferrer">https://www.youtube.com/watch?v=-f2x2_ZX83s</a></p>
<p>Musique: Invisible Beauty - Aakash Gandhi</p>
<p>Montage: lakl42</p>
<p>Réponses au quiz de fin :</p>
<p>/!\ Description à ne pas lire avant d'avoir vu la vidéo entièrement<br />
/!\</p>
<p>/!\</p>
<p>/!\ <br />
/!\</p>
<p>Quelle notion doit-on correctement mesurer pour évaluer la croissance économique réelle ?<br />
➡ L’inflation.</p>
<p>Comment Jancovici définit-il ce désordre croissant à l’extérieur du système économique ?<br />
➡ La pollution.</p>
<p>En quelle année l’Europe a-t-elle atteint son pic d’approvisionnement énergétique ?<br />
➡ 2007.</p>
]]></content:encoded>
            <dc:creator>ethique_et_tac</dc:creator>
            <enclosure length="118621254" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/d66c0775-c1eb-454a-9260-ffb7f302f02b?videoFileIds=5514077"/>
            <media:community>
                <media:statistics views="7"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/stH84CFVZwYvysaSJy91Tv"/>
            <media:player url="https://peertube2.cpy.re/w/stH84CFVZwYvysaSJy91Tv"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/c44d2788-423a-40d0-9b58-69d647f54cd5-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/22d01da0-fa57-4143-a5b9-f431755345e0-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/4d0017fe-14bc-4770-9369-c0a93685aa06-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/405e6bd0-4206-43c6-a05e-c278146255dd-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/b47ff51a-6a36-4423-a1fb-82758d77c885-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="118621254" url="https://static.indymotion.fr/streaming-playlists/hls/d66c0775-c1eb-454a-9260-ffb7f302f02b/89edf7aa-26ba-4143-9990-36ec802fc591-1080-fragmented.mp4" framerate="25" duration="716" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="72842046" url="https://static.indymotion.fr/streaming-playlists/hls/d66c0775-c1eb-454a-9260-ffb7f302f02b/2deeec3c-d0b5-4aec-87cd-c0c9541bf219-720-fragmented.mp4" framerate="25" duration="716" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="45738141" url="https://static.indymotion.fr/streaming-playlists/hls/d66c0775-c1eb-454a-9260-ffb7f302f02b/80dc81ab-4c95-4575-9152-b471b6b180ce-480-fragmented.mp4" framerate="25" duration="716" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="24315546" url="https://static.indymotion.fr/streaming-playlists/hls/d66c0775-c1eb-454a-9260-ffb7f302f02b/32b36be6-7a34-4071-81ba-77823b845b13-240-fragmented.mp4" framerate="25" duration="716" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="11573048" url="https://static.indymotion.fr/streaming-playlists/hls/d66c0775-c1eb-454a-9260-ffb7f302f02b/82c85dc0-9c77-4969-9e5e-e4ab5b9fd78b-0-fragmented.mp4" framerate="0" duration="716" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/a253d591-3dcf-4945-ae8c-f0678d1deb73.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/f1ec7016-4fc2-47e8-a26e-a5728fba4605.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">La masterclass de Jancovici qui détruit la croissance verte !</media:title>
            <media:description type="plain">Dans cette intervention marquante Jean Marc Jancovici associé chez Carbone 4 et président de The Shift Project prend la parole lors d’une conférence organisée par la chaîne YouTube de emlyon business school. Il y développe une réflexion approfondi...</media:description>
        </item>
        <item>
            <title><![CDATA[MasterClass de Anasse qui atomise une facho sur l'assimilation des français a l'étranger]]></title>
            <link>https://peertube2.cpy.re/w/u7fJjEhcYLvk21NQEhjvqQ</link>
            <guid>https://peertube2.cpy.re/w/u7fJjEhcYLvk21NQEhjvqQ</guid>
            <pubDate>Wed, 22 Oct 2025 09:08:38 GMT</pubDate>
            <description><![CDATA[https://youtu.be/3Vfv_49LMB0?si=R3Yh0dM09Ljiq8J-]]></description>
            <content:encoded><![CDATA[<p><a href="https://youtu.be/3Vfv_49LMB0?si=R3Yh0dM09Ljiq8J-" target="_blank" rel="noopener noreferrer">https://youtu.be/3Vfv_49LMB0?si=R3Yh0dM09Ljiq8J-</a></p>
]]></content:encoded>
            <dc:creator>a_gauche</dc:creator>
            <enclosure length="15845015" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/e39f6c2e-e4d3-4bf2-bc55-74b309735d44?videoFileIds=5514064"/>
            <media:community>
                <media:statistics views="3"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/u7fJjEhcYLvk21NQEhjvqQ"/>
            <media:player url="https://peertube2.cpy.re/w/u7fJjEhcYLvk21NQEhjvqQ"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/b860bba1-1325-4946-b441-db04f7caa20f-398-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/d60f94de-c80a-4f7c-8e40-3665711977a0-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/0a982f9a-5a3b-4f99-8a21-ad474036c5c7-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="398" fileSize="15845015" url="https://static.indymotion.fr/streaming-playlists/hls/e39f6c2e-e4d3-4bf2-bc55-74b309735d44/ea3c55bc-7f0c-4627-aeb3-ef654eafe44d-398-fragmented.mp4" framerate="30" duration="244" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="10209176" url="https://static.indymotion.fr/streaming-playlists/hls/e39f6c2e-e4d3-4bf2-bc55-74b309735d44/4dcf9b63-78b3-4e5d-af2a-d2a7a81b1d4e-240-fragmented.mp4" framerate="30" duration="244" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="3964756" url="https://static.indymotion.fr/streaming-playlists/hls/e39f6c2e-e4d3-4bf2-bc55-74b309735d44/1d967354-5bda-4086-8650-e81d61a4a3d8-0-fragmented.mp4" framerate="0" duration="244" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/e0a20fb7-4cbe-4836-ae86-b06519637c97.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/dee6005c-896d-4c3d-a0dc-4ccf2233b9e5.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">MasterClass de Anasse qui atomise une facho sur l'assimilation des français a l'étranger</media:title>
            <media:description type="plain">https://youtu.be/3Vfv_49LMB0?si=R3Yh0dM09Ljiq8J-</media:description>
        </item>
        <item>
            <title><![CDATA[Pourquoi il faut socialiser l’énergie]]></title>
            <link>https://peertube2.cpy.re/w/tHaYS8qLFaYj3C6BYFtqa5</link>
            <guid>https://peertube2.cpy.re/w/tHaYS8qLFaYj3C6BYFtqa5</guid>
            <pubDate>Wed, 22 Oct 2025 07:31:06 GMT</pubDate>
            <description><![CDATA[Attac diffusait le mardi 21 octobre à 19h une émission spéciale avec trois des auteur·rices du livre « L’Énergie est notre avenir, socialisons-la ! » : Lou Chesné, secrétaire générale d’Attac, Anne Debregeas, EDF Recherche et Développeme...]]></description>
            <content:encoded><![CDATA[<p>Attac diffusait le mardi 21 octobre à 19h une émission spéciale avec trois des auteur·rices du livre <em>« L’Énergie est notre avenir, socialisons-la ! »</em> : <strong>Lou Chesné</strong>, secrétaire générale d’Attac, <strong>Anne Debregeas</strong>, EDF Recherche et Développement et porte-parole de la fédération Sud-Energie et <strong>James Cleaver</strong>, Section SUD Énergie à Enercoop.</p>
<p>Découvrez avec nous les propositions pour enfin sortir l’énergie des logiques de marché et mener à bien la bifurcation écologique faire face au chaos climatique et environnemental qui est déjà à l’œuvre. Après sa diffusion, l’émission sera disponible en rediffusion sur la même page.</p>
<p>Publié dans la collection <a href="https://france.attac.org/actus-et-medias/le-flux/article/comprendre-pour-agir-la-nouvelle-collection-d-attac-aux-liens-qui-liberent" target="_blank" rel="noopener noreferrer">« Comprendre pour agir »</a>, ce livre décrit un chemin possible pour choisir démocratiquement notre avenir énergétique. Il pose des jalons pour construire de manière efficace le système électrique de demain au bénéfice de toutes et tous.<br />
Cet ouvrage propose, de manière percutante et en 80 pages, des pistes pour sortir l’électricité des logiques de marché et mettre en œuvre un véritable service public sous contrôle citoyen.</p>
]]></content:encoded>
            <dc:creator>Webinaire</dc:creator>
            <category>Activism</category>
            <enclosure length="509829649" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/e0666398-33e3-41f9-9d8b-b7f76ec91756?videoFileIds=5514057"/>
            <media:community>
                <media:statistics views="1"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/tHaYS8qLFaYj3C6BYFtqa5"/>
            <media:player url="https://peertube2.cpy.re/w/tHaYS8qLFaYj3C6BYFtqa5"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/d845b886-771c-4cdc-a472-c79a380b22b8-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/2626f9c1-ab68-4b43-8b22-067b2f494387-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/314a36c9-0645-453b-be86-36cde792ee25-360-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/8f660076-a379-48b9-aff2-8b9fa08379f4-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/1a4a837a-9e1b-434a-8f78-25ef17704e69-144-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/f2eb1249-c3cb-417f-b6c2-ea0a04af5d77-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="509829649" url="https://videos.globenet.org/static/streaming-playlists/hls/e0666398-33e3-41f9-9d8b-b7f76ec91756/10926e61-8961-4336-b375-3da04fd8870b-720-fragmented.mp4" framerate="25" duration="4846" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="291907788" url="https://videos.globenet.org/static/streaming-playlists/hls/e0666398-33e3-41f9-9d8b-b7f76ec91756/ee6f6dda-bb45-4d14-a66d-74a13bbe505f-480-fragmented.mp4" framerate="25" duration="4846" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="360" fileSize="221708163" url="https://videos.globenet.org/static/streaming-playlists/hls/e0666398-33e3-41f9-9d8b-b7f76ec91756/294fe68e-595a-4567-a594-26e6b534ef00-360-fragmented.mp4" framerate="25" duration="4846" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="150839813" url="https://videos.globenet.org/static/streaming-playlists/hls/e0666398-33e3-41f9-9d8b-b7f76ec91756/8dd61ba5-3b7c-4af3-bbf2-5ddfe9297a95-240-fragmented.mp4" framerate="25" duration="4846" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="144" fileSize="112508802" url="https://videos.globenet.org/static/streaming-playlists/hls/e0666398-33e3-41f9-9d8b-b7f76ec91756/68a86e5b-19d7-49a9-acfa-80d53d6be68a-144-fragmented.mp4" framerate="25" duration="4846" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="78692990" url="https://videos.globenet.org/static/streaming-playlists/hls/e0666398-33e3-41f9-9d8b-b7f76ec91756/b77e065b-d663-4edc-85a1-505205e1dae6-0-fragmented.mp4" framerate="0" duration="4846" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/6976019c-0b1b-419a-9d70-a997327ed3ca.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/68a6c2b4-c142-4d6f-b497-ca07c305d839.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Pourquoi il faut socialiser l’énergie</media:title>
            <media:description type="plain">Attac diffusait le mardi 21 octobre à 19h une émission spéciale avec trois des auteur·rices du livre « L’Énergie est notre avenir, socialisons-la ! » : Lou Chesné, secrétaire générale d’Attac, Anne Debregeas, EDF Recherche et Développeme...</media:description>
        </item>
        <item>
            <title><![CDATA[Secret Project Sneak Peek]]></title>
            <link>https://peertube2.cpy.re/w/wNj9aTDVNQqpfVqQW1ECYG</link>
            <guid>https://peertube2.cpy.re/w/wNj9aTDVNQqpfVqQW1ECYG</guid>
            <pubDate>Wed, 22 Oct 2025 01:30:20 GMT</pubDate>
            <dc:creator>skythedragon</dc:creator>
            <category>Entertainment</category>
            <enclosure length="1592670" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/f9698d8c-bcf5-4c0e-99ef-ee3b18077c98?videoFileIds=5514022"/>
            <media:community>
                <media:statistics views="4"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/wNj9aTDVNQqpfVqQW1ECYG"/>
            <media:player url="https://peertube2.cpy.re/w/wNj9aTDVNQqpfVqQW1ECYG"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/c26c0672-c84a-49ad-97a8-8fb2b91f2528-1080.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/2407b13a-7439-4c55-9390-914d430e506c-720.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/c3d87b24-8c9c-4a46-9ba0-e1670ecc7962-480.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/b8a8efcb-8691-4ed4-be1b-cecdd9c0078a-360.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/3dca49ff-d953-4de1-9564-f166f5d66931-240.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/194601ef-82f8-4980-a9be-fbedb0d814a0-0.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/0dfaa35d-c5e0-4049-a30b-dd88d0b8c9af-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/f61731dd-98c8-47bb-8993-a0290b8976ad-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/8889981f-cb66-4c46-820b-1b037e305ca8-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/465d6d14-c31d-49c1-a144-7c2bf8f8a1c8-360-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/79c44946-5ca7-4d1a-8c52-b2b9928b78a4-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/e292f276-c606-45b9-a442-affbb2fc700e-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="1592670" url="https://toobnix.org/static/web-videos/89039a73-fa1c-4087-b8d1-57045a27f881-1080.mp4" framerate="24" duration="3" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="975669" url="https://toobnix.org/static/web-videos/4808df3d-785f-4f59-a990-c02dcead4fec-720.mp4" framerate="24" duration="3" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="631287" url="https://toobnix.org/static/web-videos/2e20425c-3c94-4232-aafe-87506c249556-480.mp4" framerate="24" duration="3" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="360" fileSize="473915" url="https://toobnix.org/static/web-videos/b3c4983d-da9e-406e-9fde-5c52bbc7ac28-360.mp4" framerate="24" duration="3" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="288842" url="https://toobnix.org/static/web-videos/a3e4ab12-db3e-4a3b-8fdc-cb0197963df9-240.mp4" framerate="24" duration="3" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="93177" url="https://toobnix.org/static/web-videos/79429940-ccb6-4a3b-b35b-e76f03f5c2d3-0.mp4" framerate="0" duration="3" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="1591852" url="https://toobnix.org/static/streaming-playlists/hls/f9698d8c-bcf5-4c0e-99ef-ee3b18077c98/1ec64e64-4507-48fd-8fa0-9ca6a32d4f4c-1080-fragmented.mp4" framerate="24" duration="3" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="974843" url="https://toobnix.org/static/streaming-playlists/hls/f9698d8c-bcf5-4c0e-99ef-ee3b18077c98/73d06667-bf22-4a16-925b-4cecb092e1be-720-fragmented.mp4" framerate="24" duration="3" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="630381" url="https://toobnix.org/static/streaming-playlists/hls/f9698d8c-bcf5-4c0e-99ef-ee3b18077c98/afa8f59a-4d84-4dc8-9a78-280fd5e332c1-480-fragmented.mp4" framerate="24" duration="3" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="360" fileSize="472977" url="https://toobnix.org/static/streaming-playlists/hls/f9698d8c-bcf5-4c0e-99ef-ee3b18077c98/26d14a27-feb3-4681-8c8f-f59331967acc-360-fragmented.mp4" framerate="24" duration="3" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="287928" url="https://toobnix.org/static/streaming-playlists/hls/f9698d8c-bcf5-4c0e-99ef-ee3b18077c98/24afade0-f4aa-4104-8cdd-50a110c353b5-240-fragmented.mp4" framerate="24" duration="3" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="93007" url="https://toobnix.org/static/streaming-playlists/hls/f9698d8c-bcf5-4c0e-99ef-ee3b18077c98/c628eb07-dd2c-480e-8bf4-2b7a970220e0-0-fragmented.mp4" framerate="0" duration="3" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/36f8a61d-824b-4440-b609-3aa5278b6de1.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/40e83fea-fe53-42a6-b4b6-25c8c5bf590b.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Secret Project Sneak Peek</media:title>
        </item>
        <item>
            <title><![CDATA[TENIR - Teazzzzer 2025]]></title>
            <link>https://peertube2.cpy.re/w/1D7FSsSNv87SJBb6cg7mo7</link>
            <guid>https://peertube2.cpy.re/w/1D7FSsSNv87SJBb6cg7mo7</guid>
            <pubDate>Tue, 21 Oct 2025 21:23:39 GMT</pubDate>
            <description><![CDATA[TENIR - 24/45 TENIR, c’est mettre mon corps en scène et choisir comment je le mets en scène, choisir ce que j’en montre. C'est pouvoir danser pour transformer des images collées dans ma tête et sur mon corps. C’est me laisser être regardée ...]]></description>
            <content:encoded><![CDATA[<p><strong>TENIR</strong> - 24/45</p>
<p>TENIR, c’est mettre mon corps en scène et choisir comment je le mets en scène, choisir ce que j’en montre. C'est pouvoir danser pour transformer des images collées dans ma tête et sur mon corps. C’est me laisser être regardée dans une danse  intimement politisée.</p>
<p>TENIR, c'est partir de l'observation du feu.</p>
<p>C’est la possibilité d’une temporalité qui m’est propre. Une qu’on ne m’impose pas. Une qui n’est pas celle de l’école, de l’emploi, du travail ou de la productivité.  Une lenteur goûtue miam-miam.</p>
<p>Prendre le temps c’est quand même quelque chose, et il y a beaucoup de batailles avant ça.</p>
<p>Beaucoup de lutte aussi pendant, des moments de tension, de force, de repos, de sensualité de soi à soi, d’écoute de la musique, et puis la difficulté, la respiration, la douceur.</p>
<p>Dans cette danse, on peut me regarder presque sous tous les angles et je peux vous regarder aussi. Vous êtes très proches. Vous pouvez vous voir entre vous : qu’est-ce qui vous met le plus à l’aise dans tout ça ? Qu’est-ce que tu vois ? Comment tu regardes ?</p>
<p>Comment on s’apprivoise dans cette proximité et dans ce cadre de spectacle où mon petit corps de meuf blanche vient montrer sa danse ?</p>
<p>Je relis cette phrase et je pense : Est-ce mieux de dire “partager” que “montrer” sa danse ? Est-ce plus bienséant de le dire comme ça ? Je sais qu’on dit beaucoup comme ça dans le milieu du spectacle “partager avec le public”, “partager sa danse”. Et si je choisissais de <em>montrer</em> mon corps, ma danse, plutôt que de le <em>partager</em>, ça change quoi dans l’intention, ça permet et ça empêche quoi finalement entre nous ?</p>
<p>On dit aussi <em>donner à voir au public</em>. ça sonne intello mais finalement ça pourrait être un bon entre-deux. Le verbe <em>donner</em>, ça laisse imaginer un geste généreux, “bon”, désintéressé, alors que <em>montrer</em> ça renvoie plus à l’objet, la chose, au monstre. J’y sens aussi quelque chose de plus volontaire avec une certaine assurance : je te montre, regarde ici.</p>
<p>En fin de compte, je te <em>donne à voir</em>, ça pourrait aussi être faire cadeau, se rendre à disposition du regard de l’autre qui peut alors choisir où aller, se balader sur toi. Mon genre est de ceux qui héritent d’une histoire de ces regards...  Je crois qu’il y a de tout ça dans TENIR, donner, voir, montrer, et puis il y a aussi juste une meuf qui danse tout simplement.</p>

<p>Inspirée par la magie du chaos et les états modifiés de conscience, la pièce explore une forme de méditation physique intense, où le corps devient un vecteur de résistance face à une société de plus en plus répressive.</p>
<p>À travers une danse lente, exigeante et hypnotique, TENIR<br />
interroge notre rapport à la force, au contrôle et à la transformation.</p>
Solo chorégraphique, TENIR est porté par une danseuse, accompagnée d’un musicien live et d’une éclairagiste et présenté dans une scénographie immersive et intime, pour 50<br />
spectateur·trices.
<p>Production : Cie Organ Tumult<br />
Co-production : ADAMI, DRAC Hauts-de-France - Tremplin,<br />
SPEDIDAM, Happynest - SUPERAMAS, SUBS - Lyon, Ateliers Médicis, Le Croiseur - Lyon / Scènes découvertes Danse<br />
Résidences : Espace Pasolini de Valenciennes, Théâtre Le Croiseur -Lyon, Lisière - Vercors, cie Le Double des Clés -Tende, CND de Lyon, Ateliers de Paris CDCN, SUBS - Lyon, Mairie de Lucéram (06), Studio Chatha de Lyon, Espace Culturel de Fontenay- sous-bois</p>
<p>Chorégraphie &amp; Interprétation : Eva Aubigny<br />
Scénographie, accessoires : Sarah Bisson<br />
Composition du Son et live : Thibaut Langenais<br />
Costumes: Gabrielle Marty<br />
Lumières : Louise Rustan<br />
Assistance chorégraphique : Zoë De Sousa et Léa Ferec-<br />
Pourias<br />
Diffusion : Ely Husse</p>
]]></content:encoded>
            <dc:creator>Organ Tumult / Eva Aubigny</dc:creator>
            <category>Art</category>
            <enclosure length="18250006" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/052ea408-9258-4089-bdce-b92251edd1d2?videoFileIds=5513997"/>
            <media:community>
                <media:statistics views="9"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/1D7FSsSNv87SJBb6cg7mo7"/>
            <media:player url="https://peertube2.cpy.re/w/1D7FSsSNv87SJBb6cg7mo7"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/e02d6f40-32de-4e0d-8555-ae60dc1c1878-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/1c2748ff-bce5-4271-8cec-92a5f564ca19-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/fcca7ec6-b5f7-41be-956b-216fd303cec8-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/74087ace-36cf-4f4e-aecf-8f75f712fab3-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/6d4c4863-4106-40fd-a228-942d5a975e3f-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="18250006" url="https://static.indymotion.fr/streaming-playlists/hls/052ea408-9258-4089-bdce-b92251edd1d2/66095b1f-5970-4a43-abe0-6d148b0670dd-1080-fragmented.mp4" framerate="24" duration="82" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="8843095" url="https://static.indymotion.fr/streaming-playlists/hls/052ea408-9258-4089-bdce-b92251edd1d2/d374c152-6521-413a-a207-35bea0a702c9-720-fragmented.mp4" framerate="24" duration="82" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="4763079" url="https://static.indymotion.fr/streaming-playlists/hls/052ea408-9258-4089-bdce-b92251edd1d2/4ddeb89a-28bc-4fe0-903d-c797e2070737-480-fragmented.mp4" framerate="24" duration="82" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="2300538" url="https://static.indymotion.fr/streaming-playlists/hls/052ea408-9258-4089-bdce-b92251edd1d2/91adfcbb-9a27-4e06-a8cc-d67d970b7390-240-fragmented.mp4" framerate="24" duration="82" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="1335603" url="https://static.indymotion.fr/streaming-playlists/hls/052ea408-9258-4089-bdce-b92251edd1d2/73ce7da3-9cee-4505-aa86-6f182239509a-0-fragmented.mp4" framerate="0" duration="82" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/fabb5940-d45f-424d-aade-563bfbe66d5e.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/ed188b7b-cf2e-4311-8933-c203015a9f0e.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">TENIR - Teazzzzer 2025</media:title>
            <media:description type="plain">TENIR - 24/45 TENIR, c’est mettre mon corps en scène et choisir comment je le mets en scène, choisir ce que j’en montre. C'est pouvoir danser pour transformer des images collées dans ma tête et sur mon corps. C’est me laisser être regardée ...</media:description>
        </item>
        <item>
            <title><![CDATA[Drone 7 - mile bridge]]></title>
            <link>https://peertube2.cpy.re/w/r7Y8H5CQgjddWNHw4r8CL7</link>
            <guid>https://peertube2.cpy.re/w/r7Y8H5CQgjddWNHw4r8CL7</guid>
            <pubDate>Tue, 21 Oct 2025 20:57:07 GMT</pubDate>
            <dc:creator>Main joseph channel</dc:creator>
            <category>Travels</category>
            <enclosure length="1516851423" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/cb6d85b2-20aa-4edc-b6d8-c4f76064c596?videoFileIds=5513994"/>
            <media:community>
                <media:statistics views="4"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/r7Y8H5CQgjddWNHw4r8CL7"/>
            <media:player url="https://peertube2.cpy.re/w/r7Y8H5CQgjddWNHw4r8CL7"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/c7dff469-3fd0-4275-a751-64d45dec0468-2160-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/f65c93e8-d512-49e0-88e5-29c292f60e35-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/37397ce2-1428-4ce9-ae3d-48cb6ad0d24b-720-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="2160" fileSize="1516851423" url="https://video.livecchi.cloud/static/streaming-playlists/hls/cb6d85b2-20aa-4edc-b6d8-c4f76064c596/e110d9a7-db9d-4ae1-a2e8-05a7fba1e66d-2160-fragmented.mp4" framerate="30" duration="612" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="428777256" url="https://video.livecchi.cloud/static/streaming-playlists/hls/cb6d85b2-20aa-4edc-b6d8-c4f76064c596/03376806-25ee-4444-9b62-0ab7ba6284ac-1080-fragmented.mp4" framerate="30" duration="612" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="198322054" url="https://video.livecchi.cloud/static/streaming-playlists/hls/cb6d85b2-20aa-4edc-b6d8-c4f76064c596/7af92506-08a2-4ac7-8cdd-d45529004ba2-720-fragmented.mp4" framerate="30" duration="612" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/7ea5983f-ec29-4bf2-878f-63b199a60b82.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/99deb382-c5ac-45c9-930e-f3c49a570e7b.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Drone 7 - mile bridge</media:title>
        </item>
        <item>
            <title><![CDATA[🇵🇸🇮🇱 "1 ou 2 États : aux Palestiniens de choisir leur autodetermination" #Palestine #Israël #gaza]]></title>
            <link>https://peertube2.cpy.re/w/6EeQgk48ei1ExkrCAvQN7g</link>
            <guid>https://peertube2.cpy.re/w/6EeQgk48ei1ExkrCAvQN7g</guid>
            <pubDate>Tue, 21 Oct 2025 19:20:31 GMT</pubDate>
            <dc:creator>Info Gaucho</dc:creator>
            <category>News &amp; Politics</category>
            <enclosure length="8377673" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/2dd47b1d-a0d2-4e93-bb0a-67c104a887f3?videoFileIds=5513978&amp;videoFileIds=5513980"/>
            <media:community>
                <media:statistics views="0"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/6EeQgk48ei1ExkrCAvQN7g"/>
            <media:player url="https://peertube2.cpy.re/w/6EeQgk48ei1ExkrCAvQN7g"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/974f03ff-668c-4adc-8424-0907f1055785-1920-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/46267878-e642-404d-866b-cf87547628db-640-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/f26d93ae-7199-4e26-b184-6bd85547638f-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1920" fileSize="7568916" url="https://lostpod.space/static/streaming-playlists/hls/2dd47b1d-a0d2-4e93-bb0a-67c104a887f3/11976a7d-299c-4968-9357-7c64ac3b0e5e-1080-fragmented.mp4" framerate="30" duration="56" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="640" fileSize="2120384" url="https://lostpod.space/static/streaming-playlists/hls/2dd47b1d-a0d2-4e93-bb0a-67c104a887f3/057e366f-06b3-4708-a720-2de985b7ba8d-360-fragmented.mp4" framerate="30" duration="56" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="808757" url="https://lostpod.space/static/streaming-playlists/hls/2dd47b1d-a0d2-4e93-bb0a-67c104a887f3/613dd218-73d5-41e1-9d2c-02066ced6b99-0-fragmented.mp4" framerate="0" duration="56" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/14ccc396-45d6-4825-b4c1-3dfaab41f7ff.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/83f9cf3b-451f-46aa-8bbf-331cc68e10b1.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">🇵🇸🇮🇱 "1 ou 2 États : aux Palestiniens de choisir leur autodetermination" #Palestine #Israël #gaza</media:title>
        </item>
        <item>
            <title><![CDATA[La directive européenne qui a ruiné la liberté d'expression pour toujours]]></title>
            <link>https://peertube2.cpy.re/w/gDfjypHRFLSnZm4szsccqe</link>
            <guid>https://peertube2.cpy.re/w/gDfjypHRFLSnZm4szsccqe</guid>
            <pubDate>Tue, 21 Oct 2025 18:50:50 GMT</pubDate>
            <description><![CDATA[Fabrice Epelboin est invité sur Thinkerview pour discuter de hacking, de vie privée, et aussi de censure. En effet, l'Union Européenne a passé il y a 2 ans la directive DSA (Digital Services Act) qui est tout bonnnement la légitimation de la censu...]]></description>
            <content:encoded><![CDATA[<p>Fabrice Epelboin est invité sur Thinkerview pour discuter de hacking, de vie privée, et aussi de censure. En effet, l'Union Européenne a passé il y a 2 ans la directive DSA (Digital Services Act) qui est tout bonnnement la légitimation de la censure politique.</p>
<p>S'abonner à chaîne <a href="https://www.youtube.com/@thinkerview" target="_blank" rel="noopener noreferrer">https://www.youtube.com/@thinkerview</a><br />
Soutenir Thinkerview <a href="https://fr.tipeee.com/thinkerview" target="_blank" rel="noopener noreferrer">https://fr.tipeee.com/thinkerview</a></p>
<p>Pour changer le système :<br />
Réclamer le RIC constituant : <a href="https://petitions.assemblee-nationale.fr/initiatives/i-2491" target="_blank" rel="noopener noreferrer">https://petitions.assemblee-nationale.fr/initiatives/i-2491</a> <a href="https://www.mouvement-constituant-populaire.fr/" target="_blank" rel="noopener noreferrer">https://www.mouvement-constituant-populaire.fr/</a><br />
Changer de banque: <a href="https://www.lanef.com/" target="_blank" rel="noopener noreferrer">https://www.lanef.com/</a> <a href="https://change-de-banque.org/particulier/" target="_blank" rel="noopener noreferrer">https://change-de-banque.org/particulier/</a><br />
Passer à l'action militante: <a href="https://extinctionrebellion.fr/" target="_blank" rel="noopener noreferrer">https://extinctionrebellion.fr/</a> <a href="https://ripostealimentaire.fr/" target="_blank" rel="noopener noreferrer">https://ripostealimentaire.fr/</a><br />
Changer de travail : <a href="https://jobs.makesense.org/fr" target="_blank" rel="noopener noreferrer">https://jobs.makesense.org/fr</a></p>
<p>Sources<br />
Epelboin <a href="https://www.youtube.com/watch?v=ZL-XxW8VTx8" target="_blank" rel="noopener noreferrer">https://www.youtube.com/watch?v=ZL-XxW8VTx8</a><br />
Musique <a href="https://www.youtube.com/watch?v=39PVEaSytpo" target="_blank" rel="noopener noreferrer">https://www.youtube.com/watch?v=39PVEaSytpo</a></p>
<p>#epelboin #politique #UE #censure #hacking #extrait #ethiqueettac</p>
]]></content:encoded>
            <dc:creator>ethique_et_tac</dc:creator>
            <enclosure length="100527624" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/7eac6ca4-d91b-450b-960e-92197b669701?videoFileIds=5513968"/>
            <media:community>
                <media:statistics views="12"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/gDfjypHRFLSnZm4szsccqe"/>
            <media:player url="https://peertube2.cpy.re/w/gDfjypHRFLSnZm4szsccqe"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/8146ae26-2152-4783-8ae3-07eb34a1e8fc-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/f70d245b-cd43-4f15-a08e-a8f9ea836120-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/64ececc9-c055-458e-9cde-eb4b027b10d7-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/a207ecf9-d051-42ac-9cee-3c1c2fd812a4-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/75e6ec4d-dbde-43a1-891f-0c6cd867d9a4-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="100527624" url="https://static.indymotion.fr/streaming-playlists/hls/7eac6ca4-d91b-450b-960e-92197b669701/3d0fc981-258d-40bc-b72a-8f2bc06791f2-1080-fragmented.mp4" framerate="25" duration="679" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="61530919" url="https://static.indymotion.fr/streaming-playlists/hls/7eac6ca4-d91b-450b-960e-92197b669701/c3e33512-769d-47e9-81ec-b23a3a3b3381-720-fragmented.mp4" framerate="25" duration="679" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="39942335" url="https://static.indymotion.fr/streaming-playlists/hls/7eac6ca4-d91b-450b-960e-92197b669701/6df755fe-69cc-46be-b429-ebbd92558999-480-fragmented.mp4" framerate="25" duration="679" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="22532410" url="https://static.indymotion.fr/streaming-playlists/hls/7eac6ca4-d91b-450b-960e-92197b669701/d6e782b3-911d-4a21-91db-855be52670a6-240-fragmented.mp4" framerate="25" duration="679" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="11120371" url="https://static.indymotion.fr/streaming-playlists/hls/7eac6ca4-d91b-450b-960e-92197b669701/656097b0-b1f8-4ff5-8345-84cdf19e575b-0-fragmented.mp4" framerate="0" duration="679" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/6abd6398-62c5-45e9-9e1a-a8a936d111bd.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/e01e4db3-d621-43d2-a49d-2b296b4ef7f1.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">La directive européenne qui a ruiné la liberté d'expression pour toujours</media:title>
            <media:description type="plain">Fabrice Epelboin est invité sur Thinkerview pour discuter de hacking, de vie privée, et aussi de censure. En effet, l'Union Européenne a passé il y a 2 ans la directive DSA (Digital Services Act) qui est tout bonnnement la légitimation de la censu...</media:description>
        </item>
        <item>
            <title><![CDATA[Patti Smith - Gloria]]></title>
            <link>https://peertube2.cpy.re/w/137SwESm4i9iusf1uJyRi3</link>
            <guid>https://peertube2.cpy.re/w/137SwESm4i9iusf1uJyRi3</guid>
            <pubDate>Tue, 21 Oct 2025 18:03:48 GMT</pubDate>
            <description><![CDATA[Une extraordinaire vidéo d'un concert de la bonne époque, qui a survécue plus de vingt ans dans mes archives numériques. Je ne connais pas la date, mais « Rockpalast » est (était ?) une émission de la télévision allemande qui diffusait des conce...]]></description>
            <content:encoded><![CDATA[<p>Une <em>extraordinaire</em> vidéo d'un concert de la bonne époque, qui a survécue plus de vingt ans dans mes archives numériques. Je ne connais pas la date, mais « Rockpalast » est (était ?) une émission de la télévision allemande qui diffusait des concerts, on doit pouvoir la retrouver...</p>
<ul>
<li><a href="https://fr.wikipedia.org/wiki/Rockpalast" target="_blank" rel="noopener noreferrer">https://fr.wikipedia.org/wiki/Rockpalast</a></li>
</ul>
<p>C'est un peu lent à démarrer, mais la fin est <strong>torride</strong> . Enjoy ...</p>
]]></content:encoded>
            <dc:creator>Vidz of tTh</dc:creator>
            <category>Entertainment</category>
            <enclosure length="70359306" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/004bb8d8-da3f-4251-81fc-d6c80a5327e0?videoFileIds=5513966"/>
            <media:community>
                <media:statistics views="5"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/137SwESm4i9iusf1uJyRi3"/>
            <media:player url="https://peertube2.cpy.re/w/137SwESm4i9iusf1uJyRi3"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/adf6ced2-0533-446a-b20f-0105eaac466f-406-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="406" fileSize="70359306" url="https://tube.interhacker.space/static/streaming-playlists/hls/004bb8d8-da3f-4251-81fc-d6c80a5327e0/73e078b1-2c83-406a-9337-e32ac19205b1-406-fragmented.mp4" framerate="24" duration="599" isDefault="true"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/554e11d2-a42d-40ea-9143-7e2e3a6f17be.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/764fe31a-5d52-4f4f-bb8a-3484999681c2.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Patti Smith - Gloria</media:title>
            <media:description type="plain">Une extraordinaire vidéo d'un concert de la bonne époque, qui a survécue plus de vingt ans dans mes archives numériques. Je ne connais pas la date, mais « Rockpalast » est (était ?) une émission de la télévision allemande qui diffusait des conce...</media:description>
        </item>
        <item>
            <title><![CDATA[Drone - Key West Mangrove]]></title>
            <link>https://peertube2.cpy.re/w/cEygXqDPXCRiBBbh3qfvtR</link>
            <guid>https://peertube2.cpy.re/w/cEygXqDPXCRiBBbh3qfvtR</guid>
            <pubDate>Tue, 21 Oct 2025 17:30:59 GMT</pubDate>
            <dc:creator>Main joseph channel</dc:creator>
            <category>Travels</category>
            <enclosure length="1491262345" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/5e76adc2-e140-41da-8556-0a15bb780053?videoFileIds=5513955"/>
            <media:community>
                <media:statistics views="9"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/cEygXqDPXCRiBBbh3qfvtR"/>
            <media:player url="https://peertube2.cpy.re/w/cEygXqDPXCRiBBbh3qfvtR"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/b6da2429-8285-4696-bd6d-5a7e815704a9-2160-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/14d142e7-7f3e-49ef-8e90-9190598f208e-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/97c5655a-7424-44c5-bec5-cb664401699b-720-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="2160" fileSize="1491262345" url="https://video.livecchi.cloud/static/streaming-playlists/hls/5e76adc2-e140-41da-8556-0a15bb780053/0a9af8e1-9e7b-4944-a2cd-adcf7587f703-2160-fragmented.mp4" framerate="30" duration="598" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="465312449" url="https://video.livecchi.cloud/static/streaming-playlists/hls/5e76adc2-e140-41da-8556-0a15bb780053/e67f7178-e1ec-4101-93e6-4cacb532efb9-1080-fragmented.mp4" framerate="30" duration="598" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="227396812" url="https://video.livecchi.cloud/static/streaming-playlists/hls/5e76adc2-e140-41da-8556-0a15bb780053/436da7df-3069-422d-8f6e-ab256f673351-720-fragmented.mp4" framerate="30" duration="598" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/82fbb927-889a-42a5-a11b-5a69d7653b74.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/1ac7e02f-6fb5-4cf6-9e1c-23c56947e042.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Drone - Key West Mangrove</media:title>
        </item>
        <item>
            <title><![CDATA[PARMI (duo) TEASER]]></title>
            <link>https://peertube2.cpy.re/w/fGuM5fdEXWgKca2U87QCEP</link>
            <guid>https://peertube2.cpy.re/w/fGuM5fdEXWgKca2U87QCEP</guid>
            <pubDate>Tue, 21 Oct 2025 16:27:48 GMT</pubDate>
            <description><![CDATA[How can we dance from the physical qualities of the dead? How do the relationship between the living and the dead transform themselves ? Inspired by these questions, this duo stages a choreographic work composed of apnea and breaths. Bodies are co...]]></description>
            <content:encoded><![CDATA[<p>How can we dance from the physical qualities of the dead? How do the relationship between the living and the dead transform themselves ? Inspired by these questions, this duo stages a choreographic work composed of apnea and breaths. Bodies are considered here as sensitive experience vectors whose “listening” capacities will be increased. Stop breathing, don’t react, stiffen our body, tetanize our muscles. The dancers, specialists in movement, play on these “impossible” constraints, on the physicalities of non-living. Between calm and extreme physical tension, suddenly emerges an apneist duet.</p>
<p>PARMI (duo)</p>
<p>Choreography : Eva Aubigny</p>
<p>Dancers : Enzo Blond and Héloïse Larue</p>
<p>Music : Solal Mazeran and Félix Béguin</p>
<p>Light design : Louise Rustan</p>
<p>Stage design : Sarah Bisson</p>
<p>Produced by : YAGE cie</p>
<p>Co-produced by : La Plateforme / Cie Samuel Mathieu, Espace Pasolini de Valenciennes, DRAC Hauts-de-France</p>
<p>Residencies : L’Essieu du Batut, Aveyron, Le Croiseur - Scènes Découvertes, Ring -</p>
<p>Scène périphérique, Toulouse, Espace Pasolini de Valenciennes, Ateliers de Paris, CDCN</p>
]]></content:encoded>
            <dc:creator>Organ Tumult / Eva Aubigny</dc:creator>
            <category>Art</category>
            <enclosure length="36547999" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/77076d33-dd1f-4b9b-a2e7-01b97ac4c99b?videoFileIds=5513944"/>
            <media:community>
                <media:statistics views="2"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/fGuM5fdEXWgKca2U87QCEP"/>
            <media:player url="https://peertube2.cpy.re/w/fGuM5fdEXWgKca2U87QCEP"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/d715bf18-68d6-45e4-97b3-9cad4cc392e4-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/1a7a8141-e63d-44d8-94ff-b5fa067ec6c4-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/7f2552af-c9ee-4171-82ed-a2b30442f57f-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/d05abc45-052f-4fce-b42f-400e9d795391-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/e4596f3b-4f42-40f5-bac7-107e66c3851e-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="36547999" url="https://static.indymotion.fr/streaming-playlists/hls/77076d33-dd1f-4b9b-a2e7-01b97ac4c99b/57ce94e5-aa1b-4f51-a9e0-5bd5d4b35e0b-1080-fragmented.mp4" framerate="25" duration="109" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="16462567" url="https://static.indymotion.fr/streaming-playlists/hls/77076d33-dd1f-4b9b-a2e7-01b97ac4c99b/a8950cbb-7149-4992-9f60-d7cb1ebe81e0-720-fragmented.mp4" framerate="25" duration="109" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="9229913" url="https://static.indymotion.fr/streaming-playlists/hls/77076d33-dd1f-4b9b-a2e7-01b97ac4c99b/8d195118-c7d7-46df-a545-5f755d75f58f-480-fragmented.mp4" framerate="25" duration="109" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="4352359" url="https://static.indymotion.fr/streaming-playlists/hls/77076d33-dd1f-4b9b-a2e7-01b97ac4c99b/0c057851-a1aa-4511-8191-0b6106c683fe-240-fragmented.mp4" framerate="25" duration="109" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="1708179" url="https://static.indymotion.fr/streaming-playlists/hls/77076d33-dd1f-4b9b-a2e7-01b97ac4c99b/a55f01d3-ac0d-4807-8f41-29e1e4e1f5df-0-fragmented.mp4" framerate="0" duration="109" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/4b924baa-ad20-48cd-8a67-f5b1b9832a4b.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/1f8912b0-35e3-4bf9-bda1-ce3e538f5f5b.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">PARMI (duo) TEASER</media:title>
            <media:description type="plain">How can we dance from the physical qualities of the dead? How do the relationship between the living and the dead transform themselves ? Inspired by these questions, this duo stages a choreographic work composed of apnea and breaths. Bodies are co...</media:description>
        </item>
        <item>
            <title><![CDATA[Comment gagner la bataille culturelle]]></title>
            <link>https://peertube2.cpy.re/w/tAgJ2VZeNQT6PfB64qa6ro</link>
            <guid>https://peertube2.cpy.re/w/tAgJ2VZeNQT6PfB64qa6ro</guid>
            <pubDate>Tue, 21 Oct 2025 16:00:01 GMT</pubDate>
            <description><![CDATA[Soutenez Blast, nouveau média indépendant : https://www.blast-info.fr/soutenir Dans un contexte de montée internationale du fascisme, d'offensive des idées ultra conservatrices et anti démocratiques, l’autrice Blanche Sabbah défend la nécessité...]]></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>Dans un contexte de montée internationale du fascisme, d'offensive des idées ultra conservatrices et anti démocratiques, l’autrice Blanche Sabbah défend la nécessité de mener une bataille artistique, et une bataille des idées, sur tous les plans, pour pouvoir empêcher cette montée de l’obscurantisme. L’extrême droite dispose de récits, de symboles, de tout un univers de plus en plus puissant, sur tous les canaux possibles.<br />
Mais comment faire pour proposer d’autres imaginaires ? Est-ce qu’on lutte efficacement avec du cinéma, de la musique, de la peinture, de la littérature ? Est ce que c’est ça, la bataille culturelle, ou est ce plus large ? Réponses dans ce nouvel entretien au micro de Salomé Saqué, pour Blast.</p>
<p>Journaliste : Salomé Saqué<br />
Montage : Lucas Zef<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>#Entretien<br />
#extremedroite<br />
#culture</p>
]]></content:encoded>
            <dc:creator>blast, le souffle de l’info</dc:creator>
            <enclosure length="809929865" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/df6fb902-b7cf-4bb3-bec8-888af2a9dbfc?videoFileIds=5513937&amp;videoFileIds=5513941"/>
            <media:community>
                <media:statistics views="1090"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/tAgJ2VZeNQT6PfB64qa6ro"/>
            <media:player url="https://peertube2.cpy.re/w/tAgJ2VZeNQT6PfB64qa6ro"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/0f7292ed-d86c-464b-9dd2-60ed64807463-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/1b6328ff-a094-41a3-9bfc-e23baba9d8f9-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/f8d757fd-4c84-4c64-ad46-32e6df4cd87d-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/60984a0c-04b7-45f1-801e-11a60d296863-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/443d8fa8-838d-4b0f-bc25-65fd312ef366-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="763341642" url="https://cdn.octos3.fr/peertube-blast/streaming-playlists/hls/df6fb902-b7cf-4bb3-bec8-888af2a9dbfc/20beb7e3-15ed-4478-af00-ff13a8972843-1080-fragmented.mp4" framerate="25" duration="2876" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="381785384" url="https://cdn.octos3.fr/peertube-blast/streaming-playlists/hls/df6fb902-b7cf-4bb3-bec8-888af2a9dbfc/8acc92e9-ceab-47c5-849a-0b2d7328fec3-720-fragmented.mp4" framerate="25" duration="2876" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="206796590" url="https://cdn.octos3.fr/peertube-blast/streaming-playlists/hls/df6fb902-b7cf-4bb3-bec8-888af2a9dbfc/07230a5c-9841-44f3-b4aa-a21c83c4a195-480-fragmented.mp4" framerate="25" duration="2876" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="70141621" url="https://cdn.octos3.fr/peertube-blast/streaming-playlists/hls/df6fb902-b7cf-4bb3-bec8-888af2a9dbfc/e97b82b7-040d-4b95-a6c0-dda77c559a4e-240-fragmented.mp4" framerate="25" duration="2876" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="46588223" url="https://cdn.octos3.fr/peertube-blast/streaming-playlists/hls/df6fb902-b7cf-4bb3-bec8-888af2a9dbfc/02e67545-8abb-4428-a92c-1a2873831c0a-0-fragmented.mp4" framerate="0" duration="2876" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/a5c84314-6c67-4238-b255-8b72073f37ec.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/cf34cc89-2a57-4f3d-85a2-ea3c6d4a93ca.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Comment gagner la bataille culturelle</media:title>
            <media:description type="plain">Soutenez Blast, nouveau média indépendant : https://www.blast-info.fr/soutenir Dans un contexte de montée internationale du fascisme, d'offensive des idées ultra conservatrices et anti démocratiques, l’autrice Blanche Sabbah défend la nécessité...</media:description>
        </item>
        <item>
            <title><![CDATA[Drone - Bahia Honda Beach 2]]></title>
            <link>https://peertube2.cpy.re/w/jUA3JNNiY5TYVWMUkA21g5</link>
            <guid>https://peertube2.cpy.re/w/jUA3JNNiY5TYVWMUkA21g5</guid>
            <pubDate>Tue, 21 Oct 2025 15:45:11 GMT</pubDate>
            <dc:creator>Main joseph channel</dc:creator>
            <category>Travels</category>
            <enclosure length="2193986388" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/991c277d-647d-4e69-9bf6-f06bf19f4212?videoFileIds=5513935"/>
            <media:community>
                <media:statistics views="2"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/jUA3JNNiY5TYVWMUkA21g5"/>
            <media:player url="https://peertube2.cpy.re/w/jUA3JNNiY5TYVWMUkA21g5"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/471efa91-3054-4b80-a19d-67a807b4c8e2-2160-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/eda7ddc5-3fb0-49ad-8f07-5761f848d715-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/6f5354c3-e4f0-4bc1-afca-c128db45e28c-720-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="2160" fileSize="2193986388" url="https://video.livecchi.cloud/static/streaming-playlists/hls/991c277d-647d-4e69-9bf6-f06bf19f4212/be1eaf45-e5a5-4d2f-920e-7066372269e5-2160-fragmented.mp4" framerate="30" duration="889" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="587987695" url="https://video.livecchi.cloud/static/streaming-playlists/hls/991c277d-647d-4e69-9bf6-f06bf19f4212/b7dd15fd-77e9-4297-b578-3a758d83fafb-1080-fragmented.mp4" framerate="30" duration="889" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="265840711" url="https://video.livecchi.cloud/static/streaming-playlists/hls/991c277d-647d-4e69-9bf6-f06bf19f4212/1a43ec35-3fed-4f07-8a3c-eb8f08a5369e-720-fragmented.mp4" framerate="30" duration="889" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/2a0a7352-b690-4efb-8ddd-2bd18351d775.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/ee6cc19f-89f8-480b-9e2f-4c70e40e9a70.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Drone - Bahia Honda Beach 2</media:title>
        </item>
        <item>
            <title><![CDATA[Improvisation musicale au tongue drum pour vous inviter à lire « En finir avec les idées fausses sur l'antispécisme »]]></title>
            <link>https://peertube2.cpy.re/w/3FB7kss1rRLZN3P6Rzr3iy</link>
            <guid>https://peertube2.cpy.re/w/3FB7kss1rRLZN3P6Rzr3iy</guid>
            <pubDate>Tue, 21 Oct 2025 15:31:45 GMT</pubDate>
            <description><![CDATA[Petit délire improvisation musicale au tongue drum pour vous inviter à lire le livre « En finir avec les idées fausses sur l'antispécisme » de Victor Duran-Le Peuch : https://editionsatelier.com/boutique/accueil/492-en-finir-avec-les-ide...]]></description>
            <content:encoded><![CDATA[<p>Petit délire improvisation musicale au tongue drum pour vous inviter à lire le livre « <strong><em>En finir avec les idées fausses sur l'antispécisme</em></strong> » de <strong>Victor Duran-Le Peuch</strong> : <a href="https://editionsatelier.com/boutique/accueil/492-en-finir-avec-les-idees-fausses-sur-l-antispecisme-9782708295407.html" target="_blank" rel="noopener noreferrer">https://editionsatelier.com/boutique/accueil/492-en-finir-avec-les-idees-fausses-sur-l-antispecisme-9782708295407.html</a></p>
<p>auteur du podcast « <strong><em>Comme un poisson dans l'eau</em></strong> » : <a href="https://linktr.ee/poissonpodcast" target="_blank" rel="noopener noreferrer">https://linktr.ee/poissonpodcast</a></p>
<p>Préfacé par <strong>Kaoutar Harchi</strong>, auteure entre autres de « <strong><em>Ainsi l'Animal et nous</em></strong> ».</p>
<p>Merci de votre attention !</p>
]]></content:encoded>
            <dc:creator>Cuisine, Art, Politique et compagnie Vegan</dc:creator>
            <category>Activism</category>
            <enclosure length="26733977" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/15b9ebd2-a42d-4203-978d-d85c31ad6d9a?videoFileIds=5513924"/>
            <media:community>
                <media:statistics views="3"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/3FB7kss1rRLZN3P6Rzr3iy"/>
            <media:player url="https://peertube2.cpy.re/w/3FB7kss1rRLZN3P6Rzr3iy"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/f7672b52-be24-4d80-a0b8-6f5af9dec0a6-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/c0bdf016-550e-40c7-8243-08b7a17086d4-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/33f743dc-d625-44b8-8981-786c98dae42d-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/fe97d99d-132b-42c1-8dd8-335cc5073079-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/5b5df7f0-58ce-4998-8939-f68cf31cdba8-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="26733977" url="https://static.indymotion.fr/streaming-playlists/hls/15b9ebd2-a42d-4203-978d-d85c31ad6d9a/427f1bd3-2e13-45b4-9119-71848bdaa9c0-1080-fragmented.mp4" framerate="25" duration="68" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="13066435" url="https://static.indymotion.fr/streaming-playlists/hls/15b9ebd2-a42d-4203-978d-d85c31ad6d9a/06799e7b-eb0d-4402-88a7-1e0b05d0e333-720-fragmented.mp4" framerate="25" duration="68" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="6642625" url="https://static.indymotion.fr/streaming-playlists/hls/15b9ebd2-a42d-4203-978d-d85c31ad6d9a/18b52ee2-caae-4581-818d-bd2bcbaad023-480-fragmented.mp4" framerate="25" duration="68" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="3008231" url="https://static.indymotion.fr/streaming-playlists/hls/15b9ebd2-a42d-4203-978d-d85c31ad6d9a/94e20881-4979-4942-9240-eac4a2a9dc7f-240-fragmented.mp4" framerate="25" duration="68" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="1023214" url="https://static.indymotion.fr/streaming-playlists/hls/15b9ebd2-a42d-4203-978d-d85c31ad6d9a/f9b66d4f-1f1c-464e-8bf9-5b2b44d1b2bc-0-fragmented.mp4" framerate="0" duration="68" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/b06187a5-c947-4de2-9471-ba54e2f3c209.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/7c2e9cc3-b014-4430-b6c7-ca4be5a539d5.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Improvisation musicale au tongue drum pour vous inviter à lire « En finir avec les idées fausses sur l'antispécisme »</media:title>
            <media:description type="plain">Petit délire improvisation musicale au tongue drum pour vous inviter à lire le livre « En finir avec les idées fausses sur l'antispécisme » de Victor Duran-Le Peuch : https://editionsatelier.com/boutique/accueil/492-en-finir-avec-les-ide...</media:description>
        </item>
        <item>
            <title><![CDATA[parmi l'humilité de la chair, ceux qu'il reste - TEASER]]></title>
            <link>https://peertube2.cpy.re/w/bwCkkP7AJm1kef57kn6mHm</link>
            <guid>https://peertube2.cpy.re/w/bwCkkP7AJm1kef57kn6mHm</guid>
            <pubDate>Tue, 21 Oct 2025 15:21:02 GMT</pubDate>
            <description><![CDATA[(Parmi l'humilité de la chair, ceux qu'il reste) à Les SUBS de Lyon les 28 ET 29 OCTOBRE 2021. Création 20/21 D'après une proposition chorégraphique de Eva Aubigny Avec Danse : Enzo Blond , Bastien Charmette, Léna Dompy, Héloise...]]></description>
            <content:encoded><![CDATA[<p>(<strong>Parmi l'humilité de la chair, ceux qu'il reste</strong>)<br />
à Les SUBS de Lyon les 28 ET 29 OCTOBRE 2021.</p>
<p>Création 20/21</p>
<p>D'après une proposition chorégraphique de Eva Aubigny</p>
<p>Avec</p>
<p>Danse : Enzo Blond , Bastien Charmette, Léna Dompy, Héloise Larue, Mélisande Tonolo</p>
<p>Musique : Felix Beguin</p>
<p>Scénographie : Sarah Bisson</p>
<p>Lumières : Louise Rustan</p>
<p>Moulages : Alexia Pouget-Neron</p>
<p>Projet lauréat du Post-Diplôme de Recherche et Création Artistique des Ecoles Supérieures en Art de Lyon 20/21.</p>
<p>Accueil en Résidences : La Pratique, Atelier de fabrique artistique, Vatan - région Centre-, Val de Loire, L’Essieu du Batut - Aveyron, Le Croiseur - Scènes Découvertes, Ring - Scène périphérique</p>
<p>Coproduction : Région Auvergne Rhône Alpes, La Plateforme / Cie Samuel Mathieu</p>
]]></content:encoded>
            <dc:creator>Organ Tumult / Eva Aubigny</dc:creator>
            <category>Art</category>
            <enclosure length="81157625" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/5542174b-c48a-44ed-9ef1-3c1665a8dba6?videoFileIds=5513918"/>
            <media:community>
                <media:statistics views="2"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/bwCkkP7AJm1kef57kn6mHm"/>
            <media:player url="https://peertube2.cpy.re/w/bwCkkP7AJm1kef57kn6mHm"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/1631ac5e-c4a8-4b37-98b2-3d6d62bc74ef-2160-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/42100f7d-b098-4273-8a84-ab25856519ee-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/8bcb32b6-fc0c-42e9-b0a0-72d39ea34e3f-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/7ca5a8fb-3ee1-4c70-a58d-61cafe786310-480-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/9b3a0fd4-0e00-4f82-bca5-e2529ae8512f-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/3ce40acd-bcdc-46c6-9211-b2a707678e0a-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="2160" fileSize="81157625" url="https://static.indymotion.fr/streaming-playlists/hls/5542174b-c48a-44ed-9ef1-3c1665a8dba6/ba5dd792-1cf3-4454-bb0c-ce640d02ae2a-2160-fragmented.mp4" framerate="25" duration="118" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="27823884" url="https://static.indymotion.fr/streaming-playlists/hls/5542174b-c48a-44ed-9ef1-3c1665a8dba6/b6dd8338-145a-43c4-8284-0f7a5dada8c5-1080-fragmented.mp4" framerate="25" duration="118" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="15569060" url="https://static.indymotion.fr/streaming-playlists/hls/5542174b-c48a-44ed-9ef1-3c1665a8dba6/0ae8120f-d6ac-4701-86e6-9cf7837672d2-720-fragmented.mp4" framerate="25" duration="118" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="480" fileSize="9417504" url="https://static.indymotion.fr/streaming-playlists/hls/5542174b-c48a-44ed-9ef1-3c1665a8dba6/f766fbbf-5521-4e16-ab33-12fe0218cb14-480-fragmented.mp4" framerate="25" duration="118" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="4666369" url="https://static.indymotion.fr/streaming-playlists/hls/5542174b-c48a-44ed-9ef1-3c1665a8dba6/eaa2c043-837f-42df-8c7c-20d19ebebdcf-240-fragmented.mp4" framerate="25" duration="118" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="1823189" url="https://static.indymotion.fr/streaming-playlists/hls/5542174b-c48a-44ed-9ef1-3c1665a8dba6/1d768d64-2d87-4793-af0d-bf4663b4b765-0-fragmented.mp4" framerate="0" duration="118" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/6857925f-b3b2-41a4-b8c6-80b16a68d835.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/c0685113-0738-4755-8453-ae0bc0471cb4.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">parmi l'humilité de la chair, ceux qu'il reste - TEASER</media:title>
            <media:description type="plain">(Parmi l'humilité de la chair, ceux qu'il reste) à Les SUBS de Lyon les 28 ET 29 OCTOBRE 2021. Création 20/21 D'après une proposition chorégraphique de Eva Aubigny Avec Danse : Enzo Blond , Bastien Charmette, Léna Dompy, Héloise...</media:description>
        </item>
        <item>
            <title><![CDATA[Voilaaa - L'intro]]></title>
            <link>https://peertube2.cpy.re/w/j4HSgBqKi6MnVzUdSngjX5</link>
            <guid>https://peertube2.cpy.re/w/j4HSgBqKi6MnVzUdSngjX5</guid>
            <pubDate>Tue, 21 Oct 2025 14:38:41 GMT</pubDate>
            <description><![CDATA[Provided to YouTube by The Orchard Enterprises L'intro · Voilaaa · Bruno Hovart C'est Tout ℗ 2024 Favorite Recordings Released on: 2024-09-27 Music  Publisher: Favorite Recordings SAS Auto-generated by YouTube.]]></description>
            <content:encoded><![CDATA[<p>Provided to YouTube by The Orchard Enterprises</p>
<p>L'intro · Voilaaa · Bruno Hovart</p>
<p>C'est Tout</p>
<p>℗ 2024 Favorite Recordings</p>
<p>Released on: 2024-09-27</p>
<p>Music  Publisher: Favorite Recordings SAS</p>
<p>Auto-generated by YouTube.</p>
]]></content:encoded>
            <dc:creator>ZIKMU</dc:creator>
            <category>Music</category>
            <enclosure length="10376432" type="video/mp4" url="https://peertube2.cpy.re/download/videos/generate/92498749-90ec-40c9-b8a8-afe0dedbe8ea?videoFileIds=5513913"/>
            <media:community>
                <media:statistics views="2"/>
            </media:community>
            <media:embed url="https://peertube2.cpy.re/videos/embed/j4HSgBqKi6MnVzUdSngjX5"/>
            <media:player url="https://peertube2.cpy.re/w/j4HSgBqKi6MnVzUdSngjX5"/>
            <media:group>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/246d8e44-28f2-4069-8e07-02a2348a6187-1080-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/1333b96e-d8e3-439c-be3a-83f89a989096-720-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/fd9b4fa8-9c05-4fb1-b651-f9511f5f74ac-240-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/2863405c-1e00-469b-b3eb-c2290b296c79-144-hls.torrent" isDefault="false"/>
                <media:peerLink type="application/x-bittorrent" href="https://peertube2.cpy.re/lazy-static/torrents/ca757fa9-fa9c-48f9-a4a9-f12899417633-0-hls.torrent" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="1080" fileSize="10376432" url="https://tube.aquilenet.fr/static/streaming-playlists/hls/92498749-90ec-40c9-b8a8-afe0dedbe8ea/7538ec35-9b4d-43e0-be0c-bb82fbb2bbd3-1080-fragmented.mp4" framerate="25" duration="250" isDefault="true"/>
                <media:content type="video/mp4" medium="video" height="720" fileSize="7345715" url="https://tube.aquilenet.fr/static/streaming-playlists/hls/92498749-90ec-40c9-b8a8-afe0dedbe8ea/28458c74-a50a-449b-acde-c5d52bf2ca5f-720-fragmented.mp4" framerate="25" duration="250" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="240" fileSize="5019673" url="https://tube.aquilenet.fr/static/streaming-playlists/hls/92498749-90ec-40c9-b8a8-afe0dedbe8ea/4e523557-ce8f-4498-87d2-efc13e5616d5-240-fragmented.mp4" framerate="25" duration="250" isDefault="false"/>
                <media:content type="video/mp4" medium="video" height="144" fileSize="4710435" url="https://tube.aquilenet.fr/static/streaming-playlists/hls/92498749-90ec-40c9-b8a8-afe0dedbe8ea/326ba847-3bb2-481f-8bff-f39952682b42-144-fragmented.mp4" framerate="25" duration="250" isDefault="false"/>
                <media:content type="audio/mp4" medium="video" height="0" fileSize="4228734" url="https://tube.aquilenet.fr/static/streaming-playlists/hls/92498749-90ec-40c9-b8a8-afe0dedbe8ea/7ca3c49f-3d0f-416d-87bf-4700b7c7ddc1-0-fragmented.mp4" framerate="0" duration="250" isDefault="false"/>
            </media:group>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/previews/83e96efd-0822-46f5-bae2-ee6df743164e.jpg"/>
            <media:thumbnail url="https://peertube2.cpy.re/lazy-static/thumbnails/056b7e02-deec-48b4-bc2b-e2039a7970d2.jpg"/>
            <media:rating>nonadult</media:rating>
            <media:title type="plain">Voilaaa - L'intro</media:title>
            <media:description type="plain">Provided to YouTube by The Orchard Enterprises L'intro · Voilaaa · Bruno Hovart C'est Tout ℗ 2024 Favorite Recordings Released on: 2024-09-27 Music  Publisher: Favorite Recordings SAS Auto-generated by YouTube.</media:description>
        </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
videoChannelId
required
string

Limit listing to a specific video channel

Responses

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 .. 255 ] 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

Responses

Request samples

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

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 .. 255 ] 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

Responses

Request samples

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

Response samples

Content type
application/json
{
  • "id": 42,
  • "state": {
    },
  • "registrationReason": "string",
  • "moderationResponse": "string",
  • "username": "string",
  • "email": "user@example.com",
  • "emailVerified": true,
  • "accountDisplayName": "string",
  • "channelHandle": "string",
  • "channelDisplayName": "string",
  • "createdAt": "2019-08-24T14:15:22Z",
  • "updatedAt": "2019-08-24T14:15:22Z",
  • "user": {
    }
}

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

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 .. 255 ] 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
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

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
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)

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

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

withStats
boolean

include daily view statistics for the last 30 days and total views (only if authentified 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

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 .. 255 ] 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

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
}

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

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,
  • "emailPublic": true,
  • "nsfwPolicy": "display",
  • "nsfwFlagsDisplayed": 0,
  • "nsfwFlagsHidden": 0,
  • "nsfwFlagsWarned": 0,
  • "nsfwFlagsBlurred": 0,
  • "adminFlags": 1,
  • "autoPlayNextVideo": true,
  • "autoPlayNextVideoPlaylist": true,
  • "autoPlayVideo": true,
  • "p2pEnabled": true,
  • "videosHistoryEnabled": true,
  • "videoLanguages": [
    ],
  • "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
}

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)

email
string <email>

The updated email of the user

emailVerified
boolean

Set the email as verified

password
string <password> (password) [ 6 .. 255 ] 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"
}

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

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.

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
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 .. 255 ] 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 .. 255 ] characters
theme
string
videoLanguages
Array of strings

list of languages to filter videos down to

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,
  • "p2pEnabled": true,
  • "autoPlayVideo": true,
  • "autoPlayNextVideo": true,
  • "autoPlayNextVideoPlaylist": true,
  • "videosHistoryEnabled": true,
  • "videoLanguages": [
    ],
  • "language": "string",
  • "theme": "string",
  • "noInstanceConfigWarningModal": true,
  • "noAccountSetupWarningModal": true,
  • "noWelcomeModal": true
}

Get video imports of my user

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

Number of items to return

search
string

Search in video names

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

targetUrl
string

Filter on import target URL

videoChannelSyncId
number

Filter on imports created by a specific channel synchronization

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
videoId
required
integer >= 1
Example: 42

The video id

Responses

Response samples

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

List videos of my user

Authorizations:
OAuth2
query Parameters
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
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

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": [
    ]
}

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
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

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",
  • "isLocal": true,
  • "banners": [
    ],
  • "ownerAccount": {
    }
}

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

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
videoId
required
integer >= 1
Example: 42

object id for the video

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
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

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)

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
Array
Any of
name
string
Value: "cut"
object

Responses

List videos

query Parameters
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

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 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": "Copyrighted - All Rights Reserved"
}

List available video languages

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",
  • "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 (Brazilian)",
  • "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-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
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.

commentsEnabled
boolean
Deprecated

Deprecated in 6.2, use commentsPolicy instead

commentsPolicy
integer (VideoCommentsPolicySet)
Enum: 1 2 3

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

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>

Video preview file

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

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

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": "/lazy-static/thumbnails/a65bc12f-9383-462e-81ae-8207e8b434ee.jpg",
  • "previewPath": "/lazy-static/previews/a65bc12f-9383-462e-81ae-8207e8b434ee.jpg",
  • "embedPath": "/videos/embed/a65bc12f-9383-462e-81ae-8207e8b434ee",
  • "views": 1337,
  • "likes": 42,
  • "dislikes": 7,
  • "comments": 0,
  • "nsfw": true,
  • "nsfwFlags": 0,
  • "nsfwSummary": "string",
  • "waitTranscoding": true,
  • "state": {
    },
  • "scheduledUpdate": {
    },
  • "blacklisted": true,
  • "blacklistedReason": "string",
  • "account": {
    },
  • "channel": {
    },
  • "userHistory": {
    },
  • "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": [
    ],
  • "commentsEnabled": true,
  • "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

Get complete video description

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
"**[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"

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"
}

Set watching progress of a video Deprecated

This endpoint has been deprecated. Use /videos/{id}/views instead

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
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

category
integer (VideoCategorySet)

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

commentsEnabled
boolean
Deprecated

Deprecated in 6.2, use commentsPolicy instead

commentsPolicy
integer (VideoCommentsPolicySet)
Enum: 1 2 3

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

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>

Video preview file

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

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

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

category
integer (VideoCategorySet)

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

commentsEnabled
boolean
Deprecated

Deprecated in 6.2, use commentsPolicy instead

commentsPolicy
integer (VideoCommentsPolicySet)
Enum: 1 2 3

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

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>

Video preview file

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

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

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": [
    ],
  • "commentsEnabled": true,
  • "commentsPolicy": 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.

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

category
integer (VideoCategorySet)

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

commentsEnabled
boolean
Deprecated

Deprecated in 6.2, use commentsPolicy instead

commentsPolicy
integer (VideoCommentsPolicySet)
Enum: 1 2 3

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

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>

Live video/replay preview file

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

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

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
{
  • "filename": "string",
  • "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.

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
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

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
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

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

category
integer (VideoCategorySet)

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

commentsEnabled
boolean
Deprecated

Deprecated in 6.2, use commentsPolicy instead

commentsPolicy
integer (VideoCommentsPolicySet)
Enum: 1 2 3

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

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>

Video preview file

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

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

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

category
integer (VideoCategorySet)

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

commentsEnabled
boolean
Deprecated

Deprecated in 6.2, use commentsPolicy instead

commentsPolicy
integer (VideoCommentsPolicySet)
Enum: 1 2 3

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

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>

Video preview file

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

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

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": [
    ],
  • "commentsEnabled": true,
  • "commentsPolicy": 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.

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

category
integer (VideoCategorySet)

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

commentsEnabled
boolean
Deprecated

Deprecated in 6.2, use commentsPolicy instead

commentsPolicy
integer (VideoCommentsPolicySet)
Enum: 1 2 3

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

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>

Video preview file

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

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

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.

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

category
integer (VideoCategorySet)

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

commentsEnabled
boolean
Deprecated

Deprecated in 6.2, use commentsPolicy instead

commentsPolicy
integer (VideoCommentsPolicySet)
Enum: 1 2 3

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

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>

Video preview file

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

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

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

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

support
any

How to support/fund the channel

Responses

Request samples

Content type
application/json
{
  • "displayName": null,
  • "description": null,
  • "support": null,
  • "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",
  • "isLocal": true,
  • "banners": [
    ],
  • "ownerAccount": {
    }
}

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

support
any

How to support/fund the channel

Responses

Request samples

Content type
application/json
{
  • "displayName": null,
  • "description": null,
  • "support": null,
  • "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
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

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 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

sort
string
Example: sort=-createdAt

Sort column

start
integer >= 0

Offset used to paginate results

withStats
boolean

include daily view statistics for the last 30 days and total views (only if authentified 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

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": [
    ]
}

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

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

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)

header Parameters
x-peertube-video-password
string

Required on password protected video

Responses

Response samples

Content type
application/json
{
  • "comment": {
    },
  • "children": [
    ]
}

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

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
videoId
required
integer >= 1
Example: 42

The video id

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",
  • "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
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)

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": [
    ]
}

Video Ownership Change

List video ownership changes

Authorizations:
OAuth2

Responses

Accept 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 ownership change request

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

The object id, uuid or short uuid

Responses

Request ownership change

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
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)

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
Array
Any of
name
string
Value: "cut"
object

Responses

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

category
integer (VideoCategorySet)

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

commentsEnabled
boolean
Deprecated

Deprecated in 6.2, use commentsPolicy instead

commentsPolicy
integer (VideoCommentsPolicySet)
Enum: 1 2 3

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

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>

Live video/replay preview file

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

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

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

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

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

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

Operation 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": [
    ]
}

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

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

The video password id

Responses

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 not could be not federated by the instance.

Search videos

query Parameters
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

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

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

Responses

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 Blocks

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 account blocks

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

Responses

Block an account

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 its handle

Authorizations:
OAuth2
path Parameters
accountName
required
string

account to unblock, in the form username@domain

Responses

Server Blocks

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 server blocks

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

Responses

Block a 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 its domain

Authorizations:
OAuth2
path Parameters
host
required
string <hostname>

server domain to unblock

Responses

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": [
    ]
}

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

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": "7.3.0-nightly-2025-10-22",
  • "serverCommit": "",
  • "transcoding": {
    },
  • "live": {
    },
  • "videoStudio": {
    },
  • "videoFile": {
    },
  • "videoTranscription": {
    },
  • "import": {
    },
  • "export": {
    },
  • "autoBlacklist": {
    },
  • "avatar": {
    },
  • "banner": {
    },
  • "video": {
    },
  • "videoCaption": {
    },
  • "user": {
    },
  • "videoChannels": {
    },
  • "trending": {
    },
  • "tracker": {
    },
  • "followings": {},
  • "federation": {
    },
  • "broadcastMessage": {
    },
  • "homepage": {
    },
  • "openTelemetry": {
    },
  • "views": {
    },
  • "storyboards": {
    },
  • "webrtc": {
    },
  • "nsfwFlagsSettings": {
    },
  • "fieldsConstraints": {
    },
  • "signup": {
    }
}

Get instance "About" 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": {
    },
  • "followers": {
    },
  • "storyboard": {
    },
  • "defaults": {
    }
}

Set instance runtime configuration

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

Set a cookie so that, the next time the client refreshes the HTML of the web interface, PeerTube will use the next language

Request Body schema: application/json
language
required
string

Language code to set

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.

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.

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.

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

Responses

Request samples

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

Update a plugin

Authorizations:
OAuth2
Request Body schema: application/json
One of
npmName
required
string

Responses

Request samples

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

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,
  • "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

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

Authorizations:
OAuth2

Responses

Response samples

Content type
application/json
[
  • "string"
]

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

Responses

Resume job queue

Authorizations:
OAuth2

Responses

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
Enum: "activitypub-follow" "activitypub-http-broadcast" "activitypub-http-fetcher" "activitypub-http-unicast" "email" "video-transcoding" "video-file-import" "video-import" "videos-views-stats" "activitypub-refresher" "video-redundancy" "video-live-ending" "video-channel-import"

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": [
    ]
}

Runner Registration Token

Manage runner registration token

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

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": {
    }
}

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

Responses

Response samples

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

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": [
    ]
}