Next Previous Contents

4. wrestool

Usage:

wrestool [OPTIONS]... [FILE]...

The wrestool program reads 16- or 32-bit Windows binaries (.EXE and .DLL files), and lists or extracts the resources they contain. Some resources require processing before they can be written to files; wrestool is able to do this with icon and cursor resources.

Filters, specified as command line options, control what resources to extract.

4.1 Command line options

-x, --extract

Extract resources. (By default, resources will be extracted to standard out if --output was not specified.)

-l, --list

Output list of resources (default).

-t, --type=[+|-]ID

Resource type identifier of affected resources. If preceeded with a dash ("-"), id must be numeric; if preceeded with a plus sign ("+"), id must be a string.

The type ID may also be the name of a resource type. (If this is the case, a leading dash or plus sign may not be included.) A list of resource types can be found in the Resource Types section.

-n, --name=[+|-]ID

Resource name identifier of affected resources. Like the --type option, a leading dash or plus sign controls the datatype of the id.

-L, --language=[+|-]ID

Resource language identifier. Has no effect when processing 16-bit libraries.

--all

Perform operation on all resource (default).

-o, --output=PATH

Where to place extracted resources. If PATH does not refer to an existing directory, and does not end with a slash ("/"), all output will be written to the file PATH. (This means that if you extract multiple resources, PATH will contain the last resource only.)

-R, --raw

Do not parse resource contents - extract raw data. (This option will probably be replaced with --format=raw in future version of icoutils.)

-v, --verbose

Explain what is being done. The verbose option may be specified more than once, like "-vv", to make wrestool even more verbose.

--help

Display a help message and exit.

--version

Output version information and exit.

4.2 Examples

List all resources in file "write.exe":

$ wrestool -l write.exe
--type=3 --name=1 --lang=1033 [type=icon offset=0x3120 size=752]
--type=3 --name=2 --lang=1033 [type=icon offset=0x3410 size=304]
--type=14 --name=1 --lang=1033 [type=group_icon offset=0x3540 size=34]
--type=16 --name=1 --lang=1033 [type=version offset=0x3564 size=808]
$

List all (group-) icon resource in file "write.exe":

$ wrestool -l --type=group_icon write.exe
--type=14 --name=1 --lang=1033 [type=group_icon offset=0x3540 size=34]
$

Extract all icons to current directory, naming the destination files "write.exe_T_N.ico":

$ wrestool -x --output=. -t14 write.exe
$ ls *.xpm
write.exe_14_1.ico
$

Combining wrestool and icotool to extract icon images of an icon resource:

$ wrestool -x write.exe -t14 -n1 | icotool -x -o. -
$ ls *.xpm
write.exe_14_1.ico_16_16x16.xpm  write.exe_14_1.ico_16_32x32.xpm
$


Next Previous Contents