swaylock(1)                 General Commands Manual                swaylock(1)

نام (NAME)
       swaylock - قفل‌کننده صفحه نمایش برای Wayland

خلاصه دستور (SYNOPSIS)
       swaylock [options...]

       نشست Wayland شما را قفل می‌کند.

گزینه‌ها (OPTIONS)
       -C, --config <path>
           فایل پیکربندی برای استفاده. به‌طور پیش‌فرض، مسیرهای زیر بررسی می‌شوند:
           $HOME/.swaylock/config، $XDG_CONFIG_HOME/swaylock/config و
           SYSCONFDIR/swaylock/config. تمام پرچم‌ها به جز این گزینه، با قالب
           long-option=value گزینه‌های معتبری در فایل پیکربندی به شمار می‌روند.
           برای گزینه‌هایی مانند ignore-empty-password، تنها کافی است
           long-option مشخص شود. تمام خط‌های تیره ابتدایی باید حذف شوند و علامت
           مساوی برای پرچم‌هایی که آرگومان دریافت می‌کنند الزامی است. برای مثال:

               image=/usr/share/backgrounds/sway/Sway_Wallpaper_Blue_768x1024.png
               scaling=center
               show-failed-attempts
               ring-color=#ff00ff

       -d, --debug
           فعال‌سازی خروجی اشکال‌زدایی (دیباگ).

       -e, --ignore-empty-password
           هنگامی که گذرواژه خالی وارد می‌شود، آن را اعتبارسنجی نکن.

       -F, --show-failed-attempts
           نمایش تعداد فعلی تلاش‌های ناموفق احراز هویت.

       -f, --daemonize
           جدا شدن از ترمینال کنترل‌کننده پس از قفل کردن.

           نکته: این رفتار پیش‌فرض i3lock است.

       -R, --ready-fd <fd>
           توصیف‌گر فایل (file descriptor) برای ارسال اعلان‌های آماده‌بودن.

           هنگامی که نشست قفل شد، یک نویسه خط جدید روی FD نوشته می‌شود. در این
           نقطه، کامپوزیتور تضمین می‌کند که هیچ محتوای حساس امنیتی روی صفحه
           نمایش قابل مشاهده نیست.

       -h, --help
           نمایش پیام راهنما و خروج.

       -v, --version
           نمایش شماره نسخه و خروج.

