گزینه‌های تصویربرداری (Capture Options)

-w window_id|monitor|focused|portal|region|v4l2_device_path

مشخص کردن موردی که باید ضبط شود. قالب‌ها:

برای مشاهده فهرست منابع تصویربرداری موجود، دستور زیر را اجرا کنید: --list-capture-options

با جدا کردن منبع تصویربرداری با کاراکتر ; می‌توان گزینه‌های اضافی را به هر منبع ارسال کرد؛ به عنوان مثال: screen;x=50;y=50.
این گزینه‌ها برای تمام منابع تصویربرداری در دسترس هستند (اختیاری):

گزینه‌های اضافی موجود برای منابع دوربین (V4L2) (اختیاری):

-region WxH+X+Y

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

این گزینه با ابزارهایی مانند slop (در X11) و slurp (در Wayland) سازگار است.

-c container_format

فرمت کانتینر (mp4، mkv، flv، webm). مقدار پیش‌فرض از پسوند نام فایل در -o تعیین می‌شود.

-s WxH

محدودیت وضوح خروجی (مانند 1920x1080). محتوای ضبط‌شده برای جا گرفتن در این وضوح با حفظ نسبت تصویر مقیاس‌بندی می‌شود و ابعاد ویدیو برای تناسب با محتوای مقیاس‌شده کاهش می‌یابد. برای وضوح اصلی از 0x0 استفاده کنید. برای -w focused الزامی است (که در آن وضوح ویدیو دقیقاً برابر با همین مقدار خواهد بود).

-f fps

نرخ فریم (پیش‌فرض: 60). در حالت نرخ فریم متغیر، این مقدار حداکثر FPS است.

-cursor yes|no

ضبط نشانگر ماوس (پیش‌فرض: yes).

-restore-portal-session yes|no

بازیابی نشست قبلی پرتال (همراه با گزینه -w portal استفاده می‌شود، پیش‌فرض: no).

گزینه‌های صوتی (Audio Options)

-a audio_source

دستگاه صوتی یا برنامه‌ای که صدای آن ضبط می‌شود. می‌تواند چندین بار مشخص شود. قالب‌ها:

برای مشاهده فهرست دستگاه‌های صوتی موجود، دستور زیر را اجرا کنید: --list-audio-devices
برای مشاهده فهرست برنامه‌های موجود جهت ضبط صدا، دستور زیر را اجرا کنید: --list-application-audio

-ac aac|opus|flac

کدک صوتی (پیش‌فرض: opus برای mp4/mkv، در غیر این صورت aac). کدک FLAC موقتاً غیرفعال است.

-ab bitrate

بیت‌ریت صدا بر حسب kbps (پیش‌فرض: 128 برای opus/flac، و 160 برای aac). مقدار 0 = خودکار.

گزینه‌های کیفیت ویدیو (Video Quality Options)

-k codec

کدک ویدیو: 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) را کاهش می‌دهد، اما ممکن است به درستی توسط تمام پخش‌کننده‌های ویدیو پشتیبانی نشود.
گزینه‌های کدک Vulkan آزمایشی هستند و ممکن است به دلیل مشکلات درایور GPU در سیستم شما به درستی کار نکنند.
استفاده از کدک‌های Vulkan ممکن است در درایورهای قدیمی‌تر NVIDIA به عملکرد بهتر در بازی‌ها منجر شود، زیرا رمزگذاری ویدیویی Vulkan از مشکلی به نام "cuda p2 state" رنج نمی‌برد
که در آن هنگام استفاده از nvenc (کدک‌های ویدیویی معمول در NVIDIA)، فرکانس کاری GPU کاهش می‌یابد.

(پیش‌فرض: auto ← h264).

-q quality

پریست کیفیت (medium، high، very_high، ultra) برای حالت QP/VBR، یا بیت‌ریت (kbps) برای حالت CBR (پیش‌فرض: very_high).

-bm auto|qp|vbr|cbr

حالت بیت‌ریت (پیش‌فرض: auto ← qp). حالت CBR برای بافر بازپخش و پخش زنده توصیه می‌شود.

حالت QP به معنای ضبط با کیفیت ثابت حتی در صحنه‌های پرتحرک است، در حالی که VBR و CBR به معنای ضبط با حجم ثابت هستند.

-fm cfr|vfr|content

حالت نرخ فریم: cfr (ثابت)، vfr (متغیر)، یا content (منطبق بر محتوا) (پیش‌فرض: vfr). حالت content فقط در X11 یا ضبط پرتال در دسترس است.

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

