Screen capture

From ArchWiki
Jump to: navigation, search

This article explains different methods to capture your screen.

For a list of screenshot software, see List of applications/Multimedia#Screenshot.

For a list of screencast software, see List of applications/Multimedia#Screencast.

Screenshot software


An easy way to take a screenshot of your current system is using the import(1) command:

$ import -window root screenshot.jpg

import is part of the imagemagick package.

Running import without the -window option allows selecting a window or an arbitrary region interactively.

Note: If you prefer graphicsmagick alternative, just prepend "gm", e.g. $ gm import -window root screenshot.jpg.

Screenshot of multiple X screens

If you run twinview or dualhead, simply take the screenshot twice and use imagemagick to paste them together:

import -window root -display :0.0 -screen /tmp/0.png
import -window root -display :0.1 -screen /tmp/1.png
convert +append /tmp/0.png /tmp/1.png screenshot.png
rm /tmp/{0,1}.png

Screenshot of individual Xinerama heads

Xinerama-based multi-head setups have only one virtual screen. If the physical screens are different in height, you will find dead space in the screenshot. In this case, you may want to take screenshot of each physical screen individually. As long as Xinerama information is available from the X server, the following will work:

xdpyinfo -ext XINERAMA | sed '/^  head #/!d;s///' |
while IFS=' :x@,' read i w h x y; do
        import -window root -crop ${w}x$h+$x+$y head_$i.png

Screenshot of the active/focused window

The following script takes a screenshot of the currently focused window. It works with EWMH/NetWM compatible X Window Managers. To avoid overwriting previous screenshots, the current date is used as the filename.

activeWinLine=$(xprop -root | grep "_NET_ACTIVE_WINDOW(WINDOW)")
import -window "$activeWinId" /tmp/$(date +%F_%H%M%S_%N).png

Alternatively, the following should work regardless of EWMH support:

$ import -window "$(xdotool getwindowfocus -f)" /tmp/$(date +%F_%H%M%S_%N).png
Note: If screenshots of some programs (dwb and zathura) appear blank, try appending -frame or removing -f from the xdotool command.


You also can take screenshots with GIMP (File > Create > Screenshot...).


xwd(1) provided by xorg-xwd

Take a screenshot of the root window:

$ xwd -root -out screenshot.xwd
Note: The methods for taking shots of active windows with import can also be used with xwd.


scrot enables taking screenshots from the CLI and offers features such as a user-definable time delay. Unless instructed otherwise, it saves the file in the current working directory.

$ scrot -t 20 -d 5

The above command saves a dated .png file, along with a thumbnail (20% of original), for Web posting. It provides a 5 second delay before capturing in this instance.

You can also use standard date and time formatting when saving to a file. e.g.,

$ scrot ~/screenshots/%Y-%m-%d-%T-screenshot.png

saves the screenshot in a filename with the current year, month, date, hours, minutes, and seconds to a folder in your home directory called "screenshots"

See scrot(1) for more information. You can simply automate the file to uploaded like so [1].

Note: In some window managers (dwmAUR, xmonad and possibly others) scrot -s does not work properly when running via window manager's keyboard shortcut, this can be worked around by prepending scrot invocation with a short pause sleep 0.2; scrot -s.


escrotum-gitAUR screen capture using pygtk, inspired by scrot

Created because scrot has glitches when selection mode is used with refreshing windows.

Because the command line interface its almost the same as scrot, can be used as a replacement of it.


imlib2 provides a binary imlib2_grab to take screenshots. To take a screenshot of the full screen, type:

$ imlib2_grab screenshot.png

Note that scrot actually uses imlib2.


maim is aimed to be an improved scrot.

Takes screenshots of your desktop using slop for regions. It's meant to overcome shortcomings of scrot.


See FFmpeg#Screen capture.


In the Weston Wayland compositor, screenshots can be taking by pressing Super+s, which are stored in Weston's current working directory. Screencasts are also supported; recording is started and stopped by pressing Super+r, which will create a file called capture.wcap in Weston's current working directory. The capture can be decoded to YUV format by running wcap-decode --yuv4mpeg2 capture.wcap; the output of this command can be written to a file or piped into FFmpeg for further processing.


flameshot allows you to add simple shapes to your screenshot as you are taking it (either fullscreen or a selected region).

Details: desktop environment specific


If you use KDE, you might want to use Spectacle.

Spectacle is provided by the spectacle.

Xfce Screenshooter

If you use Xfce you can install xfce4-screenshooter and then add a keyboard binding:

Xfce Menu > Settings > Keyboard > Application Shortcuts

If you want to skip the Screenshot prompt, type $ xfce4-screenshooter -h in terminal for the options.


GNOME users can press Prnt Scr or Apps > Accessories > Take Screenshot. You may need to install gnome-screenshot.


The default installation of Cinnamon does not provide a screenshot utility. Installing gnome-screenshot will enable screenshots through the Menu > Accessories > Screenshot or by pressing Prnt Scr.

Other desktop environments or window managers

For other desktop environments such as LXDE or window managers such as Openbox and Compiz, one can add the above commands to the hotkey to take the screenshot. For example,

$ import -window root ~/Pictures/$(date '+%Y%m%d-%H%M%S').png

Adding the above command to the Prnt Scr key to Compiz allows to take the screenshot to the Pictures folder according to date and time. Notice that the rc.xml file in Openbox does not understand commas; so, in order to bind that command to the Prnt Scr key in Openbox, you need to add the following to the keyboard section of your rc.xml file:

<!-- Screenshot -->
    <keybind key="Print">
      <action name="Execute">
        <command>sh -c "import -window root ~/Pictures/$(date '+%Y%m%d-%H%M%S').png"</command>

If the Print above does not work, see Extra keyboard keys and use different keysym or keycode.


Capture with ANSI codes

You can use the script(1) command, part of the util-linux package. Just run script and from that moment, all the output is going to be saved to the typescript file, including the ANSI codes.

Once you are done, just run exit and the typescript would ready. The resulting file can be converted to HTML using the ansi2htmlAUR package, from the AUR.

To convert the typescript file to typescript.html, do the following:

$ ansi2html --bg=dark < typescript > typescript.html

Actually, some commands can be piped directly to ansi2html:

$ ls --color|ansi2html --bg=dark >output.html

That does not work on every single case, so in those cases, using script is mandatory.


Install a framebuffer and use fbgrabAUR or fbdumpAUR to take a screenshot.

Virtual console

If you merely want to capture the text in the console and not an actual image, you can use setterm, which is part of the util-linux package. The following command will dump the textual contents of virtual console 1 to a file screen.dump in the current directory:

# setterm -dump 1 -file screen.dump

Root permission is needed because the contents of /dev/vcs1 need to be read.