.TH GPU-SCREEN-RECORDER 1 "2026-08-18" "6.0.1" "GPU Screen Recorder Manual"
.SH "نام (NAME)"
gpu-screen-recorder \- سریع‌ترین ابزار ضبط صفحه نمایش برای لینوکس
.SH "خلاصه دستور (SYNOPSIS)"
.B gpu-screen-recorder
.B \-w
.I window_id|monitor|focused|portal|region|v4l2_device_path
.RI [ گزینه‌ها ]
.B \-o
.I output_file
.PP
.B gpu-screen-recorder
.B \-\-help
|
.B \-\-version
|
.B \-\-info
|
.B \-\-list\-capture\-options
|
.B \-\-list\-monitors
|
.B \-\-list\-v4l2\-devices
|
.B \-\-list\-audio\-devices
|
.B \-\-list\-application\-audio
.SH "توضیحات (DESCRIPTION)"
.B gpu-screen-recorder
سریع‌ترین ابزار ضبط صفحه نمایش برای لینوکس است. این برنامه منحصراً از پردازنده گرافیکی (GPU) برای ضبط صفحه استفاده می‌کند تا تأثیر منفی بر کارایی و عملکرد سیستم را به حداقل برساند. این ابزار از ضبط ویدیو، پخش زنده (استریمینگ)، بازپخش آنی (مشابه قابلیت ShadowPlay در NVIDIA) و ثبت اسکرین‌شات پشتیبانی می‌کند. این برنامه در هر دو محیط X11 و Wayland با کارت‌های گرافیک AMD، Intel و NVIDIA کار می‌کند.
.PP
ویژگی‌های کلیدی شامل موارد زیر است:
.RS
.IP \(bu 3
کدگذاری با شتاب‌دهنده سخت‌افزاری GPU با استفاده از کدک‌های H264، HEVC، AV1، VP8 یا VP9
.IP \(bu 3
پشتیبانی از ضبط HDR (شامل HEVC HDR و AV1 HDR)
.IP \(bu 3
بافر بازپخش آنی (ضبط N ثانیه گذشته)
.IP \(bu 3
قابلیت‌های پخش زنده (استریمینگ)
.IP \(bu 3
ضبط صدا از دستگاه‌ها و برنامه‌ها (برای صدای برنامه‌ها به PipeWire نیاز است)
.IP \(bu 3
سیستم افزونه برای روکش گرافیکی سفارشی (Overlay)
.IP \(bu 3
حداقل افت کارایی در مقایسه با ابزارهای سنتی ضبط صفحه نمایش
.RE
.SH "گزینه‌ها (OPTIONS)"
.SS "گزینه‌های تصویربرداری (Capture Options)"
.TP
.BI \-w " window_id|monitor|focused|portal|region|v4l2_device_path"
مشخص کردن موردی که باید ضبط شود.
قالب‌ها:
.RS
.IP \(bu 3
.B window
\- ضبط یک پنجره خاص (با استفاده از شناسه پنجره) (فقط در X11)
.IP \(bu 3
.B screen
\- ضبط اولین مانیتور یافت‌شده
.IP \(bu 3
.B screen\-direct
\- فقط برای NVIDIA X11، جهت پشتیبانی از VRR/G-SYNC (به دلیل مشکلات درایور توصیه نمی‌شود)
.IP \(bu 3
.B focused
\- ضبط پنجره‌ای که اکنون فوکوس روی آن است (فقط در X11) (همراه با گزینه
.B \-s
استفاده شود)
.IP \(bu 3
.B portal
\- استفاده از xdg-desktop-portal با PipeWire (فقط در Wayland)
.IP \(bu 3
.B region
\- ضبط یک ناحیه مشخص (همراه با گزینه
.B \-region
استفاده شود)
.IP \(bu 3
نام مانیتور (مانند
.BR DP\-1 )
\- ضبط مانیتور مشخص‌شده
.IP \(bu 3
مسیر دستگاه V4L2 (مانند
.BR /dev/video0 )
\- ضبط از دستگاه دوربین (V4L2).

زمانی که GPU Screen Recorder در حال استفاده از دوربین است، برنامه‌های دیگر نمی‌توانند از دوربین استفاده کنند و در صورتی که برنامه دیگری در حال حاضر از دوربین استفاده کند، ممکن است GPU Screen Recorder نتواند به آن دسترسی داشته باشد.
.IP \(bu 3
ترکیب منابع با | (مانند
.BR "monitor:screen|v4l2:/dev/video0" )
.RE
.PP
برای مشاهده فهرست منابع تصویربرداری موجود، دستور زیر را اجرا کنید:
.B \-\-list\-capture\-options
.PP
با جدا کردن منبع تصویربرداری با کاراکتر
.B ;
می‌توان گزینه‌های اضافی را به هر منبع ارسال کرد؛ به عنوان مثال:
.BR "screen;x=50;y=50" .
.br
این گزینه‌ها برای تمام منابع تصویربرداری در دسترس هستند (اختیاری):
.RS
.IP \(bu 3
.B x
\- موقعیت افقی (X) بر حسب پیکسل. اگر عدد با % خاتمه یابد، موقعیت X را نسبت به عرض ویدیو تنظیم می‌کند (درصد عدد صحیح که 100 = 100% است)
.IP \(bu 3
.B y
\- موقعیت عمودی (Y) بر حسب پیکسل. اگر عدد با % خاتمه یابد، موقعیت Y را نسبت به ارتفاع ویدیو تنظیم می‌کند (درصد عدد صحیح که 100 = 100% است)
.IP \(bu 3
.B width
\- عرض بر حسب پیکسل. اگر عدد با % خاتمه یابد، عرض را نسبت به عرض ویدیو تنظیم می‌کند (درصد عدد صحیح که 100 = 100% است).

مقدار 0 به این معنی است که منبع تصویربرداری مقیاس‌بندی نشود و در عوض از عرض اصلی استفاده شود.
.IP \(bu 3
.B height
\- ارتفاع بر حسب پیکسل. اگر عدد با % خاتمه یابد، ارتفاع را نسبت به ارتفاع ویدیو تنظیم می‌کند (درصد عدد صحیح که 100 = 100% است).

مقدار 0 به این معنی است که منبع تصویربرداری مقیاس‌بندی نشود و در عوض از ارتفاع اصلی استفاده شود.
.IP \(bu 3
.B halign
\- تراز افقی، باید یکی از مقادیر
.BR start ،
.B center
یا
.B end
باشد.

در صورت استفاده از یک منبع تصویربرداری، به‌طور پیش‌فرض برابر با
.B center
است؛ در غیر این صورت به‌طور پیش‌فرض روی
.B start
تنظیم می‌شود.
.IP \(bu 3
.B valign
\- تراز عمودی، باید یکی از مقادیر
.BR start ،
.B center
یا
.B end
باشد.

در صورت استفاده از یک منبع تصویربرداری، به‌طور پیش‌فرض برابر با
.B center
است؛ در غیر این صورت به‌طور پیش‌فرض روی
.B start
تنظیم می‌شود.
.IP \(bu 3
.B hflip
\- تعیین اینکه آیا منبع باید به‌صورت افقی معکوس (آینه‌ای) شود یا خیر؛ باید
.B true
یا
.B false
باشد. به‌طور پیش‌فرض روی
.B false
تنظیم است.
.IP \(bu 3
.B vflip
\- تعیین اینکه آیا منبع باید به‌صورت عمودی معکوس شود یا خیر؛ باید
.B true
یا
.B false
باشد. به‌طور پیش‌فرض روی
.B false
تنظیم است.
.RE
.PP
گزینه‌های اضافی موجود برای منابع دوربین (V4L2) (اختیاری):
.RS
.IP \(bu 3
.B pixfmt
\- فرمت پیکسل، باید یکی از مقادیر
.BR auto ،
.B yuyv
یا
.B mjpeg
باشد. به‌طور پیش‌فرض روی
.B auto
تنظیم است.
.IP \(bu 3
.B camera_fps
\- نرخ فریم (fps) دوربین. باید با نرخ فریم دوربین برگردانده‌شده در
.B \-\-info
یا
.B \-\-list\-v4l2\-devices
برای آن دستگاه مطابقت داشته باشد.

مقدار 0 به معنای استفاده از بهترین گزینه موجود است.
.IP \(bu 3
.B camera_width
\- عرض دوربین بر حسب پیکسل. باید با عرض دوربین برگردانده‌شده در
.B \-\-info
یا
.B \-\-list\-v4l2\-devices
برای آن دستگاه مطابقت داشته باشد.

مقدار 0 به معنای استفاده از بهترین گزینه موجود است.
.IP \(bu 3
.B camera_height
\- ارتفاع دوربین بر حسب پیکسل. باید با ارتفاع دوربین برگردانده‌شده در
.B \-\-info
یا
.B \-\-list\-v4l2\-devices
برای آن دستگاه مطابقت داشته باشد.

مقدار 0 به معنای استفاده از بهترین گزینه موجود است.
.RE
.TP
.BI \-region " WxH+X+Y"
مشخص کردن ناحیه برای ضبط هنگام استفاده از
.BR \-w " region" .
قالب به صورت عرض x ارتفاع + آفست X + آفست Y است. برای ضبط کل مانیتوری که این موقعیت را در بر دارد، عرض و ارتفاع را روی 0 قرار دهید.

این گزینه با ابزارهایی مانند slop (در X11) و slurp (در Wayland) سازگار است.
.TP
.BI \-c " container_format"
فرمت کانتینر (mp4، mkv، flv، webm). مقدار پیش‌فرض از پسوند نام فایل در
.B \-o
تعیین می‌شود.
.TP
.BI \-s " WxH"
محدودیت وضوح خروجی (مانند 1920x1080). محتوای ضبط‌شده برای جا گرفتن در این وضوح با حفظ نسبت تصویر مقیاس‌بندی می‌شود و ابعاد ویدیو برای تناسب با محتوای مقیاس‌شده کاهش می‌یابد.
برای وضوح اصلی از 0x0 استفاده کنید.
برای
.BR \-w " focused"
الزامی است (که در آن وضوح ویدیو دقیقاً برابر با همین مقدار خواهد بود).
.TP
.BI \-f " fps"
نرخ فریم (پیش‌فرض: 60). در حالت نرخ فریم متغیر، این مقدار حداکثر FPS است.
.TP
.BI \-cursor " yes|no"
ضبط نشانگر ماوس (پیش‌فرض: yes).
.TP
.BI \-restore\-portal\-session " yes|no"
بازیابی نشست قبلی پرتال (همراه با گزینه \-w portal استفاده می‌شود، پیش‌فرض: no).
.SS "گزینه‌های صوتی (Audio Options)"
.TP
.BI \-a " audio_source"
دستگاه صوتی یا برنامه‌ای که صدای آن ضبط می‌شود. می‌تواند چندین بار مشخص شود.
قالب‌ها:
.RS
.IP \(bu 3
.B default_output
\- دستگاه خروجی پیش‌فرض
.IP \(bu 3
.B default_input
\- دستگاه ورودی پیش‌فرض
.IP \(bu 3
.B device:name
\- دستگاه مشخص
.IP \(bu 3
.B app:name
\- صدای برنامه (بدون حساسیت به بزرگی و کوچکی حروف)
.IP \(bu 3
.B app\-inverse:name
\- تمام برنامه‌ها به جز برنامه مشخص‌شده
.IP \(bu 3
ترکیب منابع با | (مانند
.BR "default_output|app:firefox" )
.RE
.PP
برای مشاهده فهرست دستگاه‌های صوتی موجود، دستور زیر را اجرا کنید:
.B \-\-list\-audio\-devices
.br
برای مشاهده فهرست برنامه‌های موجود جهت ضبط صدا، دستور زیر را اجرا کنید:
.B \-\-list\-application\-audio
.TP
.BI \-ac " aac|opus|flac"
کدک صوتی (پیش‌فرض: opus برای mp4/mkv، در غیر این صورت aac). کدک FLAC موقتاً غیرفعال است.
.TP
.BI \-ab " bitrate"
بیت‌ریت صدا بر حسب kbps (پیش‌فرض: 128 برای opus/flac، و 160 برای aac). مقدار 0 = خودکار.
.SS "گزینه‌های کیفیت ویدیو (Video Quality Options)"
.TP
.BI \-k " codec"
کدک ویدیو:
.BR auto ", " h264 ", " hevc ", " av1 ", " vp8 ", " vp9 ", " hevc_hdr ", " av1_hdr ", " hevc_10bit ", " av1_10bit ", " h264_vulkan ", " hevc_vulkan ", " hevc_10bit_vulkan ", " av1_vulkan ", " av1_hdr_vulkan ", " av1_10bit_vulkan

گزینه‌های HDR در X11 یا ضبط از پرتال در دسترس نیستند. ضبط ۱۰ بیتی پدیده نواربندی رنگ (Banding) را کاهش می‌دهد، اما ممکن است به درستی توسط تمام پخش‌کننده‌های ویدیو پشتیبانی نشود.
.br
گزینه‌های کدک Vulkan آزمایشی هستند و ممکن است به دلیل مشکلات درایور GPU در سیستم شما به درستی کار نکنند.
.br
استفاده از کدک‌های Vulkan ممکن است در درایورهای قدیمی‌تر NVIDIA به عملکرد بهتر در بازی‌ها منجر شود، زیرا رمزگذاری ویدیویی Vulkan از مشکلی به نام "cuda p2 state" رنج نمی‌برد
.br
که در آن هنگام استفاده از nvenc (کدک‌های ویدیویی معمول در NVIDIA)، فرکانس کاری GPU کاهش می‌یابد.

(پیش‌فرض: auto ← h264).
.TP
.BI \-q " quality"
پریست کیفیت (medium، high، very_high، ultra) برای حالت QP/VBR، یا بیت‌ریت (kbps) برای حالت CBR (پیش‌فرض: very_high).
.TP
.BI \-bm " auto|qp|vbr|cbr"
حالت بیت‌ریت (پیش‌فرض: auto ← qp). حالت CBR برای بافر بازپخش و پخش زنده توصیه می‌شود.

حالت QP به معنای ضبط با کیفیت ثابت حتی در صحنه‌های پرتحرک است، در حالی که VBR و CBR به معنای ضبط با حجم ثابت هستند.
.TP
.BI \-fm " cfr|vfr|content"
حالت نرخ فریم: cfr (ثابت)، vfr (متغیر)، یا content (منطبق بر محتوا) (پیش‌فرض: vfr). حالت content فقط در X11 یا ضبط پرتال در دسترس است.

حالت content (با \-fm content) ویدیو را با محتوای در حال ضبط همگام می‌کند و برای دستیابی به روان‌ترین ویدیو در حالتی که بازی با نرخ فریم برابر یا کمتر از نرخ فریم هدف اجرا می‌شود، توصیه می‌شود.

حالت نرخ فریم ثابت (با \-fm cfr) تضمین می‌کند که نرخ فریم ویدیو در سرتاسر فایل همان‌طور که با گزینه \-f تنظیم شده ثابت بماند. این حالت ممکن است برای برخی از نرم‌افزارهای ویرایش ویدیو مورد نیاز باشد.
.br
این گزینه توصیه نمی‌شود؛ زیرا برای مثال اگر قصد ضبط با نرخ ۶۰ فریم بر ثانیه را داشته باشید و بازی سنگینی انجام دهید که با کمتر از ۶۰ فریم بر ثانیه اجرا می‌شود، ضبط نیز ممکن است با همان نرخ فریم پایین تصویربرداری کند،
.br
که انکودر را دچار اضافه بار کرده و ممکن است در نهایت ضبط با نرخ ۱ تا ۲ فریم بر ثانیه انجام شود و توانایی بازیابی نداشته باشد.
.br
در این شرایط، سعی کنید در حالت نرخ فریم متغیر (با \-fm vfr) در قالب فایل mkv ضبط کنید، زیرا نرم‌افزار Kdenlive از ویدیوهای با نرخ فریم متغیر در صورت قرار داشتن در کانتینر mkv پشتیبانی می‌کند.
.TP
.BI \-cr " limited|full"
دامنه رنگ (پیش‌فرض: limited). دامنه کامل (full) ممکن است در برخی پخش‌کننده‌های ویدیو یا وب‌سایت‌ها مشکل ایجاد کند.
.TP
.BI \-tune " performance|quality"
تنظیم بهینه‌سازی رمزگذاری (پیش‌فرض: performance). در حال حاضر فقط برای NVIDIA.
.TP
.BI \-keyint " seconds"
فاصله فریم‌های کلیدی (Keyframe) بر حسب ثانیه (پیش‌فرض: 2.0). بر دقت پرش زمانی در ویدیو تأثیر می‌گذارد.
.TP
.BI \-encoder " gpu|cpu"
دستگاه رمزگذاری (پیش‌فرض: gpu). رمزگذاری با CPU فقط برای H264 است.
.TP
.BI \-fallback\-cpu\-encoding " yes|no"
بازگشت به رمزگذاری CPU در صورت در دسترس نبودن شتاب‌دهنده سخت‌افزاری GPU (پیش‌فرض: no).
.SS "گزینه‌های بافر بازپخش (Replay Buffer Options)"
.TP
.BI \-r " seconds"
مدت زمان بافر بازپخش (۲ تا ۸۶۴۰۰ ثانیه). هنگام تنظیم، ویدیو تنها با دستور کاربر ذخیره می‌شود.
.TP
.BI \-replay\-storage " ram|disk"
محل ذخیره‌سازی بافر (پیش‌فرض: ram). حالت دیسک ممکن است طول عمر حافظه SSD را کاهش دهد.
.TP
.BI \-restart\-replay\-on\-save " yes|no"
پاک کردن بافر پس از ذخیره بازپخش (پیش‌فرض: no).
.TP
.BI \-df " yes|no"
سازماندهی بازپخش‌ها در پوشه‌های مبتنی بر تاریخ (پیش‌فرض: no).
.SS "گزینه‌های پیشرفته (Advanced Options)"
.TP
.BI \-p " plugin.so"
بارگذاری افزونه (فایل .so). می‌تواند چندین بار مشخص شود.
.TP
.BI \-sc " script_path"
اسکریپتی که پس از ذخیره ویدیو اجرا می‌شود. مسیر فایل و نوع آن ("regular"، "replay"، "screenshot") را دریافت می‌کند.
.TP
.BI \-portal\-session\-token\-filepath " path"
فایل توکن نشست پرتال (پیش‌فرض: ~/.config/gpu-screen-recorder/restore_token).
.TP
.BI \-ffmpeg-opts " options"
آرگومان‌های اضافی برای ارسال به FFmpeg برای فایل به صورت فهرستی از جفت‌های کلید-مقدار در قالب "key=value;key=value"،
.br
برای مثال: \-ffmpeg-opts "hls_list_size=3;hls_time=1;hls_flags=delete_segments".
.br
نکته: این تنظیمات گزینه‌های هم‌نام تعیین‌شده توسط GPU Screen Recorder را بازنویسی می‌کنند.
.TP
.BI \-ffmpeg-video-opts " options"
آرگومان‌های اضافی برای ارسال به FFmpeg برای ویدیو به صورت فهرستی از جفت‌های کلید-مقدار در قالب "key=value;key=value"،
.br
برای مثال: \-ffmpeg-video-opts "codec=cabac;rc_mode=CQP;qp=16".
.br
نکته: این تنظیمات گزینه‌های هم‌نام تعیین‌شده توسط GPU Screen Recorder را بازنویسی می‌کنند.
.TP
.BI \-ffmpeg-audio-opts " options"
آرگومان‌های اضافی برای ارسال به FFmpeg برای صدا به صورت فهرستی از جفت‌های کلید-مقدار در قالب "key=value;key=value"،
.br
برای مثال: \-ffmpeg-audio-opts "aac_coder=fast;aac_pce=true".
.br
نکته: این تنظیمات گزینه‌های هم‌نام تعیین‌شده توسط GPU Screen Recorder را بازنویسی می‌کنند.
.TP
.BI \-auth " token"
توکن حامل (Bearer) اختیاری جهت احراز هویت هنگام پخش زنده، برای مثال هنگام استفاده از پروتکل whip (گزینه \-c whip).
.br
برای سرورهایی با احراز هویت نام کاربری/رمز عبور، توکن می‌تواند به صورت "username:password" تنظیم شود. استریم با پروتکل Whip نیازمند نسخه ۸.۰ یا بالاتر FFmpeg است.
.br
همچنین می‌توان توکن را در متغیر محیطی GSR_AUTH قرار داد تا در خط فرمان فرآیند نمایش داده نشود. گزینه \-auth بر متغیر محیطی اولویت دارد.
.br
هنگام استریم با whip، گزینه ماکسر ts_buffer_size به طور پیش‌فرض روی 4194304 تنظیم است. این مقدار را می‌توان با \-ffmpeg-opts "ts_buffer_size=<value>" بازنویسی کرد.
.br
هسته سیستم‌عامل (کرنل) اندازه بافر را بر اساس متغیر sysctl مربوط به net.core.wmem_max محدود می‌کند (که معمولاً فقط حدود ۲۰۸ کیلوبایت است). اگر استریم whip با خطای "UDP send blocked" متوقف شد، این مقدار را افزایش دهید؛ برای مثال: sysctl \-w net.core.wmem_max=8388608
.TP
.BI \-gl\-debug " yes|no"
خروجی خطایابی (دیباگ) OpenGL (پیش‌فرض: no).
.TP
.BI \-v " yes|no"
چاپ اطلاعات FPS و آسیب دیدگی تصویر (damage info) (پیش‌فرض: yes).
.TP
.BI \-low-power " yes|no"
اجرا در حالت کم‌مصرف. این گزینه در حال حاضر تنها بر کارت‌های AMD تأثیر دارد (چون این مسئله فقط در AMD وجود دارد) و به GPU اجازه می‌دهد هنگام ضبط به حالت مصرف توان کمتر برود (پیش‌فرض: no).
.br
تنظیم این گزینه روی
.B yes
ممکن است همیشه به دلیل مشکلات درایور AMD ایده‌آل نباشد؛ جایی که پس از پخش یک ویدیو با VAAPI در سیستم، عملکرد رمزگذاری ویدیو نیز کاهش می‌یابد که بر GPU Screen Recorder اثر منفی می‌گذارد.
.br
توصیه می‌شود هنگام فعال بودن این گزینه، از گزینه
.B \-fm content
نیز استفاده کنید تا فریم‌ها تنها زمانی که محتوای صفحه به‌روز می‌شود رمزگذاری شوند و در زمان بیکاری سیستم، مصرف پردازنده گرافیکی و انکودر ویدیو کاهش یابد.
.TP
.BI \-exclude-metadata " yes|no"
حذف فراداده‌های (متادیتا) شخصی از فایل ویدیو، مانند عنوان ترک صوتی که به طور پیش‌فرض از نام دستگاه صوتی تشکیل شده است (پیش‌فرض: no).
.TP
.BI \-write\-first\-frame\-ts " yes|no"
در صورت فعال بودن، یک فایل برچسب زمانی (Timestamp) با پسوند اضافی \fI.ts\fR در کنار ویدیوی خروجی ایجاد می‌کند که شامل موارد زیر است:
.nf
monotonic_microsec	realtime_microsec
<monotonic_microsec>	<realtime_microsec>
.fi
(پیش‌فرض: no). برای پخش زنده و زمانی که خروجی پایپ می‌شود نادیده گرفته می‌شود.
.TP
.BI \-ipc " socket_path"
شنود دستورات روی یک سوکت یونیکس در مسیر
.I socket_path
به جای پذیرش صرف سیگنال‌ها. سوکت با شروع به کار GPU Screen Recorder ایجاد و هنگام خروج برنامه حذف می‌شود.
برای مشاهده پروتکل به بخش
.B IPC
مراجعه کنید. هنگام ثبت اسکرین‌شات تأثیری ندارد.
.SS "گزینه‌های خروجی (Output Options)"
.TP
.BI \-o " output"
مسیر فایل خروجی (یا پوشه در حالت بازپخش). به جز در حالت خروجی به stdout الزامی است.
.TP
.BI \-ro " directory"
پوشه خروجی برای ضبط‌های معمولی در حین حالت بازپخش/استریم.
.SS "دستورات اطلاعاتی (Information Commands)"
.TP
.B \-\-help
نمایش پیام راهنما.
.TP
.B \-\-version
نمایش نسخه (5.10.2).
.TP
.B \-\-info
نمایش اطلاعات سیستم (کدک‌ها، گزینه‌های تصویربرداری).
.TP
.B \-\-list\-capture\-options
فهرست کردن منابع تصویربرداری موجود (پنجره، مانیتورها، پرتال، مسیر دستگاه v4l2).
.TP
.B \-\-list\-monitors
فهرست کردن مانیتورهای موجود.
.TP
.B \-\-list\-v4l2\-devices
فهرست کردن دستگاه‌های دوربین موجود (V4L2).
.TP
.B \-\-list\-audio\-devices
فهرست کردن دستگاه‌های صوتی موجود.
.TP
.B \-\-list\-application\-audio
فهرست کردن برنامه‌های موجود برای ضبط صدا.
.SH "سیگنال‌ها (SIGNALS)"
برنامه GPU Screen Recorder را می‌توان از طریق سیگنال‌ها کنترل کرد:
.TP
.B SIGINT (Ctrl+C)
توقف و ذخیره ضبط (توقف بدون ذخیره در حالت بازپخش).
.TP
.B SIGUSR1
ذخیره بازپخش (فقط در حالت بازپخش).
.TP
.B SIGUSR2
مکث/ادامه ضبط (برای استریم/بازپخش کاربرد ندارد).
.TP
.B SIGRTMIN
شروع/توقف ضبط معمولی در حین بازپخش/استریم.
.TP
.B SIGRTMIN+1
ذخیره ۱۰ ثانیه گذشته (حالت بازپخش).
.TP
.B SIGRTMIN+2
ذخیره ۳۰ ثانیه گذشته (حالت بازپخش).
.TP
.B SIGRTMIN+3
ذخیره ۶۰ ثانیه گذشته (حالت بازپخش).
.TP
.B SIGRTMIN+4
ذخیره ۵ دقیقه گذشته (حالت بازپخش).
.TP
.B SIGRTMIN+5
ذخیره ۱۰ دقیقه گذشته (حالت بازپخش).
.TP
.B SIGRTMIN+6
ذخیره ۳۰ دقیقه گذشته (حالت بازپخش).
.PP
برای ارسال سیگنال‌ها از
.B pkill
استفاده کنید (مانند
.BR "pkill -SIGUSR1 -f ""^gpu-screen-recorder""" ).
.SH "ارتباط بین‌فرآیندی (IPC)"
هنگامی که گزینه
.B \-ipc
استفاده می‌شود، GPU Screen Recorder همچنین روی یک سوکت دامنه یونیکس به دستورات گوش می‌دهد. این قابلیت همان امکانات کنترلی سیگنال‌ها را فراهم می‌کند، با این تفاوت که بازپخش را می‌توان با هر تعداد ثانیه دلخواه ذخیره کرد. این سوکت تنها توسط کاربری که GPU Screen Recorder را اجرا کرده قابل استفاده است و با خروج برنامه حذف می‌شود.
.PP
دستور
.BR gsr\-cli (1)
برنامه‌ای است که این دستورات را ارسال کرده و پاسخ را گزارش می‌دهد؛ بنابراین پروتکل زیر تنها توسط برنامه‌هایی نیاز به پیاده‌سازی دارد که قصد ارتباط مستقیم با سوکت را دارند.
.PP
درخواست‌ها و پاسخ‌ها اشیاء JSON هستند که با خط جدید (newline) خاتمه می‌یابند. به هر درخواست یک پاسخ داده می‌شود.
یک درخواست دارای این فیلدها است:
.TP
.B id
عددی که شناسه درخواست است. پاسخ مربوط به این درخواست دارای همین id خواهد بود.
.TP
.B name
رشته‌ای حاوی نام درخواست.
.TP
.B data
اختیاری است؛ نوع آن به نوع درخواست بستگی دارد.
.PP
یک پاسخ دارای این فیلدها است:
.TP
.B id
شناسه درخواستی که این پیام پاسخ آن است، یا 0 در صورتی که درخواست شناسه معتبری نداشته باشد.
.TP
.B result
یکی از دو مقدار
.B ok
یا
.BR error .
.TP
.B data
اختیاری است. برای نتیجه
.B error
یک رشته شامل شرح خطا است. برای نتیجه
.B ok
در دستورات
.BR stop "، " save-replay " یا " stop-replay-recording
یک رشته حاوی مسیر فایل ذخیره‌شده است.
.PP
درخواست‌های
.BR stop "، " save-replay " و " stop-replay-recording
یک فایل را ذخیره می‌کنند و پاسخ آن‌ها زمانی ارسال می‌شود که فایل ذخیره شده و اسکریپت تعیین‌شده با گزینه
.B \-sc
اجرا شده باشد. سایر درخواست‌ها به محض پذیرفته شدن پاسخ داده می‌شوند.
.PP
درخواست‌های زیر در دسترس هستند:
.TP
.B stop
توقف و ذخیره ضبط (توقف بدون ذخیره در حالت بازپخش). پاسخ شامل مسیر فایل ذخیره‌شده است، مگر در حالت بازپخش که فایلی ذخیره نمی‌شود.
.TP
.B save-replay
ذخیره بازپخش (فقط در حالت بازپخش).
فیلد
.B data
یک شیء با این فیلدهای اختیاری است:
.RS
.TP
.B seconds
تعداد ثانیه‌ها برای ذخیره، که باید بزرگتر از 0 باشد.
.TP
.B restart-replay
مقدار true/false، که گزینه
.B \-restart\-replay\-on\-save
را برای این ذخیره‌سازی بازنویسی می‌کند. همانند آن گزینه، بافر بازپخش تنها زمانی پاک می‌شود که کل بافر بازپخش ذخیره گردد.
.RE
.IP
زمانی که
.B data
یا
.B seconds
مشخص نشود یا null باشد، کل بافر بازپخش ذخیره می‌شود. پاسخ حاوی مسیر فایل ذخیره‌شده است.
.TP
.B toggle-pause
مکث/ادامه ضبط (برای استریم/بازپخش کاربرد ندارد).
.TP
.B set-paused
مکث/ادامه ضبط (برای استریم/بازپخش کاربرد ندارد).
فیلد
.B data
باید برای مکث true و برای ادامه false باشد. برخلاف
.B toggle-pause
اگر ضبط از قبل در حالت مکث/ادامه باشد، این دستور با خطا مواجه نمی‌شود.
.TP
.B toggle-replay-recording
شروع/توقف ضبط معمولی در حین بازپخش/استریم، که نیازمند گزینه
.B \-ro
است.
.TP
.B start-replay-recording
شروع ضبط معمولی در حین بازپخش/استریم، که نیازمند گزینه
.B \-ro
است. اگر ضبطی از قبل در حال اجرا باشد، کاری انجام نمی‌دهد.
.TP
.B stop-replay-recording
توقف ضبط معمولی در حال اجرا در حین بازپخش/استریم. اگر ضبطی در حال اجرا نباشد، با خطا مواجه می‌شود. پاسخ شامل مسیر فایل ذخیره‌شده است.
.PP
مثال:
.nf
.RS
gpu-screen-recorder -w screen -f 60 -c mp4 -r 60 -o ~/Videos -ipc "$XDG_RUNTIME_DIR/gsr.sock" &
echo '{"id":1,"name":"save-replay","data":{"seconds":30}}' | socat - "UNIX-CONNECT:$XDG_RUNTIME_DIR/gsr.sock"
.RE
.fi
پس از ذخیره بازپخش، پاسخی مانند زیر بازگردانده می‌شود:
.nf
.RS
{"id":1,"result":"ok","data":"/home/user/Videos/Replay_2026-08-05_14-04-22.mp4"}
.RE
.fi
.SH "مثال‌ها (EXAMPLES)"
.B ضبط مانیتور با نرخ ۶۰ فریم بر ثانیه به همراه صدای دسکتاپ:
.nf
.RS
gpu-screen-recorder -w screen -f 60 -a default_output -o video.mp4
.RE
.fi
.PP
.B ضبط مانیتور با نرخ ۶۰ فریم بر ثانیه به همراه صدای دسکتاپ و میکروفون:
.nf
.RS
gpu-screen-recorder -w screen -f 60 -a "default_output|default_input" -o video.mp4
.RE
.fi
.PP
.B ضبط پنجره مشخص (فقط در X11):
.nf
.RS
gpu-screen-recorder -w $(xdotool selectwindow) -f 60 -o video.mp4
.RE
.fi
.PP
.B بازپخش آنی (۶۰ ثانیه گذشته):
.nf
.RS
gpu-screen-recorder -w screen -c mp4 -r 60 -o ~/Videos
.RE
.fi
.PP
.B بازپخش آنی با نرخ فریم ثابت (توصیه‌شده برای مصرف حافظه رم پیش‌بینی‌پذیر):
.nf
.RS
gpu-screen-recorder -w screen -c mp4 -r 60 -bm cbr -q 40000 -o ~/Videos
.RE
.fi
.PP
.B ضبط ناحیه با استفاده از slop:
.nf
.RS
gpu-screen-recorder -w $(slop) -o video.mp4
.RE
.fi
.PP
.B ضبط ناحیه با استفاده از slurp:
.nf
.RS
gpu-screen-recorder -w $(slurp -f "%wx%h+%x+%y") -o video.mp4
.RE
.fi
.PP
.B بازپخش آنی و اجرای یک اسکریپت هنگام ذخیره بازپخش:
.nf
.RS
gpu-screen-recorder -w screen -c mp4 -r 60 -sc ./script.sh -o ~/Videos
.RE
.fi
.PP
.B استریم در Twitch با حالت بیت‌ریت ثابت:
.nf
.RS
gpu-screen-recorder -w screen -c flv -a default_output -bm cbr -q 8000 -o "rtmp://live.twitch.tv/app/stream_key"
.RE
.fi
.PP
.B ثبت اسکرین‌شات:
.nf
.RS
gpu-screen-recorder -w screen -o screenshot.jpg
.RE
.fi
.PP
.B ضبط صفحه و دوربین:
.nf
.RS
gpu-screen-recorder -w "screen|/dev/video0" -o video.mp4
.RE
.fi
.PP
.B ضبط صفحه و دوربین (دوربین در پایین سمت راست قرار گرفته و افقی معکوس شده است):
.nf
.RS
gpu-screen-recorder -w "screen|/dev/video0;halign=end;valign=end;hflip=true;width=30%;height=30%" -o video.mp4
.RE
.fi
.PP
.B ضبط دو مانیتور در کنار هم (با فرض اینکه مانیتور اول وضوح 1920x1080 دارد):
.nf
.RS
gpu-screen-recorder -w "DP-1|DP-2;x=1920" -o video.mp4
.RE
.fi
.PP
.B استریم با پروتکل whip به همراه کلید احراز هویت:
.nf
.RS
gpu-screen-recorder -w screen -bm cbr -q 3500 -auth "streamtest" -c whip -o https://b.siobud.com/api/whip
.RE
.fi
.SH "فایل‌ها (FILES)"
.TP
.I ~/.config/gpu-screen-recorder/gpu-screen-recorder.env
متغیرهای محیطی برای سرویس systemd (اختیاری).
.TP
.I /usr/lib/modprobe.d/gsr-nvidia.conf
رفع مشکل تعلیق/ازسرگیری (Suspend/Resume) در NVIDIA.
.TP
.I ~/.config/gpu-screen-recorder/restore_token
محل ذخیره توکن نشست پرتال (مسیر پیش‌فرض).
.SH "نکات (TIPS)"
.IP \(bu 3
برخی نرم‌افزارهای ویرایش ویدیو از ویدیوها در حالت نرخ فریم متغیر پشتیبانی نمی‌کنند.

برای دور زدن این مشکل، کانتینر ویدیو را به .mkv تغییر دهید یا در حالت نرخ فریم ثابت ضبط کنید.
.IP \(bu 3
نرخ فریم متغیر ممکن است در برخی پخش‌کننده‌های ویدیو مشکل ایجاد کند (از MPV استفاده کنید).
.IP \(bu 3
فرمت H.265/HEVC در مرورگرها/دیسکورد پشتیبانی نمی‌شود (برای اشتراک‌گذاری از H264 استفاده کنید).
.IP \(bu 3
برخی توزیع‌ها کدک‌های سخت‌افزاری را غیرفعال می‌کنند (از نسخه Flatpak استفاده کنید).
.IP \(bu 3
برای بافر بازپخش از حالت CBR (با
.B \-bm cbr
) استفاده کنید تا مصرف حافظه RAM کنترل شود.
.SH "نکات عملکردی (PERFORMANCE TIPS)"
.IP \(bu 3
ویدیوها را روی SSD ذخیره کنید (حافظه HDD ممکن است بیش از حد کند باشد).
.IP \(bu 3
سایر برنامه‌های ضبط صفحه را ببندید (از جمله OBS در حالت بیکار).
.SH "مشکلات شناخته‌شده (KNOWN ISSUES)"
.IP \(bu 3
در NVIDIA: قابلیت CUDA پس از تعلیق (Suspend) از کار می‌افتد (وصله gsr-nvidia.conf را نصب کنید).
.IP \(bu 3
در AMD: احتمال ایجاد خطوط سیاه در ویدیوی خروجی با HEVC/AV1 (از H264 یا FFmpeg نسخه ۸ یا بالاتر استفاده کنید).
.SH "نویسندگان (AUTHORS)"
توسعه‌یافته توسط dec05eba و مشارکت‌کنندگان.
.SH "گزارش باگ‌ها (REPORTING BUGS)"
گزارش اشکالات به:
.UR mailto:dec05eba@protonmail.com
dec05eba@protonmail.com
.UE .
.br
مشاهده اطلاعات بیشتر درباره گزارش اشکالات در وب‌سایت gpu-screen-recorder: \fIhttps://git.dec05eba.com/?p=about\fR
.br
لطفاً پیش از گزارش باگ، بخش FAQ در فایل README را بررسی کنید: \fIhttps://git.dec05eba.com/gpu-screen-recorder/about\fR
.br
اشکال ممکن است قبلاً گزارش شده باشد یا به gpu-screen-recorder مرتبط نباشد (مانند مشکلات درایور).
.SH "حق نشر (COPYRIGHT)"
حق نشر © dec05eba. تحت مجوز GPL-3.0-only.
.SH "همچنین ببینید (SEE ALSO)"
.BR gsr\-cli (1)،
.BR gsr\-kms\-server (1)
.PP
.UR https://git.dec05eba.com/gpu-screen-recorder
صفحه اصلی پروژه
.UE
.br
.UR https://git.dec05eba.com/gpu-screen-recorder/about
فایل راهنمای پروژه (README) با اطلاعات بیشتر
.UE
.br
.UR https://git.dec05eba.com/gpu-screen-recorder-gtk
نسخه رابط گرافیکی GTK (منسوخ‌شده)
.UE
.br
.UR https://git.dec05eba.com/gpu-screen-recorder-ui
رابط کاربری به سبک ShadowPlay
.UE
.br
.BR xdotool (1)،
.BR slop (1)،
.BR slurp (1)