XRECODE3 - User contributions [en]

Output Path Settings

2025-02-16T08:25:09Z

Wikiadmin:

[[file:Additional_output_path_settings.png]]
{| class="wikitable"
|Preserve the structure of the source folder
|Folders structure of the source file will be re-used, when creating output path. For example, if source file has full path "c:\audio\album\file.flac" and output path is set to "c:\converted", then the output file will be "c:\converted\'''audio\album\file.mp3'''"
|-
|Number source folders (from the beginning) to include
|Specify number of source folders (from the beginning) to use when creating the output path. If, for example, it is set to 1, then output file from the example above would be "c:\converted\'''audio\file.mp3'''"
|-
|Number source folders (from the end) to include
|Specify number of source folders (from the end) to use when creating the output path. If, for example, it is set to 1, then output file from the example above would be "c:\converted\'''album\file.mp3'''"
|-
|Number source folders (from the beginning) to skip
|Specify number of source folders to skip (from the beginning) when creating the output path.
|-
|Number source folders (from the end) to skip
|Specify number of source folders to skip (from the end) when creating the output path.
|-
|Maximum output file name length
|Specify the maximum length of the output file name (only the file name, not the whole path). File name will be cut up to this number, if it's longer. If, as a result, more than one file gets the same name, a unique file name will be created.
|-
|Maximum output path length
|Specify the maximum length of the output file path. If the length of the output path and file name is bigger than this, program will show an error.
|-
|Discard CUE output folder when "Create files in source folder" is used
|Normally, when converting audio file added via CUE, output files will be created in a sub-folder (specified by a pattern), even if "Create files in source folder" option is used. If this option is enabled, files will be created directly in then output folder.
|-
|Delete source file when done (do not move to Recycle Bin)
|Source files will be deleted when process is completed. '''Please use with caution.'''. This option is disabled when "Move source file to Recycle Bin when done" is used and vice versa.
|}
<historylink type="back" />

File Name Pattern Elements

2024-12-12T20:01:27Z

Wikiadmin: /* Lossy/Lossless */

== Elements from file name and/or audio stream ==
{| class="wikitable"
|%filename%
|Output file name (created from the input file name).
|-
|%folder%
|Input file name folder, e.g. ''audio'' for file c:\some\folder\audio\file.flac.
|-
|%outputfiletype%
|Output file type, e.g. mp3.
|-
|%filetype%
|The same as %outputfiletype%
|-
|%language%
|Language (for file with multiple audio streams).
|-
|%streamid%
|Audio stream index.
|-
|%codec%
|Input file Codec.
|-
|%nchannel%
|Channel number (used in "Split into file per channel").
|-
|%chname%
|Channel name (used in "Split into file per channel"), e.g. (FL, FR, C, etc).
|-
|%channels%
|Number of channels of the output file.
|-
|%originalfilename%
|Input file name (used in "Split By" file name pattern). Also, if files were added vie CUE file, input file name will be used for output.
|-
|}

== Metadata elements ==
{| class="wikitable"
|%albumartist%
|Album artist
|-
|%artist%
|Artist
|-
|%album%
|Album
|-
|%track%
|Track
|-
|%track2%
|2 digit track number, i.e. values 1-9 will be left-padded with a zero (01, 02, etc.).
|-
|%disc%
|Disc
|-
|%disc2%
|See %track2%
|-
|%disc3%
|The same as %disc%, only if value is 1/1, it will be discarded.
|-
|%title%
|Title
|-
|%year%
|Year
|-
|%date%
|Date
|-
|%genre%
|Genre
|-
|}

== Pregap ==
{| class="wikitable"
|%pre%:pre_
|It will be processed as
* if option to save pre-gaps as a separate tracks is enabled and it's a pre-gap track then [%pre%:pre_] will be replaced with value pre_
* if option to save pre-gaps as a separate tracks is enabled and it's not a pre-gap track then [%pre%:pre_] will be discarded
* if option to save pre-gaps as a separate tracks is not enabled then [%pre%:pre_] will be discarded
* pre_ can be any value, but it must not contain spaces
|-
|}

== Lossy/Lossless ==
{| class="wikitable"
|[%lossy%:lossy:lossless]
|It will be processed as
* if the input audio is lossy, the value between 1st and 2nd colon will be used
* if the input audio is lossless, the value after and 2nd colon will be used
* values for losless or lossy can also be left empty (see examples below)
|}

== Lossy/Lossless Examples ==
{| class="wikitable"
|[%lossy%:lossy:losless]\%filename%
|
* if the input audio is lossy, the output path will be defined_output_path\lossy\output_file_name
* if the input audio is lossless, the output path will be defined_output_path\lossless\output_file_name
|-
|[%lossy%:lossy:]\%filename%
|
* if the input audio is lossy, the output path will be defined_output_path\lossy\output_file_name
* if the input audio is lossless, the output path will be defined_output_path\output_file_name
|-
|[%lossy%::lossless]\%filename%
|
* if the input audio is lossy, the output path will be defined_output_path\lossy\output_file_name
* if the input audio is lossless, the output path will be defined_output_path\output_file_name
|}

== Optional parts ==
Some parts of the Pattern can be marked as optional, which means that if Metadata element in that part is empty, the whole part will be discarded. Optional part is enclosed in brackets [ ]. For example:
{| class="wikitable"
|%albumartist%[ - %album%]\%track2%. %title%
|If %album% is empty, then everything, which was enclosed in [ ] will be discarded (including dash and space).
|-
|%filename%_(%streamid%[_%language%][%codec%])
|Here, if %language% is empty, underscore won't be added to the output file name.
|}
* It is also possible to add several, comma separated, tag patterns elements in []. In this case the first non-empty value will be used.
{| class="wikitable"
|[%title%,%album%]
|If %title% is not empty, it will be used. If %album% is not empty, then it will be used. If both, %title% and %album% are empty, the whole [] block will be discarded.
|-
|[%title%,%album%][-%albumartist%,-%performer%]
|You can use multiple [] blocks. Dash before the pattern element will be retained, if the pattern element is used. Otherwise it will be discarded.
|}

== Tags with multiple values ==
It is possible to access value of the tag by index, e.g. %genre(1)% will return first value.

== Case conversion ==
Is is possible to change case of the Metadata elements using the following:
* To have element in UPPER case, either add a prefix U to it (e.g. %Utitle%, %Ufilename%) or have it all in uppercase (e.g. %TITLE%, %ALBUM%, %FILENAME%).
* To have element in lower case, add a prefix L to it (%Ltitle%, %Lfilename%).
* To have element Capitalized, add a prefix C to it (%Ctitle%, %Cfilename%).

== Date conversion elements (taken from Linux) ==
{| class="wikitable"
|%%
|a literal %
|-
|%a
|locale's abbreviated weekday name (e.g., Sun)
|-
|%A
|locale's full weekday name (e.g., Sunday)
|-
|%b
|locale's abbreviated month name (e.g., Jan)
|-
|%B
|locale's full month name (e.g., January)
|-
|%c
|locale's date and time (e.g., Thu Mar 3 23:05:25 2005)
|-
|%C
|century; like %Y, except omit last two digits (e.g., 20)
|-
|%d
|day of month (e.g., 01)
|-
|%D
|date; same as %m/%d/%y
|-
|%e
|day of month, space padded; same as %_d
|-
|%F
|full date; same as %Y-%m-%d
|-
|%g
|last two digits of year of ISO week number (see %G)
|-
|%G
|year of ISO week number (see %V); normally useful only with %V
|-
|%h
|same as %b
|-
|%H
|hour (00..23)
|-
|%I
|hour (01..12)
|-
|%j
|day of year (001..366)
|-
|%k
|hour, space padded ( 0..23); same as %_H
|-
|%l
|hour, space padded ( 1..12); same as %_I
|-
|%m
|month (01..12)
|-
|%M
|minute (00..59)
|-
|%n
|a newline
|-
|%N
|nanoseconds (000000000..999999999)
|-
|%p
|locale's equivalent of either AM or PM; blank if not known
|-
|%P
|like %p, but lower case
|-
|%r
|locale's 12-hour clock time (e.g., 11:11:04 PM)
|-
|%R
|24-hour hour and minute; same as %H:%M
|-
|%s
|seconds since 1970-01-01 00:00:00 UTC
|-
|%S
|second (00..60)
|-
|%t
|a tab
|-
|%T
|time; same as %H:%M:%S
|-
|%u
|day of week (1..7); 1 is Monday
|-
|%U
|week number of year, with Sunday as first day of week (00..53)
|-
|%V
|ISO week number, with Monday as first day of week (01..53)
|-
|%w
|day of week (0..6); 0 is Sunday
|-
|%W
|week number of year, with Monday as first day of week (00..53)
|-
|%x
|locale's date representation (e.g., 12/31/99)
|-
|%X
|locale's time representation (e.g., 23:13:48)
|-
|%y
|last two digits of year (00..99)
|-
|%Y
|year
|-
|}

