| Both sides previous revision Previous revision Next revision | Previous revision |
| vcs:conf_files [2011/08/26 02:56] – [List of options] Add disable_*, plain_messages -> simple_feedback Toni Corvera | vcs:docs:conf_files [2016/04/17 23:28] (current) – ↷ Links adapted because of a move operation Toni Corvera |
|---|
| * ''./vcs.conf'': (i.e. ''vcs.conf'' in the current directory) Per-dir configuration | * ''./vcs.conf'': (i.e. ''vcs.conf'' in the current directory) Per-dir configuration |
| |
| See also //[[vcs:profiles]]// for an alternative to auto-loading configuration files. | See also //[[vcs:docs:profiles]]// for an alternative to auto-loading configuration files. |
| |
| They're loaded in this order, and when a configuration option is present in more than one file the last file takes precedence. | They're loaded in this order, and when a configuration option is present in more than one file the last file takes precedence. |
| **Examples**\\ | **Examples**\\ |
| * Setting background colour for the heading to blue: ''bg_heading=blue''. Added to a configuration file or from the command-line: ''$ vcs -O 'bg_heading=blue' file.avi'' | * Setting background colour for the heading to blue: ''bg_heading=blue''. Added to a configuration file or from the command-line: ''$ vcs -O 'bg_heading=blue' file.avi'' |
| * Output to JPEG by default: ''format=jpg''. Added to a configuration file (the command-line option ''[[vcs:cli_options#jpeg|-j]]'' does the same for a single run). | * Output to JPEG by default: ''format=jpg''. Added to a configuration file (the command-line option ''[[vcs:docs:cli_options#jpeg|-j]]'' does the same for a single run). |
| |
| **Example configuration file**\\ | **Example configuration file**\\ |
| ^ Option ^ Default ^ Description ^ Additional details ^ | ^ Option ^ Default ^ Description ^ Additional details ^ |
| ^ Main behaviour options ^^^^ | ^ Main behaviour options ^^^^ |
| | ''interval'' | ''300'' | Default capture interval | [[vcs:time_syntax|Time]] | | | ''interval'' | ''300'' | Default capture interval | [[vcs:docs:time_syntax|Time]] | |
| | ''numcaps'' | ''16'' | Default number of captures | Integer | | | ''numcaps'' | ''16'' | Default number of captures | Integer | |
| | ''columns'' | ''2'' | Default number of columns | Integer | | | ''columns'' | ''2'' | Default number of columns | Integer | |
| | ''height'' | | Height | Can be a fixed value or a percentage. By default same as input | | | ''height'' | | Height | Can be a fixed value or a percentage. By default same as input | |
| | ''signature'' | "Preview created by" | Text before the user name in the signature | | | | ''signature'' | "Preview created by" | Text before the user name in the signature | | |
| | ''user'' | ''$(id -un)'' ((i.e. your username)) | User name for signature. | See ''[[vcs:cli_options#user|-u]]'' (''[[vcs:cli_options#user|--user]]'') and ''[[vcs:cli_options#fullname|-U]]'' (''[[vcs:cli_options#fullname|--fullname]]'') | | | ''user'' | ''$(id -un)'' ((i.e. your username)) | User name for signature. | See ''[[vcs:docs:cli_options#user|-u]]'' (''[[vcs:docs:cli_options#user|--user]]'') and ''[[vcs:docs:cli_options#fullname|-U]]'' (''[[vcs:docs:cli_options#fullname|--fullname]]'') | |
| | ''format'' | png | Sets the output format | Should match the extension of a format known by ImageMagick | | | ''format'' | png | Sets the output format | Should match the extension of a format known by ImageMagick | |
| | ''quality'' | 92 | Image quality for output in lossy formats | Integer, Only affects the final image | | | ''quality'' | 92 | Image quality for output in lossy formats | Integer, Only affects the final image | |
| | ''decoder'' | ''$DEC_FFMPEG'' | Controls which capturer to use by default | Symbolic: ''$DEC_FFMPEG'' => FFmpeg, ''$DEC_MPLAYER'' => MPlayer | | | ''decoder'' | ''$DEC_FFMPEG'' | Controls which capturer to use by default | Symbolic: ''$DEC_FFMPEG'' => FFmpeg, ''$DEC_MPLAYER'' => MPlayer | |
| | ''timecode_from'' | ''$TC_INTERVAL'' | Selects between [[vcs:usage#capture_count_modes|number of captures or interval mode]] | Symbolic: ''$TC_INTERVAL'' => interval mode, ''$TC_NUMCAPS'' => number of captures mode | | | ''timecode_from'' | ''$TC_INTERVAL'' | Selects between [[vcs:docs:usage#capture_count_modes|number of captures or interval mode]] | Symbolic: ''$TC_INTERVAL'' => interval mode, ''$TC_NUMCAPS'' => number of captures mode | |
| | ''extended_factor'' | ''0'' | Set the extended factor. | ''0'' disables extended mode.\\ See [[vcs:extended_mode]] | | | ''extended_factor'' | ''0'' | Set the extended factor. | ''0'' disables extended mode.\\ See [[vcs:docs:extended_mode]] | |
| | ''disable_shadows'' | ''0'' | Disables drop shadows when ''1''. | Equivalent command-line argument ''-ds''. | | | ''disable_shadows'' | ''0'' | Disables drop shadows when ''1''. | Equivalent command-line argument ''-ds''. | |
| | ''disable_timestamps'' | ''0'' | Disables timestamps on captures when ''1''. | Equivalent command-line argument ''-dt''. | | | ''disable_timestamps'' | ''0'' | Disables timestamps on captures when ''1''. | Equivalent command-line argument ''-dt''. | |
| | ''end_offset'' | ''5%'' | Default value for end offset. See ''-E'' | | | | ''end_offset'' | ''5%'' | Default value for end offset. See ''-E'' | | |
| | ''safe_rename_pattern'' | ''%b-%N.%e'' | Pattern used for output files to avoid overwriting existing files. | ''%b'': Basename \\ ''%N'': Incremental number \\ ''%e'': extension \\ Scheduled for removal in 1.13 | | | ''safe_rename_pattern'' | ''%b-%N.%e'' | Pattern used for output files to avoid overwriting existing files. | ''%b'': Basename \\ ''%N'': Incremental number \\ ''%e'': extension \\ Scheduled for removal in 1.13 | |
| | ''verbosity'' | ''$V_ALL'' | Verbosity level | Available: ''$V_ALL'', ''$V_NONE'', ''$V_ERROR'', ''$V_WARN'', ''$V_INFO'' \\ See also ''[[vcs:cli_options#quiet|--quiet]]'' | | | ''verbosity'' | ''$V_ALL'' | Verbosity level | Available: ''$V_ALL'', ''$V_NONE'', ''$V_ERROR'', ''$V_WARN'', ''$V_INFO'' \\ See also ''[[vcs:docs:cli_options#quiet|--quiet]]'' | |
| | ''simple_feedback'' | ''0'' | Controls colour output ((**From 1.11**: Also the alternative prefixes when no colour is available)) to console. | Set to ''1'' to disable colour | | | ''simple_feedback'' | ''0'' | Controls colour output ((**From 1.11**: Also the alternative prefixes when no colour is available)) to console. | Set to ''1'' to disable colour | |
| | ''stdout'' | ''/dev/null'' | Standard output of decoder is sent here | | | | ''stdout'' | ''/dev/null'' | Standard output of decoder is sent here | | |
| | ''stderr'' | ''/dev/null'' | Standard error of decoder is sent here | | | | ''stderr'' | ''/dev/null'' | Standard error of decoder is sent here | | |
| |