.\" Generated by scdoc 1.11.5
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "wayvnc" "1" "2026\-07\-19"
.PP
.SH "نام (NAME)"
.PP
wayvnc \- کارساز VNC برای کامپوزیتورهای Wayland مبتنی بر wlroots.\&
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBwayvnc\fR [گزینه‌ها] [address.\&.\&.\&]
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB\-a, \-\-desktop\fR
.RS 4
ضبط تمام خروجی‌ها.\&
.PP
.RE
\fB\-C, \-\-config=<path>\fR
.RS 4
انتخاب یک فایل پیکربندی.\&
.PP
.RE
\fB\-d, \-\-disable\-input\fR
.RS 4
غیرفعال کردن تمام ورودی‌های از راه دور.\& این کار اجازه می‌دهد wayvnc بدون
پشتیبانی کامپوزیتور از پروتکل‌های ماوس / صفحه‌کلید مجازی استفاده شود.\&
.PP
.RE
\fB\-D, \-\-detached\fR
.RS 4
راه‌اندازی به‌صورت جدا شده از کامپوزیتور.\& برای اتصال به
یک کامپوزیتور دستور \fBwayvncctl attach\fR را اجرا کنید.\&
.PP
.RE
\fB\-f, \-\-max\-fps=<fps>\fR
.RS 4
تنظیم محدودیت نرخ فریم (پیش‌فرض 30).\&
.PP
.RE
\fB\-F, \-\-log\-filter=<file>\fR
.RS 4
تنظیم یک فیلتر گزارش.\&
.PP
.RE
\fB\-g, \-\-gpu\fR
.RS 4
فعال‌سازی قابلیت‌هایی که به GPU نیاز دارند.\&
.PP
.RE
\fB\-h, \-\-help\fR
.RS 4
دریافت راهنما.\&
.PP
.RE
\fB\-k, \-\-keyboard=<layout>[\-variant]\fR
.RS 4
انتخاب چیدمان صفحه‌کلید.\& در صورت نیاز می‌توان variant را نیز اضافه کرد.\&
.PP
.RE
\fB\-L, \-\-log\-level\fR
.RS 4
تنظیم سطح گزارش‌گیری.\& سطوح عبارتند از: error، warning، info، debug، trace و
quiet.\&
.PP
.RE
\fB\-n, \-\-name=<name>\fR
.RS 4
تنظیم نام میزکار.\& پیش‌فرض: WayVNC
.PP
.RE
\fB\-o, \-\-output=<name>\fR
.RS 4
انتخاب خروجی برای ضبط.\&
.PP
.RE
\fB\-p, \-\-show\-performance\fR
.RS 4
نمایش شمارنده‌های کارایی.\&
.PP
.RE
\fB\-r, \-\-render\-cursor\fR
.RS 4
فعال‌سازی رندر نشانگر هم‌پوشان (overlay cursor).\&
.PP
.RE
\fB\-R, \-\-disable\-resizing\fR
.RS 4
غیرفعال کردن تغییر اندازهٔ خودکار میزکار.\&
.PP
.RE
\fB\-s, \-\-seat=<name>\fR
.RS 4
انتخاب seat بر پایه نام.\&
.PP
.RE
\fB\-t, \-\-transient\-seat\fR
.RS 4
ایجاد یک seat گذرا (transient) برای هر نشست کلاینت.\&
.PP
.RE
\fB\-T, \-\-toplevel=<identifier>\fR
.RS 4
ضبط یک toplevel.\&
.PP
.RE
\fB\-S, \-\-socket=<path>\fR
.RS 4
تنظیم مسیر سوکت کنترلی wayvnc.\& پیش‌فرض: $XDG_RUNTIME_DIR/wayvncctl
یا /tmp/wayvncctl\-$UID
.PP
.RE
\fB\-v, \-\-verbose\fR
.RS 4
نمایش جزئیات بیشتر.\& همانند تنظیم `\-\-log\-level=info`.\&
.PP
.RE
\fB\-V, \-\-version\fR
.RS 4
نمایش اطلاعات نسخه.\&
.PP
.RE.SH "آدرس‌ها (ADDRESSES)"
.PP
می‌توان چندین آدرس شنود را با افزودن آنها به فهرست آرگومان‌ها مشخص کرد.\&
.PP
برای یک آدرس شبکهٔ معمولی، شمارهٔ پورت را می‌توان با افزودن آن به آدرس با جداکنندهٔ \fB:\fR تعیین کرد؛ مانند: \fBlocalhost:5901\fR.\&
.PP
اگر پورت مشخص شده باشد، آدرس‌های IPv6 باید در کروشه قرار گیرند؛ مانند: \fB[::]:5901\fR.\&
.PP
انواع مختلف سوکت را می‌توان با قرار دادن نام نوع مربوطه به عنوان پیشوند آدرس همراه با یک \fB:\fR در میان آنها مشخص کرد؛ مانند \fBunix:/tmp/wayvnc.\&sock\fR.\& انواع سوکت عبارتند از: tcp، unix، fd، ws، ws\-unix و ws\-fd.\&
.PP
با نوع \fBfd\fR، می‌توانید یک سوکت از پیش متصل‌شده (bound) را برای شنود کارساز VNC ارسال کنید.\& توصیف‌گر فایل (file descriptor) یک مقدار عددی به ارث رسیده از فرایند والد wayvnc است.\& مثال: \fBfd:42\fR.\&
.PP
خانوادهٔ پیشوندهای \fBws\fR تمام ارتباطات روی سوکت داده‌شده را با استفاده از فریم‌بندی WebSocket کپسوله‌سازی می‌کند.\& مثال: \fBws:0.\&0.\&0.\&0\fR.\&
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
این یک کارساز VNC برای کامپوزیتورهای Wayland مبتنی بر wlroots است.\& این برنامه به یک نشست Wayland در حال اجرا متصل می‌شود، دستگاه‌های ورودی مجازی ایجاد می‌کند و یک نمایشگر منفرد را از طریق پروتکل RFB ارائه می‌دهد.\& نشست Wayland ممکن است بدون سر (headless) باشد، بنابراین امکان اجرای wayvnc بدون اتصال نمایشگر فیزیکی نیز وجود دارد.\&
.PP
.SS "چندین خروجی (MULTIPLE OUTPUTS)"
.PP
اگر نشست Wayland شامل چندین خروجی باشد، تنها یکی از آنها ضبط خواهد شد.\& این خروجی به طور پیش‌فرض اولین خروجی خواهد بود، اما می‌توان آن را با آرگومان خط فرمان \fI\-o\fR مشخص کرد.\& این آرگومان نام کوتاهی مانند \fIeDP\-1\fR یا \fIDP\-4\fR را می‌پذیرد.\& اجرای wayvnc در حالت پرگویی (\fI\-v\fR) نام تمام خروجی‌ها را هنگام راه‌اندازی نمایش می‌دهد، یا می‌توانید آنها را در زمان اجرا از طریق دستور \fBwayvncctl output\-list\fR پرس‌وجو کنید.\&
.PP
همچنین می‌توانید خروجی در حال ضبط را در لحظه از طریق دستور \fBwayvncctl output\-set\fR تغییر دهید.\&
.PP
.SH "پیکربندی (CONFIGURATION)"
.PP
دستور wayvnc فایل پیکربندی را در این مکان جستجو می‌کند:
.RS 4
\(ti/$XDG_CONFIG_HOME/wayvnc/config
.RE
یا اگر $XDG_CONFIG_HOME تنظیم نشده باشد:
.RS 4
\(ti/.\&config/wayvnc/config
.PP
.RE
.SS "نحو (SYNTAX)"
.PP
فایل پیکربندی از جفت‌های کلید\-مقدار تشکیل شده است که با یک علامت \fBمساوی\fR از هم جدا می‌شوند.\& فاصله‌های خالی در اطراف کلید یا مقدار بی‌اهمیت هستند و بخشی از کلید یا مقدار محسوب نمی‌شوند.\&
.PP
.SS "کلیدواژه‌ها (KEYWORDS)"
.PP
\fBaddress\fR
.RS 4
آدرسی که کارساز باید به آن متصل شود، مانند 0.\&0.\&0.\&0 یا localhost.\&
.PP
.RE
\fBcertificate_file\fR
.RS 4
مسیر فایل گواهی برای رمزنگاری.\& فقط زمانی اعمال می‌شود که \fBenable_auth\fR=true باشد.\&
.PP
.RE
\fBenable_auth\fR
.RS 4
فعال‌سازی احراز هویت و رمزنگاری.\& تنظیم این مقدار بر روی \fBtrue\fR نیازمند تنظیم \fBcertificate_file\fR، \fBprivate_key_file\fR و \fBpassword\fR نیز هست.\& مقدار \fBusername\fR اختیاری است و در صورت تنظیم نشدن، پیش‌فرض آن یک رشتهٔ خالی است.\&
.PP
.RE
\fBenable_pam\fR
.RS 4
استفاده از PAM برای احراز هویت.\& در صورت فعال بودن، PAM تنظیمات \fBusername\fR و \fBpassword\fR را نادیده می‌گیرد.\& برخی روش‌های احراز هویت مانند DES با PAM کار نمی‌کنند.\&
.PP
.RE
\fBpassword\fR
.RS 4
انتخاب یک گذرواژه برای احراز هویت.\& زمانی که \fBenable_auth\fR تنظیم شده باشد و از \fBenable_pam\fR استفاده نشود، الزامی است.\&
.PP
.RE
\fBport\fR
.RS 4
پورتی که کارساز باید به آن متصل شود.\& پیش‌فرض 5900 است.\&
.PP
.RE
\fBprivate_key_file\fR
.RS 4
مسیر فایل کلید خصوصی برای رمزنگاری TLS.\& فقط زمانی اعمال می‌شود که \fBenable_auth\fR=true باشد.\&
.PP
.RE
\fBrelax_encryption\fR
.RS 4
پس از احراز هویت کاربر، نیازی به رمزنگاری نباشد.\& این گزینه برخی انواع امنیتی مانند Apple Diffie\-Hellman را فعال می‌کند.\&
.PP
.RE
\fBrsa_private_key_file\fR
.RS 4
مسیر فایل کلید خصوصی برای رمزنگاری RSA\-AES.\& فقط زمانی اعمال می‌شود که \fBenable_auth\fR=true باشد.\&
.PP
.RE
\fBusername\fR
.RS 4
انتخاب یک نام کاربری برای احراز هویت.\& اگر تنظیم نشود، پیش‌فرض آن یک نام کاربری خالی است.\&
.PP
.RE
\fBallow_broken_crypto\fR
.RS 4
اجازه دادن به استفاده از روش‌های رمزنگاری ناامن مانند احراز هویت DES.\& در صورت فعال بودن، کلاینت‌های قدیمی VNC که از انواع امنیتی مدرن پشتیبانی نمی‌کنند می‌توانند با استفاده از فیلد \fBpassword\fR احراز هویت شوند.\& تنها برای سازگاری با کلاینت‌های قدیمی در یک شبکهٔ مورد اعتماد استفاده شود.\&
.PP
.RE
\fBuse_relative_paths\fR
.RS 4
نسبی کردن مسیرهای فایل نسبت به مکان فایل پیکربندی.\&
.PP
.RE
\fBxkb_layout\fR
.RS 4
چیدمان صفحه‌کلید برای جستجوی کد کلیدها.\&
.PP
پیش‌فرض: \fIXKB_DEFAULT_LAYOUT\fR یا پیش‌فرض سیستم.\&
.PP
.RE
\fBxkb_model\fR
.RS 4
مدل صفحه‌کلید که کدهای کلید و LEDها بر اساس آن تفسیر می‌شوند.\&
.PP
پیش‌فرض: "pc105"
.PP
.RE
\fBxkb_options\fR
.RS 4
فهرستی از گزینه‌ها با کاما جدا شده که از طریق آن، کاربر ترجیحات غیرمرتبط با چیدمان را تعیین می‌کند، مانند این که کدام کلید، کلید Compose باشد.\&
.PP
پیش‌فرض: \fIXKB_DEFAULT_OPTIONS\fR یا پیش‌فرض سیستم.\&
.PP
.RE
\fBxkb_rules\fR
.RS 4
فایل قوانین نحوهٔ تفسیر مقادیر فیلدهای مدل، چیدمان، گونه و گزینه‌ها را شرح می‌دهد.\&
.PP
پیش‌فرض: \fIXKB_DEFAULT_RULES\fR یا پیش‌فرض سیستم.\&
.PP
.RE
\fBxkb_variant\fR
.RS 4
گونهٔ صفحه‌کلید برای استفاده در جستجوی کد کلید.\&
.PP
پیش‌فرض: \fIXKB_DEFAULT_VARIANT\fR یا پیش‌فرض سیستم.\&
.PP
.RE.SS "مثال (EXAMPLE)"
.PP
.nf
.RS 4
use_relative_paths=true
address=0\&.0\&.0\&.0
enable_auth=true
username=luser
password=p455w0rd
rsa_private_key_file=rsa_key\&.pem
private_key_file=tls_key\&.pem
certificate_file=tls_cert\&.pem
.fi
.RE
.PP
.SH "سوکت کنترلی WAYVNCCTL (WAYVNCCTL CONTROL SOCKET)"
.PP
برای تسهیل تعامل و کنترل در زمان اجرا، wayvnc یک سوکت دامنه یونیکس (unix domain socket) در مسیر \fB$XDG_RUNTIME_DIR\fR/wayvncctl (یا در صورت عدم دسترسی، /tmp/wayvncctl\-\fB$UID\fR) باز می‌کند.\& یک کلاینت می‌تواند متصل شده و برای پرس‌وجو و کنترل نمونه‌ی در حال اجرای wayvnc، پیام‌های IPC با قالب JSON مبادله کند.\&
.PP
.SS "دستورات IPC (IPC COMMANDS)"
.PP
\fIHELP\fR
.PP
دستور \fBhelp\fR هنگامی که بدون هیچ پارامتری صادر شود، نام تمامی دستورات موجود را فهرست می‌کند.\&
.PP
اگر پارامتر اختیاری \fBcommand\fR با نام به یکی از این دستورات اشاره کند، داده‌های پاسخ شامل توضیحاتی دقیق درباره آن دستور و پارامترهایش خواهد بود.\&
.PP
\fIEVENT\-RECEIVE\fR
.PP
دستور \fBevent\-receive\fR برای رویدادهای ناهمگام سرور ثبت‌نام می‌کند.\& برای جزئیات مربوط به قالب پیام رویداد به بخش \fIEVENTS\fR در زیر، و برای شرح تمامی رویدادهای ممکن سرور به بخش \fIIPC EVENTS\fR در زیر مراجعه کنید.\&
.PP
ثبت‌نام رویداد، برای تمامی رویدادهای موجود سرور ثبت‌نام می‌کند و دامنه آن تنها به اتصال فعلی محدود است.\& اگر یک کلاینت قطع و دوباره متصل شود، باید مجدداً برای رویدادها ثبت‌نام کند.\&
.PP
\fICLIENT\-LIST\fR
.PP
دستور \fBclient\-list\fR فهرستی از تمامی کلاینت‌های VNC که در حال حاضر به wayvnc متصل هستند را دریافت می‌کند.\&
.PP
\fICLIENT\-DISCONNECT\fR
.PP
دستور \fBclient\-disconnect\fR یک کلاینت VNC منفرد را قطع می‌کند.\&
.PP
پارامترها:
.PP
\fBid\fR
.RS 4
الزامی: شناسه (ID) کلاینت جهت قطع اتصال.\& این شناسه را می‌توان از دستور \fIGET\-CLIENTS\fR یا دریافت رویداد \fICLIENT\-CONNECTED\fR به دست آورد.\&
.PP
.RE
\fISET\-DESKTOP\-NAME\fR
.PP
دستور \fBset\-desktop\-name\fR نام میزکار ارسال‌شده به کلاینت‌های جدید را تغییر می‌دهد و نام را برای کلاینت‌های متصلی که از به‌روزرسانی نام میزکار پشتیبانی می‌کنند، به‌روزرسانی می‌کند.\&
.PP
پارامترها:
.PP
\fBdesktop\-name\fR
.RS 4
الزامی: نام میزکار.\&
.PP
.RE
\fIOUTPUT\-LIST\fR
.PP
دستور \fBoutput\-list\fR فهرستی از تمامی خروجی‌های شناخته‌شده برای wayvnc و اینکه آیا هر کدام در حال حاضر ضبط می‌شوند یا خیر را دریافت می‌کند.\&
.PP
\fIOUTPUT\-CYCLE\fR
.PP
برای نمایشگرهای چندخروجی Wayland، دستور \fBoutput\-cycle\fR خروجی‌ای که به طور فعال توسط wayvnc ضبط می‌شود را تغییر می‌دهد.\& اجرای یک‌باره این دستور، به خروجی در دسترس بعدی جابه‌جا می‌شود.\& اگر خروجی دیگری در دسترس نباشد، دوباره به خروجی اول برمی‌گردد.\&
.PP
\fIOUTPUT\-SET\fR
.PP
برای نمایشگرهای چندخروجی Wayland، دستور \fBoutput\-set\fR خروجی‌ای که به طور فعال توسط wayvnc ضبط می‌شود را بر اساس نام تغییر می‌دهد.\&
.PP
\fBoutput\-name=name\fR
.RS 4
الزامی: نام خروجی بعدی جهت ضبط.\&
.PP
.RE
\fIVERSION\fR
.PP
دستور \fBversion\fR اطلاعات نسخه را از نمونه در حال اجرای wayvnc پرس‌وجو می‌کند.\& همانند گزینه \fI\-V\fR، داده‌های پاسخ شامل شماره نسخه‌های wayvnc و همچنین نسخه‌های مؤلفه‌های neatvnc و aml خواهد بود.\&
.PP
\fIWAYVNC\-EXIT\fR
.PP
دستور \fBwayvnc\-exit\fR تمام کلاینت‌ها را قطع کرده و wayvnc را می‌بندد.\&
.PP.SS "رویدادهای IPC (IPC EVENTS)"
.PP
\fICAPTURE_CHANGED\fR
.PP
رویداد \fBcapture\-changed\fR زمانی ارسال می‌شود که خروجیِ در حال ضبط تغییر کند.\&
.PP
پارامترها:
.PP
\fBoutput=.\&.\&.\&\fR
.RS 4
نام خروجی‌ای که اکنون در حال ضبط است.\&
.PP
.RE
\fICLIENT\-CONNECTED\fR
.PP
رویداد \fBclient\-connected\fR زمانی ارسال می‌شود که یک کلاینت VNC جدید به wayvnc متصل شود.\&
.PP
پارامترها:
.PP
\fBid=.\&.\&.\&\fR
.RS 4
یک شناسه یکتا برای این کلاینت.\&
.PP
.RE
\fBconnection_count=.\&.\&.\&\fR
.RS 4
تعداد کل کلاینت‌های VNC متصل، شامل این کلاینت.\&
.PP
.RE
\fBaddress=.\&.\&.\&\fR
.RS 4
نشانی IP این کلاینت.\& ممکن است null باشد.\&
.PP
.RE
\fBusername=.\&.\&.\&\fR
.RS 4
نام کاربری استفاده‌شده برای احراز هویت این کلاینت.\& ممکن است null باشد.\&
.PP
.RE
\fICLIENT\-DISCONNECTED\fR
.PP
رویداد \fBclient\-disconnected\fR زمانی ارسال می‌شود که اتصال یک کلاینت VNC از wayvnc قطع شود.\&
.PP
پارامترها:
.PP
\fBid=.\&.\&.\&\fR
.RS 4
یک شناسه یکتا برای این کلاینت.\&
.PP
.RE
\fBconnection_count=.\&.\&.\&\fR
.RS 4
تعداد کل کلاینت‌های VNC متصل، بدون احتساب این کلاینت.\&
.PP
.RE
\fBaddress=.\&.\&.\&\fR
.RS 4
نشانی IP این کلاینت.\& ممکن است null باشد.\&
.PP
.RE
\fBusername=.\&.\&.\&\fR
.RS 4
نام کاربری استفاده‌شده برای احراز هویت این کلاینت.\& ممکن است null باشد.\&
.PP
.RE
.SS "قالب پیام IPC (IPC MESSAGE FORMAT)"
.PP
ابزار خط فرمان \fBwayvncctl(1)\fR پیام‌های json ipc با قالب‌بندی درست ایجاد می‌کند، اما هر کلاینتی کار خواهد کرد.\& کلاینت ارتباط را آغاز کرده و یک یا چند شیء درخواست می‌فرستد که هر کدام یک شیء پاسخ متناظر دریافت خواهند کرد.\&
.PP
\fBنکته\fR: این قالب پیام ناپایدار است و ممکن است در چند نسخه بعدی دستخوش تغییرات اساسی شود.\&
.PP
\fIREQUEST\fR
.PP
شکل کلی یک پیام درخواست json\-ipc به این صورت است:
.PP
.nf
.RS 4
{
	"method": "command\-name",
	"id": 123,
	"params": {
		"key1": "value1",
		"key2": "value2",
	}
}
.fi
.RE
.PP
مقدار \fBmethod\fR نام دستوری است که باید اجرا شود.\& از متد \fBhelp\fR برای استعلام فهرستی از تمام نام‌های معتبر متدها استفاده کنید.\&
.PP
فیلد \fBid\fR اختیاری است و می‌تواند هر عدد یا رشته معتبر JSON باشد.\& در صورت ارائه، پاسخ این درخواست شامل همان مقدار id خواهد بود که کلاینت می‌تواند از آن برای هماهنگ کردن چندین درخواست و پاسخ استفاده کند.\&
.PP
شیء \fBparams\fR پارامترهای اختیاری را برای هر متد فراهم می‌کند و در صورت خالی بودن می‌تواند حذف شود.\&
.PP
\fIRESPONSE\fR
.PP
.nf
.RS 4
{
	"id": 123,
	"code": 0,
	"data": {
		\&.\&.\&.
	}
}
.fi
.RE
.PP
اگر درخواست دارای id بود، پاسخ نیز مقدار یکسانی برای \fBid\fR خواهد داشت.\&
.PP
کد عددی \fBcode\fR نشان‌دهنده چگونگی رسیدگی به درخواست است.\& مقدار \fB0\fR همیشه نشان‌دهنده موفقیت است.\& هر مقدار دیگری به معنی شکست بوده و بسته به متد مورد نظر متغیر است.\&
.PP
شیء \fBdata\fR شامل داده‌های بازگشتی مخصوص هر متد است.\& این داده‌ها ممکن است داده‌های ساختاریافته در پاسخ به یک پرس‌وجو، یک رشته خطای ساده در صورت شکست درخواست باشند، یا اگر کد خطا به‌تنهایی کافی باشد، ممکن است به طور کامل حذف شود.\&
.PP
\fIEVENTS\fR
.PP
رویدادها پیام‌های ناهمگامی هستند که از یک سرور به تمام کلاینت‌های ثبت‌شده ارسال می‌شوند.\& قالب پیام با یک \fIREQUEST\fR یکسان است، اما فاقد فیلد "id" بوده و کلاینت نباید پاسخی ارسال کند.\&
.PP
پیام رویداد نمونه:
.PP
.nf
.RS 4
{
	"method": "event\-name",
	"params": {
		"key1": "value1",
		"key2": "value2",
	}
}
.fi
.RE
.PP
برای دریافت هرگونه رویداد، کلاینت ابتدا باید با ارسال یک درخواست IPC از نوع \fIevent\-receive\fR برای دریافت آن‌ها ثبت‌نام کند.\& هنگامی که پاسخ موفقیت‌آمیز توسط سرور ارسال شد، کلاینت باید انتظار داشته باشد که پیام‌های رویداد ناهمگام در هر زمانی توسط سرور ارسال شوند، حتی میان یک درخواست و پاسخ مرتبط با آن.\&
.PP.SH "محیط (ENVIRONMENT)"
.PP
متغیرهای محیطی زیر بر wayvnc تأثیر می‌گذارند:
.PP
\fIWAYLAND_DISPLAY\fR
.RS 4
نام نمایشگر Wayland را مشخص می‌کند که کامپوزیتوری که wayvnc باید به آن متصل شود، بر روی آن در حال اجرا است.\&
.PP
.RE
\fIXDG_CONFIG_HOME\fR
.RS 4
مکان فایل‌های پیکربندی را مشخص می‌کند.\&
.PP
.RE
\fIXDG_RUNTIME_DIR\fR
.RS 4
مکان پیش‌فرض را برای سوکت کنترلی wayvncctl مشخص می‌کند.\&
.PP
.RE
.SH "پرسش‌های متداول (FAQ)"
.PP
\fBخطای wayvnc مبنی بر عدم پشتیبانی از یک پروتکل\fR
.PP
.RS 4
خطا ممکن است به این شکل باشد:
.nf
.RS 4
wl_registry@2: error 0: invalid version for global zxdg_output_manager_v1 (4): have 2, wanted 3
ERROR: \&.\&./src/main\&.c: 388: Screencopy protocol not supported by compositor\&. Exiting\&. Refer to FAQ section in man page\&.
ERROR: \&.\&./src/main\&.c: 1024: Failed to initialise wayland
.fi
.RE
.PP
این بدان معناست که کامپوزیتور Wayland شما پروتکل screencopy را پیاده‌سازی نکرده است و wayvnc با آن کار نخواهد کرد.\& پروتکل screencopy توسط کامپوزیتورهای مبتنی بر wlroots مانند Sway و Wayfire پیاده‌سازی شده است.\&
.PP
.RE
\fBچگونه می‌توانم wayvnc را در حالت headless یا بر بستر یک نشست SSH اجرا کنم؟\&\fR
.PP
.RS 4
پیش از اجرای کامپوزیتور، متغیرهای محیطی \fIWLR_BACKENDS\fR=headless و \fIWLR_LIBINPUT_NO_DEVICES\fR=1 را مقداردهی کرده و سپس wayvnc را به صورت عادی اجرا کنید.\&
.PP
.RE
\fBچگونه می‌توانم کلید mod خود را از Sway به نشست میزکار از راه دور منتقل کنم؟\&\fR
.PP
.RS 4
یک حالت (mode) تقریباً خالی در پیکربندی sway خود ایجاد کنید.\& به عنوان مثال:
.nf
.RS 4
mode passthrough {
	bindsym $mod+Pause mode default
}
bindsym $mod+Pause mode passthrough
.fi
.RE
این پیکربندی باعث می‌شود زمانی که کلیدهای $mod+Pause را فشار می‌دهید، تمامی کلیدهای میانبر به جز کلید بازگشت، غیرفعال شوند.\&
.PP
.RE
\fBهنگام تایپ کردن همه نمادها نمایش داده نمی‌شوند.\& چگونه این مشکل را رفع کنم؟\&\fR
.PP
.RS 4
سعی کنید چیدمان صفحه‌کلید را در wayvnc به چیدمانی تغییر دهید که بیشترین تطابق را با چیدمان مورد استفاده در سمت کلاینت دارد.\& نیازی به چیدمان کاملاً یکسان نیست، فقط کافی است شامل تمام نمادهایی باشد که استفاده می‌کنید.\&
.PP
.RE
\fBچگونه کلید Compose را فعال کنم؟\&\fR
.PP
.RS 4
مقدار "xkb_options=compose:menu" را در فایل پیکربندی تنظیم کنید.\& هر کلیدی که برای کار دیگری تخصیص داده نشده باشد کار خواهد کرد.\& فقط باید کلیدی وجود داشته باشد تا wayvnc بتواند آن را تطبیق دهد.\&
.PP
.RE.SH "نویسندگان (AUTHORS)"
.PP
توسط Andri Yngvason <andri@yngvason.\&is> نگهداری می‌شود.\& سورس‌کدهای به‌روز را می‌توان در
https://github.\&com/any1/wayvnc یافت و گزارش باگ‌ها یا وصله‌ها را می‌توان به
ردیاب مشکلات (issue tracker) در GitHub ارسال کرد.\&
.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBwayvncctl(1)\fR