== Examples ==
{| class="wikitable"
|%filename%_(%streamid%[_%language%][_%stream_name%])
|Output file name will be like inputfilename_(1_eng_main track).
|-
|0%nchannel%_%filename%
|Output file name will be like 01_inputfilename, 02_inputfilename, etc.
|}
<historylink type="back" />

File Name Pattern Elements

2024-12-12T20:00:17Z

Wikiadmin:

== Elements from file name and/or audio stream ==
{| class="wikitable"
|%filename%
|Output file name (created from the input file name).
|-
|%folder%
|Input file name folder, e.g. ''audio'' for file c:\some\folder\audio\file.flac.
|-
|%outputfiletype%
|Output file type, e.g. mp3.
|-
|%filetype%
|The same as %outputfiletype%
|-
|%language%
|Language (for file with multiple audio streams).
|-
|%streamid%
|Audio stream index.
|-
|%codec%
|Input file Codec.
|-
|%nchannel%
|Channel number (used in "Split into file per channel").
|-
|%chname%
|Channel name (used in "Split into file per channel"), e.g. (FL, FR, C, etc).
|-
|%channels%
|Number of channels of the output file.
|-
|%originalfilename%
|Input file name (used in "Split By" file name pattern). Also, if files were added vie CUE file, input file name will be used for output.
|-
|}

== Metadata elements ==
{| class="wikitable"
|%albumartist%
|Album artist
|-
|%artist%
|Artist
|-
|%album%
|Album
|-
|%track%
|Track
|-
|%track2%
|2 digit track number, i.e. values 1-9 will be left-padded with a zero (01, 02, etc.).
|-
|%disc%
|Disc
|-
|%disc2%
|See %track2%
|-
|%disc3%
|The same as %disc%, only if value is 1/1, it will be discarded.
|-
|%title%
|Title
|-
|%year%
|Year
|-
|%date%
|Date
|-
|%genre%
|Genre
|-
|}

== Pregap ==
{| class="wikitable"
|%pre%:pre_
|It will be processed as
* if option to save pre-gaps as a separate tracks is enabled and it's a pre-gap track then [%pre%:pre_] will be replaced with value pre_
* if option to save pre-gaps as a separate tracks is enabled and it's not a pre-gap track then [%pre%:pre_] will be discarded
* if option to save pre-gaps as a separate tracks is not enabled then [%pre%:pre_] will be discarded
* pre_ can be any value, but it must not contain spaces
|-
|}

== Lossy/Lossless ==
{| class="wikitable"
|[%lossy%:lossy:lossless]
|It will be processed as
* if the input audio is lossy, the value between 1st and 2nd colons will be used
* if the input audio is lossless, the value after and 2nd colon will be used
* values for losless or lossy can also be left empty (see examples below)
|}
== Lossy/Lossless Examples ==
{| class="wikitable"
|[%lossy%:lossy:losless]\%filename%
|
* if the input audio is lossy, the output path will be defined_output_path\lossy\output_file_name
* if the input audio is lossless, the output path will be defined_output_path\lossless\output_file_name
|-
|[%lossy%:lossy:]\%filename%
|
* if the input audio is lossy, the output path will be defined_output_path\lossy\output_file_name
* if the input audio is lossless, the output path will be defined_output_path\output_file_name
|-
|[%lossy%::lossless]\%filename%
|
* if the input audio is lossy, the output path will be defined_output_path\lossy\output_file_name
* if the input audio is lossless, the output path will be defined_output_path\output_file_name
|}

== Optional parts ==
Some parts of the Pattern can be marked as optional, which means that if Metadata element in that part is empty, the whole part will be discarded. Optional part is enclosed in brackets [ ]. For example:
{| class="wikitable"
|%albumartist%[ - %album%]\%track2%. %title%
|If %album% is empty, then everything, which was enclosed in [ ] will be discarded (including dash and space).
|-
|%filename%_(%streamid%[_%language%][%codec%])
|Here, if %language% is empty, underscore won't be added to the output file name.
|}
* It is also possible to add several, comma separated, tag patterns elements in []. In this case the first non-empty value will be used.
{| class="wikitable"
|[%title%,%album%]
|If %title% is not empty, it will be used. If %album% is not empty, then it will be used. If both, %title% and %album% are empty, the whole [] block will be discarded.
|-
|[%title%,%album%][-%albumartist%,-%performer%]
|You can use multiple [] blocks. Dash before the pattern element will be retained, if the pattern element is used. Otherwise it will be discarded.
|}

== Tags with multiple values ==
It is possible to access value of the tag by index, e.g. %genre(1)% will return first value.

== Case conversion ==
Is is possible to change case of the Metadata elements using the following:
* To have element in UPPER case, either add a prefix U to it (e.g. %Utitle%, %Ufilename%) or have it all in uppercase (e.g. %TITLE%, %ALBUM%, %FILENAME%).
* To have element in lower case, add a prefix L to it (%Ltitle%, %Lfilename%).
* To have element Capitalized, add a prefix C to it (%Ctitle%, %Cfilename%).

== Date conversion elements (taken from Linux) ==
{| class="wikitable"
|%%
|a literal %
|-
|%a
|locale's abbreviated weekday name (e.g., Sun)
|-
|%A
|locale's full weekday name (e.g., Sunday)
|-
|%b
|locale's abbreviated month name (e.g., Jan)
|-
|%B
|locale's full month name (e.g., January)
|-
|%c
|locale's date and time (e.g., Thu Mar 3 23:05:25 2005)
|-
|%C
|century; like %Y, except omit last two digits (e.g., 20)
|-
|%d
|day of month (e.g., 01)
|-
|%D
|date; same as %m/%d/%y
|-
|%e
|day of month, space padded; same as %_d
|-
|%F
|full date; same as %Y-%m-%d
|-
|%g
|last two digits of year of ISO week number (see %G)
|-
|%G
|year of ISO week number (see %V); normally useful only with %V
|-
|%h
|same as %b
|-
|%H
|hour (00..23)
|-
|%I
|hour (01..12)
|-
|%j
|day of year (001..366)
|-
|%k
|hour, space padded ( 0..23); same as %_H
|-
|%l
|hour, space padded ( 1..12); same as %_I
|-
|%m
|month (01..12)
|-
|%M
|minute (00..59)
|-
|%n
|a newline
|-
|%N
|nanoseconds (000000000..999999999)
|-
|%p
|locale's equivalent of either AM or PM; blank if not known
|-
|%P
|like %p, but lower case
|-
|%r
|locale's 12-hour clock time (e.g., 11:11:04 PM)
|-
|%R
|24-hour hour and minute; same as %H:%M
|-
|%s
|seconds since 1970-01-01 00:00:00 UTC
|-
|%S
|second (00..60)
|-
|%t
|a tab
|-
|%T
|time; same as %H:%M:%S
|-
|%u
|day of week (1..7); 1 is Monday
|-
|%U
|week number of year, with Sunday as first day of week (00..53)
|-
|%V
|ISO week number, with Monday as first day of week (01..53)
|-
|%w
|day of week (0..6); 0 is Sunday
|-
|%W
|week number of year, with Monday as first day of week (00..53)
|-
|%x
|locale's date representation (e.g., 12/31/99)
|-
|%X
|locale's time representation (e.g., 23:13:48)
|-
|%y
|last two digits of year (00..99)
|-
|%Y
|year
|-
|}

== Examples ==
{| class="wikitable"
|%filename%_(%streamid%[_%language%][_%stream_name%])
|Output file name will be like inputfilename_(1_eng_main track).
|-
|0%nchannel%_%filename%
|Output file name will be like 01_inputfilename, 02_inputfilename, etc.
|}
<historylink type="back" />

Command Line

2024-11-11T14:45:02Z

Wikiadmin: /* Examples */

