PluginPeerTube
This wiki plugin embeds a PeerTube video in a Tiki page.
It uses PeerTube’s oEmbed under the hood but exposes familiar Tiki parameters.
Available since Tiki 30.x.
Parameters
Embed a PeerTube video (uses oEmbed under the hood).
Introduced in Tiki 30.x. Required parameters are in bold.
Go to the source code
Required preferences: wikiplugin_peertube and feature_peertube.
| Parameter | Accepted values | Description | Default | Since |
url | url | Full watch URL of the PeerTube video (e.g., https://videos.example.com/w/abc123xyz) | Tiki 30.x | |
height | digits | Height in pixels (e.g., 315). Leave empty to use provider dimensions | Tiki 30.x | |
width | digits | Width in pixels (e.g., 560). Leave empty to use provider dimensions | Tiki 30.x | |
start | digits | Start time offset in seconds | 0 | Tiki 30.x |
privacyEnhanced | y / n | Enable “privacy-enhanced” mode (if supported by the provider) | Tiki 30.x | |
bg | text | Container background color. Examples: #ffffff, rgb(255,255,255), white | Tiki 30.x | |
allowFullScreen | y / n | Allow full-screen playback | y | Tiki 30.x |
borderRadius | y / n | Apply rounded corners to the container | y | Tiki 30.x |
border | text | Container border color. Examples: #ffffff, rgb(255,255,255), white | Tiki 30.x |
Show a video
Examples of using the PeerTube plugin:
Minimal
Copy to clipboard
{peertube url="https://videos.example.com/w/abc123xyz"}
With display options
Copy to clipboard
{peertube url="https://videos.example.com/w/abc123xyz" width="560" height="315" allowFullScreen="y" bg="#000000" border="#ff0000" borderRadius="y" start="30" }
Important notes
- Always use the full watch URL (the …/w/shortUUID form).
- Private/Internal videos may not embed due to instance privacy policy.
- If
width/-+height+- are empty, Tiki uses the default responsive dimensions returned by oEmbed. -
bg,border, andborderRadiusstyle the container (not the remote player UI).
Known limitations
- No automatic oEmbed discovery: you must provide a valid PeerTube watch URL.
- Works if the PeerTube instance exposes an oEmbed endpoint and allows iframe embedding.
To do (ideas)
- Add smarter URL discovery.
- Regularly test against multiple PeerTube instances/versions.