YDOTOOL(1) General Commands Manual YDOTOOL(1)

ydotool - ابزار خط فرمان خودکارسازی /dev/uinput

ydotool cmd args

ydotool cmd --help

ydotool به شما اجازه می‌دهد ورودی صفحه‌کلید و فعالیت‌های موشواره و غیره را به‌صورت برنامه‌ریزی‌شده (یا دستی) شبیه‌سازی کنید. دیمن ydotoold(8) باید در حال اجرا باشد.

دستور(های) پیاده‌سازی‌شده در حال حاضر:

type

تایپ یک رشته
key
فشردن کلیدها
mousemove
انتقال نشانگر موشواره به موقعیت مطلق
click
کلیک روی دکمه‌های موشواره

key [-d,--key-delay <ms>] [<KEYCODE:PRESSED> ...]

تایپ یک کد کلید (keycode) مشخص.

به‌عنوان مثال، 28:1 28:0 به معنای فشردن کلید Enter روی یک صفحه‌کلید استاندارد US است. (که در آن 1: برای فشرده شدن کلید به پایین و سپس 0: به معنای رها شدن کلید است)

42:1 38:1 38:0 24:1 24:0 38:1 38:0 42:0 - "LOL"

مقدارهای غیرقابل تفسیر، مانند 0، aaa و l0l، تنها باعث ایجاد تأخیر خواهند شد.

برای مشاهده کدهای کلید موجود (KEY_*)، به فایل “/usr/include/linux/input-event-codes.h” مراجعه کنید.

می‌توانید نام و شماره کلیدی را که صفحه‌کلید شما به libinput ارسال می‌کند، با اجرای دستور “sudo libinput record” و سپس انتخاب صفحه‌کلید خود از فهرست بیابید؛ این کار نام و شماره مناسب در libinput را برای هر کلیدی که فشار می‌دهید نشان خواهد داد.

گزینه‌ها: -d,--key-delay <ms>

زمان تأخیر میان فشردن کلیدها. پیش‌فرض 12ms.

type [-D,--next-delay <ms>] [-d,--key-delay <ms>] [-f,--file <filepath>] "text"

متن را طوری تایپ می‌کند که گویی خودتان آن را روی صفحه‌کلید تایپ کرده‌اید.

گزینه‌ها:

-d,--key-delay <ms>

زمان تأخیر میان رویدادهای کلید (هر کدام از بالا/پایین رفتن‌ها). پیش‌فرض 12ms.

-D,--next-delay <ms>

تأخیر میان رشته‌ها. پیش‌فرض 0ms.

-f,--file <filepath>

مشخص کردن فایلی که محتویات آن طوری تایپ می‌شود که گویی به‌عنوان یک آرگومان فرستاده شده است. مسیر فایل می‌تواند برای خواندن از stdin برابر '-' باشد.

مثال: برای تایپ 'Hello world!' این کار را انجام دهید:

ydotool type 'Hello world!'

mousemove [-a,--absolute] <x> <y>

انتقال موشواره به مختصات نسبی X و Y روی صفحه نمایش.

گزینه‌ها: --absolute

استفاده از موقعیت مطلق

مثال: برای انتقال مکان‌نما به مختصات مطلق (100,100):

ydotool mousemove --absolute 100 100

click [-d,--next-delay <ms>] [-r,--repeat N ] [button ...]

ارسال یک کلیک.

گزینه‌ها: -d,--next-delay <ms>

تأخیر میان رویدادهای ورودی (پایین/بالا، یک کلیک کامل به معنای دو برابر شدن زمان است). پیش‌فرض 25ms.

-r,--repeat N

تکرار کل توالی به تعداد N بار

تمام دکمه‌های موشواره با استفاده از مقادیر عددی شانزده‌شانزدهی (هگزادسیمال) نشان داده می‌شوند، همراه با یک ماسک بیتی اختیاری برای مشخص کردن اینکه آیا بالا/پایین رفتن موشواره باید نادیده گرفته شود یا خیر.

  • 0x00 - LEFT
  • 0x01 - RIGHT
  • 0x02 - MIDDLE
  • 0x03 - SIDE
  • 0x04 - EXTR
  • 0x05 - FORWARD
  • 0x06 - BACK
  • 0x07 - TASK
  • 0x40 - Mouse down
  • 0x80 - Mouse up
مثال‌ها:
  • 0x00: دکمه چپ را انتخاب می‌کند، اما کاری انجام نمی‌دهد (می‌توانید از این برای ایجاد وقفه‌های اضافی استفاده کنید)
  • 0xC0: کلیک دکمه چپ (پایین رفتن و سپس بالا آمدن)
  • 0x41: فشردن دکمه راست به پایین (right button down)
  • 0x82: رها کردن دکمه وسط به بالا (middle button up)

در صورت تمایل می‌توانید از پیشوند '0x' صرف‌نظر کنید.

سوکتی که برای نوشتن در ydotoold(8) استفاده می‌شود را می‌توان از طریق متغیر محیطی YDOTOOL_SOCKET تغییر داد.

ابزار ydotool توسط ReimuNotMoe نوشته شده است.

این صفحهٔ راهنما توسط bob.hepple@gmail.com نوشته شده و پس از آن به‌روزرسانی شده است.

AGPLv3

ydotoold(8)

تارنمای پروژه: https://github.com/ReimuNotMoe/ydotool

2024-07-14