Live Settings

Live Settings

Setting	Description	Default	Example
save_location	Custom path for livestreams	Empty (uses save_location from Options)	"/home/user/streams"
vods_file_extension	File extension for recordings	".ts"	".ts" or ".mp4"
ffmpeg_convert	Convert to MP4 after recording	true	true/false
generate_contact_sheet	Create preview thumbnails	true	true/false
use_mt_for_contact_sheet	Use mt for better thumbnails if its installed	false	true/false
filename_template	Template for file naming	See below	"{model_username}_{date}"
date_format	Date format in filenames	"20060102_150405"	"2006-01-02_15:04:05"
record_chat	Save chat messages from streams to a json file*	true	true/false
ffmpeg_recording_options	Custom FFmpeg arguments for the initial stream recording. Leave empty to use application defaults.	""	"-c:v libx264 -crf 23"
ffmpeg_conversion_options	Custom FFmpeg arguments for the post-recording conversion. Overrides the default -c copy.	""	"-c copy -movflags +faststart"
check_interval	Time (in seconds) to wait between checks when a model is offline.	60	30

Custom FFmpeg Options

For advanced users, you can directly control the arguments passed to FFmpeg for both recording and post-processing.

Warning

Incorrect FFmpeg syntax can cause your recordings to fail. It is highly recommended to test your command-line arguments directly with FFmpeg before using them in the configuration file.

• ffmpeg_recording_options: This replaces the default set of arguments used to record the live stream. If left empty, the application uses its built-in defaults which are optimized for stable stream capture and reconnection (-c copy -movflags use_metadata_tags -reconnect 300 ...). This option allows you to re-encode on the fly, map specific streams, or apply filters during the recording process.
• ffmpeg_conversion_options: This replaces the default argument (-c copy) used during the post-processing step when ffmpeg_convert is set to true. This is useful for tasks like adding faststart flags for web playback, changing audio codecs, or embedding metadata without re-encoding the entire video.

Recorded chat

Chat messages are saved in a json format to be compatible with the player from this amazing archive project: https://archive.ragtag.moe/player

It allows you to play local videos with the chat to have full context of streams with timestamps of the messages (as close as possible). Any empty messages are most likely tips that had no messages associated with it, I may also save those as the amount tipped.

Video File Extensions

Common options for vods_file_extension:

• .ts - Transport Stream (recommended for live recordings)
• .mp4 - Most widely supported video format
• .mkv - Matroska format, supports multiple audio/subtitle tracks
• .mov - QuickTime Movie format
• .avi - Audio Video Interleave format
• .webm - WebM format, good for web compatibility

Note: .ts is recommended for live recordings as it handles interruptions better and can be played directly in VLC/MPV players.

Filename Template Variables

• {model_username}: Creator's username
• {date}: Recording date/time
• {streamId}: Unique stream identifier
• {streamVersion}: Stream version (automatically prefixed with 'v')

Date Format Options

The date format uses Go's time formatting syntax:

• 2006: Year
• 01: Month
• 02: Day
• 15: Hour (24h)
• 04: Minute
• 05: Second

Common formats:

• 20060102_150405: 20240215_134530
• 2006-01-02_15:04:05: 2024-02-15_13:45:30
• 2006-01-02: 2024-02-15
• 15:04:05: 13:45:30
• Jan 02 2006: Feb 15 2024
• January 02 2006: February 15 2024
• Mon Jan 02 2006: Thu Feb 15 2024
• 02-01-2006: 15-02-2024