secubox-openwrt/package/secubox/secubox-app-peertube/README.md

SecuBox PeerTube

Federated video streaming platform running in an LXC Debian container.

Features

• PeerTube Instance: Self-hosted video platform with ActivityPub federation
• Video Import: Import videos from YouTube, Vimeo, and 1000+ sites via yt-dlp
• Multi-Track Subtitles: Automatic subtitle download and sync in multiple languages
• Video Analysis: Transcript extraction and Claude AI analysis (peertube-analyse)
• Live Streaming: RTMP ingest with HLS output

Components

Component	Description
peertubectl	Main control script for container management
peertube-import	Video import with subtitle sync
peertube-analyse	Transcript extraction and AI analysis

Video Import

Import videos from external platforms with automatic subtitle synchronization.

CLI Usage

# Basic import
peertube-import https://youtube.com/watch?v=xxx

# Import with multiple subtitle languages
peertube-import --lang fr,en,de,es https://youtube.com/watch?v=xxx

# Import as unlisted video
peertube-import --privacy 2 https://youtube.com/watch?v=xxx

# Import to specific channel
peertube-import --channel 2 https://vimeo.com/xxx

Options

Option	Description	Default
--lang <codes>	Subtitle languages (comma-separated)	fr,en
--channel <id>	PeerTube channel ID	1
--privacy <level>	1=public, 2=unlisted, 3=private	1
--output <dir>	Temp directory for downloads	/tmp/peertube-import
--peertube <url>	PeerTube instance URL	from UCI config

Portal Integration

Access via SecuBox Portal → Intelligence & Analyse → Video Import

The portal provides:

• URL input for video source
• Language selection checkboxes
• Privacy level selector
• Real-time progress tracking
• Direct link to imported video

CGI Endpoints

# Start import job
curl -X POST http://192.168.255.1/cgi-bin/peertube-import \
  -H "Content-Type: application/json" \
  -d '{"url":"https://youtube.com/watch?v=xxx","languages":"fr,en"}'

# Response: {"success": true, "job_id": "import_xxx"}

# Check status
curl "http://192.168.255.1/cgi-bin/peertube-import-status?job_id=import_xxx"

# Response (in progress):
# {"status": "downloading", "progress": 45, "job_id": "import_xxx"}

# Response (completed):
# {"success": true, "video_url": "https://tube.example.com/w/uuid"}

Configuration

UCI config file: /etc/config/peertube

config peertube 'main'
    option enabled '1'
    option data_path '/srv/peertube'

config peertube 'server'
    option hostname 'tube.example.com'
    option port '9001'
    option https '1'

config peertube 'admin'
    option username 'root'
    option password 'changeme'

config peertube 'transcoding'
    option enabled '1'
    option threads '2'
    list resolutions '480p'
    list resolutions '720p'

Dependencies

• lxc, lxc-common - Container runtime
• wget-ssl - HTTPS downloads
• tar, jsonfilter - Archive and JSON handling
• yt-dlp - Video download (pip install)
• node - JavaScript runtime for yt-dlp (opkg install)

Supported Import Sources

yt-dlp supports 1000+ sites including:

• YouTube, YouTube Music
• Vimeo
• Dailymotion
• Twitch (VODs)
• Twitter/X
• TikTok
• And many more...

See: https://github.com/yt-dlp/yt-dlp/blob/master/supportedsites.md

Version

• Package: 1.2.0
• yt-dlp: 2026.2.4 (recommended)
• Node.js: 20.20.0 (for YouTube JS runtime)