.TH "SWAYIMG" "1" "2026-03-08" "swayimg" "راهنمای swayimg"
.PP
.SH "نام (NAME)"
.PP
\fBswayimg\fR \- نمایش‌دهنده تصویر برای Wayland/DRM با پشتیبانی از اسکریپت‌نویسی Lua
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBswayimg\fR [\fIOPTION\fR]... [\fIFILE\fR]...
.PP
اگر هیچ فایل ورودی یا دایرکتوری‌ای مشخص نشده باشد، نمایش‌دهنده تلاش خواهد کرد تمام فایل‌های موجود در دایرکتوری جاری را بخواند.
.PP
برای خواندن داده‌های تصویر از stdin، از \fB-\fR به عنوان \fIFILE\fR استفاده کنید.
.PP
برای دریافت داده‌های تصویر از stdout چاپ‌شده توسط یک دستور خارجی، از پیشوند \fBexec://\fR استفاده کنید.
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
برنامه swayimg یک نمایش‌دهنده تصویر سبک و بومی Wayland است که برای مدیر پنجره‌های Sway و Hyprland بهینه‌سازی شده است و از یک حالت روکش (overlay) بهره می‌برد که نمایش تصویر در ترمینال را شبیه‌سازی می‌کند. این برنامه از حالت‌های اسلایدشو و گالری پشتیبانی می‌کند، قادر به خواندن داده‌ها از stdin و دستورهای خارجی است، و از طریق اسکریپت‌نویسی Lua به‌شدت سفارشی‌پذیر است.
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB-h, --help\fR
.RS 4
نمایش پیام راهنما و خروج.
.RE
.PP
\fB-V, --version\fR
.RS 4
نمایش اطلاعات نسخه و فهرست قالب‌های تصویر پشتیبانی‌شده.
.RE
.PP
\fB-v, --viewer\fR
.RS 4
شروع اجباری در حالت نمایشگر.
.RE
.PP
\fB-g, --gallery\fR
.RS 4
شروع اجباری در حالت گالری.
.RE
.PP
\fB-s, --slideshow\fR
.RS 4
شروع اجباری در حالت اسلایدشو.
.RE
.PP
\fB-f, --from-file\fR=\fIFILE\fR
.RS 4
بارگذاری فهرست فایل‌ها از \fIFILE\fR متنی.
.RE
.PP
\fB-P, --position\fR=\fIX,Y\fR
.RS 4
تنظیم موقعیت اولیه پنجره (تنها در Sway/Hyprland).
.RE
.PP
\fB-S, --size\fR=\fIW,H\fR
.RS 4
تنظیم اندازه اولیه پنجره.
.RE
.PP
\fB-F, --fullscreen\fR
.RS 4
شروع در حالت تمام‌صفحه.
.RE
.PP
\fB-c, --config\fR=\fIFILE\fR
.RS 4
بارگذاری \fIFILE\fR مشخص‌شده Lua به‌جای فایل پیش‌فرض.
.RE
.PP
\fB-e, --execute\fR=\fILUA\fR
.RS 4
اجرای اسکریپت Lua مشخص‌شده پس از بارگذاری پیکربندی.
.RE
.PP
\fB--appid\fR=\fIID\fR
.RS 4
تنظیم شناسه برنامه (application Id).
.RE
.PP
\fB--verbose\fR
.RS 4
فعال‌سازی خروجی با جزئیات بیشتر.
.RE
.PP
.SH "کلیدها (KEYS)"
.PP
.SS "نمایشگر و اسلایدشو (Viewer and Slideshow)"
.PP
.PD 0
.IP \(bu 4
\fBEsc\fR: خروج از برنامه
.IP \(bu 4
\fBEnter\fR: رفتن به حالت گالری
.IP \(bu 4
\fBs\fR: فعال/غیرفعال کردن حالت اسلایدشو
.IP \(bu 4
\fBInsert\fR: علامت‌گذاری/برداشتن علامت تصویر جاری
.IP \(bu 4
\fBDelete\fR: نادیده گرفتن تصویر (حذف از فهرست تصاویر)
.IP \(bu 4
\fBf\fR: فعال/غیرفعال کردن حالت تمام‌صفحه
.IP \(bu 4
\fBa\fR: فعال/غیرفعال کردن هموارسازی لبه‌ها (anti-aliasing)
.IP \(bu 4
\fB]\fR: چرخش تصویر ۹۰ درجه در جهت عقربه‌های ساعت
.IP \(bu 4
\fB[\fR: چرخش تصویر ۹۰ درجه در خلاف جهت عقربه‌های ساعت
.IP \(bu 4
\fBm\fR: بازتاب عمودی تصویر
.IP \(bu 4
\fBShift-m\fR: بازتاب افقی تصویر
.IP \(bu 4
\fBt\fR: نمایش/پنهان‌سازی لایه متنی اطلاعات
.IP \(bu 4
\fBPgDown\fR: نمایش تصویر بعدی
.IP \(bu 4
\fBPgUp\fR: نمایش تصویر قبلی
.IP \(bu 4
\fBShift-PgDown\fR: نمایش فریم بعدی
.IP \(bu 4
\fBShift-PgUp\fR: نمایش فریم قبلی
.IP \(bu 4
\fB+\fR: بزرگ‌نمایی
.IP \(bu 4
\fB-\fR: کوچک‌نمایی
.IP \(bu 4
\fBLeft/Right/Up/Down\fR: پیمایش در تصویر
.IP \(bu 4
\fBBackspace\fR: بازنشانی مقیاس و موقعیت تصویر به مقادیر پیش‌فرض
.PD
.PP
کلیدهای موشواره:
.PD 0
.IP \(bu 4
\fBScrollUp/ScrollDown/ScrollLeft/ScrollRight\fR: جابه‌جایی تصویر
.IP \(bu 4
\fBCtrl-ScrollUp\fR: بزرگ‌نمایی
.IP \(bu 4
\fBCtrl-ScrollDown\fR: کوچک‌نمایی
.IP \(bu 4
\fBMouseLeft\fR: جابه‌جایی تصویر (کشیدن)
.IP \(bu 4
\fBMouseRight\fR: کشیدن و رها کردن تصویر به برنامه‌های خارجی
.PD
.PP
.SS "گالری (Gallery)"
.PP
.PD 0
.IP \(bu 4
\fBEsc\fR: خروج از برنامه
.IP \(bu 4
\fBHome\fR: انتخاب اولین تصویر بندانگشتی در فهرست تصاویر
.IP \(bu 4
\fBEnd\fR: انتخاب آخرین تصویر بندانگشتی در فهرست تصاویر
.IP \(bu 4
\fBLeft\fR: انتخاب تصویر بندانگشتی سمت چپ تصویر فعلی
.IP \(bu 4
\fBRight\fR: انتخاب تصویر بندانگشتی سمت راست تصویر فعلی
.IP \(bu 4
\fBUp\fR: انتخاب تصویر بندانگشتی بالای تصویر فعلی
.IP \(bu 4
\fBDown\fR: انتخاب تصویر بندانگشتی پایین تصویر فعلی
.IP \(bu 4
\fBPgUp\fR: انتخاب تصویر بندانگشتی در صفحه قبلی
.IP \(bu 4
\fBPgDown\fR: انتخاب تصویر بندانگشتی در صفحه بعدی
.IP \(bu 4
\fBEnter\fR: رفتن به حالت نمایشگر
.IP \(bu 4
\fBs\fR: رفتن به حالت اسلایدشو
.IP \(bu 4
\fBInsert\fR: علامت‌گذاری/برداشتن علامت تصویر انتخاب‌شده جاری
.IP \(bu 4
\fBDelete\fR: نادیده گرفتن تصویر (حذف از فهرست تصاویر)
.IP \(bu 4
\fBf\fR: فعال/غیرفعال کردن حالت تمام‌صفحه
.IP \(bu 4
\fBa\fR: فعال/غیرفعال کردن هموارسازی لبه‌ها (anti-aliasing)
.IP \(bu 4
\fB+\fR: افزایش اندازه تصویر بندانگشتی
.IP \(bu 4
\fB-\fR: کاهش اندازه تصویر بندانگشتی
.IP \(bu 4
\fBt\fR: نمایش/پنهان‌سازی لایه متنی اطلاعات
.PD
.PP
کلیدهای موشواره:
.PD 0
.IP \(bu 4
\fBMouseLeft\fR: باز کردن تصویر انتخاب‌شده فعلی در نمایشگر
.IP \(bu 4
\fBMouseRight\fR: کشیدن و رها کردن تصویر به برنامه‌های خارجی
.IP \(bu 4
\fBCtrl-ScrollUp\fR: افزایش اندازه تصویر بندانگشتی
.IP \(bu 4
\fBCtrl-ScrollDown\fR: کاهش اندازه تصویر بندانگشتی
.IP \(bu 4
\fBScrollUp/ScrollDown/ScrollLeft/ScrollRight\fR: انتخاب تصویر بعدی
.PD
.PP
.SH "محیط (ENVIRONMENT)"
.PP
\fBSWAYSOCK\fR
.RS 4
مسیر فایل سوکت مورد استفاده برای Sway IPC.
.RE
.PP
\fBHYPRLAND_INSTANCE_SIGNATURE\fR, \fBXDG_RUNTIME_DIR\fR
.RS 4
مسیر فایل سوکت مورد استفاده برای Hyprland IPC.
.RE
.PP
\fBXDG_CONFIG_HOME\fR, \fBXDG_CONFIG_DIRS\fR, \fBHOME\fR
.RS 4
پیشوند مسیر فایل پیکربندی پیش‌فرض برنامه.
.RE
.PP
\fBSHELL\fR
.RS 4
پوسته مورد استفاده برای اجرای دستورهای خارجی و بارگذاری تصویر از stdout.
.RE
.PP
.SH "سیگنال‌ها (SIGNALS)"
.PP
\fBSIGUSR1\fR, \fBSIGUSR2\fR
.RS 4
انجام اقدامات مشخص‌شده در فایل پیکربندی.
.RE
.PP
.SH "وضعیت خروج (EXIT STATUS)"
.PP
در صورت اجرای موفقیت‌آمیز برنامه، وضعیت خروج 0 و در صورت بروز خطا 1 خواهد بود. کدهای دیگر را می‌توان از طریق اسکریپت Lua تعیین کرد.
.PP
.SH "مثال‌ها (EXAMPLES)"
.PP
مشاهده چندین فایل:
.NF
.RS 4
swayimg photo.jpg logo.png
.RE
.FI
.PP
نمایش تصویر دریافت‌شده از طریق pipe:
.NF
.RS 4
wget -qO- https://www.kernel.org/theme/images/logos/tux.png | swayimg -
.RE
.FI
.PP
بارگذاری stdout از دستورهای خارجی:
.NF
.RS 4
swayimg "exec://wget -qO- https://www.kernel.org/theme/images/logos/tux.png" \\
        "exec://curl -so- https://www.kernel.org/theme/images/logos/tux.png"
.RE
.FI
.PP
.SH "فایل‌ها (FILES)"
.PP
این برنامه هنگام راه‌اندازی فایل \fBinit.lua\fR را جستجو و پردازش می‌کند. این فایل یک اسکریپت Lua است که پارامترهای اولیه را تنظیم کرده، قلاب‌ها (hooks) را می‌افزاید و رفتار برنامه را تغییر می‌دهد.
.PP
مسیرهای احتمالی فایل:
.PD 0
.IP \(bu 4
\fB$XDG_CONFIG_HOME/swayimg/init.lua\fR
.IP \(bu 4
\fB$HOME/.config/swayimg/init.lua\fR
.IP \(bu 4
\fB$XDG_CONFIG_DIRS/swayimg/init.lua\fR
.IP \(bu 4
\fB/etc/xdg/swayimg/init.lua\fR
.PD
.PP
.SH "گزارش باگ‌ها (BUGS)"
.PP
برای ارسال پیشنهادها، نظرات، گزارش باگ‌ها و موارد دیگر از صفحه پروژه به نشانی https://github.com/artemsen/swayimg بازدید کنید.