Live Streams

StreamDen IPTV Platform is a professional, enterprise-grade streaming solution designed for broadcasters, content creators, and organizations that need reliable live streaming infrastructure.

Core Capabilities

• Multi-Protocol Input - Accept streams from RTSP cameras, HTTP/HTTPS sources, HLS playlists, SRT streams, and RTMP encoders
• Universal HLS Output - All streams are converted to HLS format for maximum compatibility
• Live Transcoding - Real-time video transcoding with quality presets (4K, 1080p, 720p, etc.)
• RTMP Ingest - Receive live streams from OBS Studio, Wirecast, vMix, FFmpeg, and other encoders
• Multi-Platform Restreaming - Simultaneously push to YouTube, Twitch, Facebook Live, and custom RTMP destinations
• Radio Streaming - Full Shoutcast/Icecast server with DJ connections and listener tracking
• Radio Automation - 24/7 automated radio with playlists, scheduling, and crossfade

Supported Input Formats

Output Format

All streams are output as HLS (HTTP Live Streaming) with the following specifications:

• Segment Duration: 2 seconds (configurable)
• Playlist Type: Event (live streaming)
• Codec: H.264 video, AAC audio
• Compatible with: All modern browsers, iOS, Android, Smart TVs, VLC, and media players

Quick Start Guide

Follow these steps to get your first stream running in under 5 minutes:

Navigation

The platform is organized into tabs in the left sidebar:

• Dashboard - System overview and statistics
• Live Streams - Manage video streams from various sources
• RTMP Push - Receive streams from OBS/encoders
• Shoutcast - Manage radio stations
• Radio Automation - Automated radio playlists
• Settings - Platform configuration
• Manual - This documentation

Stream URL Structure

All your streams are available at predictable URLs:

The Dashboard provides a comprehensive real-time overview of your streaming infrastructure with live-updating statistics and performance metrics.

Statistics Cards

System Performance Gauges

• CPU Usage - Server processor utilization. High values (>80%) may indicate need for optimization or fewer concurrent streams
• Memory Usage - RAM consumption. Each stream uses approximately 100-500MB depending on quality
• Upload Speed - Current outgoing network bandwidth (all streams combined)
• Download Speed - Incoming bandwidth from source streams
• System Uptime - Time since last server restart

Quick Actions

From the dashboard, you can quickly:

• View streams that need attention (errors or stopped unexpectedly)
• Monitor overall system health
• Identify bandwidth bottlenecks

The Live Streams section is where you manage video streams from various input sources. Each stream takes a source URL and converts it to HLS format for universal playback.

Creating a Stream

1. Click the "+ New Stream" button
2. Enter a Stream Name (e.g., "News Channel", "Camera 1")
3. Enter the Source URL - supported formats:
   • rtsp://username:password@192.168.1.100:554/stream - RTSP cameras with authentication
   • rtsp://192.168.1.100:554/stream - RTSP without authentication
   • http:// or https:// - HTTP/HTTPS streams
   • https://example.com/stream.m3u8 - HLS playlists
   • srt://source.example.com:9000 - SRT streams
   • rtmp://server.com/live/key - RTMP sources
4. (Optional) Enable transcoding for quality adjustment
5. (Optional) Add RTMP Push URL to restream externally
6. Click "Create Stream"

Stream Controls

Stream Status Indicators

• Running - Stream is active and serving content
• Stopped - Stream is configured but not running
• Error - Stream failed (check source URL or logs)
• Starting - Stream is initializing FFmpeg

Bulk Operations

• Start All - Start all stopped streams simultaneously
• Stop All - Stop all running streams
• Refresh - Reload stream list from database

Output URL Format

Where {id} is the stream's numeric ID shown in the interface.

Testing Your Stream

You can test HLS streams with:

• Built-in Player - Click the preview button in the stream row
• VLC Media Player - Media → Open Network Stream → paste URL
• FFplay - ffplay "https://your-domain/streams/stream_1/playlist.m3u8"
• Web Browser - Safari plays natively; Chrome/Firefox with HLS.js

Transcoding allows you to convert video from one format/quality to another. By default, streams are copied without transcoding (passthrough) which is faster and uses less CPU.

When to Use Transcoding

• Reduce bandwidth - Lower the bitrate for limited connections
• Change resolution - Scale 4K to 1080p or 720p
• Fix compatibility - Convert non-standard codecs to H.264/AAC
• Normalize frame rate - Convert variable FPS to constant

Enabling Transcoding

1. When creating or editing a stream, check "Enable Transcoding"
2. Choose a Quality Preset or configure custom settings
3. The transcoding options panel will appear

Quality Presets

Custom Settings

When selecting "Custom" preset, you can configure:

