نام (NAME)

kitten-clipboard - رونوشت و جای‌گذاری با بریده‌دان سیستم، حتی از طریق SSH

نمای کلی (OVERVIEW)

رونوشت و جای‌گذاری در بریده‌دان سیستم از طریق اسکریپت‌های شل

از kitten مربوط به clipboard می‌توان برای خواندن از یا نوشتن در بریده‌دان سیستم از طریق شل استفاده کرد. این ابزار حتی روی SSH نیز کار می‌کند. استفاده از آن به سادگی زیر است:

echo hooray | kitten clipboard

تمام متن دریافت شده در STDIN به بریده‌دان رونوشت می‌شود.

برای دریافت متن از بریده‌دان:

kitten clipboard --get-clipboard

متن در STDOUT نوشته خواهد شد. توجه داشته باشید که به‌طور پیش‌فرض زمانی که برنامه‌ای قصد خواندن بریده‌دان را داشته باشد، kitty درخواست مجوز می‌کند. این رفتار را می‌توان از طریق clipboard_control <#opt-kitty.clipboard_control> کنترل کرد.

افزوده شده در نگارش 0.27.0: پشتیبانی از رونوشت انواع داده دلخواه

از kitten مربوط به clipboard می‌توان برای ارسال/دریافت داده‌هایی فراتر از صرفاً متن ساده از بریده‌دان سیستم استفاده کرد. شما می‌توانید انواع داده دلخواه را منتقل کنید. این موضوع به بهترین شکل در چند مثال نشان داده شده است:

# Copy an image to the clipboard:
kitten clipboard picture.png
# Copy an image and some text to the clipboard:
kitten clipboard picture.jpg text.txt
# Copy text from STDIN and an image to the clipboard:
echo hello | kitten clipboard picture.png /dev/stdin
# Copy any raster image available on the clipboard to a PNG file:
kitten clipboard -g picture.png
# Copy an image to a file and text to STDOUT:
kitten clipboard -g picture.png /dev/stdout
# List the formats available on the system clipboard
kitten clipboard -g -m . /dev/stdout

به‌طور معمول، این kitten انواع MIME را بر اساس نام فایل‌ها حدس می‌زند. برای کنترل دقیق انواع MIME، از گزینه --mime استفاده کنید.

این kitten برای کارکرد خود از یک پروتکل جدید که توسط kitty توسعه یافته استفاده می‌کند؛ برای جزئیات، رونوشت همه انواع داده به بریده‌دان را ببینید <>.

کد منبع CLIPBOARD (SOURCE CODE FOR CLIPBOARD)

کد منبع این kitten در GitHub در دسترس است https://github.com/kovidgoyal/kitty/tree/master/kittens/clipboard.

رابط خط فرمان (COMMAND LINE INTERFACE)

kitten clipboard [options] [files to copy to/from]

خواندن از یا نوشتن در بریده‌دان سیستم.

این kitten در ساده‌ترین شکل خود در حالت پالایه (filter mode) کار می‌کند. برای تنظیم متن بریده‌دان، متن جدید را به STDIN هدایت (pipe) کنید. برای خروجی دادن محتوای متنی کنونی بریده‌دان به STDOUT، به جای آن از گزینه --get-clipboard استفاده کنید. توجه داشته باشید که رونوشت از بریده‌دان باعث نمایش پنجره بازشوی مجوز خواهد شد؛ برای جزئیات، clipboard_control <#opt-kitty.clipboard_control> را ببینید.

برای کنترل بیشتر، آرگومان‌های نام فایل را مشخص کنید. سپس، انواع MIME مختلف می‌توانند به/از بریده‌دان رونوشت شوند. چند مثال:

# Copy an image to the clipboard:
kitten clipboard picture.png
# Copy an image and some text to the clipboard:
kitten clipboard picture.jpg text.txt
# Copy text from STDIN and an image to the clipboard:
echo hello | kitten clipboard picture.png /dev/stdin
# Copy any raster image available on the clipboard to a PNG file:
kitten clipboard -g picture.png
# Copy an image to a file and text to STDOUT:
kitten clipboard -g picture.png /dev/stdout
# List the formats available on the system clipboard
kitten clipboard -g -m . /dev/stdout

