| Options | |||
|---|---|---|---|
| Option | Param | Description | |
| -t | --test | Run in test mode, modify nothing. >>> USE THIS OPTION IF UNSURE! <<< |
|
| -T | --titles | file | Read file for disc titles. |
| --utf-8 | Enables UTF-8 support for filenames (default). | ||
| --no-utf-8 | Disables UTF-8 support for filenames. | ||
| --lang | lang | Define the language for titles. | |
| -s | --source | path | Use the entered file or directory as source. If parameter PATH contains at least one wildcard (e.g. '*.wbfs'), then PATH is used as search pattern and all found files are added. In order to use this variant, the calling shell must not interpret the wildcards. Therefore, the parameter must usually be enclosed in single or double quotes. Directories are expanded to all containing files but hidden files (file names begins with a point) are ignored. If a command needs only images then non image files of the directory are ignored without notification. The option --no-expand suppress the directory expansion. |
| --no-expand | Do not expand directories to the containing files or images. This option does not change the behavior of --recurse. | ||
| -r | --recurse | path | If If parameter PATH contains at least one wildcard (e.g. '*.wbfs'), then PATH is used as search pattern and all found files are added. In order to use this variant, the calling shell must not interpret the wildcards. Therefore, the parameter must usually be enclosed in single or double quotes. Directories are scanned for source files recursively. The option --rdepth limits the search depth. Hidden files and hidden sub directories (file names begins with a point) and files with non supported file types (non ISO files for most commands) are ignored without notification. |
| --rdepth | depth | Set the maximum recurse depth for option --recurse. The default search depth is 10. | |
| -x | --exclude | id | A comma separated list with ID4 and ID6 values is expected. |
| -X | --exclude-path | file_or_dir | Scan the ID of the source and add it to the exclude list. If the source is a directory then scan all images of the directory. Images with the given ID are excluded from operation. Each use of this option expands the exclude list. See --include-first for precedence issues. |
| -n | --include | id | A comma separated list with ID values is expected. |
| -N | --include-path | file_or_dir | Scan the ID of the source and add it to the include list. If the source is a directory then scan all images of the directory. Only images with the given ID are included into the operation. Each use of this option expands the include list. See --include-first for precedence issues. |
| --include-first | The options --include, --include-path, --exclude and --exclude-path decide which discs are included into the operation. If neither include nor exclude options are used, than all disc are included into the operation. If only include options are used, than only the specified discs are operated. If only exclude options are used, than all all discs but not the excluded are operated.
If include and exclude options are used together and |
||
| -1 | --one-job | Execute only the first job and exit. This is a shortcut for »--job-limit 1«. | |
| --job-limit | num | Execute only the first |
|
| -i | --ignore | Ignore non existing files/discs without warning. If set twice then all non Wii and GameCube ISO images are ignored too. | |
| -q | --quiet | Be quiet and print only error messages. | |
| --sections | Print in machine readable sections and parameter lines. | ||
| -d | --dest | path | Define a destination path (directory or file). The destination path is scanned for escape sequences (see option --esc) to allow generic paths. |
| -D | --DEST | path | Like --dest, but create the directory path automatically. |
| -E | --esc | char | Define an alternative escape character for destination files. The default is '%'. For Windows (CYGWIN) it is a good choice to set |
| -o | --overwrite | Overwrite already existing files without warning. | |
Each source, that is a Wii disc image (ISO image), is candidate for moving. See »Reading an image« for details.
Non ISO files are ignored with a warning. The option --ignore suppresses this warning. Existing files will only be overwritten if option --overwrite is set.
The destination filename can be filled with esacpe sequences to generate content dependent filenames. See »Writing an image« for details.
The option --test enables test mode: No files are renamed. If --test is set at least two times a source list with a trailing destination will be printed.
0 == OK : all done without errors. SYNTAX ERROR : at least one syntax error in command line found. READ ERROR : error while reading a file. WRITE ERROR : error while writing a file. CANT CREATE : Can't create output file.