XWD(1) General Commands Manual XWD(1)
NAME
xwd - dump an image of an X window
SYNOPSIS
xwd [-debug] [-help] [-nobdrs] [-out file] [-xy] [-frame] [-add value]
[-root | -id wdid | -name wdname ] [-icmap] [-screen] [-silent] [-dis-
play host:dpy] [-version]
DESCRIPTION
Xwd is an X Window System window dumping utility. Xwd allows X users to
store window images in a specially formatted dump file. This file can
then be read by various other X utilities for redisplay, printing, edit-
ing, formatting, archiving, image processing, etc. The target window is
selected by clicking the pointer in the desired window. The keyboard
bell is rung once at the beginning of the dump and twice when the dump
is completed.
OPTIONS
-debug Enable debug mode.
-d, -display host:dpy
This argument allows you to specify the server to connect to;
see X(7).
-help Print out the `Usage:' command syntax summary.
-nobdrs This argument specifies that the window dump should not include
the pixels that compose the X window border. This is useful in
situations where you may wish to include the window contents in
a document as an illustration.
-out file
This argument allows the user to explicitly specify the output
file on the command line. The default is to output to standard
out.
-xy This option applies to color displays only. It selects `XY' for-
mat dumping instead of the default `Z' format.
-add value
This option specifies a signed value to be added to every pixel.
-frame This option indicates that the window manager frame should be
included when manually selecting a window.
-root This option indicates that the root window should be selected
for the window dump, without requiring the user to select a win-
dow with the pointer.
-id wdid
This option indicates that the window with the specified re-
source id should be selected for the window dump, without re-
quiring the user to select a window with the pointer.
-name wdname
This option indicates that the window with the specified WM_NAME
property should be selected for the window dump, without requir-
ing the user to select a window with the pointer.
-icmap Normally the colormap of the chosen window is used to obtain RGB
values. This option forces the first installed colormap of the
screen to be used instead.
-screen This option indicates that the GetImage request used to obtain
the image should be done on the root window, rather than di-
rectly on the specified window. In this way, you can obtain
pieces of other windows that overlap the specified window, and
more importantly, you can capture menus or other popups that are
independent windows but appear over the specified window.
-silent Operate silently, i.e. don't ring any bells before and after
dumping the window.
-version
This option indicates that xwd should print its version informa-
tion and exit.
ENVIRONMENT
DISPLAY To get default host and display number.
FILES
XWDFile.h
X Window Dump File format definition file.
SEE ALSO
xwud(1), X(7)
AUTHORS
Tony Della Fera, Digital Equipment Corp., MIT Project Athena
William F. Wyatt, Smithsonian Astrophysical Observatory
X Version 11 xwd 1.0.9 XWD(1)
Generated by dwww version 1.16 on Sat Oct 3 06:26:24 CEST 2026.