WRESTOOL(1) General Commands Manual WRESTOOL(1)
wrestool – extract resources from Microsoft Windows(R) binaries
wrestool [OPTIONS]… [FILE]…
This manual page documents briefly the wrestool command. This manual
page was written for the Debian GNU distribution because the original
program does not have a manual page.
Wrestool reads 16- or 32-bit Microsoft Windows(R) binaries 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
These programs follow the usual GNU command line syntax, with long
options starting with two dashes (`-‘).
Extract resources. (By default, resources will be extracted to
standard out if –output was not specified.)
Output list of resources (default).
Resource type identifier of affected resources. If preceded with
a dash (“-”), id must be numeric; if preceded 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”
Resource name identifier of affected resources. Like the –type
option, a leading dash or plus sign controls the datatype of the
Resource language identifier. Has no effect when processing
Perform operation on all resource (default).
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.)
Do not parse resource contents – extract raw data. (This option
will probably be replaced with –format=raw in future version of
Explain what is being done. The verbose option may be specified
more than once, like “-vv”, to make wrestool even more ver‐
–help Display a help message and exit.
Output version information and exit.
The wrestool program recognizes the resource types listed below. The
ids of these resources are always numeric and not strings.
A single cursor bitmap image. Read as part of group_cursor
A bitmap image.
A single icon bitmap image. Read as part of group_icon
resources. This resource is similar to cursor resources; cur‐
sors contain four additional bytes of hotspot coordinates.
Resources for menus (in popup and menubars). Currently wrestool
does not support this resource type.
Definitions (widgets with locations) for dialog boxes. Cur‐
rently wrestool does not support this resource type.
The string table resource, containing a number of unicode
strings. Currently wrestool does not support this resource type.
The font directory, containing information on a number of font
resources (8). Non-TTF font (.FON) files are actually libraries
with resources in them. Currently wrestool does not support this
A single font – the contents of a .FNT file. Read as part of
fontdir resources. Currently wrestool does not support this
Keyboard accelerator tables. Currently wrestool does not sup‐
port this resource type.
Arbitrary resource data, user-defined. There are no restrictions
to the format of these resources.
A set of cursors. With a few modifications (and with cursor
resources), this resource can be extracted as a .CUR file.
A set of icons. With a few modifications (and with icons
resources), this resource can be extracted as a .ICO file.
Version information, stored as binary data. Could be extracted
without modifications, but the data is of probably little use.
Currently wrestool does not support this resource type.
Animated cursors. Currently wrestool does not support animated
cursor or icons, nor does icotool.
Animated icons. I have only seen these in Windows(R) 3.x. Cur‐
rently wrestool does not support animated cursor or icons, nor
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
Extract all icons to current directory, naming the destination files
$ wrestool -x –output=. -t14 write.exe
$ ls *.ico
This manual page was written by Colin Watson
the Debian GNU system (but may be used by others). It was later modi‐
fied by Oskar Liljeblad
Copyright © 2001 Colin Watson
Copyright © 2001 Oskar Liljeblad
This is free software; see the source for copying conditions. There is
NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
Windows is a registered trademark of Microsoft Corporation in the
United States and other countries.
wrestool (icoutils) April 18, 2005 WRESTOOL(1)