• Width/Height - Output resolution in pixels (e.g., 1920x1080)
• Video Bitrate - Target bitrate in kbps (higher = better quality, more bandwidth)
• Frame Rate - Frames per second (15-60 fps)
• Audio Bitrate - Audio quality in kbps (64-320 kbps)

Bandwidth Estimation

RTMP Push allows you to receive live streams from external encoders like OBS Studio, Wirecast, vMix, or any software that supports RTMP output. This is the reverse of typical streaming - instead of pulling a source, the encoder pushes to your server.

How It Works

OBS Studio Setup

1. Open OBS Studio
2. Go to Settings → Stream
3. Set Service to "Custom..."
4. Server: rtmp://your-domain.com:1935/live/
5. Stream Key: Your unique stream key (e.g., mystream)
6. Click OK to save
7. Click "Start Streaming" in OBS main window

Wirecast Setup

1. Open Wirecast → Output → Output Settings
2. Add a new RTMP destination
3. Address: rtmp://your-domain.com:1935/live/streamkey
4. Click "Start/Stop Broadcasting"

FFmpeg Command Line

Output URL Format

Port Requirements

Restreaming allows you to simultaneously push your streams to external platforms like YouTube Live, Twitch, Facebook Live, or any RTMP-compatible destination.

Setting Up Restreaming

1. Create or edit a stream in the Live Streams tab
2. Find the RTMP Push URL field
3. Paste your destination RTMP URL (from YouTube/Twitch/etc.)
4. Save and start the stream

Platform-Specific Settings

YouTube Live

1. Go to YouTube Studio → Go Live
2. Copy the Stream URL and Stream Key
3. Combine them: rtmp://a.rtmp.youtube.com/live2/YOUR-STREAM-KEY
4. Paste into the RTMP Push URL field

Twitch

1. Go to Twitch Dashboard → Settings → Stream
2. Copy your Primary Stream Key
3. Use: rtmp://live.twitch.tv/app/YOUR-STREAM-KEY

Facebook Live

1. Go to Facebook Creator Studio → Live Dashboard
2. Copy the Server URL and Stream Key
3. Combine: rtmps://live-api-s.facebook.com:443/rtmp/YOUR-STREAM-KEY

Custom RTMP Server

Multi-Platform Streaming

To stream to multiple platforms simultaneously:

1. Create separate streams with the same source URL
2. Each stream pushes to a different RTMP destination
3. All streams share the same input but output to different platforms

Create and manage professional internet radio stations using Shoutcast/Icecast technology. Each station runs independently and can have its own DJ connections and listeners.

Creating a Radio Station

1. Go to the Shoutcast tab
2. Click "+ New Station"
3. Configure station settings:
   • Station Name - Display name for listeners
   • Port - Unique port (8000, 8010, 8020, etc.)
   • DJ Password - Password for broadcasters to connect
   • Admin Password - Password for administration
   • Genre - Music genre (Pop, Rock, Jazz, etc.)
   • Bitrate - Audio quality (64, 128, 192, 256, 320 kbps)
4. Click "Create Station"

Bitrate Recommendations

Connecting with Broadcasting Software

BUTT (Broadcast Using This Tool)

1. Download BUTT from danielnoethen.de/butt
2. Settings → Main → Add Server
3. Type: Icecast
4. Address: your-domain.com
5. Port: Your station port
6. Password: Your DJ password
7. Mount: /stream
8. Click "Play" to start broadcasting

SAM Broadcaster

1. Encoders → Add → Shoutcast
2. Server IP: your-domain.com
3. Port: Your station port
4. Password: Your DJ password
5. Enable encoder to start

Listener URLs

Embedding in Websites

Radio Automation enables 24/7 unattended broadcasting with playlists, scheduling, and Auto DJ functionality. Perfect for running a radio station without constant manual intervention.

Key Features

• Playlist Management - Create unlimited playlists for different shows/times
• Scheduling - Schedule playlists for specific days and times
• Auto DJ - Automatic track selection and playback
• Crossfade - Smooth transitions between tracks (configurable duration)
• Shuffle - Random track order within playlists
• Intro/Outro - Station jingles between tracks

Creating a Playlist

1. Go to the Radio Automation tab
2. Click "+ Create Playlist"
3. Enter playlist name (e.g., "Morning Show", "Jazz Nights")
4. Click "Add Tracks" to upload or select audio files
5. Drag and drop to reorder tracks
6. Save the playlist

Supported Audio Formats

• MP3 (.mp3) - Most common, recommended
• AAC (.aac, .m4a) - Better quality at same bitrate
• OGG Vorbis (.ogg) - Open format
• FLAC (.flac) - Lossless audio
• WAV (.wav) - Uncompressed audio