== Requirements ==
Command line parameters are only supported by the console version of XRECODE3.

== Usage ==
Usage: <input> <dest> <parameters> <output>

Parameters:
/i - Files to add. Wildcards are supported. If /r is used, files from sub-folders will be added as well.
/r - Files from sub-folders will be added as well (used together with /i).
/dest - Output format (mp3, ogg, flac, m4a, dsd64, dsd128, etc.) or copy to just copy files to the destination folder by applying file name pattern.
/o - Output path.
/exclude x - file name to exclude (can contain * and ?, case does not matter). Several /exclude parameters can be passed.

/dsdft - Output file type for DSD (dff or dsf).

/preset n - Use preset (where it's applicable, e.g. mp3).
/quality n - Quality parameter for Ogg.
/compression n - Compression for flac (0 to 8, where 0 is "uncompressed").
/cbr - Use CBR (e.g. 160, 192, 320, etc. Also used as CBR Max parameter).
/vbr - Use VBR (e.g. 160, 192, 320, etc. also used as VBR Max parameter).
/vbrmin - VBR Min parameter (e.g. 160, 192, 320, etc.).
/js - Use Joint Stereo (for mp3 only).
/dc - Use Dual Channel (for mp3 only).
/maxng - Apply Max Noclip Gain (for mp3 only).

/merge - Merge files (using merge per folder).
/mergenbf - Merge files (not using merge per folder).
/split - Split into file per channel.
/one - Encode to one multi-channel file.
/tc - Always transcode (e.g. when merging MP3 files).
/nocue - Do not create CUE file.

/temp - Custom temporary files folder (e.g. c:\tempfolder).
/pp n - Number of Cores/CPUs to use (all will be used by default).
/recycle - Move source files to Recycle Bin when done.
/delete - Delete source files when done. USE WITH CAUTION!

/usesource - Add all source folders to the output path (cannot be used together with source* or skip* parameters).
/sourceb n - Number source folders (from the beginning) to include.
/sourcee n - Number source folders (from the end) to include.
/skipb n - Number source folders (from the beginning) to skip.
/skipe n - Number source folders (from the end) to skip.
/createinsrc - Create files in source folder.

/sr - Output sample rate.
/c - Output channels.
/b - Output bits per sample (16, 24, 32 or 32i). 32 is for 32bitfloat, 32i for 32bitint.
/as n - Specify which audio stream to use. Only usable for files with several audio streams.
By default first one is used. Please note that index of the first audio stream is 1.

/n - Normalize audio (by default EBUR128 method is used).
/na - Normalize audio in album mode.
/nafa - Each folder is album (only works with -na).
/nsit - Save normalization values in Tags (can only be used together with -n).
When this parameter is used and no destination is specified, no transcode will be performed.
/nsaa - Apply normalization to audio (can only be used together with -n).
/nrg - Use ReplayGain as a method
/nrgl n - Target dB level (89 by default) for ReplayGain.
/nebl "nnn" - Target level (multiplied by 10) for EBUR128 (-180 by default). Value must be put in quotes, e.g. /nebl "-165", which then will be used as -16.5

/sacdarea n - SACD ISO area to use (s for stereo, m for multi-channel, b for both).
/sacdvolume n - SACD ISO volume in dB (from 0 to 6).
/sacdas x - Extract SACD as (DFF, DSF or ASIS).
/dop - Use DSD-over-PCM (DoP) (for WAV as a destination only).
/pad x - Remove clicks when decoding SACD via padding samples (e.g. /pad "50/50").

/remsilence1 - Remove silence from the beginning of the track.
/remsilence2 - Remove silence from the end of the track.
/st - Silence threshold (0-32767). Default is 500.

/sbt n - Split input file by time (in milliseconds).
/sbs - Split input file by silence.
/sbst - Silence threshold (0-32767). Default is 500.

/limitbyd - Limit by duration (in milliseconds).

/mcmd - Specify manual command line for external encoder (e.g. for mp3 /mcmd "-V0").

/encoderexe - Specify the executable for the encoder.

/owav - Use wav as output file extension.

/fileexists n - How to handle existing output file, where n is:
0 = Overwrite (default)
1 = Overwrite when source file is newer
2 = Rename existing file to .bak<n>
3 = Add a numeric suffix <_n> to the new file's name
4 = Skip

/pt - Preserve timestamps of files and folders.

/skipbadframes - Skip bad frames when decoding. Warning will be given, if any was skipped. Off by default.

/buffersize - Set encoding buffer size used by external exe encoder. Value is in KB, e.g. 64 means 64K.

/onthefly - Use on-the-fly encoding method (see http://xrecode.com/xrecode3/wiki/index.php?title=Misc)

/uselib - Use dll encoder (currently for Ogg only).
/useexe - Use exe encoder (when it's configured in settings.ini).

/pfilename - Set output file name pattern for the destination.

/preferredcodecs - Set preferred source file codecs. If codec of the source file does not match one from the list, file will be skipped.
Value can contain several comma delimited values. In this case codes will be evaluated in the specified order.
Example1: if value is set to mlp,pcm and there are source files with mlp and pcm codecs, only the mlp files will be processed.
Example2: if value is set to mlp and there are no source files with mlp codecs, no files will be processed.

/scandts - Scan WAV files for DTS stream.

/nochapters - Ignore input file chapters.

Metadata parameters:
/nometa - Do not save Metadata in output file (including covers).
/createcue - Create CUE file.
/embedcue - Embed CUE into output file (if supported).
/createm3u - Create m3u playlist.
/nocovers - Do not save cover(s) in output file.
/onlyfirst - Save only first cover in output file, i.e. if source file contains more than one cover, only the 1st one will be saved in the output file.
/coverfilename - File name template to save cover(s) to, e.g. /coverfilename "%album%_%albumartist%", /coverfilename "folder"
/firstcoverfilename - File name template to save only first cover to, e.g. /coverfilename "%album%_%albumartist%", /coverfilename "folder"
/usecuemetaonly - Use metadata from CUE file only.
/nsec - Do not search for external metadata (i.e. in files like cover.jpg, etc.).
/tr - Tagsreplaxe file name.
/cof - Copy non-audio files to the destination folder, e.g. /cof "folder*;cover*"

/retrievemeta - Retrieve Metadata from internet.

/matrix - Set output matrix, e.g. FL:0,1;FR:1,0 to exchange left and right channels of a stereo file.

/rename - Rename files using pattern.

/exportmeta /o <filename> - Export Metadata to file <filename>.
/exportmeta /ec /o <path> - Export only Covers to the specified path. Covers will be saved as a JPEG files. You can use /pfilename to specify the name of the cover.
/importmeta <filename> - Import Metadata from file <filename>.

Notes:
Dash (-) and forward slash (/) both can be used to specify parameters, e.g. both /i and -i are valid.
If sample rate, channels or bits per sample are too large for the specified format,
maximum possible value will be used instead.

Use --ansi-output parameter if you want to forward program's output to a file. Errors will be written to the StdErr.

To display information about file(s) use -i parameter only.

== Examples ==

Output information about file:
-i c:\files\00001.m2ts

Convert wav files (including sub-folders) to mp3:
-i c:\files\*.wav /r -o c:\output /dest mp3

Convert wav files (including sub-folders) to mp3 using joint-stereo:
-i c:\files\*.wav /r -o c:\output /dest mp3 /cbr 320 /js

Convert wav files (including sub-folders) to mp3 using VBR method:
-i c:\files\*.wav /r -o c:\output /dest mp3 /vbrmin 64 /vbrmax 320

Convert wav files (including sub-folders) to mp3 using preset 5:
-i c:\files\*.wav /r -o c:\output /dest mp3 /preset 5

Convert wav files (including sub-folders) to mp3 using VBR 192:
-i c:\files\*.wav /r -o c:\output /dest mp3 /vbr 192

Convert wav files (including sub-folders) to ogg using quality/preset 5:
-i c:\files\*.wav /r -o c:\output /dest ogg /quality 5

Convert wav files (including sub-folders) to ogg using CBR 160:
-i c:\files\*.wav /r -o c:\output /dest ogg /cbr 160

Convert wav files to flac using 96000 as output sample rate and 24-bit as output sample format:
-i c:\files\*.wav -o "c:\output with spaces" /dest flac /b 24 -sr 96000

Convert flac files to alac:
-i c:\files\*.flac -o "c:\output with spaces" /dest alac

Convert wav files to flac, using 96000 as output sample rate and 24bit as output sample format. Also analyze Replay Gain and apply to output audio:
-i c:\files\*.wav -o c:\output /dest flac /b 24 /sr 96000 /n /nsaa

Convert wav files to mp3 by applying matrix to the audio to swap left and right channels:
-i c:\files\*.wav -o c:\output /dest mp3 /matrix "FL:0,1;FR:1,0"

Convert several wav files to one flac file:
-i c:\files\*.wav -o "c:\output" /dest flac /one

Convert wav files (including sub-folders) to mp3. Normal output is redirected to file named "process", error output is redirected to file named "errors":
-i c:\files\*.wav /r -o c:\output /dest mp3 --ansi-output 1>process 2>errors

Rename added files:
-i c:\files\*.mp3 /rename "%track2%. %title%"

Convert CUE image to mp3 by specifying custom file name pattern:
-i c:\files\one.cue /dest mp3 /pfilename "%albumartist%\%album%\%track2%. %title%"

Extract SACD as DSF:
-i c:\files\sacd.iso /sacdas dff /dest extract /o c:\output

Compress to flac using compression level 3
-i c:\files\*.wav -o c:\output /dest flac /compression 3

Compress to flac uncompressed
-i c:\files\*.wav -o c:\output /dest flac /compression 0

Convert flac files (including sub-folders) to mp3 and excluding some file name:
-i c:\files\*.flac /r -o c:\output /dest mp3 /exclude *HTOA*

Convert flac files to mp3 by passing manual command line to lame encoder:
-i c:\files\*.flac /r -o c:\output /dest mp3 /mcmd "--preset extreme"

Copy mp3 files to folder by applying file name pattern:
-i c:\files\*.mp3 -o c:\output /dest copy /pfilename "%albumartist%\%album%\%track2%. %title%"

Convert SACD iso files to dts using wav as extension, using external encoder and removing clicks:
-i c:\files\some.iso -o c:\output /dest dts /encoderexe "c:\dts\surcodedts.exe" /owav /pad "50/50"

Normalize files and save the information in tags (no transcoding).
-i c:\files\*.flac /n /nsit



== Specifying external executable files ==
It is possible to specify location of external encoder files using '''settings.ini''' file. For example, if console executable is located in folder '''c:\xr3console''', file named '''settings.ini''' must be put in a folder '''c:\xr3console\portable\console\settings\x86''' for 32-bit executable, or '''c:\xr3console\portable\console\settings\x64''' for a 64-bit executable.
*''settings.ini'' must contain definition for executables like this (you only need to specify ones you want to use)
enc.mp3.executable=D:\xr3console\lame.exe
enc.ogg.executable=D:\xr3console\oggenc2.exe
enc.flac.executable=c:\flac\flac.exe
enc.wavpack.executable=C:\wavpack\wavpack.exe

<historylink type="back" />

2021-07-13T14:44:28Z

Wikiadmin:

[[file:extract_settings.png]]
*Add RIFF header for DTS files - RIFF header will be added to the DTS file (some program require this).
*Use WAV as output file extension for DTS files - output files will have WAV extension.
*Extract SACD as:
** DFF - Tracks will be extracted as DFF (DST encoded tracks will be decoded to DSD).
** DSF - Tracks will be extracted as DSF (DST encoded tracks will be decoded to DSD). In DSF bytes must be organized into a certain sized blocks and when there's not enough bytes for the last block of the file, the block is padded with zeroes and that might cause the loud click for some players.

** DSD/DST - Tracks will be extracted by preserving the encoding of the SACD (e.g. DSD or DST).

* '''Please note.''' If your player supports the DFF files, it is highly recommended to always use the DFF format as it is written as 1:1 from the SACD without any padding. It also had the full Metadata support.
<historylink type="back" />

2021-07-13T14:40:48Z

Wikiadmin: Wikiadmin uploaded a new version of File:Extract settings.png

Extract Settings

2021-07-10T18:20:57Z

Wikiadmin:

[[file:extract_settings.png]]
*Add RIFF header for DTS files - RIFF header will be added to the DTS file (some program require this).
*Use WAV as output file extension for DTS files - output files will have WAV extension.
*Extract SACD as:
** DFF - Tracks will be extracted as DFF (DST encoded tracks will be decoded to DSD).
** DSF - Tracks will be extracted as DSF (DST encoded tracks will be decoded to DSD).
** DSF/NoPad - In DSF bytes must be organized into a certain sized blocks and when there's not enough bytes for the last block of the file, the block is padded with zeroes and that might cause the issue (loud click) for some players. When NoPad method is used, the block is not padded, and the left-over from the current internal buffer is passed to the beginning of the next file. When using this method, files cannot be extracted in parallel.
** DSD/DST - Tracks will be extracted by preserving the encoding of the SACD (e.g. DSD or DST).

* '''Please note.''' If your player supports the DFF files, it is highly recommended to always use the DFF format as it is written as 1:1 from the SACD without any padding.
<historylink type="back" />

Extract Settings

2021-07-10T18:19:26Z

Wikiadmin:

[[file:extract_settings.png]]
*Add RIFF header for DTS files - RIFF header will be added to the DTS file (some program require this).
*Use WAV as output file extension for DTS files - output files will have WAV extension.
*Extract SACD as:
** DFF - Tracks will be extracted as DFF (DST encoded tracks will be decoded to DSD).
** DSF - Tracks will be extracted as DSF (DST encoded tracks will be decoded to DSD).
** DSF/NoPad - In DSF bytes must be organized into a certain sized blocks and when there's not enough bytes for the last block of the file, the block is padded with zeroes and that might cause the issue (loud click) for some players. When NoPad method is used, the block is not padded, and the left-over from the current internal buffer is passed to the beginning of the next file. When using this method, files cannot be extracted in parallel.
** DSD/DST - Tracks will be extracted by preserving the encoding of the SACD (e.g. DSD or DST).

* '''Please note.''' If your player supports the DFF files, it is highly recommended to always use the DFF format as it is written as 1:1 from the SACD, no padding, no nothing.
<historylink type="back" />

Command Line

2020-09-26T19:25:58Z

Wikiadmin:

== Requirements ==
Command line parameters are only supported by the console version of XRECODE3.

== Usage ==
Usage: <input> <dest> <parameters> <output>

Parameters:
/i - Files to add. Wildcards are supported. If /r is used, files from sub-folders will be added as well.
/r - Files from sub-folders will be added as well (used together with /i).
/dest - Output format (mp3, ogg, flac, m4a, dsd64, dsd128, etc.) or copy to just copy files to the destination foler by applying file name pattern.
/o - Output path.
/exclude x - file name to exclude (can contain * and ?, case does not matter). Several /exclude parameters can be passed.

/dsdft - Output file type for DSD (dff or dsf).

/preset n - Use preset (where it's applicable, e.g. mp3).
/quality n - Quality parameter for Ogg.
/compression n - Compression for flac (0 to 8, where 0 is "uncompressed").
/cbr - Use CBR (e.g. 160, 192, 320, etc. Also used as CBR Max parameter).
/vbr - Use VBR (e.g. 160, 192, 320, etc. also used as VBR Max parameter).
/vbrmin - VBR Min parameter (e.g. 160, 192, 320, etc.).
/js - Use Joint Stereo (for mp3 only).
/dc - Use Dual Channel (for mp3 only).
/maxng - Apply Max Noclip Gain (for mp3 only).

/merge - Merge files (using merge per folder).
/mergenbf - Merge files (not using merge per folder).
/split - Split into file per channel.
/one - Encode to one multi-channel file.

/temp - Custom temporary files folder (e.g. c:\tempfolder).
/pp n - Number of Cores/CPUs to use (all will be used by default).
/recycle - Move source files to Recycle Bin when done.
/delete - Delete source files when done. USE WITH CAUTION!

/usesource - Add all source folders to the output path (cannot be used together with source* or skip* parameters).
/sourceb n - Number source folders (from the beginning) to include.
/sourcee n - Number source folders (from the end) to include.
/skipb n - Number source folders (from the beginning) to skip.
/skipe n - Number source folders (from the end) to skip.
/createinsrc - Create files in source folder.

/sr - Output sample rate.
/c - Output channels.
/b - Output bits per sample (16, 24, 32 or 32i). 32 is for 32bitfloat, 32i for 32bitint.
/as n - Specify which audio stream to use. Only usable for files with several audio streams.
By default first one is used. Please note that index of the first audio stream is 1.

/n - Normalize audio (by default EBUR128 method is used).
/na - Normalize audio in album mode.
/nafa - Each folder is album (only works with -na).
/nsit - Save normalization values in Tags (can only be used together with -n).
/nsaa - Apply normalization to audio (can only be used together with -n).
/nrg - Use ReplayGain as a method
/nrgl n - Target dB level (89 by default).

/sacdarea n - SACD ISO area to use (s for stereo, m for multi-channel, b for both).
/sacdvolume n - SACD ISO volume in dB (from 0 to 6).
/sacdas x - Extract SACD as (DFF, DSF or ASIS).
/dop - Use DSD-over-PCM (DoP) (for WAV as a destination only).
/pad x - Remove clicks when decoding SACD via padding samples (e.g. /pad "50/50").

/remsilence1 - Remove silence from the beginning of the track.
/remsilence2 - Remove silence from the end of the track.
/st - Silence threshold (0-32767). Default is 500.

/sbt n - Split input file by time (in milliseconds).
/sbs - Split input file by silence.
/sbst - Silence threshold (0-32767). Default is 500.

/limitbyd - Limit by duration (in milliseconds).

/mcmd - Specify manual command line for external encoder (e.g. for mp3 /mcmd "-V0").

/encoderexe - Specify the executable for the encoder.

/owav - Use wav as output file extension.

/fileexists n - How to handle existing output file, where n is:
0 = Overwrite (default)
1 = Overwrite when source file is newer
2 = Rename existing file to .bak<n>
3 = Add a numeric suffix <_n> to the new file's name
4 = Skip

/pt - Preserve timestamps of files and folders.

/skipbadframes - Skip bad frames when decoding. Warning will be given, if any was skipped. Off by default.

/buffersize - Set encoding buffer size used by external exe encoder. Value is in KB, e.g. 64 means 64K.

/onthefly - Use on-the-fly encoding method (see http://xrecode.com/xrecode3/wiki/index.php?title=Misc)

/uselib - Use dll encoder (currently for Ogg only).
/useexe - Use exe encoder (when it's configured in settings.ini).

/pfilename - Set output file name pattern for the destination.

/preferredcodecs - Set preferred source file codecs. If codec of the source file does not match one from the list, file will be skipped.
Value can contain several comma delimited values. In this case codes will be evaluated in the specified order.
Example1: if value is set to mlp,pcm and there are source files with mlp and pcm codecs, only the mlp files will be processed.
Example2: if value is set to mlp and there are no source files with mlp codecs, no files will be processed.

/scandts - Scan WAV files for DTS stream.

Metadata parameters:
/nometa - Do not save Metadata in output file (including covers).
/createcue - Create CUE file.
/embedcue - Embed CUE into output file (if supported).
/createm3u - Create m3u playlist.
/nocovers - Do not save cover(s) in output file.
/onlyfirst - Save only first cover in output file, i.e. if source file contains more than one cover, only the 1st one will be saved in the output file.
/coverfilename - File name template to save cover(s) to, e.g. /coverfilename "%album%_%albumartist%", /coverfilename "folder"
/firstcoverfilename - File name template to save only first cover to, e.g. /coverfilename "%album%_%albumartist%", /coverfilename "folder"
/usecuemetaonly - Use metadata from CUE file only.
/nsec - Do not search for external metadata (i.e. in files like cover.jpg, etc.).
/tr - Tagsreplaxe file name.

/retrievemeta - Retrieve Metadata from internet.

/matrix - Set output matrix, e.g. FL:0,1;FR:1,0 to exchange left and right channels of a stereo file.

/rename - Rename files using pattern.

/exportmeta /o <filename> - Export Metadata to file <filename>.
/exportmeta /ec /o <path> - Export only Covers to the specified path. Covers will be saved as a JPEG files. You can use /pfilename to specify the name of the cover.
/importmeta <filename> - Import Metadata from file <filename>.

Notes:
Dash (-) and forward slash (/) both can be used to specify parameters, e.g. both /i and -i are valid.
If sample rate, channels or bits per sample are too large for the specified format,
maximum possible value will be used instead.

Use --ansi-output parameter if you want to forward program's output to a file. Errors will be written to the StdErr.

To display information about file(s) use -i parameter only.

== Examples ==

Output information about file:
-i c:\files\00001.m2ts

Convert wav files (including sub-folders) to mp3:
-i c:\files\*.wav /r -o c:\output /dest mp3

Convert wav files (including sub-folders) to mp3 using joint-stereo:
-i c:\files\*.wav /r -o c:\output /dest mp3 /cbr 320 /js

Convert wav files (including sub-folders) to mp3 using VBR method:
-i c:\files\*.wav /r -o c:\output /dest mp3 /vbrmin 64 /vbrmax 320

Convert wav files (including sub-folders) to mp3 using preset 5:
-i c:\files\*.wav /r -o c:\output /dest mp3 /preset 5

Convert wav files (including sub-folders) to mp3 using VBR 192:
-i c:\files\*.wav /r -o c:\output /dest mp3 /vbr 192

Convert wav files (including sub-folders) to ogg using quality/preset 5:
-i c:\files\*.wav /r -o c:\output /dest ogg /quality 5

Convert wav files (including sub-folders) to ogg using CBR 160:
-i c:\files\*.wav /r -o c:\output /dest ogg /cbr 160

Convert wav files to flac using 96000 as output sample rate and 24-bit as output sample format:
-i c:\files\*.wav -o "c:\output with spaces" /dest flac /b 24 -sr 96000

Convert wav files to flac, using 96000 as output sample rate and 24bit as output sample format. Also analyse Replay Gain and apply to output audio:
-i c:\files\*.wav -o c:\output /dest flac /b 24 /sr 96000 /n /nsaa

Convert wav files to mp3 by applying matrix to the audio to swap left and right channels:
-i c:\files\*.wav -o c:\output /dest mp3 /matrix "FL:0,1;FR:1,0"

Convert several wav files to one flac file:
-i c:\files\*.wav -o "c:\output" /dest flac /one

Convert wav files (including sub-folders) to mp3. Normal output is redirected to file names process, error output is redirected to file named errors:
-i c:\files\*.wav /r -o c:\output /dest mp3 --ansi-output 1>process 2>errors

Rename added files:
-i c:\files\*.mp3 /rename "%track2%. %title%"

Convert CUE image to mp3 by specifying custom file name pattern:
-i c:\files\one.cue /dest mp3 /pfilename "%albumartist%\%album%\%track2%. %title%"

Extract SACD as DSF:
-i c:\files\sacd.iso /sacdas dff /dest extract /o c:\output

Compress to flac using compression level 3
-i c:\files\*.wav -o c:\output /dest flac /compression 3

Compress to flac uncompressed
-i c:\files\*.wav -o c:\output /dest flac /compression 0

Convert flac files (including sub-folders) to mp3 and excludinf some file name:
-i c:\files\*.flac /r -o c:\output /dest mp3 /exclude *HTOA*

Convert flac files to mp3 by passing manual command line to lame encoder:
-i c:\files\*.flac /r -o c:\output /dest mp3 /mcmd "--preset extreme"

Copy mp3 files to folder by applying file name pattern:
-i c:\files\*.mp3 -o c:\output /dest copy /pfilename "%albumartist%\%album%\%track2%. %title%"

Convert SACD iso files to dts using wav as extension, using external encoder and removing clicks:
-i c:\files\some.iso -o c:\output /dest dts /encoderexe "c:\dts\surcodedts.exe" /owav /pad "50/50"



== Specifying external executable files ==
It is possible to specify location of external encoder files using '''settings.ini''' file. For example, if console executable is located in folder '''c:\xr3console''', file named '''settings.ini''' must be put in a folder '''c:\xr3console\portable\console\settings\x86''' for 32-bit executable, or '''c:\xr3console\portable\console\settings\x64''' for a 64-bit executable.
*''settings.ini'' must contain definition for executables like this (you only need to specify ones you want to use)
enc.mp3.executable=D:\xr3console\lame.exe
enc.ogg.executable=D:\xr3console\oggenc2.exe
enc.flac.executable=c:\flac\flac.exe
enc.wavpack.executable=C:\wavpack\wavpack.exe

<historylink type="back" />

Command Line

2020-09-25T18:04:26Z

Wikiadmin:

== Requirements ==
Command line parameters are only supported by the console version of XRECODE3.

== Usage ==
Usage: <input> <dest> <parameters> <output>

Parameters:
/i - Files to add. Wildcards are supported. If /r is used, files from sub-folders will be added as well.
/r - Files from sub-folders will be added as well (used together with /i).
/dest - Output format (mp3, ogg, flac, m4a, dsd64, dsd128, etc.) or copy to just copy files to the destination foler by applying file name pattern.
/o - Output path.
/exclude x - file name to exclude (can contain * and ?, case does not matter). Several /exclude parameters can be passed.

/dsdft - Output file type for DSD (dff or dsf).

/preset n - Use preset (where it's applicable, e.g. mp3).
/quality n - Quality parameter for Ogg.
/compression n - Compression for flac (0 to 8, where 0 is "uncompressed").
/cbr - Use CBR (e.g. 160, 192, 320, etc. Also used as CBR Max parameter).
/vbr - Use VBR (e.g. 160, 192, 320, etc. also used as VBR Max parameter).
/vbrmin - VBR Min parameter (e.g. 160, 192, 320, etc.).
/js - Use Joint Stereo (for mp3 only).
/dc - Use Dual Channel (for mp3 only).
/maxng - Apply Max Noclip Gain (for mp3 only).

/merge - Merge files (using merge per folder).
/mergenbf - Merge files (not using merge per folder).
/split - Split into file per channel.
/one - Encode to one multi-channel file.

/temp - Custom temporary files folder (e.g. c:\tempfolder).
/pp n - Number of Cores/CPUs to use (all will be used by default).
/recycle - Move source files to Recycle Bin when done.
/delete - Delete source files when done. USE WITH CAUTION!

/usesource - Add all source folders to the output path (cannot be used together with source* or skip* parameters).
/sourceb n - Number source folders (from the beginning) to include.
/sourcee n - Number source folders (from the end) to include.
/skipb n - Number source folders (from the beginning) to skip.
/skipe n - Number source folders (from the end) to skip.
/createinsrc - Create files in source folder.

/sr - Output sample rate.
/c - Output channels.
/b - Output bits per sample (16, 24, 32 or 32i). 32 is for 32bitfloat, 32i for 32bitint.
/as n - Specify which audio stream to use. Only usable for files with several audio streams.
By default first one is used. Please note that index of the first audio stream is 1.

/n - Normalize audio (by default EBUR128 method is used).
/na - Normalize audio in album mode.
/nafa - Each folder is album (only works with -na).
/nsit - Save normalization values in Tags (can only be used together with -n).
/nsaa - Apply normalization to audio (can only be used together with -n).
/nrg - Use ReplayGain as a method
/nrgl n - Target dB level (89 by default).

/sacdarea n - SACD ISO area to use (s for stereo, m for multi-channel, b for both).
/sacdvolume n - SACD ISO volume in dB (from 0 to 6).
/sacdas x - Extract SACD as (DFF, DSF or ASIS).
/dop - Use DSD-over-PCM (DoP) (for WAV as a destination only).
/pad x - Remove clicks when decoding SACD via padding samples (e.g. /pad "50/50").

/remsilence1 - Remove silence from the beginning of the track.
/remsilence2 - Remove silence from the end of the track.
/st - Silence threshold (0-32767). Default is 500.

/sbt n - Split input file by time (in milliseconds).
/sbs - Split input file by silence.
/sbst - Silence threshold (0-32767). Default is 500.

/limitbyd - Limit by duration (in milliseconds).

/mcmd - Specify manual command line for external encoder (e.g. for mp3 /mcmd "-V0").

/encoderexe - Specify the executable for the encoder.

/owav - Use wav as output file extension.

/fileexists n - How to handle existing output file, where n is:
0 = Overwrite (default)
1 = Overwrite when source file is newer
2 = Rename existing file to .bak<n>
3 = Add a numeric suffix <_n> to the new file's name
4 = Skip

/pt - Preserve timestamps of files and folders.

/skipbadframes - Skip bad frames when decoding. Warning will be given, if any was skipped. Off by default.

/buffersize - Set encoding buffer size used by external exe encoder. Value is in KB, e.g. 64 means 64K.

/onthefly - Use on-the-fly encoding method (see http://xrecode.com/xrecode3/wiki/index.php?title=Misc)

/uselib - Use dll encoder (currently for Ogg only).
/useexe - Use exe encoder (when it's configured in settings.ini).

/pfilename - Set output file name pattern for the destination.

/preferredcodecs - Set preferred source file codecs. If codec of the source file does not match one from the list, file will be skipped.
Value can contain several comma delimited values. In this case codes will be evaluated in the specified order.
Example1: if value is set to mlp,pcm and there are source files with mlp and pcm codecs, only the mlp files will be processed.
Example2: if value is set to mlp and there are no source files with mlp codecs, no files will be processed.

/scandts - Scan WAV files for DTS stream.

Metadata parameters:
/nometa - Do not save Metadata in output file (including covers).
/createcue - Create CUE file.
/embedcue - Embed CUE into output file (if supported).
/createm3u - Create m3u playlist.
/nocovers - Do not save cover(s) in output file.
/onlyfirst - Save only first cover in output file, i.e. if source file contains more than one cover, only the 1st one will be saved in the output file.
/coverfilename - File name template to save cover(s) to, e.g. /coverfilename "%album%_%albumartist%", /coverfilename "folder"
/firstcoverfilename - File name template to save only first cover to, e.g. /coverfilename "%album%_%albumartist%", /coverfilename "folder"
/usecuemetaonly - Use metadata from CUE file only.
/nsec - Do not search for external metadata (i.e. in files like cover.jpg, etc.).
/tr - Tagsreplaxe file name.

/retrievemeta - Retrieve Metadata from internet.

/matrix - Set output matrix, e.g. FL:0,1;FR:1,0 to exchange left and right channels of a stereo file.

/rename - Rename files using pattern.

/exportmeta /o <filename> - Export Metadata to file <filename>.
/exportmeta /ec /o <path> - Export only Covers the specified path.
/importmeta <filename> - Import Metadata from file <filename>.

Notes:
Dash (-) and forward slash (/) both can be used to specify parameters, e.g. both /i and -i are valid.
If sample rate, channels or bits per sample are too large for the specified format,
maximum possible value will be used instead.

Use --ansi-output parameter if you want to forward program's output to a file. Errors will be written to the StdErr.

To display information about file(s) use -i parameter only.

== Examples ==

Output information about file:
-i c:\files\00001.m2ts

Convert wav files (including sub-folders) to mp3:
-i c:\files\*.wav /r -o c:\output /dest mp3

Convert wav files (including sub-folders) to mp3 using joint-stereo:
-i c:\files\*.wav /r -o c:\output /dest mp3 /cbr 320 /js

Convert wav files (including sub-folders) to mp3 using VBR method:
-i c:\files\*.wav /r -o c:\output /dest mp3 /vbrmin 64 /vbrmax 320

Convert wav files (including sub-folders) to mp3 using preset 5:
-i c:\files\*.wav /r -o c:\output /dest mp3 /preset 5

Convert wav files (including sub-folders) to mp3 using VBR 192:
-i c:\files\*.wav /r -o c:\output /dest mp3 /vbr 192

Convert wav files (including sub-folders) to ogg using quality/preset 5:
-i c:\files\*.wav /r -o c:\output /dest ogg /quality 5

Convert wav files (including sub-folders) to ogg using CBR 160:
-i c:\files\*.wav /r -o c:\output /dest ogg /cbr 160

Convert wav files to flac using 96000 as output sample rate and 24-bit as output sample format:
-i c:\files\*.wav -o "c:\output with spaces" /dest flac /b 24 -sr 96000

Convert wav files to flac, using 96000 as output sample rate and 24bit as output sample format. Also analyse Replay Gain and apply to output audio:
-i c:\files\*.wav -o c:\output /dest flac /b 24 /sr 96000 /n /nsaa

Convert wav files to mp3 by applying matrix to the audio to swap left and right channels:
-i c:\files\*.wav -o c:\output /dest mp3 /matrix "FL:0,1;FR:1,0"

Convert several wav files to one flac file:
-i c:\files\*.wav -o "c:\output" /dest flac /one

Convert wav files (including sub-folders) to mp3. Normal output is redirected to file names process, error output is redirected to file named errors:
-i c:\files\*.wav /r -o c:\output /dest mp3 --ansi-output 1>process 2>errors

Rename added files:
-i c:\files\*.mp3 /rename "%track2%. %title%"

Convert CUE image to mp3 by specifying custom file name pattern:
-i c:\files\one.cue /dest mp3 /pfilename "%albumartist%\%album%\%track2%. %title%"

Extract SACD as DSF:
-i c:\files\sacd.iso /sacdas dff /dest extract /o c:\output

Compress to flac using compression level 3
-i c:\files\*.wav -o c:\output /dest flac /compression 3

Compress to flac uncompressed
-i c:\files\*.wav -o c:\output /dest flac /compression 0

Convert flac files (including sub-folders) to mp3 and excludinf some file name:
-i c:\files\*.flac /r -o c:\output /dest mp3 /exclude *HTOA*

Convert flac files to mp3 by passing manual command line to lame encoder:
-i c:\files\*.flac /r -o c:\output /dest mp3 /mcmd "--preset extreme"

Copy mp3 files to folder by applying file name pattern:
-i c:\files\*.mp3 -o c:\output /dest copy /pfilename "%albumartist%\%album%\%track2%. %title%"

Convert SACD iso files to dts using wav as extension, using external encoder and removing clicks:
-i c:\files\some.iso -o c:\output /dest dts /encoderexe "c:\dts\surcodedts.exe" /owav /pad "50/50"



== Specifying external executable files ==
It is possible to specify location of external encoder files using '''settings.ini''' file. For example, if console executable is located in folder '''c:\xr3console''', file named '''settings.ini''' must be put in a folder '''c:\xr3console\portable\console\settings\x86''' for 32-bit executable, or '''c:\xr3console\portable\console\settings\x64''' for a 64-bit executable.
*''settings.ini'' must contain definition for executables like this (you only need to specify ones you want to use)
enc.mp3.executable=D:\xr3console\lame.exe
enc.ogg.executable=D:\xr3console\oggenc2.exe
enc.flac.executable=c:\flac\flac.exe
enc.wavpack.executable=C:\wavpack\wavpack.exe

<historylink type="back" />

Global Settings

2020-09-20T18:58:24Z

Wikiadmin:

[[file:Settings_global_settings.png]]
*Use tabs - enable/disable tabbed UI.
*Confirm program exit - program will ask for confirmation on exit.
*Confirm cancel - program will ask for confirmation when process is cancelled.
*Delete created folders/files when process is cancelled - all created files and/or folders will be deleted when process is cancelled.
*Open output folder after conversion - output folder will be opened in file explorer when all processes are completed.
*Close program when done - program will be closed when all processes are completed.
*Always on top - program will be kept on top of the other.
*Allow multiple program instances - when enabled, multiple instance of program can be started. Also, when adding files from Shell, they will be added to the new instance of then program. When disabled, only one instance is allowed. When files are sent from Shell, they will be added to that one instance (if it's not busy).
*Language - change language.
*Success sound - will be played when there were no errors during the process.
*Error sound - will be played in case of an error during the process.
*Check updates on startup - program will check for updated version once a day.
**Check for beta versions - enable this, if you want to get access to beta versions (sometimes might be unstable) of the program.
*Export - export program's settings to a zip file.
*Import - import program's settings from a zip file.
<historylink type="back" />

2020-07-08T15:17:06Z

Wikiadmin:

== Requirements ==
Command line parameters are only supported by the console version of XRECODE3.

== Usage ==
Usage: <input> <dest> <parameters> <output>

Parameters:
/i - Files to add. Wildcards are supported. If /r is used, files from sub-folders will be added as well.
/dest - Output format (mp3, ogg, flac, m4a, dsd64, dsd128, etc.) or copy to just copy files to the destination foler by applying file name pattern.
/o - Output path.
/exclude x - file name to exclude (can contain * and ?, case does not matter). Several /exclude parameters can be passed.

/dsdft - Output file type for DSD (dff or dsf).

/preset n - Use preset (where it's applicable, e.g. mp3).
/quality n - Quality parameter for Ogg.
/compression n - Compression for flac (0 to 8, where 0 is "uncompressed").
/cbr - Use CBR (e.g. 160, 192, 320, etc. Also used as CBR Max parameter).
/vbr - Use VBR (e.g. 160, 192, 320, etc. also used as VBR Max parameter).
/vbrmin - VBR Min parameter (e.g. 160, 192, 320, etc.).
/js - Use Joint Stereo (for mp3 only).
/dc - Use Dual Channel (for mp3 only).
/maxng - Apply Max Noclip Gain (for mp3 only).

/merge - Merge files (using merge per folder).
/mergenbf - Merge files (not using merge per folder).
/split - Split into file per channel.
/one - Encode to one multi-channel file.

/temp - Custom temporary files folder (e.g. c:\tempfolder).
/pp n - Number of Cores/CPUs to use (all will be used by default).
/recycle - Move source files to Recycle Bin when done.
/delete - Delete source files when done. USE WITH CAUTION!

/usesource - Add all source folders to the output path (cannot be used together with source* or skip* parameters).
/sourceb n - Number source folders (from the beginning) to include.
/sourcee n - Number source folders (from the end) to include.
/skipb n - Number source folders (from the beginning) to skip.
/skipe n - Number source folders (from the end) to skip.
/createinsrc - Create files in source folder.

/sr - Output sample rate.
/c - Output channels.
/b - Output bits per sample (16, 24, 32 or 32i). 32 is for 32bitfloat, 32i for 32bitint.
/as n - Specify which audio stream to use. Only usable for files with several audio streams.
By default first one is used. Please note that index of the first audio stream is 1.

/n - Normalize audio (by default EBUR128 method is used).
/na - Normalize audio in album mode.
/nafa - Each folder is album (only works with -na).
/nsit - Save normalization values in Tags (can only be used together with -n).
/nsaa - Apply normalization to audio (can only be used together with -n).
/nrg - Use ReplayGain as a method
/nrgl n - Target dB level (89 by default).

/sacdarea n - SACD ISO area to use (s for stereo, m for multi-channel, b for both).
/sacdvolume n - SACD ISO volume in dB (from 0 to 6).
/sacdas x - Extract SACD as (DFF, DSF or ASIS).
/dop - Use DSD-over-PCM (DoP) (for WAV as a destination only).
/pad x - Remove clicks when decoding SACD via padding samples (e.g. /pad "50/50").

/remsilence1 - Remove silence from the beginning of the track.
/remsilence2 - Remove silence from the end of the track.
/st - Silence threshold (0-32767). Default is 500.

/sbt n - Split input file by time (in milliseconds).
/sbs - Split input file by silence.
/sbst - Silence threshold (0-32767). Default is 500.

/limitbyd - Limit by duration (in milliseconds).

/mcmd - Specify manual command line for external encoder (e.g. for mp3 /mcmd "-V0").

/encoderexe - Specify the executable for the encoder.

/owav - Use wav as output file extension.

/fileexists n - How to handle existing output file, where n is:
0 = Overwrite (default)
1 = Overwrite when source file is newer
2 = Rename existing file to .bak<n>
3 = Add a numeric suffix <_n> to the new file's name
4 = Skip

/pt - Preserve timestamps of files and folders.

/skipbadframes - Skip bad frames when decoding. Warning will be given, if any was skipped. Off by default.

/buffersize - Set encoding buffer size used by external exe encoder. Value is in KB, e.g. 64 means 64K.

/onthefly - Use on-the-fly encoding method (see http://xrecode.com/xrecode3/wiki/index.php?title=Misc)

/uselib - Use dll encoder (currently for Ogg only).
/useexe - Use exe encoder (when it's configured in settings.ini).

/pfilename - Set output file name pattern for the destination.

/preferredcodecs - Set preferred source file codecs. If codec of the source file does not match one from the list, file will be skipped.
Value can contain several comma delimited values. In this case codes will be evaluated in the specified order.
Example1: if value is set to mlp,pcm and there are source files with mlp and pcm codecs, only the mlp files will be processed.
Example2: if value is set to mlp and there are no source files with mlp codecs, no files will be processed.

/scandts - Scan WAV files for DTS stream.

Metadata parameters:
/nometa - Do not save Metadata in output file (including covers).
/createcue - Create CUE file.
/embedcue - Embed CUE into output file (if supported).
/createm3u - Create m3u playlist.
/nocovers - Do not save cover(s) in output file.
/onlyfirst - Save only first cover in output file, i.e. if source file contains more than one cover, only the 1st one will be saved in the output file.
/coverfilename - File name template to save cover(s) to, e.g. /coverfilename "%album%_%albumartist%", /coverfilename "folder"
/firstcoverfilename - File name template to save only first cover to, e.g. /coverfilename "%album%_%albumartist%", /coverfilename "folder"
/usecuemetaonly - Use metadata from CUE file only.
/nsec - Do not search for external metadata (i.e. in files like cover.jpg, etc.).
/tr - Tagsreplaxe file name.

/retrievemeta - Retrieve Metadata from internet.

/matrix - Set output matrix, e.g. FL:0,1;FR:1,0 to exchange left and right channels of a stereo file.

/rename - Rename files using pattern.

/exportmeta <filename> - Export Metadata to file <filename>.
/importmeta <filename> - Import Metadata from file <filename>.

Notes:
Dash (-) and forward slash (/) both can be used to specify parameters, e.g. both /i and -i are valid.
If sample rate, channels or bits per sample are too large for the specified format,
maximum possible value will be used instead.

Use --ansi-output parameter if you want to forward program's output to a file. Errors will be written to the StdErr.

To display information about file(s) use -i parameter only.

== Examples ==

Output information about file:
-i c:\files\00001.m2ts

Convert wav files (including sub-folders) to mp3:
-i c:\files\*.wav /r -o c:\output /dest mp3

Convert wav files (including sub-folders) to mp3 using joint-stereo:
-i c:\files\*.wav /r -o c:\output /dest mp3 /cbr 320 /js

Convert wav files (including sub-folders) to mp3 using VBR method:
-i c:\files\*.wav /r -o c:\output /dest mp3 /vbrmin 64 /vbrmax 320

Convert wav files (including sub-folders) to mp3 using preset 5:
-i c:\files\*.wav /r -o c:\output /dest mp3 /preset 5

Convert wav files (including sub-folders) to mp3 using VBR 192:
-i c:\files\*.wav /r -o c:\output /dest mp3 /vbr 192

Convert wav files (including sub-folders) to ogg using quality/preset 5:
-i c:\files\*.wav /r -o c:\output /dest ogg /quality 5

Convert wav files (including sub-folders) to ogg using CBR 160:
-i c:\files\*.wav /r -o c:\output /dest ogg /cbr 160

Convert wav files to flac using 96000 as output sample rate and 24-bit as output sample format:
-i c:\files\*.wav -o "c:\output with spaces" /dest flac /b 24 -sr 96000

Convert wav files to flac, using 96000 as output sample rate and 24bit as output sample format. Also analyse Replay Gain and apply to output audio:
-i c:\files\*.wav -o c:\output /dest flac /b 24 /sr 96000 /n /nsaa

Convert wav files to mp3 by applying matrix to the audio to swap left and right channels:
-i c:\files\*.wav -o c:\output /dest mp3 /matrix "FL:0,1;FR:1,0"

Convert several wav files to one flac file:
-i c:\files\*.wav -o "c:\output" /dest flac /one

Convert wav files (including sub-folders) to mp3. Normal output is redirected to file names process, error output is redirected to file named errors:
-i c:\files\*.wav /r -o c:\output /dest mp3 --ansi-output 1>process 2>errors

Rename added files:
-i c:\files\*.mp3 /rename "%track2%. %title%"

Convert CUE image to mp3 by specifying custom file name pattern:
-i c:\files\one.cue /dest mp3 /pfilename "%albumartist%\%album%\%track2%. %title%"

Extract SACD as DSF:
-i c:\files\sacd.iso /sacdas dff /dest extract /o c:\output

Compress to flac using compression level 3
-i c:\files\*.wav -o c:\output /dest flac /compression 3

Compress to flac uncompressed
-i c:\files\*.wav -o c:\output /dest flac /compression 0

Convert flac files (including sub-folders) to mp3 and excludinf some file name:
-i c:\files\*.flac /r -o c:\output /dest mp3 /exclude *HTOA*

Convert flac files to mp3 by passing manual command line to lame encoder:
-i c:\files\*.flac /r -o c:\output /dest mp3 /mcmd "--preset extreme"

Copy mp3 files to folder by applying file name pattern:
-i c:\files\*.mp3 -o c:\output /dest copy /pfilename "%albumartist%\%album%\%track2%. %title%"

Convert SACD iso files to dts using wav as extension, using external encoder and removing clicks:
-i c:\files\some.iso -o c:\output /dest dts /encoderexe "c:\dts\surcodedts.exe" /owav /pad "50/50"



== Specifying external executable files ==
It is possible to specify location of external encoder files using ''settings.ini'' file. For example, if console executable is located in folder c:\xr3console, settings.ini for it must be put in a folder c:\xr3console\portable\console\settings\x86 for 32-bit executable, or c:\xr3console\portable\console\settings\x64 for a 64-bit executable.
*''settings.ini'' must contain definition for executables like this (you only need to specify ones you want to use)
enc.mp3.executable=D:\xr3console\lame.exe
enc.ogg.executable=D:\xr3console\oggenc2.exe
enc.flac.executable=c:\flac\flac.exe

<historylink type="back" />

Tags replace definition file

2020-06-24T10:46:05Z

Wikiadmin:

__FORCETOC__
== Example of tags replace file. Rows starting with # are comments and are ignored. ==
<nowiki>
#
# Values must be put into sections.
# The following section names are supported:
#
# [*] is for all tags, i.e. values specified under this section will be replace in all tags
# Following tag-specific identifiers can be used. Values will be replaced only in specified tag.
# [Conductor]
# [Date]
# [Publisher]
# [Lyrics]
# [Flags]
# [ISRC]
# [Title]
# [Catalog]
# [Year]
# [Genre]
# [Artist]
# [Album]
# [DiscId]
# [BPM]
# [Album Artist]
# [Composer]
# [Content Group]
# [Compilation]
# [Disc]
# [Track]
# [Comments]
# [Encoded by]
#
# Format is <value from>=<value to>
# where <value from> is case-sensitive value, which will be replaced
# with <value to>, which is RegEx expression.
#
# If you want to do a case insensitive replacement, add ! to the name of the section
#
# Those are specific value, which can be used as <value from>:
#
# <NULL> is used to specify empty tag
# <ANY> is used to specify any value
#
# Special values which can be used in value
# %y - current year (nn)
# %Y - current year (nnnn)
# %m - current month (nn)
# %d - current day (nn)

# The following can be used for Track
# [Track]
# <ANY>=%track2%/%totaltracks2%
# which means that value for Track will be replaced with zero-padded value of Track
# %totaltracks2% will be replaced with zero-padded value of number of all tracks

[Encoded by]
<ANY>=Encoded by me @ %F %T

[Comments]
<ANY>=<NULL>

[DiscId]
<ANY>=<NULL>

[Album Artist]
<ANY>=<NULL>

# case sensitive replacement for all tags
[*]
Featuring=Ft.
featuring=ft.

#special case for semicolon (;)
#it must be escaped with the \, e.g. \;
#to remove semicolon from all tags, use
\;=

[Artist]
<NULL>=Some Artists

[Album]
<ANY>=Some Album

#All tags to UPPER case
#[*]
#%CHANGECASE%=UpperCase

#All tags to lower case
#[*]
#%CHANGECASE%=LowerCase

#Capitalize Each Word for all tags
#[*]
#%CHANGECASE%=CapitalizEeachWord
</nowiki>

*<NULL> means that only empty (null) value will be replaced.
*<ANY> means the any (empty or not) value will be replaced.
*Any value from [[File Name Pattern Elements]] can be used.
*%CHANGECASE% is a spcecial id, which means that case for all tags will be changed according to specified value (UpperCase, LowerCase or CapitalizEeachWord)

== List of functions which can be used ==
<nowiki>
# $$File(n)
# - use tags from n-th file
# $$FirstFile()
# - use tags from first file
# $$LastFile()
# - use tags from last file
# $$OnlyIfAllAreEqual()
# - only use the tag if all values in all files are equeal
# $$FirstNonEmpty()
# - take 1st non-empty value

# this will apply the function to all tags
[*]
<ANY>=$$FirstNonEmpty()
</nowiki>

<historylink type="back" />