metabuilder/services/media_daemon/README.md

MetaBuilder Media Daemon

A C++ Docker daemon for media processing, radio streaming, and TV channel simulation with a modular plugin architecture.

Features

🎬 Job Queue System

• Video transcoding (H.264, H.265, VP9, AV1)
• Audio transcoding (MP3, AAC, FLAC, Opus)
• Document conversion (PDF, Office formats)
• Image processing (resize, convert, optimize)
• Priority queuing with configurable workers

📻 Radio Streaming

• Live audio streaming with multiple quality levels
• Playlist scheduling and auto-DJ
• Crossfading and audio normalization
• Metadata injection (artist, title, album art)
• Icecast/Shoutcast compatible output

📺 TV Channel Simulation

• Multi-channel scheduling system
• EPG (Electronic Program Guide) generation
• Bumpers, commercials, and interstitials
• Live-to-VOD and VOD-to-Live workflows
• HLS/DASH output for web players

🔌 Plugin Architecture

• Dynamic plugin loading (.so/.dll)
• Hot-reload support in development mode
• Plugin API for custom processors
• Built-in plugins: FFmpeg, ImageMagick, Pandoc

🔗 DBAL Integration

• Job status notifications to users
• Progress tracking in real-time
• User permission checks
• Multi-tenant isolation

Architecture

┌─────────────────────────────────────────────────────────────┐
│                    Media Daemon                              │
├─────────────────────────────────────────────────────────────┤
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         │
│  │  HTTP API   │  │  WebSocket  │  │   gRPC      │         │
│  │  (Drogon)   │  │  (Live)     │  │  (Internal) │         │
│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘         │
│         └────────────────┼────────────────┘                 │
│                          ▼                                  │
│  ┌───────────────────────────────────────────────────────┐ │
│  │                   Core Engine                          │ │
│  │  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐  │ │
│  │  │ Job     │  │ Radio   │  │ TV      │  │ Plugin  │  │ │
│  │  │ Queue   │  │ Engine  │  │ Engine  │  │ Manager │  │ │
│  │  └────┬────┘  └────┬────┘  └────┬────┘  └────┬────┘  │ │
│  └───────┼────────────┼────────────┼────────────┼───────┘ │
│          └────────────┴────────────┴────────────┘          │
│                          ▼                                  │
│  ┌───────────────────────────────────────────────────────┐ │
│  │                  Plugin System                         │ │
│  │  ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐         │ │
│  │  │FFmpeg  │ │ImageMag│ │Pandoc  │ │Custom  │         │ │
│  │  │Plugin  │ │Plugin  │ │Plugin  │ │Plugins │         │ │
│  │  └────────┘ └────────┘ └────────┘ └────────┘         │ │
│  └───────────────────────────────────────────────────────┘ │
│                          ▼                                  │
│  ┌───────────────────────────────────────────────────────┐ │
│  │              DBAL Client (Notifications)               │ │
│  └───────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘

Quick Start

# Build
docker build -t metabuilder/media-daemon -f Dockerfile .

# Run
docker run -d \
  -p 8090:8090 \
  -v /media:/data/media \
  -e DBAL_URL=http://dbal:8080 \
  metabuilder/media-daemon

API Endpoints

Job Queue

• POST /api/jobs - Submit a new job
• GET /api/jobs/:id - Get job status
• GET /api/jobs - List jobs (filtered by user/tenant)
• DELETE /api/jobs/:id - Cancel a job

Radio

• POST /api/radio/channels - Create radio channel
• GET /api/radio/channels/:id/stream - Get stream URL
• POST /api/radio/channels/:id/playlist - Update playlist
• GET /api/radio/channels/:id/now-playing - Current track info

TV Channels

• POST /api/tv/channels - Create TV channel
• GET /api/tv/channels/:id/schedule - Get EPG
• POST /api/tv/channels/:id/schedule - Update schedule
• GET /api/tv/channels/:id/stream.m3u8 - HLS playlist

Plugins

• GET /api/plugins - List loaded plugins
• POST /api/plugins/:id/reload - Hot-reload plugin (dev mode)

Configuration

See config/media-daemon.yaml for full configuration options.