.TH GSR\-CLI 1 "2026-08-18" "6.0.1" "GPU Screen Recorder CLI Manual" .SH "نام (NAME)" gsr\-cli \- مدیریت نمونه در حال اجرای GPU Screen Recorder .SH "خلاصه دستور (SYNOPSIS)" .B gsr\-cli .B \-ipc .I socket_path .I command .RI [ command_arguments... ] .PP .B gsr\-cli .B \-h | .B \-\-help .SH "توضیحات (DESCRIPTION)" دستور .B gsr\-cli دستوری را به یک نمونه در حال اجرای .BR gpu\-screen\-recorder (1) که با گزینه .B \-ipc اجرا شده است ارسال می‌کند و پاسخ آن را گزارش می‌دهد. این قابلیت، کنترلی همانند ارسال سیگنال‌ها به GPU Screen Recorder فراهم می‌کند، با این تفاوت که امکان ذخیره بازپخش (replay) با تعداد ثانیه‌های دلخواه وجود دارد و بر خلاف ارسال کورکورانه سیگنال، نتیجه دستور نیز دریافت و مشخص می‌شود. .PP دستور .B gsr\-cli در صورت موفقیت‌آمیز بودن دستور با کد ۰ و در صورت شکست با کد ۱ خارج می‌شود. هنگام بروز خطا، دلیل آن در stderr چاپ می‌شود. .SH "گزینه‌ها (OPTIONS)" .TP .BI \-ipc " socket_path" سوکت دامنه یونیکس (Unix domain socket) که GPU Screen Recorder با آن راه‌اندازی شده است. اجباری. .SH "دستورات (COMMANDS)" .TP .B status بررسی می‌کند که آیا نمونه‌ای از GPU Screen Recorder روی سوکت گوش فرا می‌دهد یا خیر؛ این کار با اتصال به سوکت بدون ارسال دستور انجام می‌شود. در صورت فعال بودن، عبارت .B running یا .B "not running" را چاپ کرده و با کد ۰ خارج می‌شود. فایل سوکتی که پس از بستن اجباری (kill) یک نمونه باقی مانده باشد، به عنوان در حال اجرا نبودن تلقی می‌شود. .TP .B stop توقف و ذخیره ضبط (در حالت بازپخش، توقف بدون ذخیره‌سازی انجام می‌شود). تا زمان ذخیره کامل فایل ضبط‌شده منتظر می‌ماند و مسیر فایل ذخیره‌شده را چاپ می‌کند. در حالت بازپخش چیزی چاپ نمی‌شود زیرا فایلی ذخیره نمی‌گردد. .TP .B toggle-pause مکث/ادامه ضبط (برای پخش زنده/بازپخش کاربرد ندارد). .TP .BR set-paused " true|false" مکث/ادامه ضبط (برای پخش زنده/بازپخش کاربرد ندارد). بر خلاف .B toggle-pause این دستور در حالتی که ضبط از قبل متوقف یا در حال اجرا باشد با خطا مواجه نمی‌شود، بنابراین نتیجه به وضعیت جاری وابسته نیست. .TP .B toggle-replay-recording شروع/توقف ضبط معمولی حین بازپخش/پخش زنده، که نیازمند اجرای GPU Screen Recorder با گزینه .B \-ro است. .TP .B start-replay-recording شروع ضبط معمولی حین بازپخش/پخش زنده، که نیازمند اجرای GPU Screen Recorder با گزینه .B \-ro است. اگر ضبط از قبل در حال اجرا باشد، هیچ عملی انجام نمی‌دهد. .TP .B stop-replay-recording توقف ضبط معمولی که حین بازپخش/پخش زنده در حال اجراست. تا زمان ذخیره کامل فایل ضبط‌شده منتظر می‌ماند و مسیر فایل ذخیره‌شده را چاپ می‌کند. اگر هیچ ضبطی در حال اجرا نباشد، با خطا متوقف می‌شود. .TP .BR save-replay " [" \fIseconds\fR "] [" restart-replay=true|false ] ذخیره بازپخش (فقط در حالت بازپخش). تعداد ثانیه‌ها باید بزرگ‌تر از ۰ باشد. اگر هیچ ثانیه‌ای مشخص نشود، کل بافر بازپخش ذخیره می‌شود. تا زمان ذخیره کامل بازپخش منتظر می‌ماند و مسیر فایل ذخیره‌شده را چاپ می‌کند. گزینه .B restart-replay گزینه .B \-restart\-replay\-on\-save برنامه GPU Screen Recorder را برای این ذخیره‌سازی لغو می‌کند، که باعث می‌شود بافر بازپخش پس از ذخیره کامل کل آن پاکسازی شود. .SH "مثال‌ها (EXAMPLES)" راه‌اندازی GPU Screen Recorder در حالت بازپخش با یک سوکت ipc: .RS .nf gpu-screen-recorder -w screen -f 60 -c mp4 -r 60 -o ~/Videos -ipc "$XDG_RUNTIME_DIR/gsr.sock" & .fi .RE .PP ذخیره ۳۰ ثانیه گذشته: .RS .nf gsr-cli -ipc "$XDG_RUNTIME_DIR/gsr.sock" save-replay 30 .fi .RE .PP ذخیره کل بافر بازپخش و پاکسازی آن: .RS .nf gsr-cli -ipc "$XDG_RUNTIME_DIR/gsr.sock" save-replay restart-replay=true .fi .RE .PP شروع بازپخش تنها زمانی که از قبل در حال اجرا نیست: .RS .nf gsr-cli -ipc "$XDG_RUNTIME_DIR/gsr.sock" status >/dev/null || start-replay.sh .fi .RE .SH "نکات (NOTES)" .IP \(bu 3 سوکت تنها توسط کاربری که GPU Screen Recorder را راه‌اندازی کرده قابل استفاده است. .IP \(bu 3 دستورات .BR stop "، " save-replay " و " stop-replay-recording زمانی پاسخ داده می‌شوند که فایل ذخیره شده و اسکریپت داده‌شده با گزینه .B \-sc اجرا شده باشد، و پاسخ شامل مسیر فایل ذخیره‌شده است. سایر دستورات به محض پذیرش توسط GPU Screen Recorder پاسخ داده می‌شوند. .IP \(bu 3 برنامه GPU Screen Recorder سوکت را قبل از اتمام کامل راه‌اندازی خود ایجاد می‌کند، بنابراین دستوری که در زمان راه‌اندازی ارسال شود، با شروع ضبط پاسخ داده خواهد شد. .SH "نویسندگان (AUTHORS)" ابزار gsr\-cli توسط مشارکت‌کنندگان GPU Screen Recorder نوشته شده است. .SH "گزارش باگ‌ها (REPORTING BUGS)" گزارش اشکالات به: .UR mailto:dec05eba@protonmail.com dec05eba@protonmail.com .UE . .SH "حق نشر (COPYRIGHT)" حق نشر © dec05eba. تحت مجوز GPL-3.0-only. .SH "همچنین ببینید (SEE ALSO)" .BR gpu\-screen\-recorder (1) .PP وبگاه پروژه: