| 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
-P, --position=X,Y
-S, --size=W,H
-F, --fullscreen
-c, --config=FILE
-e, --execute=LUA
--appid=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
HYPRLAND_INSTANCE_SIGNATURE, XDG_RUNTIME_DIR
XDG_CONFIG_HOME, XDG_CONFIG_DIRS, HOME
SHELL
سیگنال‌ها (SIGNALS)
SIGUSR1, SIGUSR2
وضعیت خروج (EXIT STATUS)
در صورت اجرای موفقیت‌آمیز برنامه، وضعیت خروج 0 و در صورت بروز خطا 1 خواهد بود. کدهای دیگر را می‌توان از طریق اسکریپت Lua تعیین کرد.
مثال‌ها (EXAMPLES)
مشاهده چندین فایل:
نمایش تصویر دریافت‌شده از طریق pipe:
بارگذاری stdout از دستورهای خارجی:
"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 بازدید کنید.
| 2026-03-08 | swayimg |