rtp2httpd.conf

#RTP2HTTPD Config file

# All blank lines and lines starting with # or ; are ignored
[global]
#GLOBAL OPTIONS
#These options can be overrided by command-line switches

#VERBOSITY: 0-quiet 1-error 2-warn 3-info 4-debug (default 1)
verbosity = 1

# Access log file path (default none, disabled)
;access-log = /tmp/rtp2httpd-access.log

# Access log format (nginx-style $variables)
;log-format = $client_addr [$time_iso8601] "$service_url" $service_type "$upstream_url"

# Supervisor PID file path (default none, disabled)
# The supervisor locks this file, writes its PID, and removes it on graceful exit.
# Relative paths are resolved from the process working directory.
;pid-file = /var/run/rtp2httpd.pid

#maximum paralell clients (default 5)
;maxclients = 5

# UDPxy URL compatibility (default yes)
;udpxy = yes

# Worker processes (default 1)
;workers = 1

# Hostname to check in the Host: HTTP header (default none)
;hostname = somehost.example.com

# When enabled, uses HTTP X-Forwarded-For header as client address for status page display (default: no)
# Only enable when running behind a reverse proxy
;xff = no

# Authentication token for HTTP requests (default none)
# When set, all HTTP requests must include r2h-token query parameter with matching value
;r2h-token = your-secret-token-here

# Status page path (default: /status)
;status-page-path = /status

# Player page path (default: /player)
;player-page-path = /player

# Public path prefix for all HTTP resources (default: none)
# Use this when a reverse proxy forwards a prefix like /app/rtp2httpd
# without stripping it
;app-path-prefix = /app/rtp2httpd

# Use root-relative paths in generated and rewritten M3U playlists (default: no)
# When enabled, playlist URLs omit the http://host prefix and start with / or app-path-prefix
;use-relative-path-in-m3u = no

# Interface configuration for upstream media streams
# Default interface for all upstream traffic (lowest priority, used when specific interface not set)
;upstream-interface = iptv

# Specific interfaces (override upstream-interface when set)
# Interface for multicast (RTP/UDP) traffic
;upstream-interface-multicast = iptv
# Interface for FCC unicast traffic
;upstream-interface-fcc = iptv
# Interface for RTSP unicast traffic
;upstream-interface-rtsp = iptv
# Interface for HTTP proxy traffic
;upstream-interface-http = iptv

# Priority: upstream-interface-{multicast,fcc,rtsp,http} > upstream-interface > routing table

# External M3U Configuration
# Fetch M3U playlist from a URL (file://, http://, https:// supported)
# Note: HTTP/HTTPS fetching requires 'curl' command to be installed
;external-m3u = https://example.com/playlist.m3u
# or use a local file
;external-m3u = file:///path/to/playlist.m3u

# External M3U update interval in seconds (default 7200 = 2 hours)
# Set to 0 to disable automatic updates, or a positive value for custom interval
;external-m3u-update-interval = 7200

# Multicast rejoin interval in seconds (default 0, disabled)
# Set to a positive value (e.g., 60) to periodically rejoin multicast groups
# This is a compatibility workaround for networks with:
# - IGMP snooping switches that timeout without proper IGMP Query from router
# - Misconfigured network equipment that drops multicast membership
# Recommended value: 30-120 seconds (less than typical switch timeout of 260s)
# Only enable if you experience multicast stream interruptions
;mcast-rejoin-interval = 0

# Local UDP port range for FCC client sockets (format: start-end, default random ports)
;fcc-listen-port-range = 40000-40100

# Maximum number of buffers in buffer pool (default 16384)
# Each buffer is 1536 bytes, so 16384 buffers = 24MB memory
# Increase this value to improve throughput for multi-client concurrency
;buffer-pool-max-size = 16384

# UDP socket receive buffer size in bytes (default 524288 = 512KB)
# Applies to multicast, FCC, and RTSP RTP/RTCP sockets.
# For 4K IPTV streams at ~30 Mbps, 512KB provides ~140ms of buffering.
# Increase to reduce packet loss on high-bandwidth streams.
# The actual buffer size may be limited by kernel parameter net.core.rmem_max.
;udp-rcvbuf-size = 524288

# Override User-Agent header for upstream HTTP proxy requests (default: disabled)
# When set, this value replaces the client User-Agent header sent to upstream /http/ targets
;http-proxy-user-agent = rtp2httpd-http-proxy/1.0

# User-Agent header used for upstream RTSP requests (default: rtp2httpd/<version>)
;rtsp-user-agent = rtp2httpd/custom

# STUN server for RTSP NAT traversal (default: disabled)
# When RTSP server only supports UDP transport and client is behind NAT,
# try using STUN for NAT traversal (may not always succeed)
# Format: host:port or host (default port 3478)
# Example: stun.miwifi.com or stun.miwifi.com:3478
;rtsp-stun-server = stun.miwifi.com

# CORS cross-origin request configuration (default: disabled)
# When set, enables CORS and automatically handles OPTIONS preflight requests
# Set to * to allow all origins, or specify a domain (e.g., https://example.com)
;cors-allow-origin = *

# Enable video snapshot feature (default: no)
# Set to 1, yes, true, or on to enable; otherwise 0 (disabled)
# When enabled, allows clients to request video snapshots with `snapshot=1` query parameter
;video-snapshot = no

# FFmpeg executable path (default: ffmpeg, which uses system PATH)
# Specify full path if ffmpeg is not in PATH or you want to use a specific version
;ffmpeg-path = /usr/bin/ffmpeg

# Additional FFmpeg arguments (default: -hwaccel none)
# These arguments are passed to ffmpeg when generating snapshots
# Common options: -hwaccel none, -hwaccel auto, -hwaccel vaapi, -hwaccel qsv
;ffmpeg-args = -hwaccel none

[bind]
#List of TCP address/ports or Unix socket paths to bind to, eg.
;mybox.example.net 5140
;mybox2.example.net 8000
;2001::1 http-alt
;/var/run/rtp2httpd.sock

#Note that binding to port number < 1024 will
#require root privelegies and therefore is
#not recommended. (Dropping privilegies is
#not implemeted at this moment)

#below is default - all addresses, port 5140
* 5140

[services]
# Instead of using external-m3u, you can also write M3U content directly below, starting with #EXTM3U header
# Example:
;#EXTM3U x-tvg-url="https://example.com/epg.xml.gz"
;#EXTINF:-1 tvg-id="CCTV1" tvg-name="CCTV1" tvg-logo="https://example.com/logo/CCTV1.png" group-title="央视" catchup="default" catchup-source="rtsp://10.0.0.50:554/catchup?playseek={utc:YmdHMS}-{utcend:YmdHMS}",CCTV-1
;rtp://239.253.64.120:5140
;#EXTINF:-1 tvg-id="CCTV2" tvg-name="CCTV2" group-title="央视",CCTV-2
;rtp://239.253.64.121:5140
;#EXTINF:-1,广东卫视
;rtp://239.194.10.15:1234