PeerTube Plugin — Odysee Player

Embed and manage unlisted Odysee videos directly inside PeerTube with full episode management.

Features

• ▶ Embed unlisted Odysee videos via iframe
• ✏ Manually set title, description, thumbnail per episode
• 🔢 Custom episode numbering (pick any number)
• 🗑 Delete episodes from admin panel
• 📄 Episode pagination below the video (6 per page)
• ✨ Active episode card is highlighted for both admin and users

Folder Structure

peertube-plugin-odysee-player/ ├── index.js ← Plugin entry point ├── package.json ← Plugin manifest ├── server/ │ └── plugin.js ← API routes (get/add/delete episodes) └── client/ ├── client-plugin.js ← Admin panel + player UI └── styles.css ← All styles

Installation

Option 1 — Install from folder (Development)

1. Copy the entire peertube-plugin-odysee-player folder into your PeerTube plugins directory:

   /var/www/peertube/storage/plugins/

2. Inside the folder, run:

   npm install

3. In PeerTube Admin → Plugins/Themes → Install → select the plugin.

Option 2 — Publish to npm then install via PeerTube UI

1. Run npm publish from inside the plugin folder.
2. In PeerTube Admin → Plugins/Themes → search peertube-plugin-odysee-player → Install.

How to Use

Admin Panel

1. Go to Admin → Plugins → Odysee Player → Settings
2. Click ⚙ Manage Episodes tab
3. Fill in:
   • Episode Number — any number you choose (e.g. 1, 5, 12)
   • Title — episode title
   • Description — optional
   • Thumbnail URL — optional image URL
   • Odysee Embed ID — from the Odysee embed URL: https://odysee.com/$/embed/THIS_IS_THE_EMBED_ID
4. Cl+ Add Episodede**
5. To delete, click 🗑 next to any episode

Player Preview

Cl▶ Preview Playerer** tab to see how it looks for users.

Odysee Embed ID

To get the embed ID of an unlisted Odysee video:

1. Open your video on Odysee

2. ClSharere*Embeded**

3. Copy the URL from the iframe src:

   https://odysee.com/$/embed/my-video-title:abc123hash

4. The embed ID is: my-video-title:abc123hash

License

MIT