Extract Files

Extracts a translated file or group of translated files from a TTK.

Syntax

Catalyst /E TTKName ToFolder [/Original] [TextFileEncoding:"Option"] [/S] [/P] [FileTypes:Files_to_Extract] [SNKFile:snkFile] [ezLogFile:ezLogFile] [/write] [/open]

Catalyst /E FolderName ToFolder [/S] [/P] [/Original] [TextFileEncoding:"Option"] [/S] [/P] [FileTypes:Files_to_Extract] [SNKFile:snkFile] [ezLogFile:ezLogFile] [/write] [/open]

Catalyst /E TTKName ToFolder [Filename:FileName_To_Extract] [/Original] [TextFileEncoding:"Option"] [/S] [/P] [SNKFile:snkFile] [ezLogFile:ezLogFile] [/write] [/open]

Parameters

/E	Extract Files
TTKName	TTK Filename to extract files from.
ToFolder:Path	Extracted files will be stored in this folder/directory.
FolderName	The name of a folder that contains TTK files. All the TTKs in this folder will have their files extracted.
/S	Recursively scan all directories within FolderName and extract files from every TTK located. All extracted files will be stored in ToFolder.
/P	Extract files and store them in ToFolder maintaining the Project Hierarchy of each TTK. If the relevant subfolders do not exist in ToFolder then ezScript will create them automatically.
/Original	Use this option to extract the original file from the Project TTK.
TextFileEncoding:"Option"	Use this switch when extracting Text Files and you want a different encoding than the source file. The possible labels are: ANSI UTF16 UTF16BE UTF8 UTF8_NO_BOM
SNKFile:snkFile	Use this option to specify the path for the digital signature key file to be used to fully sign the .NET language assembly files when extracting them.
FileTypes:Files_to_Extract	This tag will allow the user to extract only the extensions matching a certain mask. Use a comma to separate each mask. Note: You cannot use a partial file extension for a mask.
Filename:FileName_To_Extract	Name of the file to be extracted from the TTK file. If backslash is used at beginning of FileName_To_Extract: only the filename with the exact path from the root will be deleted /P maintains folder structure the root folder of the ttk should not be specified If no backslash appears in front of FileName_To_Extract: file in the ttk matching that name is extracted, disregarding path in ttk If /P is used, the folder structure within the ttk is maintained on extraction If /S and /P are used, all files matching that name in the ttk are extracted and folder structure maintained if just /S is used, the first file matching that filename in the ttk is extracted
ezLogFile:ezLogFile	The user can optionally specify a log file to which results of each Catalyst ezScript command are output. If the log file is not specified by the user or is invalid, the default log file (ezScriptBatchLog.txt in the Public location) is used.
/write	The command line which has been processed by Catalyst will be written into the ezScript batch log file. This will help to debug your command if something is not behaving as expected.
/open	Launches MS Notepad and displays the content of ezScript batch log when the command finishes.

Examples

Extract all files from GMC.ttk and store them in C:\Destination

Catalyst /E GMC.ttk C:\Destination

Extract all files from C:\FinalBuilds into C:\TranslatedBuilds and preserve the TTK project hierarchy.

Catalyst /E C:\FinalBuilds C:\TranslatedBuilds /P

Extract files from all TTKs stored in C:\Translations, and all sub-folders and store them in C:\FinalFiles

Catalyst /E C:\Translations C:\FinalFiles /S

Extract all files from MixedFileTypes.ttk stored in C:\Samples and save to folder C:\Samples\Extracted. Any text files found in this TTK will be extracted with the encoding type of UTF8 with no BOM (Byte Order Mark).

Catalyst /E "C:\Samples\MixedFileTypes.ttk" "C:\Samples\Extracted" TextFileEncoding:"UTF8_NO_BOM" /P

Extract all files from DotNETProject.ttk stored in C:\Samples store them in C:\Samples\Extracted. All .NET assembly language files will be signed with the key from the file Key.snk.

Catalyst /E "C:\Samples\DotNETProject.ttk" "C:\Samples\Extracted" SNKFile:"C:\Samples\Signing\Key.snk" /P

Extract files with an extension of either *.dll, *.rc or *.json from MixedFileTypes.ttk stored in C:\Samples and save them to folder C:\Samples\Extracted.

Catalyst /E "C:\Samples\MixedFileTypes.ttk" "C:\Samples\Extracted" Filetypes:"*.dll,*.rc,*.json" /P

Extract all files in ttk named Idbasedfiles.properties to location d:\Project\Extract maintaining ttk folder structure on extraction and giving all the extracted (text) files UTF16 Big Endian encoding:

Catalyst /E "d:\Project\SWProject.ttk" "d:\Project\Extract" Filename:"Idbasedfiles.properties" /P /S ezlogfile:"d:\Project\Batchlog.txt" Textfileencoding:UTF16BE /write

Extract the first file in the ttk named Idbasedfiles.properties directly to location d:\Project\Extract and giving the extracted (text) file UTF8 without BOM encoding:

Catalyst /E "d:\Project\SWProject.ttk" "d:\Project\Extract" Filename:"Idbasedfiles.properties" ezlogfile:"d:\Project\Batchlog.txt" TextFileEncoding:UTF8_NO_BOM /write

Extract only -Project Title-\New\Sub NEW\Idbasedfiles.properties from the ttk, maintaining folder structure, so resulting in: d:\Project\Extract\-Project Title-\New\Sub NEW\Idbasedfiles.properties and encoding the extracted file as UTF8:

Catalyst /E "d:\Project\SWProject.ttk" "d:\Project\Extract" Filename:"\New\Sub NEW\Idbasedfiles.properties" /P ezlogfile:"d:\Project\Batchlog.txt" TextFileEncoding:UTF8 /write