SWAYIMG(1)                      راهنمای swayimg                     SWAYIMG(1)

نام (NAME)
       swayimg - نمایش‌دهنده تصویر برای Wayland/DRM با پشتیبانی از اسکریپت‌نویسی
       Lua

خلاصه دستور (SYNOPSIS)
       swayimg [OPTION]... [FILE]...

       اگر هیچ فایل ورودی یا دایرکتوری‌ای مشخص نشده باشد، نمایش‌دهنده تلاش خواهد
       کرد تمام فایل‌های موجود در دایرکتوری جاری را بخواند.

       برای خواندن داده‌های تصویر از stdin، از - به عنوان FILE استفاده کنید.

       برای دریافت داده‌های تصویر از stdout چاپ‌شده توسط یک دستور خارجی، از
       پیشوند exec:// استفاده کنید.

توضیحات (DESCRIPTION)
       برنامه swayimg یک نمایش‌دهنده تصویر سبک و بومی Wayland است که برای مدیر
       پنجره‌های Sway و Hyprland بهینه‌سازی شده است و از یک حالت روکش (overlay)
       بهره می‌برد که نمایش تصویر در ترمینال را شبیه‌سازی می‌کند. این برنامه از
       حالت‌های اسلایدشو و گالری پشتیبانی می‌کند، قادر به خواندن داده‌ها از stdin
       و دستورهای خارجی است، و از طریق اسکریپت‌نویسی Lua به‌شدت سفارشی‌پذیر است.

گزینه‌ها (OPTIONS)
       -h, --help
           نمایش پیام راهنما و خروج.

       -V, --version
           نمایش اطلاعات نسخه و فهرست قالب‌های تصویر پشتیبانی‌شده.

       -v, --viewer
           شروع اجباری در حالت نمایشگر.

       -g, --gallery
           شروع اجباری در حالت گالری.

       -s, --slideshow
           شروع اجباری در حالت اسلایدشو.

       -f, --from-file=FILE
           بارگذاری فهرست فایل‌ها از FILE متنی.

       -P, --position=X,Y
           تنظیم موقعیت اولیه پنجره (تنها در Sway/Hyprland).

       -S, --size=W,H
           تنظیم اندازه اولیه پنجره.

       -F, --fullscreen
           شروع در حالت تمام‌صفحه.

       -c, --config=FILE
           بارگذاری FILE مشخص‌شده Lua به‌جای فایل پیش‌فرض.

       -e, --execute=LUA
           اجرای اسکریپت Lua مشخص‌شده پس از بارگذاری پیکربندی.

       --appid=ID
           تنظیم شناسه برنامه (application Id).

       --verbose
           فعال‌سازی خروجی با جزئیات بیشتر.