حالت نرخ فریم ثابت (با -fm cfr) تضمین می‌کند که نرخ فریم ویدیو در سرتاسر فایل همان‌طور که با گزینه -f تنظیم شده ثابت بماند. این حالت ممکن است برای برخی از نرم‌افزارهای ویرایش ویدیو مورد نیاز باشد.
این گزینه توصیه نمی‌شود؛ زیرا برای مثال اگر قصد ضبط با نرخ ۶۰ فریم بر ثانیه را داشته باشید و بازی سنگینی انجام دهید که با کمتر از ۶۰ فریم بر ثانیه اجرا می‌شود، ضبط نیز ممکن است با همان نرخ فریم پایین تصویربرداری کند،
که انکودر را دچار اضافه بار کرده و ممکن است در نهایت ضبط با نرخ ۱ تا ۲ فریم بر ثانیه انجام شود و توانایی بازیابی نداشته باشد.
در این شرایط، سعی کنید در حالت نرخ فریم متغیر (با -fm vfr) در قالب فایل mkv ضبط کنید، زیرا نرم‌افزار Kdenlive از ویدیوهای با نرخ فریم متغیر در صورت قرار داشتن در کانتینر mkv پشتیبانی می‌کند.

-cr limited|full

دامنه رنگ (پیش‌فرض: limited). دامنه کامل (full) ممکن است در برخی پخش‌کننده‌های ویدیو یا وب‌سایت‌ها مشکل ایجاد کند.

-tune performance|quality

تنظیم بهینه‌سازی رمزگذاری (پیش‌فرض: performance). در حال حاضر فقط برای NVIDIA.

-keyint seconds

فاصله فریم‌های کلیدی (Keyframe) بر حسب ثانیه (پیش‌فرض: 2.0). بر دقت پرش زمانی در ویدیو تأثیر می‌گذارد.

-encoder gpu|cpu

دستگاه رمزگذاری (پیش‌فرض: gpu). رمزگذاری با CPU فقط برای H264 است.

-fallback-cpu-encoding yes|no

بازگشت به رمزگذاری CPU در صورت در دسترس نبودن شتاب‌دهنده سخت‌افزاری GPU (پیش‌فرض: no).

گزینه‌های بافر بازپخش (Replay Buffer Options)

-r seconds

مدت زمان بافر بازپخش (۲ تا ۸۶۴۰۰ ثانیه). هنگام تنظیم، ویدیو تنها با دستور کاربر ذخیره می‌شود.

-replay-storage ram|disk

محل ذخیره‌سازی بافر (پیش‌فرض: ram). حالت دیسک ممکن است طول عمر حافظه SSD را کاهش دهد.

-restart-replay-on-save yes|no

پاک کردن بافر پس از ذخیره بازپخش (پیش‌فرض: no).

-df yes|no

سازماندهی بازپخش‌ها در پوشه‌های مبتنی بر تاریخ (پیش‌فرض: no).

گزینه‌های پیشرفته (Advanced Options)

-p plugin.so

بارگذاری افزونه (فایل .so). می‌تواند چندین بار مشخص شود.

-sc script_path

اسکریپتی که پس از ذخیره ویدیو اجرا می‌شود. مسیر فایل و نوع آن ("regular"، "replay"، "screenshot") را دریافت می‌کند.

-portal-session-token-filepath path

فایل توکن نشست پرتال (پیش‌فرض: ~/.config/gpu-screen-recorder/restore_token).

-ffmpeg-opts options

آرگومان‌های اضافی برای ارسال به FFmpeg برای فایل به صورت فهرستی از جفت‌های کلید-مقدار در قالب "key=value;key=value"،
برای مثال: -ffmpeg-opts "hls_list_size=3;hls_time=1;hls_flags=delete_segments".
نکته: این تنظیمات گزینه‌های هم‌نام تعیین‌شده توسط GPU Screen Recorder را بازنویسی می‌کنند.

-ffmpeg-video-opts options

آرگومان‌های اضافی برای ارسال به FFmpeg برای ویدیو به صورت فهرستی از جفت‌های کلید-مقدار در قالب "key=value;key=value"،
برای مثال: -ffmpeg-video-opts "codec=cabac;rc_mode=CQP;qp=16".
نکته: این تنظیمات گزینه‌های هم‌نام تعیین‌شده توسط GPU Screen Recorder را بازنویسی می‌کنند.

-ffmpeg-audio-opts options

آرگومان‌های اضافی برای ارسال به FFmpeg برای صدا به صورت فهرستی از جفت‌های کلید-مقدار در قالب "key=value;key=value"،
برای مثال: -ffmpeg-audio-opts "aac_coder=fast;aac_pce=true".
نکته: این تنظیمات گزینه‌های هم‌نام تعیین‌شده توسط GPU Screen Recorder را بازنویسی می‌کنند.

-auth token

