Batch Processing is a powerful tool for processing and converting a set of files automatically.
Use Batch Processing to:
Each tab contains settings to configure edits and effects, conversions, destination folder, and file information. These are explained below.
When everything is configured, you can use the preset controls to save all the settings, then choose the Begin button to start processing all the files. A status window will appear showing the progress and listing any errors that occur.
Files are processed one at a time in the order they are listed. Each file is processed as follows:
To process raw files that GoldWave cannot open automatically, such as .vox or .pcm, use Options | File Formats to add a default format for that type.
Source Tab
Use these controls to specify files to process. Select
Current Sound window
to process the currently active Sound window opened
in GoldWave. Only items on the Process
tab are applied. No other changes are made. The file is not converted and the information
is not changed. Select All Sound windows to process all opened Sound windows in
GoldWave in the same manner.
Select Files and folders to create a list of files to process. Add files with the Add Files button or drag-and-drop a group of files from Windows Explorer. Add an entire folder (including subfolders) or all the files in a folder of a specific type by using the Add Folder button. Remove items from the list by selecting one or more of them and choosing the Remove button. The Clear button removes all files and folders from the list.
Process Tab
To apply effects or edits to a group of files, use this tab
to add a set of effects, edits, or chains to the list. If no effect
processing is required, remove all effects by using the Clear
button on this tab. To remove a single effect from the list, select
the effect and use the Remove button. To change the order of processing,
drag-and-drop items within the list or use the Up or Down
button.
To add an effect, use the Add Effect button to display a tree list of all effects available and their presets. Select the preset you want to use. If you require custom effect settings, you must create new presets for the effect outside of Batch Processing. To do that, open a file, display the effect window, adjust the settings, then add a preset. Chains may be added by using the Add Chain button. Effects and chains are performed on the entire file by default. To perform them on part of the file only, add an edit to set the selection first (see the fade in/out example below).
To add an edit, use the Add Edit button. The Set Marker/Selection edit command sets the part of the file (the selection) to use for all subsequent effects and edits during processing. The selection can be specified using time, percent, or cue point names or indexes. If using the Cue option to set the selection, the first cue point matching the given name is used. If a number is given, cue points are searched for a name matching the number. If no such cue point is found, then the number is used as an index in the list of cue points. So if the number 6 is given, for example, a cue point with the name "6" is searched for first. If that name isn't found, then the sixth cue point is used. The Quick selection drop down list contains many examples of selection settings.
To change settings for an edit or effect, remove it, add a new one with the correct settings, then drag-and-drop it to the correct position in the process list (if necessary). If you require effect settings that are not available in any of the current presets, open a file and use the Effect menu or the Effect Chain Editor tool to create a new preset or chain with the settings you require prior to using Batch Processing.
To add or edit a comment, either double click a line in the process list or select a line and press the Ctrl+N key. If you are changing or adding a comment to an existing preset, be sure to update the preset by choosing the preset Add button.
Process Example
You have hundreds of songs and want to create a 10 second sample
file for each song, with the beginning faded in, the end faded out,
and the volume maximized. To set up that processing requires adding
eight edits and effects, as explained below.
After performing all these steps, the process list will contain eight edit and effect items. Use the Convert and Destination tabs to set the file type and destination folder for the 10 second sample files (so the original files are not overwritten). Add all the songs in the Source tab and begin processing.
To use clipboard related edit commands, it may be necessary to open a file and copy it prior to using Batch Processing. For example, to paste or mix an announcement at the beginning of many files, first open the file containing the announcement, use Copy, then use Batch Processing and add a Paste or Mix edit command to the Process list.
Convert Tab
If the Convert files to this format box is checked, then files
are converted to the format specified on this tab. Otherwise
no conversion is performed and a processed file will have the
same format as the original file, if possible. If the same format
cannot be used, then an error is reported.
Use the Save as type drop down list to select the destination format for the conversion, then use the Attributes drop down list to select the specific attributes to use for the destination type. If a save type supports customized attributes, use the Custom button to display a configuration window.
If the attributes allow any sampling rate to be used, you can specify the destination rate to use by checking the Rate box and entering the rate in the box. Some attributes have a fixed rate, so a separate rate cannot be specified for those. If no rate conversion is needed, make sure the Rate box is not checked. In that case, a processed file will have the same rate as the original file.
Destination Tab
To stored all processed files in the folder
where they currently reside, select Store all files in their
original folder.
To store all processed files in a specific folder, select Store all files in this folder and specify a folder in the box provided. You can click on the folder button to browse for a folder.
When adding an entire folder with subfolders by using the Add Folder button, select Preserve subfolder structure to ensure that the relative subfolders are maintained when storing processed files in a different destination folder. If this item is not checked, all files are stored in the destination folder and no subfolders are created. Folders listed in the file list will have double backslashes. The part before the double backslashes will be replaced by the destination folder. For example, if the destination folder is C:\Folder1\ and the added folder (with subfolders included) is C:\Source1\Source2\, then the file list may look something like this:
C:\Source1\Source2\*.* C:\Source1\Source2\\Source3\*.* C:\Source1\Source2\\Source4\*.* C:\Source1\Source2\\Source4\Source5\*.*
Note the double backslashes. The destination folders will be:
C:\Folder1\*.* C:\Folder1\Source3\*.* C:\Folder1\Source4\*.* C:\Folder1\Source4\Source5\*.*
Taking the last item, the folder is divided into three parts with the following colour coding: the
original source root folders, the subfolders, and the pattern.
C:\Source1\Source2\\Source4\Source5\*.*
The destination folder is:
C:\Folder1\
The original source folders are replaced by the destination folder to give:
C:\Folder1\Source4\Source5\*.*
Using the Add Folder button more than once when preserving subfolders is not recommended unless you fully understand how the source folder, subfolders, and destination folder are manipulated.
To overwrite any files having the same name and folder as the processed file, check the Overwrite existing files checkbox. GoldWave fully processes original files before overwriting them. Check the Only if older than the original checkbox to process and overwrite files that have not been processed or modified recently. Files are processed only if the destination file does not exist already or if the destination file is older than the original file. Selecting the Delete original files checkbox removes the original files after processing. Note the warning below.
Overwriting or deleting original files is not recommended. Processing lossy formats such as MP3 and iTunes M4A reduces the quality. Always keep a copy of the high quality original files.
Use Create log file to save the processing details shown in the progress window to a text log file that can be viewed and searched later (in the Notepad accessory, for example).
Information Tab
Use this tab to control how information is processed. See
File | Information.
Information Tab Settings | |
---|---|
Setting | Description |
Retain current text information | Keeps the file's current information unchanged. |
Replace text information | Replaces all of the information with new information provided using the Set Info button. Any blank entries are removed from the file. |
Replace specified text information only | Replaces the information with new information provided using the Set Info button. Blank entries are not removed or changed, except the Title. GoldWave uses the file's name as the Title text when a file currently has no Title. |
Remove text information | Removes all text information from the processed file. The Title is not set. |
Remove text information and pictures | Removes text, cover art, and other pictures. |
If the Track number is set to ##, GoldWave replaces it with a sequential number based on the order in which the files are processed. The first processed file will have a track number of 01, then the next file will have 02, etc. If the Title is left blank and the file does not have a title, GoldWave sets it to the file's name.
Depending on the settings used, all processed files may have exactly the same information (except for ## track numbering and title mentioned above), so care must be taken when specifying file specific information such as the Title. Also note that not all file types can store information.
When retaining information and converting to a different file type, some information from the old file type may not be valid for the new file type. GoldWave does not verify any information, so care must be taken when retaining information while converting.
Add Folder button on the Source tab of Batch Processing window.
Use this window to add an entire folder or file type to Batch Processing source list.
Enter the folder path in the Folder box or use the folder button to browse for a folder.
Specify the file type in the Type filter box. To add all files in the folder, select the *.* item from the drop down list. To add Wave files only, select the *.wav item. To add MP3 files, select *.mp3. Other unlisted items can be entered manually, such as *.abc.
Use the Include all subfolders checkbox to include all subfolders within the given folder. The entire tree of subfolders will be added to the list for processing. Use the Preserve subfolder structure checkbox on the Destination tab of Batch Processing to maintain the relative subfolder structure when storing processed files.
Add Edit button on the Process tab of Batch Processing window.
Use this window to add edit commands to Batch Processing process list. Supported commands are listed in the Edit command listbox. Additional settings may appear in the Settings area when a command is selected. Some commands do not have any additional settings.
When changing the selection, use the Quick settings drop down list to see examples of selections. If using the Cue option, the first cue point matching the given name is used. If a number is given, cue points are searched for a name matching the number. If no such cue point is found, then the number is used as an index in the list of cue points. So if the number 6 is given, for example, a cue point with the name "6" is searched for first. If that name isn't found, then the sixth cue point is used.
For more information about each command, look up the command in the Edit Menu Commands.
See Also: Editing Overview, Batch Add Effect Window
Add Effect button on the Process tab of Batch Processing window.
Use this window to add an effect to the Batch Processing process list. The tree list shows all plug-in modules.
To use effect settings that are not available in any of the current presets, open a file and use the effect to create a new preset with the settings you need.
To select an effect from a different plug-in module, scroll down the list and select the module name to expand its branch.
To use the effect on part of the file only, add an edit command to set the selection first.
See Also: Editing Overview, Edit Menu Commands, Effect Menu Commands, Presets
Add Logic button on the Process tab of Batch Processing window.
Use this window to add logic to the Batch Processing process list. Construct a logic statement or add labels by using the drop-down list boxes and edit boxes. See the tables below for details.
Logic Statements | |||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Statements | Description | ||||||||||||||||||||||
None | Use this statement to unconditionally change the flow of processing by performing a command. | ||||||||||||||||||||||
Label | Labels are used by the goto command to skip ahead or loop back to a specific point in the processing list. | ||||||||||||||||||||||
If value of |
Compares the value of two parameters using the selected comparison operator. Parameters are listed below.
|
Logic Commands | |
---|---|
Command | Description |
goto | Skips ahead or loops back to the given label in the processing list. Enter the label in the box below this drop-down list. Use the Label statement to add a label in the list. |
cancel processing this file | Stops processing the current file and starts processing the next file. |
error | Stop processing and displays an error message. Enter the message in the box below this drop-down list. |
terminate all processing | Stops all processing. Processing of the current file is stopped and no other files are processed. |
See Also: Editing Overview, Edit Menu Commands, Effect Menu Commands, Presets
Batch Processing on the command line uses presets, so the first step is to use Batch Processing to create a preset that does the processing required.
The -process command line parameter starts GoldWave in Batch Processing mode and processes files given on the command line. The basic syntax is as follows:
"C:\Program Files\GoldWave\GoldWave.exe" -process[:preset] <filespec> [<filespec> ...]
If no preset is specified, then the default (previous) settings are used. The filespec can specify a single file or contain wildcard characters (* and ?). Quotes are required if the filespec contains any spaces. Other parameters include -proclog:filename to set a log file, -region:start,length to set the initial selection for processing, and -clipboard:filename to set the initial contents of the edit clipboard, and -outfolder:pathname to set the destination folder.
To convert all Wave files to MP3 on the command line, for example, first use the Batch Processing command to create a preset with conversion set to the "MPEG Audio" file type and save that preset as "MP3". On the command line, enter the following parameters:
-process:MP3 "C:\My Music\*.wav"
If the preset name contains spaces, use quotes around the entire parameter:
"-process:Trim and convert" "C:\My Music\*.wav"
To include all subfolders when processing, include the -subfolders command line parameter:
-process:MP3 "C:\My Music\*.wav" -subfolders
Make sure all folder settings under the Destination tab are set appropriately in the preset before using this parameter and specify the absolute pathname of the folder (do not use relative pathnames). To specify a different destination folder than the one contained in the preset, include the -outfolder command line parameter. The Preserve subfolder structure setting must be set in the preset if the hierarchy is to be preserved. Quotes must be used around the entire parameter if spaces are used:
"-outfolder:C:\My Music\Batch Destination"
During processing the progress windows is displayed in minimized form, usually just above the Windows Start button. Double-click on it to open it to monitor processing. If no errors occur, the window will disappear and GoldWave will close automatically. Otherwise the progress window opens so that errors can be viewed. To use a log file instead, so that GoldWave always closes regardless of errors, use the -proclog command line parameter to specify the name of the log file:
-proclog:filenameQuotes are required around the entire parameter if the filename contains spaces:
"-proclog:C:\Log Files\Batch.log"
All messages and errors are appended to the log file in unicode (UTF-16). If you do not require a log file, but still need GoldWave to always close, use nul as the filename:
-proclog:nul
To process many commands in a single instance, store the list of command lines in a text file and use the @ symbol to specify that file in the process parameter. For example:
"C:\Program Files\GoldWave\GoldWave.exe" -process@batch.txt -proclog:batch.log
If a log file is specified, it will be used by default for all command lines in the list file. A different log file may be specified within the list file too.
Each command line must be stored on a single line in the list file. Do not break a command line across multiple lines. A list file would look like this:
-process:Trim *.wav -region:10.0,30.0 "-process:Convert to MP3" "C:\My Music\iTunes\*.m4a" -subfolders -proclog:itunes.log "-process:Match Volumes -18dB" *.wav