hyprctl(1) راهنمای کاربری hyprctl hyprctl(1)

hyprctl - ابزاری برای واپایش بخش‌هایی از Hyprland از طریق واسط خط فرمان یا اسکریپت

hyprctl [(opt)flags] [command] [(opt)args]

دستور hyprctl ابزاری برای واپایش برخی از بخش‌های کامپوزیتور از طریق واسط خط فرمان یا یک اسکریپت است.

dispatch

فراخوانی یک توزیع‌کننده (dispatcher) به همراه یک آرگومان.

وجود آرگومان الزامی است. برای توزیع‌کننده‌های بدون پارامتر، این مقدار می‌تواند هر چیزی باشد.

خروجی: در صورت موفقیت ok و در صورت شکست یک پیام خطا بازمی‌گرداند.

مثال‌ها:
hyprctl dispatch "hl.dsp.exec_cmd('kitty')"

hyprctl dispatch "hl.dsp.window.close()"

keyword

تنظیم پویای یک کلیدواژه پیکربندی. در صورتی که ارائه‌دهنده پیکربندی شما lua باشد، این دستور کار نخواهد کرد (به eval مراجعه کنید).

خروجی: در صورت موفقیت ok و در صورت شکست یک پیام خطا بازمی‌گرداند.

مثال‌ها:
hyprctl keyword bind SUPER,0,pseudo

hyprctl keyword general:border_size 10

eval

ارزیابی پویای عبارت‌های دلخواه Lua هنگام استفاده از ارائه‌دهنده پیکربندی مبتنی بر Lua.

خروجی: در صورت موفقیت ok و در صورت شکست یک پیام خطا بازمی‌گرداند.

مثال‌ها:
hyprctl eval 'hl.config({ general = { border_size = 10 } })'

hyprctl eval 'hl.bind("SUPER + SHIFT + Q", hl.dsp.exec_cmd("firefox"))'

reload

بارگذاری مجدد اجباری فایل پیکربندی.

kill

ورود به حالت بستن اجباری (kill mode)، که در آن می‌توانید با کلیک روی یک برنامه آن را ببندید. با فشردن کلید ESCAPE می‌توانید از این حالت خارج شوید.

version

نمایش نسخه Hyprland، پرچم‌ها، کامیت و شاخه ساخت.

monitors

فهرست کردن تمام خروجی‌ها به همراه مشخصات آن‌ها.

workspaces

فهرست کردن تمام میزهای کار به همراه مشخصات آن‌ها.

clients

فهرست کردن تمام پنجره‌ها به همراه مشخصات آن‌ها.

devices

فهرست کردن تمام دستگاه‌های ورودی متصل‌شده.

activewindow

بازگرداندن نام پنجره فعال.

layers

فهرست کردن تمام لایه‌ها.

splash

بازگرداندن متن تصادفی صفحه شروع (splash) جاری.

status

بازگرداندن اطلاعات وضعیت داخلی مانند ساختار پیکربندی یا بک‌اند.

--batch

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

مثال:
hyprctl --batch "keyword general:border_size 2 ; keyword general:gaps_out 20"

علامت ; دستورها را از یکدیگر جدا می‌کند.

-j

نمایش خروجی اطلاعات در قالب JSON.

گزارش باگ‌ها و درخواست قابلیت‌های جدید را به صورت برخط در نشانی زیر ارسال کنید:
https://github.com/hyprwm/Hyprland/issues

کدهای منبع در: https://github.com/hyprwm/Hyprland

حق نشر (c) 2022، vaxerski

Vaxerski https://github.com/vaxerski.