توکن حامل (Bearer) اختیاری جهت احراز هویت هنگام پخش زنده، برای مثال هنگام استفاده از پروتکل whip (گزینه -c whip).
برای سرورهایی با احراز هویت نام کاربری/رمز عبور، توکن می‌تواند به صورت "username:password" تنظیم شود. استریم با پروتکل Whip نیازمند نسخه ۸.۰ یا بالاتر FFmpeg است.
همچنین می‌توان توکن را در متغیر محیطی GSR_AUTH قرار داد تا در خط فرمان فرآیند نمایش داده نشود. گزینه -auth بر متغیر محیطی اولویت دارد.
هنگام استریم با whip، گزینه ماکسر ts_buffer_size به طور پیش‌فرض روی 4194304 تنظیم است. این مقدار را می‌توان با -ffmpeg-opts "ts_buffer_size=<value>" بازنویسی کرد.
هسته سیستم‌عامل (کرنل) اندازه بافر را بر اساس متغیر sysctl مربوط به net.core.wmem_max محدود می‌کند (که معمولاً فقط حدود ۲۰۸ کیلوبایت است). اگر استریم whip با خطای "UDP send blocked" متوقف شد، این مقدار را افزایش دهید؛ برای مثال: sysctl -w net.core.wmem_max=8388608

-gl-debug yes|no

خروجی خطایابی (دیباگ) OpenGL (پیش‌فرض: no).

-v yes|no

چاپ اطلاعات FPS و آسیب دیدگی تصویر (damage info) (پیش‌فرض: yes).

-low-power yes|no

اجرا در حالت کم‌مصرف. این گزینه در حال حاضر تنها بر کارت‌های AMD تأثیر دارد (چون این مسئله فقط در AMD وجود دارد) و به GPU اجازه می‌دهد هنگام ضبط به حالت مصرف توان کمتر برود (پیش‌فرض: no).
تنظیم این گزینه روی yes ممکن است همیشه به دلیل مشکلات درایور AMD ایده‌آل نباشد؛ جایی که پس از پخش یک ویدیو با VAAPI در سیستم، عملکرد رمزگذاری ویدیو نیز کاهش می‌یابد که بر GPU Screen Recorder اثر منفی می‌گذارد.
توصیه می‌شود هنگام فعال بودن این گزینه، از گزینه -fm content نیز استفاده کنید تا فریم‌ها تنها زمانی که محتوای صفحه به‌روز می‌شود رمزگذاری شوند و در زمان بیکاری سیستم، مصرف پردازنده گرافیکی و انکودر ویدیو کاهش یابد.

-exclude-metadata yes|no

حذف فراداده‌های (متادیتا) شخصی از فایل ویدیو، مانند عنوان ترک صوتی که به طور پیش‌فرض از نام دستگاه صوتی تشکیل شده است (پیش‌فرض: no).

-write-first-frame-ts yes|no

در صورت فعال بودن، یک فایل برچسب زمانی (Timestamp) با پسوند اضافی .ts در کنار ویدیوی خروجی ایجاد می‌کند که شامل موارد زیر است:

monotonic_microsec	realtime_microsec
<monotonic_microsec>	<realtime_microsec>

(پیش‌فرض: no). برای پخش زنده و زمانی که خروجی پایپ می‌شود نادیده گرفته می‌شود.

-ipc socket_path

شنود دستورات روی یک سوکت یونیکس در مسیر socket_path به جای پذیرش صرف سیگنال‌ها. سوکت با شروع به کار GPU Screen Recorder ایجاد و هنگام خروج برنامه حذف می‌شود. برای مشاهده پروتکل به بخش IPC مراجعه کنید. هنگام ثبت اسکرین‌شات تأثیری ندارد.

گزینه‌های خروجی (Output Options)

-o output

مسیر فایل خروجی (یا پوشه در حالت بازپخش). به جز در حالت خروجی به stdout الزامی است.

-ro directory

پوشه خروجی برای ضبط‌های معمولی در حین حالت بازپخش/استریم.

دستورات اطلاعاتی (Information Commands)

--help

نمایش پیام راهنما.

--version

نمایش نسخه (5.10.2).

--info

نمایش اطلاعات سیستم (کدک‌ها، گزینه‌های تصویربرداری).

--list-capture-options

فهرست کردن منابع تصویربرداری موجود (پنجره، مانیتورها، پرتال، مسیر دستگاه v4l2).

--list-monitors

فهرست کردن مانیتورهای موجود.

--list-v4l2-devices

فهرست کردن دستگاه‌های دوربین موجود (V4L2).

--list-audio-devices

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

--list-application-audio

فهرست کردن برنامه‌های موجود برای ضبط صدا.