کلیدها (KEYS)
   نمایشگر و اسلایدشو (Viewer and Slideshow)
       •   Esc: خروج از برنامه
       •   Enter: رفتن به حالت گالری
       •   s: فعال/غیرفعال کردن حالت اسلایدشو
       •   Insert: علامت‌گذاری/برداشتن علامت تصویر جاری
       •   Delete: نادیده گرفتن تصویر (حذف از فهرست تصاویر)
       •   f: فعال/غیرفعال کردن حالت تمام‌صفحه
       •   a: فعال/غیرفعال کردن هموارسازی لبه‌ها (anti-aliasing)
       •   ]: چرخش تصویر ۹۰ درجه در جهت عقربه‌های ساعت
       •   [: چرخش تصویر ۹۰ درجه در خلاف جهت عقربه‌های ساعت
       •   m: بازتاب عمودی تصویر
       •   Shift-m: بازتاب افقی تصویر
       •   t: نمایش/پنهان‌سازی لایه متنی اطلاعات
       •   PgDown: نمایش تصویر بعدی
       •   PgUp: نمایش تصویر قبلی
       •   Shift-PgDown: نمایش فریم بعدی
       •   Shift-PgUp: نمایش فریم قبلی
       •   +: بزرگ‌نمایی
       •   -: کوچک‌نمایی
       •   Left/Right/Up/Down: پیمایش در تصویر
       •   Backspace: بازنشانی مقیاس و موقعیت تصویر به مقادیر پیش‌فرض

       کلیدهای موشواره:
       •   ScrollUp/ScrollDown/ScrollLeft/ScrollRight: جابه‌جایی تصویر
       •   Ctrl-ScrollUp: بزرگ‌نمایی
       •   Ctrl-ScrollDown: کوچک‌نمایی
       •   MouseLeft: جابه‌جایی تصویر (کشیدن)
       •   MouseRight: کشیدن و رها کردن تصویر به برنامه‌های خارجی

   گالری (Gallery)
       •   Esc: خروج از برنامه
       •   Home: انتخاب اولین تصویر بندانگشتی در فهرست تصاویر
       •   End: انتخاب آخرین تصویر بندانگشتی در فهرست تصاویر
       •   Left: انتخاب تصویر بندانگشتی سمت چپ تصویر فعلی
       •   Right: انتخاب تصویر بندانگشتی سمت راست تصویر فعلی
       •   Up: انتخاب تصویر بندانگشتی بالای تصویر فعلی
       •   Down: انتخاب تصویر بندانگشتی پایین تصویر فعلی
       •   PgUp: انتخاب تصویر بندانگشتی در صفحه قبلی
       •   PgDown: انتخاب تصویر بندانگشتی در صفحه بعدی
       •   Enter: رفتن به حالت نمایشگر
       •   s: رفتن به حالت اسلایدشو
       •   Insert: علامت‌گذاری/برداشتن علامت تصویر انتخاب‌شده جاری
       •   Delete: نادیده گرفتن تصویر (حذف از فهرست تصاویر)
       •   f: فعال/غیرفعال کردن حالت تمام‌صفحه
       •   a: فعال/غیرفعال کردن هموارسازی لبه‌ها (anti-aliasing)
       •   +: افزایش اندازه تصویر بندانگشتی
       •   -: کاهش اندازه تصویر بندانگشتی
       •   t: نمایش/پنهان‌سازی لایه متنی اطلاعات

       کلیدهای موشواره:
       •   MouseLeft: باز کردن تصویر انتخاب‌شده فعلی در نمایشگر
       •   MouseRight: کشیدن و رها کردن تصویر به برنامه‌های خارجی
       •   Ctrl-ScrollUp: افزایش اندازه تصویر بندانگشتی
       •   Ctrl-ScrollDown: کاهش اندازه تصویر بندانگشتی
       •   ScrollUp/ScrollDown/ScrollLeft/ScrollRight: انتخاب تصویر بعدی

محیط (ENVIRONMENT)
       SWAYSOCK
           مسیر فایل سوکت مورد استفاده برای Sway IPC.

       HYPRLAND_INSTANCE_SIGNATURE, XDG_RUNTIME_DIR
           مسیر فایل سوکت مورد استفاده برای Hyprland IPC.

       XDG_CONFIG_HOME, XDG_CONFIG_DIRS, HOME
           پیشوند مسیر فایل پیکربندی پیش‌فرض برنامه.

       SHELL
           پوسته مورد استفاده برای اجرای دستورهای خارجی و بارگذاری تصویر از
           stdout.

سیگنال‌ها (SIGNALS)
       SIGUSR1, SIGUSR2
           انجام اقدامات مشخص‌شده در فایل پیکربندی.

وضعیت خروج (EXIT STATUS)
       در صورت اجرای موفقیت‌آمیز برنامه، وضعیت خروج 0 و در صورت بروز خطا 1
       خواهد بود. کدهای دیگر را می‌توان از طریق اسکریپت Lua تعیین کرد.

مثال‌ها (EXAMPLES)
       مشاهده چندین فایل:
           swayimg photo.jpg logo.png

       نمایش تصویر دریافت‌شده از طریق pipe:
           wget -qO- https://www.kernel.org/theme/images/logos/tux.png |
           swayimg -

       بارگذاری stdout از دستورهای خارجی:
           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"

فایل‌ها (FILES)
       این برنامه هنگام راه‌اندازی فایل init.lua را جستجو و پردازش می‌کند. این
       فایل یک اسکریپت Lua است که پارامترهای اولیه را تنظیم کرده، قلاب‌ها
       (hooks) را می‌افزاید و رفتار برنامه را تغییر می‌دهد.

       مسیرهای احتمالی فایل:
       •   $XDG_CONFIG_HOME/swayimg/init.lua
       •   $HOME/.config/swayimg/init.lua
       •   $XDG_CONFIG_DIRS/swayimg/init.lua
       •   /etc/xdg/swayimg/init.lua

گزارش باگ‌ها (BUGS)
       برای ارسال پیشنهادها، نظرات، گزارش باگ‌ها و موارد دیگر از صفحه پروژه به
       نشانی https://github.com/artemsen/swayimg بازدید کنید.

swayimg                           2026-03-08                        SWAYIMG(1)