.\" Text automatically generated by txt2man
.TH scrot 1 "13 Mar 2026" "scrot-2.0.0" "ابزار خط فرمانی تصویربرداری از صفحه نمایش"
.SH "نام (NAME)"
scrot \- ابزار خط فرمانی تصویربرداری از صفحه نمایش
.SH "خلاصه دستور (SYNOPSIS)"
.nf
.fam C
\fBscrot\fP [\fB-bcfhimopuvz\fP] [\fB-a\fP \fIX,Y,W,H\fP] [\fB-C\fP \fINAME\fP] [\fB-D\fP \fIDISPLAY\fP] [\fB-d\fP \fISEC\fP] [\fB-e\fP \fICMD\fP]
      [\fB-k\fP \fIOPT\fP] [\fB-l\fP \fISTYLE\fP] [\fB-M\fP \fINUM\fP] [\fB-n\fP \fIOPTS\fP] [\fB-q\fP \fINUM\fP] [\fB-s\fP \fIOPTS\fP] [\fB-t\fP % | \fIWxH\fP]
      [\fB-w\fP \fINUM\fP] [[\fB-F\fP] \fIFILE\fP]

.fam T
.fi
.fam T
.fi
.SH "توضیحات (DESCRIPTION)"
برنامهٔ \fBscrot\fP (مخفف SCReenshOT) یک ابزار خط فرمانی ساده برای تصویربرداری از صفحه نمایش است که از imlib2 برای گرفتن و ذخیره کردن تصاویر استفاده می‌کند.
.PP
ابزار \fBscrot\fP دارای ویژگی‌های کاربردی متعددی است:
.RS
.IP \(bu 3
پشتیبانی از چندین قالب تصویر مختلف: JPG، PNG، GIF و غیره.
.IP \(bu 3
کیفیت تصویر گرفته‌شده قابل پیکربندی است.
.IP \(bu 3
امکان تصویربرداری از یک پنجره مشخص یا یک ناحیه مستطیلی بر روی صفحه وجود دارد.
.RE
.PP
از آنجا که \fBscrot\fP یک ابزار خط فرمانی است، به‌سادگی می‌توان از آن در اسکریپت‌ها و کاربردهای نوین استفاده کرد. برای نمونه، می‌توان از \fBscrot\fP برای پایش یک X server در غیاب کاربر استفاده نمود.
.PP
برنامهٔ \fBscrot\fP یک نرم‌افزار آزاد تحت مجوز MIT-feh است.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B
\fB-a\fP, \fB--autoselect\fP \fIX,Y,W,H\fP
انتخاب غیرتعاملی یک مستطیل که از موقعیت X,Y آغاز شده و دارای ابعاد وضوح W در H است.
.TP
.B
\fB-b\fP, \fB--border\fP
هنگام انتخاب یک پنجره، حاشیهٔ مدیر پنجره (WM) را نیز ضبط می‌کند. برای بالا آوردن و تمرکز روی پنجره، همراه با \fB-s\fP استفاده شود.
.TP
.B
\fB-C\fP, \fB--class\fP \fINAME\fP
مقدار \fINAME\fP نام کلاس پنجره است. مرتبط با \fB-k\fP.
.TP
.B
\fB-c\fP, \fB--count\fP
نمایش شمارش معکوس در صورت استفاده همراه با \fB-d\fP.
.TP
.B
\fB-D\fP, \fB--display\fP \fIDISPLAY\fP
مقدار \fIDISPLAY\fP نمایشگری است که باید استفاده شود؛ به \fBX\fP(7) مراجعه کنید.
.TP
.B
\fB-d\fP, \fB--delay\fP [b]\fISEC\fP
پیش از گرفتن تصویر به مدت \fISEC\fP ثانیه منتظر می‌ماند. اگر پیشوند `b` داده شود (مانند `\fB-d\fP b8`)، تأخیر پیش از فرایند انتخاب اعمال خواهد شد.
.TP
.B
\fB-e\fP, \fB--exec\fP \fICMD\fP
اجرای دستور \fICMD\fP روی تصویر ذخیره‌شده.
.TP
.B
\fB-F\fP, \fB--file\fP \fIFILE\fP
تعیین فایل خروجی. اگر \fIFILE\fP برابر با "-" باشد، \fBscrot\fP تصویر را در stdout خروجی می‌دهد. نام فایل بر اساس ساختار مشخص‌شده در بخش رشته‌های ویژه (SPECIAL STRINGS) بسط داده می‌شود. فایل خروجی می‌تواند از طریق گزینهٔ \fB-F\fP یا به عنوان آرگومانی بدون گزینه مشخص شود.
.TP
.B
\fB-f\fP, \fB--freeze\fP
ثابت کردن صفحه هنگام استفاده از \fB-s\fP.
.TP
.B
\fB-h\fP, \fB--help\fP
نمایش راهنما و خروج.
.TP
.B
\fB-i\fP, \fB--ignorekeyboard\fP
با ورودی صفحه‌کلید خارج نمی‌شود؛ کلید ESC همچنان باعث خروج خواهد شد.
.TP
.B
\fB-k\fP, \fB--stack\fP[=\fIOPT\fP]
تصویربرداری از پنجره‌های پشته‌ای/همپوشان و پیوستن آن‌ها به هم. برای کارکرد درست، اجرای یک Composite Manager الزامی است. \fIOPT\fP نویسهٔ اختیاری اتصال است: v/h (عمودی/افقی). پیش‌فرض: h
.TP
.B
\fB-l\fP, \fB--line\fP \fISTYLE\fP
مقدار \fISTYLE\fP نشان‌دهنده سبک خط در زمان استفاده از گزینهٔ \fB-s\fP است؛ به بخش SELECTION \fISTYLE\fP مراجعه کنید.
.TP
.B
\fB-M\fP, \fB--monitor\fP \fINUM\fP
تصویربرداری از مانیتور Xrandr با شمارهٔ \fINUM\fP.
.TP
.B
\fB-m\fP, \fB--multidisp\fP
در صورت وجود چند نمایشگر، از تمامی آن‌ها به ترتیب تصویربرداری می‌کند.
.TP
.B
\fB-o\fP, \fB--overwrite\fP
به‌طور پیش‌فرض \fBscrot\fP فایل خروجی (\fIFILE\fP) را بازنویسی نمی‌کند؛ از این گزینه برای فعال‌سازی بازنویسی استفاده کنید.
.TP
.B
\fB-p\fP, \fB--pointer\fP
ضبط مکان‌نمای موشوار.
.TP
.B
\fB-q\fP, \fB--quality\fP \fINUM\fP
مقدار \fINUM\fP باید در بازهٔ [1, 100] باشد. مقدار بالاتر نشان‌دهنده کیفیت بهتر تصویر و مقدار کمتر نشان‌دهنده کیفیت پایین‌تر است. اثر این پرچم به قالب فایل بستگی دارد؛ به بخش COMPRESSION QUALITY مراجعه کنید. پیش‌فرض: 75.
.TP
.B
\fB-s\fP, \fB--select\fP[=\fIOPTS\fP]
انتخاب تعاملی یک پنجره یا ناحیهٔ مستطیلی با موشوار، استفاده از کلیدهای جهت‌نما برای تغییر اندازه. گزینه‌های \fB-l\fP و \fB-f\fP را ببینید. \fIOPTS\fP اختیاری است؛ به بخش SELECTION MODE مراجعه کنید.
.TP
.B
\fB-t\fP, \fB--thumb\fP % | \fIWxH\fP
همچنین یک تصویر بندانگشتی تولید می‌کند. آرگومان نشان‌دهنده وضوح تصویر بندانگشتی است: اگر آرگومان یک تک‌عدد باشد، درصدی از وضوح تصویر اصلی در اندازهٔ کامل است؛ اگر دو عدد باشد که با نویسهٔ "x" از هم جدا شده‌اند، ابعاد وضوح خواهد بود. اگر یکی از ابعاد وضوح برابر با 0 باشد، با عددی جایگزین می‌شود که نسبت ابعاد تصویر در اندازهٔ کامل را حفظ کند. مثال‌ها: 10، 25، 320x240، 500x200، 100x0، 0x480.
.TP
.B
\fB-u\fP, \fB--focused\fP, \fB--focussed\fP
استفاده از پنجره‌ای که در حال حاضر دارای فوکوس است.
.TP
.B
\fB-v\fP, \fB--version\fP
نمایش اطلاعات نسخه و خروج.
.TP
.B
\fB-w\fP, \fB--window\fP WID
شناسهٔ پنجره برای تصویربرداری. مقدار WID باید یک شناسهٔ معتبر باشد (به \fBxwininfo\fP(1) مراجعه کنید).
.TP
.B
\fB-Z\fP, \fB--compression\fP LVL
سطح فشرده‌سازی برای استفاده؛ مقدار LVL باید در بازهٔ [0, 9] باشد. سطح فشرده‌سازی بالاتر حجم فایل کمتری ایجاد می‌کند، اما به بهای کندتر شدن سرعت کدگذاری/ذخیره‌سازی تمام می‌شود. اثر این پرچم به قالب فایل بستگی دارد؛ به بخش COMPRESSION QUALITY مراجعه کنید. پیش‌فرض: 7.
.TP
.B
\fB-z\fP, \fB--silent\fP
جلوگیری از ایجاد صدای بوق.
.TP
.B
\fB--format\fP FMT
مشخص کردن قالب فایل خروجی؛ به عنوان نمونه "\fB--format\fP png". در صورتی که قالبی مشخص نشود، \fBscrot\fP از پسوند فایل برای تشخیص قالب استفاده خواهد کرد. اگر نام فایل فاقد پسوند باشد، PNG به عنوان حالت جایگزین استفاده خواهد شد.
.TP
.B
\fB--list-options\fP[=\fIOPT\fP]
فهرست کردن تمام گزینه‌های برنامه. اگر آرگومان "tsv" باشد، خروجی را به صورت فهرستی جداشده با نویسهٔ TAB مناسب برای اسکریپت‌ها تولید می‌کند. مقدار پیش‌فرض "human" است. توجه داشته باشید که قالب tsv پایدار نبوده و ممکن است در آینده تغییر کند..SH "رشته‌های ویژه (SPECIAL STRINGS)"
پارامترهای \fB-e\fP، \fB-F\fP و \fIFILE\fP می‌توانند مشخص‌کننده‌های قالبی را بپذیرند که
هنگام پردازش توسط \fBscrot\fP بسط داده می‌شوند. دو نوع مشخص‌کننده قالب وجود دارد:
نویسه‌هایی که پیش از آن‌ها '%' می‌آید توسط \fBstrftime\fP(3) تفسیر می‌شوند. نوع دوم
مختص خود \fBscrot\fP بوده و با پیشوند '$' مشخص می‌شوند. مشخص‌کننده‌های زیر توسط
\fBscrot\fP شناخته می‌شوند:
.PP
.nf
.fam C
    $$   نویسه واقعی '$'.
    $a   نام میزبان (hostname) سیستم.
    $F   قالب فایل خروجی.
    $f   مسیر تصویر (می‌تواند نسبی باشد؛ در صورت استفاده در نام فایل نادیده گرفته می‌شود).
    $h   ارتفاع تصویر.
    $m   مسیر تصویر بندانگشتی (می‌تواند نسبی باشد؛ در صورت استفاده در نام فایل نادیده گرفته می‌شود).
    $n   نام پایه (basename) تصویر (در صورت استفاده در نام فایل نادیده گرفته می‌شود).
    $p   اندازه تصویر به پیکسل.
    $s   اندازه تصویر به بایت (در صورت استفاده در نام فایل نادیده گرفته می‌شود).
    $t   قالب فایل تصویر (در صورت استفاده در نام فایل نادیده گرفته می‌شود).
    $w   عرض تصویر.
    $W   نام پنجره (تنها برای --select، --focused و --window).
    \\n   یک سطر جدید واقعی (در صورت استفاده در نام فایل نادیده گرفته می‌شود).

.fam T
.fi
مثال:
.PP
.nf
.fam C
    $ scrot '%Y-%m-%d_$wx$h.png' -e 'du -h $f'

.fam T
.fi
این دستور یک فایل PNG با نامی شبیه به 2000-10-30_2560x1024.png ایجاد کرده
و میزان مصرف دیسک را با \fBdu\fP(1) نمایش می‌دهد.
.SH "حالت انتخاب (SELECTION MODE)"
هنگام استفاده از \fB-s\fP، می‌توانید به دلخواه عملیاتی را که باید روی ناحیه انتخابی انجام شود مشخص کنید.
برخی از این عملیات پارامترهای اختیاری نیز می‌پذیرند.
.PP
.nf
.fam C
    capture             عکس‌برداری از ناحیه انتخابی؛ این عمل پیش‌فرض است و
                        نیازی به مشخص شدن ندارد.

    hole                برجسته کردن ناحیه انتخابی با سایه انداختن بر بقیه تصویر.

    hide,IMAGE          مخفی کردن ناحیه انتخابی با کشیدن ناحیه‌ای رنگی (یا تصویر) روی آن.
                        به دلخواه نام تصویر برای استفاده به عنوان پوشش مشخص می‌شود.
                        تصویر بر رنگ اولویت دارد.

    blur,AMOUNT         مات کردن ناحیه انتخابی.
                        به دلخواه می‌توانید میزان مات‌شدگی را مشخص کنید.
                        مقدار باید در بازه [1, 30] باشد. پیش‌فرض: 18.

.fam T
.fi
در حالت‌های 'hole' و 'hide'، رنگ ناحیه توسط ویژگی 'color' در سبک خط و میزان کدری رنگ (یا تصویر)
توسط ویژگی 'opacity' مشخص می‌شود؛ بخش «سبک انتخاب» (SELECTION \fISTYLE\fP).
.PP
اگر در حالت 'hide' از تصویری استفاده شود که فاقد کانال آلفا (alpha channel) باشد، پارامتر opacity
نادیده گرفته شده و تصویر کاملاً کدر رسم خواهد شد.
.PP
مثال‌ها:
.PP
.nf
.fam C
    $ scrot --select=hide
    $ scrot -shole --line color="Dark Salmon",opacity=200
    $ scrot -sblur,10
    $ scrot -shide,stamp.png --line opacity=120

.fam T
.fi
.SH "سبک انتخاب (SELECTION STYLE)"
هنگام استفاده از \fB-s\fP، می‌توانید سبک خط را با \fB-l\fP مشخص کنید.
.PP
گزینه \fB-l\fP فهرستی از مشخص‌کننده‌ها را که با کاما از هم جدا شده‌اند به عنوان آرگومان می‌پذیرد:
.PP
.nf
.fam C
    style=STYLE     مقدار STYLE یا "solid" است یا "dash" (بدون علامت نقل‌قول).

    width=NUM       مقدار NUM تعداد پیکسل‌ها در بازه [1, 8] است.

    color="COLOR"   رنگ یک کد رنگ هگزادسیمال HTML یا نام یک رنگ است.
                    کدهای رنگ HTML از یک علامت '#' و به دنبال آن ۳ عدد
                    هگزادسیمال ۲ رقمی تشکیل شده‌اند که به ترتیب نمایانگر
                    قرمز، سبز و آبی هستند. مثال‌ها: #FF0000 (قرمز)،
                    #E0FFFF (فیروزه‌ای روشن)، #000000 (سیاه).

    opacity=NUM     مقدار NUM در بازه [0, 255] است. ۲۵۵ به معنای ۱۰۰٪ کدر
                    و ۰ به معنای ۱۰۰٪ شفاف است. این گزینه برای شفافیت خط
                    تنها در صورتی مؤثر است که کامپوزیتور از
                    _NET_WM_WINDOW_OPACITY پشتیبانی کند.

    mode=MODE       مقدار MODE می‌تواند "auto"، "edge" یا "classic" (بدون نقل‌قول) باشد.
                    گزینه edge انتخاب جدید است و classic از روش قدیمی استفاده می‌کند.
                    "auto" در صورتی که پرچم -f فعال نباشد از "edge" استفاده می‌کند
                    وگرنه از "classic". حالت "edge" مشخص‌کننده style را نادیده می‌گیرد
                    و "classic" مشخص‌کننده opacity را نادیده می‌گیرد.


.fam T
.fi
بدون گزینه \fB-l\fP، سبک پیش‌فرض اعمال می‌شود:
.PP
.nf
.fam C
    mode=auto,style=solid,opacity=100

.fam T
.fi
عرض پیش‌فرض به‌طور خودکار بر اساس DPI نمایشگر تعیین می‌شود.
.PP
مثال:
.PP
.nf
.fam C
    $ scrot -l style=dash,width=3,color="red" -s

.fam T
.fi.SH "کیفیت فشرده‌سازی (COMPRESSION QUALITY)"

برای قالب‌های بدون اتلاف (مانند PNG)، گزینه‌های کیفیت نادیده گرفته می‌شوند. برای قالب‌های با اتلاف که کیفیت و فشرده‌سازی در آن‌ها به یکدیگر وابسته‌اند (مانند JPEG)، فشرده‌سازی نادیده گرفته خواهد شد. و برای قالب‌های تصویری که کیفیت و فشرده‌سازی در آن‌ها می‌تواند به صورت مستقل تنظیم شود (مانند WebP، JXL)، هر دو پرچم اعمال می‌شوند.
.SH "مثال‌ها (EXAMPLES)"

در ادامه چند مثال از به‌کارگیری \fBscrot\fP به همراه سایر ابزارها آورده شده است.
.PP
کپی کردن نماگرفت در کلیپ‌بورد با استفاده از \fBxclip\fP(1):
.PP
.nf
.fam C
  $ scrot - | xclip -selection clipboard -target image/png

.fam T
.fi
گرفتن نماگرفت و بهینه‌سازی اندازه آن با \fBoptipng\fP(1):
.PP
.nf
.fam C
  $ scrot -e 'optipng -o4 $f'

.fam T
.fi
انتخاب یک پنجره بر اساس PID با استفاده از \fBxdo\fP(1):
.PP
.nf
.fam C
  $ scrot -w $(xdo id -p PID)

.fam T
.fi
گرفتن نماگرفت و درج یادداشت روی آن با \fBImageMagick\fP(1):
.PP
.nf
.fam C
  $ scrot - | magick - -pointsize 64 -gravity North -annotate +16+16 'hello, world!' out.png

.fam T
.fi
.SH "نویسندگان (AUTHORS)"
\fBscrot\fP در ابتدا توسط Tom Gilbert توسعه داده شد.
.PP
در حال حاضر، کد منبع توسط داوطلبان نگهداری می‌شود. نسخه‌های جدیدتر در نشانی https://github.com/resurrecting-open-source-projects/\fBscrot\fP در دسترس هستند.
.SH "همچنین ببینید (SEE ALSO)"
\fBImageMagick\fP(1)
\fBoptipng\fP(1)
\fBxclip\fP(1)
\fBxdo\fP(1)
\fBxwininfo\fP(1)