mediaforge - v2.2.0
    Preparing search index...

    Interface HlsOptions

    interface HlsOptions {
        input: string;
        outputDir: string;
        playlistName?: string;
        segmentDuration?: number;
        segmentFilename?: string;
        hlsListSize?: number;
        videoCodec?: string;
        videoBitrate?: string;
        audioCodec?: string;
        audioBitrate?: string;
        hlsFlags?: string;
        hlsVersion?: number;
        gopSize?: number;
        forceKeyFrames?: string;
        crf?: number;
        movflags?: string;
        hlsKeyInfoFile?: string;
        binary?: string;
    }
    Index

    Properties

    input: string

    Input file path

    outputDir: string

    Output directory for HLS segments. Must exist.

    playlistName?: string

    Playlist filename. Default: 'playlist.m3u8'

    segmentDuration?: number

    Segment duration in seconds. Default: 6

    segmentFilename?: string

    Segment filename pattern. Default: 'segment%03d.ts'

    hlsListSize?: number

    Number of segments to keep in playlist. 0=all. Default: 0

    videoCodec?: string

    Video codec. Default: 'libx264'

    videoBitrate?: string

    Video bitrate. Default: '2M'

    audioCodec?: string

    Audio codec. Default: 'aac'

    audioBitrate?: string

    Audio bitrate. Default: '128k'

    hlsFlags?: string

    HLS flags (comma-separated). Common: 'delete_segments', 'append_list', 'split_by_time'

    hlsVersion?: number

    HLS protocol version to write (-hls_version), 3-8.

    This is a top-level hls-muxer option, NOT an hls_flags entry — passing hls_version=3 via hlsFlags makes ffmpeg abort with Unable to parse option value "hls_version=3". ffmpeg picks a version automatically when this is omitted.

    gopSize?: number

    Keyframe interval (must align with segment duration × fps). Default: 48

    forceKeyFrames?: string

    Force IDR frame at each segment boundary

    crf?: number

    CRF value for VBR quality mode

    movflags?: string

    Fast start (moov atom at beginning). Applied per segment.

    hlsKeyInfoFile?: string

    Encryption key info file for AES-128

    binary?: string

    Path to ffmpeg binary