ظاهر (APPEARANCE)
       -u, --no-unlock-indicator
           غیرفعال‌سازی نشانگر بازگشایی قفل.

       -i, --image [[<output>]:]<path>
           نمایش تصویر داده‌شده، در صورت تمایل تنها روی خروجی مشخص‌شده. از -c
           برای تنظیم رنگ پس‌زمینه استفاده کنید. اگر مسیر احتمالاً حاوی ':' است،
           یک ':' دیگر به ابتدای آن اضافه کنید تا از تفسیر بخشی از آن به‌عنوان
           <output> جلوگیری شود.

       -k, --show-keyboard-layout
           نمایش چیدمان فعلی xkb هنگام تایپ.

       -K, --hide-keyboard-layout
           مخفی‌سازی اجباری چیدمان فعلی xkb هنگام تایپ، حتی اگر بیش از یک
           چیدمان پیکربندی شده باشد یا گزینه show-keyboard-layout تنظیم شده
           باشد.

       -L, --disable-caps-lock-text
           غیرفعال‌سازی متن Caps Lock.

       -l, --indicator-caps-lock
           نمایش وضعیت فعلی Caps Lock روی نشانگر.

       -s, --scaling
           حالت مقیاس‌بندی تصویر: stretch، fill، fit، center، tile،
           solid_color. از solid_color برای نمایش تنها رنگ پس‌زمینه استفاده
           کنید، حتی اگر یک تصویر پس‌زمینه مشخص شده باشد.

       -t, --tiling
           مشابه --scaling=tile.

       -c, --color <rrggbb[aa]>
           تغییر رنگ صفحه به رنگ داده‌شده به‌جای خاکستری روشن. در صورت استفاده
           از -i، این گزینه رنگ پس‌زمینه تصویر را به مقدار داده‌شده تغییر می‌دهد.
           مقدار پیش‌فرض خاکستری روشن (A3A3A3) است.

       --bs-hl-color <rrggbb[aa]>
           تنظیم رنگ بخش‌های برجسته‌شده کلید backspace.

       --caps-lock-bs-hl-color <rrggbb[aa]>
           تنظیم رنگ بخش‌های برجسته‌شده کلید backspace زمانی که Caps Lock فعال
           است.

       --caps-lock-key-hl-color <rrggbb[aa]>
           تنظیم رنگ بخش‌های برجسته‌شده فشردن کلید زمانی که Caps Lock فعال است.

       --font <font>
           تنظیم قلم متن.

       --font-size <size>
           تنظیم اندازه ثابت قلم برای متن نشانگر.

       --indicator-idle-visible
           تنظیم نشانگر برای نمایش حتی در حالت بی‌کاری.

       --indicator-radius <radius>
           تنظیم شعاع نشانگر. مقدار پیش‌فرض 50 است.

       --indicator-thickness <thickness>
           تنظیم ضخامت نشانگر. مقدار پیش‌فرض 10 است.

       --indicator-x-position <x>
           تنظیم موقعیت افقی نشانگر.

       --indicator-y-position <y>
           تنظیم موقعیت عمودی نشانگر.

       --inside-color <rrggbb[aa]>
           تنظیم رنگ درون نشانگر.

       --inside-clear-color <rrggbb[aa]>
           تنظیم رنگ درون نشانگر هنگام پاک شدن ورودی.

       --inside-caps-lock-color <rrggbb[aa]>
           تنظیم رنگ درون نشانگر زمانی که Caps Lock فعال است.

       --inside-ver-color <rrggbb[aa]>
           تنظیم رنگ درون نشانگر هنگام اعتبارسنجی.

       --inside-wrong-color <rrggbb[aa]>
           تنظیم رنگ درون نشانگر هنگام نامعتبر بودن گذرواژه.

       --key-hl-color <rrggbb[aa]>
           تنظیم رنگ بخش‌های برجسته‌شده فشردن کلید.

       --layout-bg-color <rrggbb[aa]>
           تنظیم رنگ پس‌زمینه کادر حاوی متن چیدمان صفحه‌کلید.

       --layout-border-color <rrggbb[aa]>
           تنظیم رنگ حاشیه کادر حاوی متن چیدمان صفحه‌کلید.

       --layout-text-color <rrggbb[aa]>
           تنظیم رنگ متن چیدمان صفحه‌کلید.

       --line-color <rrggbb[aa]>
           تنظیم رنگ خط بین بخش درونی و حلقه نشانگر.

       --line-clear-color <rrggbb[aa]>
           تنظیم رنگ خط بین بخش درونی و حلقه هنگام پاک شدن ورودی.

       --line-caps-lock-color <rrggbb[aa]>
           تنظیم رنگ خط بین بخش درونی و حلقه زمانی که Caps Lock فعال است.

       --line-ver-color <rrggbb[aa]>
           تنظیم رنگ خط بین بخش درونی و حلقه هنگام اعتبارسنجی.

       --line-wrong-color <rrggbb[aa]>
           تنظیم رنگ خط بین بخش درونی و حلقه هنگام نامعتبر بودن گذرواژه.

       -n, --line-uses-inside
           استفاده از رنگ بخش درونی برای خط میان بخش درونی و حلقه.

       -r, --line-uses-ring
           استفاده از رنگ حلقه برای خط میان بخش درونی و حلقه.

       --ring-color <rrggbb[aa]>
           تنظیم رنگ حلقه نشانگر هنگام تایپ یا در حالت بی‌کاری.

       --ring-clear-color <rrggbb[aa]>
           تنظیم رنگ حلقه نشانگر هنگام پاک شدن ورودی.

       --ring-caps-lock-color <rrggbb[aa]>
           تنظیم رنگ حلقه نشانگر زمانی که Caps Lock فعال است.

       --ring-ver-color <rrggbb[aa]>
           تنظیم رنگ حلقه نشانگر هنگام اعتبارسنجی.

       --ring-wrong-color <rrggbb[aa]>
           تنظیم رنگ حلقه نشانگر هنگام نامعتبر بودن گذرواژه.

       --separator-color <rrggbb[aa]>
           تنظیم رنگ خطوط جداکننده بخش‌های برجسته‌شده.

       --text-color <rrggbb[aa]>
           تنظیم رنگ متن.

       --text-clear-color <rrggbb[aa]>
           تنظیم رنگ متن هنگام پاک شدن ورودی.

       --text-caps-lock-color <rrggbb[aa]>
           تنظیم رنگ متن زمانی که Caps Lock فعال است.

       --text-ver-color <rrggbb[aa]>
           تنظیم رنگ متن هنگام اعتبارسنجی.

       --text-wrong-color <rrggbb[aa]>
           تنظیم رنگ متن هنگام نامعتبر بودن گذرواژه.

سیگنال‌ها (SIGNALS)
       SIGUSR1
           بازگشایی قفل صفحه نمایش و خروج.

نویسندگان (AUTHORS)
       توسط Drew DeVault <sir@cmpwn.com> و با کمک سایر مشارکت‌کنندگان متن‌باز
       نگهداری می‌شود. برای اطلاعات بیشتر پیرامون توسعه swaylock، به
       <https://github.com/swaywm/swaylock> مراجعه کنید.

                                  2026-07-09                       swaylock(1)