7bfaa4a2d0
- reorganize help - switch back to beta version - add docs for closed cations - unify playlist/playlist-root argument - colorize ads - add vtt_* to update config handler - update packages - add -muxpreload 0 and -muxdelay 0 to default settings
24 lines
1.4 KiB
Markdown
24 lines
1.4 KiB
Markdown
## Closed Captions
|
||
|
||
#### Note:
|
||
**This is only an _experimental feature_. Please be aware that bugs and unexpected behavior may occur. To utilize this feature, a [special patched](https://github.com/jb-alvarado/compile-ffmpeg-osx-linux) version of FFmpeg is required. Importantly, there is currently no official support for this functionality.**
|
||
|
||
### Usage
|
||
**ffplayout** can handle closed captions in WebVTT format for HLS streaming.
|
||
|
||
The captions can be embedded in the file, such as in a [Matroska](https://www.matroska.org/technical/subtitles.html) file, or they can be a separate *.vtt file that shares the same filename as the video file. In either case, the processing option **vtt_enable** must be enabled, and the path to the **vtt_dummy** file must exist.
|
||
|
||
To encode the closed captions, the **hls** mode needs to be enabled, and specific output parameters must be provided. Here’s an example:
|
||
|
||
```
|
||
-c:v libx264 -crf 23 -x264-params keyint=50:min-keyint=25:scenecut=-1 \
|
||
-maxrate 1300k -bufsize 2600k -preset faster -tune zerolatency \
|
||
-profile:v Main -level 3.1 -c:a aac -ar 44100 -b:a 128k -flags +cgop \
|
||
-muxpreload 0 -muxdelay 0 -f hls -hls_time 6 -hls_list_size 600 \
|
||
-hls_flags append_list+delete_segments+omit_endlist \
|
||
-var_stream_map v:0,a:0,s:0,sgroup:subs,name:English,language:en-US,default:YES \
|
||
-master_pl_name master.m3u8 \
|
||
-hls_segment_filename \
|
||
live/stream-%d.ts live/stream.m3u8
|
||
```
|