.\" Generated by scdoc 1.11.4
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "grimshot" "1" "2026-06-24"
.PP
.SH "نام (NAME)"
.PP
grimshot \- ابزار کمکی ثبت اسکرین‌شات در کامپوزیتور Sway
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBgrimshot\fR [--notify] [--cursor] [--wait N] (copy|save) [TARGET] [FILE]
.br
\fBgrimshot\fR check
.br
\fBgrimshot\fR usage
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB--notify\fR
.RS 4
نمایش اعلان به کاربر مبنی بر اینکه اسکرین‌شات گرفته شده است.\&
.PP
.RE
\fB--cursor\fR
.RS 4
گنجاندن مکان‌نما در تصویر اسکرین‌شات.\&
.PP
.RE
\fB--wait N\fR
.RS 4
مکث به مدت N ثانیه پیش از ثبت اسکرین‌شات.\& پس از انجام هرگونه
انتخاب دستی مکث می‌کند.\& توصیه می‌شود با --notify ترکیب شود
تا زمان گرفته شدن اسکرین‌شات مشخص گردد.\&
.PP
.RE
\fBsave\fR
.RS 4
ذخیره اسکرین‌شات در یک فایل معمولی.\& در صورتی که متغیر
\fBXDG_SCREENSHOTS_DIR\fR مقداردهی شده باشد (یا در
\fBuser-dirs.\&dir\fR تعریف شده باشد)، Grimshot فایل‌های تصویر
را در آن می‌نویسد، در غیر این صورت به \fBXDG_PICTURES_DIR\fR بازمی‌گردد.\&
برای هدایت خروجی به STDOUT مقدار FILE را برابر با '\&-'\& قرار دهید.\&
متغیر محیطی GRIMSHOT_FILENAME_FORMAT را برای بازنویسی نام پیش‌فرض فایل تنظیم کنید.\&
.PP
.RE
\fBcopy\fR
.RS 4
رونوشت داده‌های اسکرین‌شات (به صورت image/png) در حافظه موقت (کلیپ‌بورد).\&
.PP
.RE
\fB\fRsavecopy\fB\fR
.RS 4
ذخیره اسکرین‌شات در یک فایل معمولی (مستندات \fIsave\fR را ببینید) و
رونوشت داده‌های اسکرین‌شات در حافظه موقت (کلیپ‌بورد) (مستندات \fIcopy\fR را ببینید).\&
.PP
.RE
.SH "توضیحات (DESCRIPTION)"
.PP
برنامه Grimshot یک ابزار آسان برای ثبت اسکرین‌شات در محیط sway است.\& این برنامه یک
رابط کاربری راحت بر روی ابزارهای grim ،slurp و jq فراهم می‌کند، و از ذخیره مستقیم
اسکرین‌شات در حافظه موقت با استفاده از wl-copy یا در یک فایل پشتیبانی می‌کند.\&
.PP
.SH "مثال‌ها (EXAMPLES)"
.PP
یک الگوی کاربردی نمونه، افزودن این کلیدهای میانبر به پیکربندی sway است:
.PP
.nf
.RS 4
# Screenshots:
# Super+P: Current window
# Super+Shift+p: Select area
# Super+Alt+p Current output
# Super+Ctrl+p Select a window

bindsym Mod4+p       exec grimshot save active
bindsym Mod4+Shift+p exec grimshot save area
bindsym Mod4+Mod1+p  exec grimshot save output
bindsym Mod4+Ctrl+p  exec grimshot save window
.fi
.RE
.PP
و/یا افزودن این متغیرهای محیطی به پیکربندی پوسته:
.PP
.nf
.RS 4
export GRIMSHOT_FILENAME_FORMAT="$(date --iso-8601=ns | tr \&':\&' -)"
.fi
.RE
.PP
.SH "اهداف (TARGETS)"
.PP
برنامه grimshot می‌تواند اهداف نام‌برده زیر را ثبت کند:
.PP
\fIactive\fR
.RS 4
پنجره فعال کنونی را ثبت می‌کند.\&
.PP
.RE
\fIscreen\fR
.RS 4
کل صفحه نمایش را ثبت می‌کند.\& این شامل تمام خروجی‌های قابل مشاهده است.\&
.PP
.RE
\fIarea\fR
.RS 4
امکان انتخاب دستی یک ناحیه مستطیلی و ثبت آن را فراهم می‌کند.\&
.PP
.RE
\fIwindow\fR
.RS 4
امکان انتخاب دستی یک پنجره منفرد (با کلیک روی آن) و
ثبت آن را فراهم می‌کند.\&
.PP
.RE
\fIoutput\fR
.RS 4
خروجی (نمایشگر) فعال کنونی را ثبت می‌کند.\&
.PP
.RE
\fIanything\fR
.RS 4
امکان انتخاب دستی یک پنجره منفرد (با کلیک روی آن)، یک خروجی (با
کلیک در خارج از تمام پنجره‌ها، مثلاً روی نوار وضعیت) یا یک ناحیه (با
استفاده از کلیک و کشیدن) را فراهم می‌کند.\&
.PP
.RE
.SH "خروجی (OUTPUT)"
.PP
در صورت فراخوانی با زیردستورهای \fIsave\fR یا \fIsavecopy\fR، برنامه Grimshot نام
فایل اسکرین‌شات ثبت‌شده را در خروجی استاندارد (stdout) چاپ می‌کند.\&
.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBgrim\fR(1)