📘 O11 v4 OTT Streamer: Full Command-Line Options Reference & Usage Guide
O11 v4 OTT Streamer includes a rich set of CLI (command-line interface) options that let you customize how the service behaves, debugs, logs, and processes content. This guide explains each -h option available from the binary ./o11v4 -h, offering advanced control for system administrators, IPTV engineers, and DRM developers.
🔧 General Configuration Flags
| Flag |
Description |
-c |
Load custom config file path. |
-path |
Set working directory (default: current directory). All internal paths are built from this. |
-password |
Set a static admin password. Useful in headless or automation setups. |
-user |
Set a static admin username. |
-noautostart |
Prevent channels from starting automatically. Manual start only. |
-noramfs |
Allow using FFMpeg even if RAMFS is not mounted at ./hls/live. |
-keep |
Don’t delete temporary media files (mainly for debugging). |
-novodmetadata |
Disable metadata for VOD files (faster, less accurate). |
-replaymode |
Set replay mode (e.g., ffmpeg, internalremuxer) for test streams. |
-replay |
Provide path to replay a local stream from hls/live/. |
-defaultprovid |
Use as default provider ID when not specified in config. |
🌐 Networking & Server Options
| Flag |
Description |
-p |
Port for HTTP server (default: 4000). |
-b |
Bind IP for HTTP server. |
-https |
Enable HTTPS. Requires server.crt and server.key in current directory. |
-baseurl |
Public base URL used in stream manifests and playlists. |
-streamport |
Set streaming port. Overrides default HTTP if needed. |
-streambind |
Bind address for streaming service. |
-epgbind |
Bind IP for EPG grabber. |
-epgport |
Port for EPG grabber. |
🔐 Security & Access
| Flag |
Description |
-jwtsecret |
Set JWT secret manually. If not set, it’s randomly generated at boot. |
-allow |
Comma-separated list of IPs that can access panel without login. |
-headless |
Disable UI – run panel in API/CLI only mode. Useful for embedded or restricted deployments. |
🛠️ Logging & Debugging
| Flag |
Description |
-logtomain |
Send all stream logs to the main log file. |
-logtomainonly |
Disable individual logs – log everything to main log only. |
-stdout |
Print logs to STDOUT instead of file. |
-logsize |
Max log file size (MB). Rotate after this limit. |
-logscount |
Number of rotated logs to keep. |
-v |
Global log level (0 = error, 5 = trace). Default is 2 (info). |
-V |
Enable module-specific logs, e.g. subtitles. |
-debugspeed |
Print real-time fragment download queue per channel. |
📺 Stream/Playlist Control
| Flag |
Description |
-plstreamname |
Format for stream names in playlists. %p = provider, %s = stream name. |
-providers |
Set provider configuration folder. Default is providers/. |
-rec |
File to track recordings. |
-flushperiod |
Time between writing config/keys to disk (in seconds). Use 0 to disable. |
-tsplay |
Path to tsplay for UDP outputs. |
🎞️ VOD Download & DRM Decryption
| Flag |
Description |
-manifest |
Convert VOD manifest to MP4 and exit. |
-video |
Select video index. |
-audio |
Audio indexes to grab (comma separated). |
-subs |
Subtitle indexes or 'all'. |
-extrasubs |
Add external subtitle files (repeatable). |
-key |
Provide KID:KEY pairs for manual DRM decryption. |
-keys |
Path to list of keys. Used when KID not found in config. |
-cdmmode |
Set CDM mode (internal or external). |
-cdmtype |
DRM type: widevine, playready, or verimatrix. |
-usecdm |
Use CDM decryption scripts. |
-doh |
Set custom DNS-over-HTTPS resolver URL. |
-script |
CDM script filename. |
-cdmparams |
Parameters for the CDM script. |
-H |
Custom header for VOD HTTP requests (key:value). Repeatable. |
-maxsegments |
Limit number of segments to download (useful for testing). |
🔄 Advanced Output
| Flag |
Description |
-pipeoutputcmd |
Pipe output command (e.g., for post-processing or external muxers). |
By understanding these CLI options, you can customize O11 v4 for your exact use case — whether it's headless deployment, automated decryption, live stream control, or advanced VOD processing.
This reference is part of our ongoing O11 documentation series. Stay tuned for more insights on automation, scripting, and DRM integration with this powerful OTT platform.