SHUTTER(1)

✨ SHUTTER(1) ✨

okay bestie, so this one's from the User Contributed Perl Documentation section of the manual, and it's literally about Shutter, the feature-rich screenshot tool 🎀 like, the main character of screen capture. Let's get into it 💅

---

🌸 NAME 🌸

Shutter — the Feature-rich Screenshot Tool 👑

---

🦋 SYNOPSIS 🦋

shutter [options]

that's it. that's the whole vibe. just shutter and whatever options you wanna throw at it ✨

---

💜 COPYRIGHT 💜

Shutter is Copyright (C) by Mario Kemper and the Shutter Team 🫶

---

🎀 DESCRIPTION 🎀

okay so Shutter is a feature-rich screenshot program, and when they say feature-rich they MEAN it, no cap. You can take a screenshot of a specific area, a window, your whole entire screen, or even of a website — and then it gets better. Apply different effects to it, draw on it to highlight points, and then upload it to an image hosting site — and the way that ALL of this happens within one window?? iconic. genuinely iconic. 🔥

---

💅 OPTIONS 💅

⭐ Examples (iykyk) ⭐

Example 1

shutter -a -p=myprofile --min_at_startup

Example 2

shutter -s=100,100,300,300 -e

Example 3

shutter --window=.*firefox.*

Example 4

shutter --web=http://shutter-project.org/ -e

---

📸 CAPTURE MODE OPTIONS 📸

• -s, --select=[X,Y,WIDTH,HEIGHT] — capture an area of the screen 🫶 giving it X,Y,WIDTH,HEIGHT is optional, so it's giving "your call, bestie"
• -f, --full — capture the ENTIRE screen 🌈 the whole thing. all of it.
• -w, --window=[NAME_PATTERN] — pick a window to capture 👀 and the NAME_PATTERN is a Perl-style regex, which is optional to provide
• -a, --active — capture the current active window ✨ the one that's literally the main character rn
• -m, --menu — capture a menu 🍓
• -t, --tooltip — capture a tooltip 💬
• --web=[URL] — capture a webpage 🌐 providing the URL is optional
• -r, --redo — redo the last screenshot 🔁 we love a second chance

---

🎛️ SETTINGS OPTIONS 🎛️

• -p, --profile=NAME — load a specific profile on startup 💖
• -o, --output=FILENAME — specify a filename to save the screenshot to, and heads up: this overwrites any profile-related setting 😭

supported image formats: you can save to any popular image format (e.g. jpeg, png, gif, bmp). plus, extra slay, it's possible to save to pdf, ps or svg too 🎀

please note: there are several wildcards available 👑

wild cards provided by Shutter are:

 $w = width
 $h = height
 $name = multi-purpose (e.g. window title)
 $nb_name = like $name but without blanks in resulting strings
 $profile = name of current profile
 $R = random char (e.g. $RRRR = ag4r)
 %NN = counter

additionally, there are date related wildcards:

 %Y = year
 %m = month
 %d = day
 %T = time

the string is interpretted by strftime. see man strftime for more examples ✨

as an example: shutter -f -e -o './%y-%m-%d_$w_$h.png' would create a file named '11-10-28_1280_800.png' in the current directory 🌸

• -d, --delay=SECONDS — wait n seconds before taking a screenshot ⏳ like a lil countdown
• -c, --include_cursor — include the cursor when taking a screenshot 👆
• -C, --remove_cursor — remove the cursor when taking a screenshot 🙈

---

🧚 APPLICATION OPTIONS 🧚

• -h, --help — prints a brief help message and exits 🫶
• -v, --version — prints version information ⭐
• --debug — prints a LOT of debugging information to STDOUT 💀 like, a lot a lot
• --clear_cache — clears cache, e.g. installed plugins, at startup 🧹
• --min_at_startup — starts Shutter minimized to tray 🎀
• --disable_systray — disables the systray icon 🚫
• -e, --exit_after_capture — exit after the first capture has been made. this is useful when using Shutter in scripts 🔥
• -n, --no_session — do not add the screenshot to the session. this is useful when using Shutter in scripts 🔥

---

😭 BUG REPORTS 😭

if you find a bug in Shutter, you should report it. but FIRST, bestie, you should make sure that it really is a bug, and that it appears in the latest version of Shutter 🙏

the latest version is always available from: https://github.com/shutter-project/shutter/releases

once you have determined that a bug actually exists, please report it at github: https://github.com/shutter-project/shutter/issues/new

---

and that's the whole page, bestie 💖 this one's running on perl v5.42.0 and it's dated 2026-01-11, so go forth and screenshot slay ✨👑💅