import(1)

💖 import(1) — General Commands Manual 💖

okay bestie, sit down, hydrate, and let me tell you about import from the General Commands Manual. this is the one that grabs a window off your X server and turns it into an image file. screenshots but make it ✨art✨. you can capture a single window, the entire screen, or any rectangular portion of the screen you want. and how do you pick which window? you click it, or you tell it with a program option. that's it, that's the whole vibe. 🦋

---

🌸 NAME 🌸

import — saves any visible window on an X server and outputs it as an image file. You can capture a single window, the entire screen, or any rectangular portion of the screen. The window to capture is selected by clicking the desired window or a program option.

---

✨ SYNOPSIS ✨

magick import [options] output-file

---

🫶 OVERVIEW 🫶

so import is literally a member of the ImageMagick(1) suite of tools. bestie, it's a whole family. and this specific one is here to capture some or all of an X server screen and save that image to a file. no cap. 📸

want more tea about the import command? point your browser at:

file:///usr/share/doc/ImageMagick-7/www/import.html

or

https://imagemagick.org/script/import.php

go read, i'll wait 💅

---

👑 DESCRIPTION 👑

💫 Image Settings 💫

• -adjoin — join images into a single multi-image file (one file, many pics, slay)
• -border — include window border in the output image
• -colorspace type — alternate image colorspace
• -comment string — annotate image with comment
• -compress type — type of pixel compression when writing the image
• -define format:option — define one or more image format options
• -density geometry — horizontal and vertical density of the image
• -depth value — image depth
• -descend — obtain image by descending window hierarchy
• -display server — X server to contact
• -dispose method — layer disposal method
• -dither method — apply error diffusion to image
• -delay centiseconds — display the next image after pausing
• -encipher filename — convert plain pixels to cipher pixels
• -endian type — endianness (MSB or LSB) of the image
• -encoding type — text encoding type
• -filter type — use this filter when resizing an image
• -format "string" — output formatted image characteristics
• -frame — include window manager frame
• -gravity direction — which direction to gravitate towards
• -identify — identify the format and characteristics of the image
• -interlace type — None, Line, Plane, or Partition
• -interpolate method — pixel color interpolation method
• -label string — assign a label to an image
• -limit type value — Area, Disk, Map, or Memory resource limit
• -monitor — monitor progress
• -page geometry — size and location of an image canvas
• -pause seconds — seconds delay between snapshots
• -pointsize value — font point size
• -quality value — JPEG/MIFF/PNG compression level
• -quiet — suppress all warning messages (shhh, no drama)
• -regard-warnings — pay attention to warning messages
• -repage geometry — size and location of an image canvas
• -respect-parentheses — settings remain in effect until parenthesis boundary
• -sampling-factor geometry — horizontal and vertical sampling factor
• -scene value — image scene number
• -screen — select image from root window
• -seed value — seed a new sequence of pseudo-random numbers
• -set property value — set an image property
• -silent — operate silently, i.e. don't ring any bells 🔕
• -snaps value — number of screen snapshots
• -support factor — resize support: > 1.0 is blurry, < 1.0 is sharp
• -synchronize — synchronize image to storage device
• -taint — declare the image as modified
• -transparent-color color — transparent color
• -treedepth value — color tree depth
• -verbose — print detailed information about the image
• -virtual-pixel method — Constant, Edge, Mirror, or Tile
• -window id — select window with this id or name; root selects the whole screen

🎀 Image Operators 🎀

• -annotate geometry text — annotate the image with text
• -channel mask — set the image channel mask
• -colors value — preferred number of colors in the image
• -crop geometry — preferred size and location of the cropped image
• -extent geometry — set the image size
• -geometry geometry — preferred size or location of the image
• -help — print program options
• -monochrome — transform image to black and white
• -negate — replace each pixel with its complementary color
• -quantize colorspace — reduce colors in this colorspace
• -resize geometry — resize the image
• -rotate degrees — apply Paeth rotation to the image
• -strip — strip image of all profiles and comments
• -thumbnail geometry — create a thumbnail of the image
• -transparent color — make this color transparent within the image
• -trim — trim image edges
• -type type — image type

🌈 Miscellaneous Options 🌈

• -debug events — display copious debugging information
• -help — print program options
• -log format — format of debugging information
• -list type — print a list of supported option arguments
• -version — print version information

---

⚠️ okay important, don't skip this one. By default, 'file' is written in the Postscript image format. To specify a particular image format, precede the filename with an image format name and a colon (i.e. ps:image) or specify the image type as the filename suffix (i.e. image.ps). Specify 'file' as '-' for standard input or output. 📝

---

🔥 SEE ALSO 🔥

• ImageMagick(1)

---

💜 COPYRIGHT 💜

Copyright (C) 1999 ImageMagick Studio LLC. Additional copyrights and licenses apply to this software, see:

file:///usr/share/doc/ImageMagick-7/www/license.html

or

https://imagemagick.org/license/

---

ImageMagick · Date: 2009/01/10 01:00:00 · import(1)

and that's the whole page bestie 🫶 this was import(1) from the General Commands Manual, brought to you by ImageMagick, dated 2009/01/10 01:00:00. go screenshot something iconic. periodt. 💅✨🎀