نام (NAME)

gsr-cli - مدیریت نمونه در حال اجرای GPU Screen Recorder

خلاصه دستور (SYNOPSIS)

gsr-cli -ipc socket_path command [command_arguments...]

gsr-cli -h | --help

توضیحات (DESCRIPTION)

دستور gsr-cli دستوری را به یک نمونه در حال اجرای gpu-screen-recorder(1) که با گزینه -ipc اجرا شده است ارسال می‌کند و پاسخ آن را گزارش می‌دهد. این قابلیت، کنترلی همانند ارسال سیگنال‌ها به GPU Screen Recorder فراهم می‌کند، با این تفاوت که امکان ذخیره بازپخش (replay) با تعداد ثانیه‌های دلخواه وجود دارد و بر خلاف ارسال کورکورانه سیگنال، نتیجه دستور نیز دریافت و مشخص می‌شود.

دستور gsr-cli در صورت موفقیت‌آمیز بودن دستور با کد ۰ و در صورت شکست با کد ۱ خارج می‌شود. هنگام بروز خطا، دلیل آن در stderr چاپ می‌شود.

گزینه‌ها (OPTIONS)

-ipc socket_path: سوکت دامنه یونیکس (Unix domain socket) که GPU Screen Recorder با آن راه‌اندازی شده است. اجباری.

دستورات (COMMANDS)

status: بررسی می‌کند که آیا نمونه‌ای از GPU Screen Recorder روی سوکت گوش فرا می‌دهد یا خیر؛ این کار با اتصال به سوکت بدون ارسال دستور انجام می‌شود. در صورت فعال بودن، عبارت running یا not running را چاپ کرده و با کد ۰ خارج می‌شود. فایل سوکتی که پس از بستن اجباری (kill) یک نمونه باقی مانده باشد، به عنوان در حال اجرا نبودن تلقی می‌شود.
stop: توقف و ذخیره ضبط (در حالت بازپخش، توقف بدون ذخیره‌سازی انجام می‌شود). تا زمان ذخیره کامل فایل ضبط‌شده منتظر می‌ماند و مسیر فایل ذخیره‌شده را چاپ می‌کند. در حالت بازپخش چیزی چاپ نمی‌شود زیرا فایلی ذخیره نمی‌گردد.
toggle-pause: مکث/ادامه ضبط (برای پخش زنده/بازپخش کاربرد ندارد).
set-paused true|false: مکث/ادامه ضبط (برای پخش زنده/بازپخش کاربرد ندارد). بر خلاف toggle-pause این دستور در حالتی که ضبط از قبل متوقف یا در حال اجرا باشد با خطا مواجه نمی‌شود، بنابراین نتیجه به وضعیت جاری وابسته نیست.
toggle-replay-recording: شروع/توقف ضبط معمولی حین بازپخش/پخش زنده، که نیازمند اجرای GPU Screen Recorder با گزینه -ro است.
start-replay-recording: شروع ضبط معمولی حین بازپخش/پخش زنده، که نیازمند اجرای GPU Screen Recorder با گزینه -ro است. اگر ضبط از قبل در حال اجرا باشد، هیچ عملی انجام نمی‌دهد.
stop-replay-recording: توقف ضبط معمولی که حین بازپخش/پخش زنده در حال اجراست. تا زمان ذخیره کامل فایل ضبط‌شده منتظر می‌ماند و مسیر فایل ذخیره‌شده را چاپ می‌کند. اگر هیچ ضبطی در حال اجرا نباشد، با خطا متوقف می‌شود.
save-replay [seconds] [restart-replay=true|false]: ذخیره بازپخش (فقط در حالت بازپخش). تعداد ثانیه‌ها باید بزرگ‌تر از ۰ باشد. اگر هیچ ثانیه‌ای مشخص نشود، کل بافر بازپخش ذخیره می‌شود. تا زمان ذخیره کامل بازپخش منتظر می‌ماند و مسیر فایل ذخیره‌شده را چاپ می‌کند. گزینه restart-replay گزینه -restart-replay-on-save برنامه GPU Screen Recorder را برای این ذخیره‌سازی لغو می‌کند، که باعث می‌شود بافر بازپخش پس از ذخیره کامل کل آن پاکسازی شود.

مثال‌ها (EXAMPLES)

راه‌اندازی GPU Screen Recorder در حالت بازپخش با یک سوکت ipc:

gpu-screen-recorder -w screen -f 60 -c mp4 -r 60 -o ~/Videos -ipc "$XDG_RUNTIME_DIR/gsr.sock" &

ذخیره ۳۰ ثانیه گذشته:

gsr-cli -ipc "$XDG_RUNTIME_DIR/gsr.sock" save-replay 30

ذخیره کل بافر بازپخش و پاکسازی آن:

gsr-cli -ipc "$XDG_RUNTIME_DIR/gsr.sock" save-replay restart-replay=true

شروع بازپخش تنها زمانی که از قبل در حال اجرا نیست:

gsr-cli -ipc "$XDG_RUNTIME_DIR/gsr.sock" status >/dev/null || start-replay.sh

نکات (NOTES)

سوکت تنها توسط کاربری که GPU Screen Recorder را راه‌اندازی کرده قابل استفاده است.
دستورات stop، save-replay و stop-replay-recording زمانی پاسخ داده می‌شوند که فایل ذخیره شده و اسکریپت داده‌شده با گزینه -sc اجرا شده باشد، و پاسخ شامل مسیر فایل ذخیره‌شده است. سایر دستورات به محض پذیرش توسط GPU Screen Recorder پاسخ داده می‌شوند.
برنامه GPU Screen Recorder سوکت را قبل از اتمام کامل راه‌اندازی خود ایجاد می‌کند، بنابراین دستوری که در زمان راه‌اندازی ارسال شود، با شروع ضبط پاسخ داده خواهد شد.

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

ابزار gsr-cli توسط مشارکت‌کنندگان GPU Screen Recorder نوشته شده است.

گزارش باگ‌ها (REPORTING BUGS)

گزارش اشکالات به: dec05eba@protonmail.com.

حق نشر (COPYRIGHT)

همچنین ببینید (SEE ALSO)

gpu-screen-recorder(1)

وبگاه پروژه: https://git.dec05eba.com/gpu-screen-recorder/about