Command Line
Requirements
Console version of XRECODE3 is required to use command line.
Usage
Usage: <input> <dest> <params> <output>
Parameters: <input> <dest> <params> <output> /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, etc.) /o - Output path.
/preset n - Use preset (where it's applicable, e.g. mp3). /quality n - Qulity parameter for Ogg. /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. /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.
/sourceb n - Number source folders (from the beginning) to include.
/sourcee n - Number source folders (from the end) to include.
/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 (EBUR128 will be used).
/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).
/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 miliseconds).
Metadata parameters: /nometa - Do not save Metadata in output file (including covers). /createcue - Create CUE file. /embedcue - Embed CUE into output file (if supported). /nocovers - Do not save cover(s) in output file. /onlyfirst - Save only first cover in output file. /coverfilename - File name template to save cover(s) to. /firstcoverfilename - File name template to save only first cover to. /usecuemetaonly - Use metadata from CUE file only. /retrvievemeta - 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. 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 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 24nit 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 24nit 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 wav files (including sub-folders) to mp3. Normal output is redirected to file names process, error output is redirected to file name errors: -i c:\files\*.wav /r -o c:\output /dest mp3 --ansi-output 1>process 2>errors
Advanced
Normally, executable of console version (xrecode3cx64.exe or xrecode3c) should be copied to the same folder as executable of the main program, but it is also possible to keep them in separate folders. For example:
- executable of console version is copied to folder "C:\xr3console"
- main executable is located in "C:\Program Files\xrecode3"
Parameter /bin can be used to tell console executable where the main program is:
C:\xr3console\xrecode3cx64.exe /bin "C:\Program Files\xrecode3\bin" -i "D:\test\wav\album\*.wav" -o "d:\converted\output" /dest flac