swaylock(1) General Commands Manual swaylock(1)

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

swaylock [options...]

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

-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

نمایش شماره نسخه و خروج.

-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]>

تنظیم رنگ متن هنگام نامعتبر بودن گذرواژه.

SIGUSR1

بازگشایی قفل صفحه نمایش و خروج.

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

2026-07-09