Auto DJ Settings

• Crossfade Duration - Overlap time between tracks (0-10 seconds)
• Repeat Mode - Loop playlist when finished
• Shuffle Mode - Randomize track order
• Priority Queue - Insert urgent tracks immediately

Scheduling Shows

1. Go to Schedule section
2. Click on a time slot in the calendar
3. Select a playlist to assign
4. Set repeat options (daily, weekly, one-time)
5. Save the schedule

The built-in video player allows you to preview streams directly in the CMS interface. It uses HLS.js for broad browser compatibility.

Using the Preview Player

1. Find your stream in the Live Streams list
2. Click the Preview button (play icon)
3. The video player modal will open
4. Click play or wait for auto-play

Player Controls

Embedding Streams on External Websites

Use this code to embed your HLS stream on any website:

Testing with External Players

• VLC - Media → Open Network Stream → paste HLS URL
• FFplay - ffplay "https://domain/streams/stream_1/playlist.m3u8"
• mpv - mpv "https://domain/streams/stream_1/playlist.m3u8"

Configure your streaming platform settings, manage licenses, and view system information.

Server Configuration

• Hostname - Your server's domain name (e.g., stream.example.com)
• HTTP Port - Web server port (default: 3000)
• RTMP Port - RTMP server port (default: 1935)

SSL/TLS Configuration

HTTPS is required for secure streaming and is mandatory for embedding on HTTPS websites.

• Let's Encrypt - Automatic free SSL certificate generation
• Custom Certificate - Upload your own SSL certificate and key

License Management

System Options

• Debug Mode - Enable detailed logging for troubleshooting
• Auto Restart - Automatically restart failed streams
• Log Retention - Number of days to keep log files
• HLS Segment Duration - Length of each HLS segment (default: 2 seconds)
• HLS Playlist Size - Number of segments in playlist (default: 5)

Backup & Restore

• Export Configuration - Download settings as JSON
• Import Configuration - Restore settings from backup
• Database Backup - Export stream configurations

SSL certificates enable HTTPS for secure streaming. This is required for embedding streams on HTTPS websites and is recommended for all production deployments.

Why SSL is Important

• Security - Encrypts data between viewers and server
• Mixed Content - HTTPS pages cannot load HTTP streams
• Browser Trust - Modern browsers warn about non-HTTPS sites
• SEO - Search engines prefer HTTPS sites

Option 1: Let's Encrypt (Recommended)

1. Go to Settings → SSL
2. Enter your domain name
3. Click "Generate Certificate"
4. Wait for automatic verification and certificate generation
5. Certificate auto-renews every 60 days

Option 2: Custom Certificate

1. Obtain SSL certificate from your CA (DigiCert, Comodo, etc.)
2. Go to Settings → SSL → Custom Certificate
3. Upload your certificate file (.crt or .pem)
4. Upload your private key file (.key)
5. Click "Install Certificate"

Requirements for Let's Encrypt

• Domain must point to this server (DNS A record)
• Port 80 must be accessible from internet
• No firewall blocking HTTP validation

Troubleshooting SSL

The platform provides a RESTful API for programmatic control of streams and configuration.

Base URL

Stream Endpoints

Example: List All Streams

Example: Create Stream

Example: Start Stream

Example: Stop Stream

System Endpoints

Response Format

All responses are JSON with the following structure:

Stream Won't Start

RTMP Connection Failed

High CPU Usage

• Too many transcoding streams - Disable transcoding where not needed
• High resolution output - Lower quality preset (720p instead of 1080p)
• Complex source - Some codecs are more CPU-intensive to decode
• Insufficient hardware - Consider upgrading server or using GPU encoding

CPU guidelines per stream:

• Passthrough (no transcoding): ~1-2% CPU
• 720p transcoding: ~15-25% CPU
• 1080p transcoding: ~30-50% CPU
• 4K transcoding: ~80-100% CPU

Stream Buffering / Playback Issues

• Check source stability - Test source URL directly with VLC
• Network bandwidth - Ensure upload > total stream bitrate
• HLS latency - Normal latency is 10-30 seconds for HLS
• Player issues - Try different player (VLC, FFplay)

Audio/Video Sync Issues

• Enable transcoding and let FFmpeg re-sync A/V
• Check if source has stable frame rate
• Try different quality preset

SSL/HTTPS Problems

• Certificate not generating - Check DNS points to server, port 80 open
• Mixed content - All resources must use HTTPS
• Certificate expired - Regenerate or renew certificate

Useful Diagnostic Commands

Log File Locations

Speed up your workflow with these keyboard shortcuts:

Navigation

Stream Controls

Video Player

General