.TH WL-CLIPBOARD 1 2026-03-22 wl-clipboard
.SH "نام (NAME)"
wl-clipboard \- ابزارهای خط فرمان رونوشت و جای‌گذاری Wayland
.SH "خلاصه دستور (SYNOPSIS)"
.B wl-copy
[\fB\-\-primary\fR]
[\fB\-\-type \fImime/type\fR]
[\fItext\fR...]
.PP
.B wl-paste
[\fB\-\-primary\fR]
[\fB\-\-type \fImime/type\fR]
.PP
تنها کاربردی‌ترین گزینه‌ها در اینجا فهرست شده‌اند؛ برای دیدن فهرست کامل به ادامه مراجعه کنید.
.SH "توضیحات (DESCRIPTION)"
دستور \fBwl-copy\fR متن مشخص‌شده (\fItext\fR) را در کلیپ‌بورد Wayland کپی می‌کند.
اگر هیچ متنی (\fItext\fR) مشخص نشده باشد، \fBwl-copy\fR داده‌ها را از ورودی استاندارد خود کپی می‌کند.
.PP
دستور \fBwl-paste\fR داده‌ها را از کلیپ‌بورد Wayland در خروجی استاندارد خود جای‌گذاری می‌کند.
.PP
اگرچه \fBwl-copy\fR و \fBwl-paste\fR به‌ویژه برای متن ساده و دیگر قالب‌های محتوای متنی بهینه‌سازی شده‌اند، اما به‌طور کامل از محتوای انواع MIME دلخواه پشتیبانی می‌کنند. \fBwl-copy\fR نوع محتوای کپی‌شده را با اجرای \fBxdg-mime\fR(1) روی آن به‌طور خودکار تشخیص می‌دهد. \fBwl-paste\fR بر اساس فهرست انواع MIME ارائه‌شده و پسوند فایلی که در آن جای‌گذاری می‌کند، بیشترین تلاش خود را برای انتخاب یک نوع مناسب به کار می‌گیرد. اگر از نوع انتخاب‌شده توسط آن‌ها راضی نیستید یا نمی‌خواهید به این تشخیص خودکار تکیه کنید، می‌توانید نوع مورد استفاده را صراحتاً با گزینهٔ \fB\-\-type\fR مشخص کنید.
.SH "گزینه‌ها (OPTIONS)"
برای تجزیهٔ گزینه‌ها، wl-clipboard از توابع کتابخانه‌ای
.BR getopt (3)
استفاده می‌کند که قابلیت‌های آن به کتابخانهٔ C مورد استفاده بستگی دارد. به‌ویژه، ممکن است بتوان \fB\-\-\fR را به عنوان یک آرگومان مستقل مشخص کرد تا از تجزیهٔ آرگومان‌های بعدی به عنوان گزینه جلوگیری شود (که به شما امکان می‌دهد متنی شامل کلماتی را که با علامت \fB-\fR شروع می‌شوند کپی کنید)، و گزینه‌های طولانی را تا پیشوندهای یکتای آن‌ها خلاصه کرد.
.TP
\fB\-p\fR, \fB\-\-primary
به جای کلیپ‌بورد معمولی، از کلیپ‌بورد «اولیه» (primary) استفاده می‌کند.
.TP
\fB\-o\fR, \fB\-\-paste-once\fR (برای \fBwl-copy\fR)
تنها به یک درخواست جای‌گذاری پاسخ می‌دهد و سپس خارج می‌شود. مگر اینکه از یک مدیر کلیپ‌بورد که مشخصاً برای جلوگیری از این کار طراحی شده استفاده شود، این گزینه تأثیر پاک‌کردن کلیپ‌بورد پس از اولین جای‌گذاری را دارد که برای کپی کردن داده‌های حساس مانند گذرواژه‌ها مفید است. توجه داشته باشید که این کار ممکن است جای‌گذاری در برخی کلاینت‌هایی را که انتظار دارند بتوانند چندین بار جای‌گذاری کنند با اختلال مواجه کند؛ به‌ویژه مشخص شده است که هنگام استفاده از این گزینه، جای‌گذاری در پنجره‌های XWayland دچار مشکل می‌شود.
.TP
\fB\-f\fR, \fB\-\-foreground\fR (برای \fBwl-copy\fR)
به‌طور پیش‌فرض، \fBwl-copy\fR منشعب (fork) شده و به درخواست‌های داده در پس‌زمینه پاسخ می‌دهد؛ این گزینه آن رفتار را لغو کرده و باعث می‌شود \fBwl-copy\fR در پیش‌زمینه اجرا شود.
.TP
\fB\-c\fR, \fB\-\-clear\fR (برای \fBwl-copy\fR)
به جای کپی کردن هر چیزی، کلیپ‌بورد را پاک می‌کند تا هیچ چیزی کپی نشود.
.TP
\fB\-n\fR, \fB\-\-trim-newline\fR (برای \fBwl-copy\fR)
نویسهٔ خط جدید انتهایی را، در صورت وجود در فایل ورودی، کپی نمی‌کند.
.TP
\fB\-n\fR, \fB\-\-no-newline\fR (برای \fBwl-paste\fR)
نویسهٔ خط جدید را پس از محتوای جای‌گذاری‌شدهٔ کلیپ‌بورد اضافه نمی‌کند. این گزینه برای انواع محتوای غیرمتنی و هنگام استفاده از حالت \fB\-\-watch\fR به‌طور خودکار فعال می‌شود.
.TP
\fB\-t\fI mime/type\fR, \fB\-\-type\fI mime/type
نوع MIME انتخاب‌شده به‌طور خودکار را لغو می‌کند. برای \fBwl-copy\fR، این گزینه مشخص می‌کند که محتوا تحت چه نوعی ارائه شود. برای \fBwl-paste\fR، تعیین می‌کند که محتوا در قالب کدام‌یک از انواع ارائه‌شده درخواست شود. علاوه بر انواع MIME خاص مانند \fIimage/png\fR، دستور \fBwl-paste\fR نام‌های نوع عمومی مانند \fItext\fR و \fIimage\fR را نیز می‌پذیرد که باعث می‌شود نوع MIME ارائه‌شده‌ای را که با نام عمومی داده‌شده مطابقت دارد به‌طور خودکار انتخاب کند.
.TP
\fB\-s\fI seat-name\fR, \fB\-\-seat\fI seat-name
مشخص می‌کند که \fBwl-copy\fR و \fBwl-paste\fR باید با کدام جایگاه (seat) کار کنند. Wayland به‌طور بومی از پیکربندی‌های چندجایگاهی پشتیبانی می‌کند که در آن هر جایگاه، نشانگر ماوس، فوکوس صفحه‌کلید، و در میان موارد دیگر کلیپ‌بورد مجزای خود را دارد. نام جایگاه پیش‌فرض احتمالاً \fIdefault\fR یا \fIseat0\fR است، و نام‌های جایگاه اضافی معمولاً از ویژگی
.BR udev (7)
با نام \fBENV{WL_SEAT}\fR می‌آیند. می‌توانید فهرست جایگاه‌های در دسترس فعلی را که توسط کامپوزیتور اعلان شده‌اند با استفاده از ابزار
.BR weston-info (1)
مشاهده کنید. اگر نام جایگاه را صراحتاً مشخص نکنید، \fBwl-copy\fR و \fBwl-paste\fR جایگاهی را به دلخواه انتخاب خواهند کرد. اگر از یک سیستم تک‌جایگاهی استفاده می‌کنید، دلیل چندانی برای استفاده از این گزینه وجود ندارد.
.TP
\fB\-l\fR, \fB\-\-list-types\fR (برای \fBwl-paste\fR)
به جای جای‌گذاری انتخاب، فهرست انواع MIME را که محتوا در آن‌ها ارائه شده است، در خروجی نمایش می‌دهد.
.TP
\fB\-w\fI command\fR..., \fB\-\-watch \fIcommand\fR... (برای \fBwl-paste\fR)
به جای یک بار جای‌گذاری و خارج شدن، تغییرات کلیپ‌بورد را به‌طور مداوم زیر نظر می‌گیرد و با هر بار ظاهر شدن یک انتخاب جدید، \fIcommand\fR مشخص‌شده را اجرا می‌کند. فرایند ایجادشده می‌تواند محتوای کلیپ‌بورد را از ورودی استاندارد خود بخواند. همچنین \fBwl-paste\fR متغیر \fBCLIPBOARD_STATE\fR را در محیط فرایندهای ایجادشده تنظیم می‌کند (به زیر مراجعه کنید).
.IP
این حالت به کامپوزیتوری نیاز دارد که از پروتکل data-control در wlroots پشتیبانی کند.
.TP
\fB\-\-sensitive\fR (برای \fBwl-copy\fR)
اشاره می‌کند که داده‌های در حال کپی حاوی گذرواژه‌ها، کلیدها یا سایر محتویات حساس هستند. برخی از مدیران کلیپ‌بورد ممکن است با ذخیره نکردن داده‌های کپی‌شده در تاریخچهٔ کلیپ‌بورد به این موضوع واکنش نشان دهند. این متناظر با \fBCLIPBOARD_STATE=sensitive\fR است (به زیر مراجعه کنید).
.TP
\fB\-v\fR, \fB\-\-version
نسخهٔ wl-clipboard و اطلاعات کوتاهی دربارهٔ مجوز آن را نمایش می‌دهد.
.TP
\fB\-h\fR, \fB\-\-help
پیام راهنمای کوتاهی شامل فهرست گزینه‌های موجود را نمایش می‌دهد.
.SH "محیط (ENVIRONMENT)"
.TP
.B WAYLAND_DISPLAY
مشخص می‌کند که \fBwl-copy\fR و \fBwl-paste\fR باید به کدام سرور Wayland متصل شوند. این همان متغیر محیطی است که به سایر کلاینت‌های Wayland مانند برنامه‌های گرافیکی که به این سرور Wayland متصل می‌شوند، ارسال می‌کنید. این متغیر معمولاً به‌طور خودکار توسط نشست گرافیکی و کامپوزیتور Wayland تنظیم می‌شود. برای جزئیات بیشتر
.BR wl_display_connect (3)
را ببینید.
.TP
.B WAYLAND_DEBUG
هنگامی که روی \fB1\fR تنظیم شود، باعث می‌شود کتابخانهٔ \fBwayland-client\fR(7) هر تعامل \fBwl-copy\fR و \fBwl-paste\fR با کامپوزیتور Wayland را در stderr ثبت کند.
.TP
.B CLIPBOARD_STATE
توسط \fBwl-paste\fR برای دستور ایجادشده در حالت \fB\-\-watch\fR تنظیم می‌شود. در حال حاضر مقادیر ممکن زیر \fIتعریف شده‌اند\fR:
.RS
.TP
CLIPBOARD_STATE=\fBdata
نشان می‌دهد که کلیپ‌بورد حاوی داده‌هایی است که دستور ایجادشده می‌تواند از ورودی استاندارد خود بخواند. این رایج‌ترین حالت است.
.TP
CLIPBOARD_STATE=\fBnil
نشان می‌دهد که کلیپ‌بورد خالی است. در این حالت ورودی استاندارد دستور ایجادشده به \fI/dev/null\fR متصل خواهد شد. توجه داشته باشید که این حالت با حالتی که کلیپ‌بورد حاوی داده‌هایی با اندازهٔ صفر باشد تفاوت ظریفی دارد (که برای نمونه با اجرای \fBwl-copy < /dev/null\fR می‌توان به آن رسید).
.TP
CLIPBOARD_STATE=\fBclear
نشان می‌دهد که کلیپ‌بورد به دلیل یک درخواست پاک‌سازی صریح خالی است، مانند پس از اجرای \fBwl-copy --clear\fR. همانند \fBnil\fR، ورودی استاندارد دستور به \fI/dev/null\fR متصل خواهد شد.
.TP
CLIPBOARD_STATE=\fBsensitive
نشان می‌دهد که کلیپ‌بورد حاوی داده‌های حساس مانند یک گذرواژه یا کلید است. احتمالاً بهتر است از نمایش دیداری یا ذخیرهٔ دائمی محتویات کلیپ‌بورد خودداری شود.
.RE
.IP
به هر برنامهٔ کلاینتی که پروتکل \fBCLIPBOARD_STATE\fR را پیاده‌سازی می‌کند توصیه می‌شود که پشتیبانی مناسبی را برای تمام مقادیر فهرست‌شده در بالا پیاده‌سازی کند، و همچنین در صورتی که \fBCLIPBOARD_STATE\fR تنظیم نشده باشد یا روی مقدار ناشناخته‌ای تنظیم شده باشد، رفتار معقولی را در پیش بگیرد (این امر برای باز گذاشتن فضای طراحی برای توسعه‌های آینده است). با این حال، پروتکل‌های کلیپ‌بورد فعلی موجود در Wayland به wl-clipboard اجازه نمی‌دهند مواردی را که مقادیر \fBclear\fR و \fBsensitive\fR باید تنظیم شوند شناسایی کند. به همین دلیل، در حال حاضر wl-clipboard هرگز \fBCLIPBOARD_STATE\fR را روی \fBclear\fR تنظیم نمی‌کند، و تنها زمانی آن را روی \fBsensitive\fR تنظیم می‌کند که با \fBx-kde-passwordManagerHint\fR در میان انواع MIME مواجه شود.
.IP
پروتکل \fBCLIPBOARD_STATE\fR عمداً به گونه‌ای طراحی شده است که مختص wl-clipboard یا Wayland نباشد؛ در واقع، سایر ابزارهای کلیپ‌بورد تشویق می‌شوند که همین پروتکل را پیاده‌سازی کنند. در حال حاضر، مشخص شده است که ابزار
.BR paste (1)
در SerenityOS همین پروتکل \fBCLIPBOARD_STATE\fR را پیاده‌سازی کرده است.
.SH "فایل‌ها (FILES)"
.TP
.I /etc/mime.types
در صورت وجود، توسط \fBwl-paste\fR خوانده می‌شود تا نوع MIME مناسب برای جای‌گذاری را بر اساس پسوند نام فایل خروجی استاندارد خود تشخیص دهد.
.SH "گزارش باگ‌ها (BUGS)"
مگر اینکه کامپوزیتور Wayland پروتکل data-control در wlroots را پیاده‌سازی کرده باشد، wl-clipboard مجبور است برای دسترسی به کلیپ‌بورد به یک ترفند متوسل شود: این ابزار برای لحظه‌ای کوتاه یک سطح (پنجره) شفاف بسیار کوچک ایجاد می‌کند. در برخی محیط‌های رومیزی (به‌ویژه هنگام استفاده از مدیر پنجره‌های کاشی‌ساز)، این کار می‌تواند باعث مشکلات بصری مانند چشمک‌زدن کوتاه شود. در برخی موارد، کامپوزیتور Wayland فوکوس را به پنجرهٔ بازشونده نمی‌دهد، که مانع دسترسی wl-clipboard به کلیپ‌بورد شده و به صورت قفل شدن (hang) نمایان می‌شود.
.PP
در حال حاضر راهی برای کپی هم‌زمان داده‌ها در چند نوع MIME، مانند چند قالب تصویر، وجود ندارد.
.br
ببینید:
.nh
<https://github.com/bugaevc/wl-clipboard/issues/71>
.hy
.PP
برنامهٔ wl-clipboard همیشه قادر به تشخیص متنی بودن یک نوع MIME نیست، که ممکن است جای‌گذاری در کلاینت‌هایی را که انتظار قالب‌های متنی دارند و نه \fIapplication/something\fR، دچار مشکل کند. راهکار موقت، همانند تمام مشکلات تشخیص قالب، مشخص کردن صریح نوع MIME مورد نظر است، مانند \fBwl-copy \-\-type\fI text/plain\fR.
.PP
دستورهای \fBwl-copy \-\-clear\fR و \fBwl-copy \-\-paste-once\fR همیشه تعامل خوبی با مدیران کلیپ‌بوردی که اصرار زیادی به حفظ محتویات کلیپ‌بورد دارند، ندارند.
.PP
برنامه‌هایی که با استفاده از جعبه‌ابزار GTK 3 نوشته شده‌اند، متن را با پایان‌خط‌های \(dq\er\en\(dq (که با نام CR LF نیز شناخته می‌شود) کپی می‌کنند، که بیشتر نرم‌افزارهای دیگر را غافلگیر می‌کند. برنامهٔ wl-clipboard هیچ اقدامی برای اصلاح این مورد انجام نمی‌دهد. راهکار موقت پیشنهادی این است که هنگام جای‌گذاری از یک برنامهٔ GTK 3، خروجی \fBwl-paste\fR را از طریق
.BR dos2unix (1)
هدایت کنید.
.br
ببینید:
.nh
<https://gitlab.gnome.org/GNOME/gtk/-/issues/2307>
.hy
.PP
هنگام تلاش برای جای‌گذاری محتوای کپی‌شده با \fBwl-copy\fR، دستور \fBwl-copy\fR بررسی نمی‌کند که آیا نوع MIME درخواست‌شده در میان انواع ارائه‌شده توسط آن هست یا خیر، و همیشه همان داده‌ها را در پاسخ ارائه می‌دهد.
.SH "مثال‌ها (EXAMPLES)"
.TP
کپی یک پیام متنی ساده:
$
.BI wl-copy " Hello world!"
.TP
کپی پیامی که با خط تیره آغاز می‌شود:
.BI "wl-copy -- " --long
.TP
کپی فهرست فایل‌ها در \fI~/Downloads\fR:
$
.IB "ls ~/Downloads" " | wl-copy"
.TP
کپی یک تصویر:
$
.BI "wl-copy < " ~/Pictures/photo.png
.TP
کپی دستور قبلی:
$
.B wl-copy \(dq!!\(dq
.TP
جای‌گذاری در یک فایل، بدون اضافه کردن خط جدید:
$
.BI "wl-paste \-n > " clipboard.txt
.TP
مرتب‌سازی محتویات کلیپ‌بورد:
$
.B wl-paste | sort | wl-copy
.TP
بارگذاری محتویات کلیپ‌بورد در یک pastebin با هر تغییر:
$
.BI "wl-paste --watch nc " "paste.example.org 5555
.SH "نویسندگان (AUTHORS)"
نوشته‌شده توسط Sergey Bugaev.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
باگ‌های wl-clipboard را به <https://github.com/bugaevc/wl-clipboard/issues> گزارش دهید.
.br
لطفاً حتماً ذکر کنید از کدام کامپوزیتور Wayland استفاده می‌کنید، و گزارش‌های اشکال‌زدایی \fBWAYLAND_DEBUG=1\fR مربوط به wl-clipboard را ضمیمه کنید.
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
حق نشر \(co 2018-2026 Sergey Bugaev.
مجوز GPLv3+‎: گنو GPL نسخه ۳ یا بالاتر <https://gnu.org/licenses/gpl.html>.
.br
این یک نرم‌افزار آزاد است: شما در تغییر و بازتوزیع آن آزاد هستید.
هیچ‌گونه ضمانتی وجود ندارد، تا حدی که قانون اجازه می‌دهد.
.SH "همچنین ببینید (SEE ALSO)"
.BR xclip (1),
.BR xsel (1),
.BR wl-clipboard-x11 (1)