گزینه‌ها (OPTIONS)

--get-clipboard [=no], -g [=no]: خروجی دادن محتویات فعلی بریده‌دان به STDOUT. توجه داشته باشید که به‌طور پیش‌فرض kitty برای دسترسی به بریده‌دان درخواست مجوز خواهد کرد. این رفتار با clipboard_control <#opt-kitty.clipboard_control> قابل کنترل است.

--use-primary [=no], -p [=no]: استفاده از انتخاب اولیه (primary selection) به جای بریده‌دان در سیستم‌هایی که از آن پشتیبانی می‌کنند، مانند لینوکس.

--mime <MIME>, -m <MIME>: نوع MIME فایل مشخص‌شده. زمانی مفید است که نوع MIME تشخیص‌داده‌شده به‌صورت خودکار احتمالاً نادرست باشد یا نام فایل پسوندی نداشته باشد و بنابراین نتوان هیچ نوع MIME را تشخیص داد. اگر بیش از یک فایل مشخص شده باشد، این گزینه باید چندین بار، یک بار برای هر فایل مشخص‌شده، تعیین شود. هنگام رونوشت داده از بریده‌دان، می‌توانید از الگوهای جانشین (wildcards) برای تطبیق انواع MIME استفاده کنید. برای مثال: --mime 'text/*' با هر نوع MIME متنی موجود روی بریده‌دان تطبیق می‌یابد؛ معمولاً نخستین نوع MIME تطبیق‌یافته رونوشت می‌شود. نوع ویژه MIME یعنی . فهرستی از انواع MIME موجود کنونی روی بریده‌دان سیستم را برمی‌گرداند.

--alias <ALIAS>, -a <ALIAS>: تعیین نام‌های مستعار برای انواع MIME. انواع MIME دارای نام مستعار، معادل در نظر گرفته می‌شوند. هنگام رونوشت به بریده‌دان، هر دو مورد اصلی و مستعار روی بریده‌دان در دسترس قرار می‌گیرند. هنگام رونوشت از بریده‌دان، اگر مورد اصلی یافت نشود، از نام مستعار به عنوان جایگزین پشتیبان استفاده می‌شود. می‌تواند چندین بار برای ایجاد چندین نام مستعار مشخص شود. برای مثال: --alias text/plain=text/x-rst نوع text/plain را به یک نام مستعار برای text/rst تبدیل می‌کند. نام‌های مستعار در حالت پالایه استفاده نمی‌شوند. اگر text/plain در داده‌های ورودی موجود نباشد، اما یک نوع دیگر از text/* موجود باشد، نام مستعاری برای text/plain به‌طور خودکار ایجاد می‌شود.

--wait-for-completion [=no]: انتظار تا تکمیل رونوشت به بریده‌دان پیش از خروج. هنگام اجرای kitten در یک پنجره موقت و اختصاصی مفید است. تنها در حالت پالایه مورد نیاز است.

--password <PASSWORD>: گذرواژه‌ای برای استفاده هنگام دسترسی به بریده‌دان. اگر کاربر پذیرش گذرواژه را انتخاب کند، فراخوانی‌های بعدی kitten در این نشست tty دیگر اعلانی برای درخواست مجوز نخواهند داشت. در حالت پالایه کار نمی‌کند. باید به شکل text:actual-password یا fd:integer (شماره یک توصیف‌گر فایل برای خواندن گذرواژه از آن) یا file:path-to-file (فایلی که گذرواژه از آن خوانده شود) باشد. توجه داشته باشید که باید با استفاده از پرچم --human-name یک نام کاربرپسند را نیز مشخص کنید.

--human-name <HUMAN_NAME>: یک نام کاربرپسند جهت نمایش به کاربر هنگام درخواست مجوز برای دسترسی به بریده‌دان.

نویسندگان (AUTHORS)

Kovid Goyal

کپی‌رایت و تکثیر (COPYRIGHT)

2026, Kovid Goyal

July 30, 2026

0.48.2