MAIM(1)MAIM(1)NAMEmaim - Takes screenshots
SYNOPSISmaim [options] [file]
DESCRIPTIONmaim (MAke IMage) is a utility that takes screenshots of your desktop
using imlib2. It´s meant to overcome shortcomings of scrot and performs
better than scrot in several ways.
OPTIONS--help Print help and exit
-V, --version
Print version and exit
Options
--xdisplay=hostname:number.screen_number
Sets the x display.
--format=FORMAT
Sets output format (png, jpg, etc) (default=`auto´)
-s, --select
Enables user region selection. Requires slop to be installed.
(default=off)
-x, --x=INT
Sets the x coordinate for taking an image
-y, --y=INT
Sets the y coordinate for taking an image
-w, --w=INT
Sets the width for taking an image
-h, --h=INT
Sets the height for taking an image
-g, --geometry=WxH+X+Y
Set the region to capture
-d, --delay=FLOAT
Set the amount of time to wait before taking an image.
(default=`0.0´)
-i, --windowid=INT
Set the window to capture. Defaults to the root window id.
--localize
Localizes given geometry to the given window. So maim-i $ID -g
100x100+0+0 --localize would screenshot the top-left 100x100
pixels of the given window, rather than the top-left 100x100
pixels of the root window. (default=off)
--showcursor
Causes the system cursor to be blended on top of the screenshot.
(default=off)
-m, --mask=STRING
Masks off-screen pixels so they don´t show up in screenshots.
(possible values="auto", "off", "on" default=`auto´)
SLOP OPTIONS
--nokeyboard
Disables the ability to cancel selections with the keyboard.
(default=off)
-b, --bordersize=INT
Set the selection rectangle´s thickness. Does nothing when
--highlight is enabled. (default=`5´)
-p, --padding=INT
Set the padding size of the selection. Can be negative.
(default=`0´)
-t, --tolerance=INT
How far in pixels the mouse can move after clicking and still be
detected as a normal click instead of a click and drag. Setting
this to 0 will disable window selections. (default=`2´)
--gracetime=FLOAT
Set the amount of time before slop will check for keyboard can‐
cellations in seconds. (default=`0.4´)
-c, --color=FLOAT,FLOAT,FLOAT,FLOAT
Set the selection rectangle´s color. Supports RGB or RGBA val‐
ues. (default=`0.5,0.5,0.5,1´)
-n, --nodecorations
Attempt to select child windows in order to avoid window decora‐
tions. (default=off)
--min=INT
Set the minimum output of width or height values. This is useful
to avoid outputting 0. Setting min and max to the same value
disables drag selections. (default=`0´)
--max=INT
Set the maximum output of width or height values. Setting min
and max to the same value disables drag selections.
(default=`0´)
-l, --highlight
Instead of outlining selections, slop highlights it. This is
only useful when --color is set to a transparent color.
(default=off)
--opengl
Enable hardware acceleration. Only works with modern systems
that are also running a compositor. (default=off)
--magnify
Display a magnifying glass when --opengl is also enabled.
(default=off)
--magstrength=FLOAT
Sets how many times the magnification window size is multiplied.
(default=`4´)
--magpixels=INT
Sets how many pixels are displayed in the magnification. The
less pixels the bigger the magnification. (default=`64´)
--theme=STRING
Sets the theme of the selection, using textures from ~/.con‐
fig/slop/ or /usr/share/. (default=`none´)
--shader=STRING
Sets the shader to load and use from ~/.config/slop/ or
/usr/share/. (default=`simple´)
EXAMPLES
Screenshot the active window
$ maim-i $(xdotool getactivewindow)
Prompt a transparent red selection to screenshot.
$ maim-s -c 1,0,0,0.6
Save a dated screenshot.
$ maim ~/$(date +%F-%T).png
Output screenshot to stdout
$ maim--format png /dev/stdout
COPYRIGHT
Copyright (C) 2014 Dalton Nell <naelstrof@gmail.com>, Maim Contributors
<http://github.com/naelstrof/maim/graphs/contributors>.
July 2015 MAIM(1)
