Streamcopy

ساده‌ترین خط لوله در ffmpeg عملیات کپی استریم (streamcopy) تک‌استریمی است، یعنی کپی کردن بسته‌های یک جریان مقدماتی ورودی بدون دیکود کردن، فیلتر کردن یا انکود مجدد آن‌ها. به عنوان مثال، یک فایل ورودی به نام INPUT.mkv با ۳ جریان مقدماتی را در نظر بگیرید که دومین جریان آن را برداشته و در فایل OUTPUT.mp4 می‌نویسیم. نمایش شماتیک چنین خط لوله‌ای به صورت زیر است:

┌──────────┬─────────────────────┐
│ demuxer  │                     │ unused
╞══════════╡ elementary stream 0 ├────────╳
│          │                     │
│INPUT.mkv ├─────────────────────┤          ┌──────────────────────┬───────────┐
│          │                     │ packets  │                      │   muxer   │
│          │ elementary stream 1 ├─────────►│  elementary stream 0 ╞═══════════╡
│          │                     │          │                      │OUTPUT.mp4 │
│          ├─────────────────────┤          └──────────────────────┴───────────┘
│          │                     │ unused
│          │ elementary stream 2 ├────────╳
│          │                     │
└──────────┴─────────────────────┘

خط لوله فوق را می‌توان با خط فرمان زیر ایجاد کرد:

ffmpeg -i INPUT.mkv -map 0:1 -c copy OUTPUT.mp4

در این خط فرمان:

• یک ورودی منفرد INPUT.mkv وجود دارد؛
• هیچ گزینه ورودی برای این ورودی تعیین نشده است؛
• یک خروجی منفرد OUTPUT.mp4 وجود دارد؛
• دو گزینه خروجی برای این خروجی وجود دارد:

کپی استریم برای تغییر تعداد جریان‌های مقدماتی، قالب کانتینر، یا اصلاح متادیتای سطح کانتینر مفید است. از آنجا که هیچ دیکود یا انکودی صورت نمی‌گیرد، این فرایند بسیار سریع است و هیچ افت کیفیتی رخ نمی‌دهد. با این حال، ممکن است به دلایل گوناگون در برخی موارد کار نکند (مثلاً برخی اطلاعات مورد نیاز کانتینر مقصد در منبع موجود نباشد). بدیهی است اعمال فیلترها نیز غیرممکن است، زیرا فیلترها بر روی فریم‌های دیکودشده عمل می‌کنند.

سناریوهای پیچیده‌تر کپی استریم را نیز می‌توان ایجاد کرد - برای مثال ترکیب استریم‌ها از دو فایل ورودی درون یک خروجی واحد:

┌──────────┬────────────────────┐         ┌────────────────────┬───────────┐
│ demuxer 0│                    │ packets │                    │   muxer   │
╞══════════╡elementary stream 0 ├────────►│elementary stream 0 ╞═══════════╡
│INPUT0.mkv│                    │         │                    │OUTPUT.mp4 │
└──────────┴────────────────────┘         ├────────────────────┤           │
┌──────────┬────────────────────┐         │                    │           │
│ demuxer 1│                    │ packets │elementary stream 1 │           │
╞══════════╡elementary stream 0 ├────────►│                    │           │
│INPUT1.aac│                    │         └────────────────────┴───────────┘
└──────────┴────────────────────┘

که با خط فرمان زیر قابل ساخت است:

ffmpeg -i INPUT0.mkv -i INPUT1.aac -map 0:0 -map 1:0 -c copy OUTPUT.mp4

گزینه خروجی -map در اینجا دو بار استفاده شده است و دو استریم در فایل خروجی ایجاد می‌کند - یکی از اولین ورودی و دیگری از دومی تغذیه می‌شود. یک نمونه منفرد از گزینه -c عملیات کپی استریم را برای هر دوی این استریم‌ها انتخاب می‌نماید. شما همچنین می‌توانید از چندین نمونه از این گزینه به همراه مشخص‌کننده‌های استریم (Stream specifiers) استفاده کنید تا مقادیر متفاوتی را روی هر استریم اعمال نمایید، همان‌طور که در بخش‌های بعدی نشان داده خواهد شد.

یک سناریوی معکوس، تفکیک چندین استریم از یک ورودی منفرد به چندین فایل خروجی مجزا است:

┌──────────┬─────────────────────┐          ┌───────────────────┬───────────┐
│ demuxer  │                     │ packets  │                   │ muxer 0   │
╞══════════╡ elementary stream 0 ├─────────►│elementary stream 0╞═══════════╡
│          │                     │          │                   │OUTPUT0.mp4│
│INPUT.mkv ├─────────────────────┤          └───────────────────┴───────────┘
│          │                     │ packets  ┌───────────────────┬───────────┐
│          │ elementary stream 1 ├─────────►│                   │ muxer 1   │
│          │                     │          │elementary stream 0╞═══════════╡
└──────────┴─────────────────────┘          │                   │OUTPUT1.mp4│
                                            └───────────────────┴───────────┘

که با دستور زیر ساخته می‌شود:

ffmpeg -i INPUT.mkv -map 0:0 -c copy OUTPUT0.mp4 -map 0:1 -c copy OUTPUT1.mp4

توجه کنید که چگونه برای هر فایل خروجی به یک نمونه مجزا از گزینه -c نیاز است، حتی اگر مقادیر آن‌ها یکسان باشد. این امر به این دلیل است که گزینه‌های غیرعمومی (که اکثر گزینه‌ها را تشکیل می‌دهند) تنها در حیطه فایلی اعمال می‌شوند که پیش از آن قرار گرفته‌اند.

این مثال‌ها البته می‌توانند به نگاشت‌های دلخواه از هر تعداد ورودی به هر تعداد خروجی تعمیم یابند.

Transcoding

ترنسکدینگ فرایند دیکود کردن یک استریم و سپس انکود مجدد آن است. از آن‌جا که انکودینگ معمولاً از نظر محاسباتی سنگین است و در اکثر موارد کیفیت استریم را کاهش می‌دهد (یعنی اتلافی است)، باید تنها در صورت نیاز ترنسکد کنید و در غیر این صورت از کپی استریم بهره ببرید. دلایل معمول برای ترنسکد کردن عبارتند از:

• اعمال فیلترها - مانند تغییر اندازه، حذف خطوط درهم‌بافته (deinterlacing)، یا هم‌پوشانی ویدیو؛ تغییر نرخ نمونه‌برداری (resampling) یا میکس و ترکیب صدا؛
• تمایل به ارسال استریم به سامانه‌ای که قادر به دیکود کردن کدک اصلی نیست.

توجه داشته باشید که ffmpeg تمام استریم‌های صدا، تصویر و زیرنویس را ترنسکد خواهد کرد مگر این‌که برای آن‌ها گزینه -c copy را مشخص نمایید.

یک خط لوله نمونه را در نظر بگیرید که یک فایل ورودی با یک استریم صوتی و یک استریم ویدیویی را می‌خواند، ویدیو را ترنسکد کرده و صدا را در یک فایل خروجی واحد کپی می‌کند. این فرایند را می‌توان به صورت شماتیک به شکل زیر نشان داد:

┌──────────┬─────────────────────┐
│ demuxer  │                     │       audio packets
╞══════════╡ stream 0 (audio)    ├─────────────────────────────────────╮
│          │                     │                                     │
│INPUT.mkv ├─────────────────────┤ video    ┌─────────┐     raw        │
│          │                     │ packets  │  video  │ video frames   │
│          │ stream 1 (video)    ├─────────►│ decoder ├──────────────╮ │
│          │                     │          │         │              │ │
└──────────┴─────────────────────┘          └─────────┘              │ │
                                                                     ▼ ▼
                                                                     │ │
┌──────────┬─────────────────────┐ video    ┌─────────┐              │ │
│ muxer    │                     │ packets  │  video  │              │ │
╞══════════╡ stream 0 (video)    │◄─────────┤ encoder ├──────────────╯ │
│          │                     │          │(libx264)│                │
│OUTPUT.mp4├─────────────────────┤          └─────────┘                │
│          │                     │                                     │
│          │ stream 1 (audio)    │◄────────────────────────────────────╯
│          │                     │
└──────────┴─────────────────────┘

و با خط فرمان زیر پیاده‌سازی می‌گردد:

ffmpeg -i INPUT.mkv -map 0:v -map 0:a -c:v libx264 -c:a copy OUTPUT.mp4

توجه کنید که چگونه از مشخص‌کننده‌های استریم ":v" و ":a" برای انتخاب استریم‌های ورودی و اعمال مقادیر متفاوت گزینه -c به آن‌ها استفاده شده است؛ برای جزئیات بیشتر به بخش مشخص‌کننده‌های استریم (Stream specifiers) مراجعه کنید.

Filtering

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

فیلترگراف‌های ساده (Simple filtergraphs)

فیلترگراف‌های ساده آن‌هایی هستند که دقیقاً یک ورودی و یک خروجی دارند و هر دو از یک نوع (صدا یا ویدیو) هستند. آن‌ها با گزینه به‌ازای‌هر‌استریم -filter پیکربندی می‌شوند (با نام‌های مستعار -vf و -af به ترتیب برای -filter:v (ویدیو) و -filter:a (صدا)). توجه داشته باشید که فیلترگراف‌های ساده به جریان خروجی خود وابسته هستند، بنابراین برای مثال اگر چندین جریان صوتی داشته باشید، -af برای هر یک فیلترگراف جداگانه‌ای ایجاد می‌کند.

با در نظر گرفتن مثال ترنسکدینگ فوق، افزودن فیلترینگ (و حذف صدا جهت وضوح بیشتر) آن را به شکل زیر درمی‌آورد:

┌──────────┬───────────────┐
│ demuxer  │               │          ┌─────────┐
╞══════════╡ video stream  │ packets  │  video  │ frames
│INPUT.mkv │               ├─────────►│ decoder ├─────►───╮
│          │               │          └─────────┘         │
└──────────┴───────────────┘                              │
                                  ╭───────────◄───────────╯
                                  │   ┌────────────────────────┐
                                  │   │  simple filtergraph    │
                                  │   ╞════════════════════════╡
                                  │   │  ┌───────┐  ┌───────┐  │
                                  ╰──►├─►│ yadif ├─►│ scale ├─►├╮
                                      │  └───────┘  └───────┘  ││
                                      └────────────────────────┘│
                                                                │
                                                                │
┌──────────┬───────────────┐ video    ┌─────────┐               │
│ muxer    │               │ packets  │  video  │               │
╞══════════╡ video stream  │◄─────────┤ encoder ├───────◄───────╯
│OUTPUT.mp4│               │          │         │
│          │               │          └─────────┘
└──────────┴───────────────┘

فیلترگراف‌های پیچیده (Complex filtergraphs)

فیلترگراف‌های پیچیده آن‌هایی هستند که نمی‌توان آن‌ها را به سادگی به عنوان یک زنجیره پردازش خطی اعمال‌شده بر روی یک استریم توصیف کرد. این حالت برای مثال زمانی رخ می‌دهد که گراف بیش از یک ورودی و/یا خروجی داشته باشد، یا زمانی که نوع استریم خروجی با ورودی متفاوت باشد. فیلترگراف‌های پیچیده با گزینه -filter_complex پیکربندی می‌شوند. توجه کنید که این گزینه عمومی است، زیرا یک فیلترگراف پیچیده ماهیتاً نمی‌تواند به طور بدون ابهام به یک استریم یا فایل منفرد مرتبط شود. هر نمونه از -filter_complex یک فیلترگراف پیچیده جدید ایجاد می‌کند، و هر تعداد از آن‌ها می‌تواند وجود داشته باشد.

یک مثال ساده از فیلترگراف پیچیده، فیلتر "overlay" است که دو ورودی ویدیو و یک خروجی ویدیو دارد و شامل یک ویدیو هم‌پوشانی‌شده بر روی ویدیوی دیگر است. معادل صوتی آن فیلتر "amix" می‌باشد.

Loopback decoders

در حالی که دیکودرها معمولاً با استریم‌های دی‌ماکسر مرتبط هستند، همچنین امکان ایجاد دیکودرهای "بازگشتی" (loopback) وجود دارد که خروجی یک انکودر را رمزگشایی کرده و اجازه می‌دهند تا دوباره به فیلترگراف‌های پیچیده تغذیه شود. این کار با دستورالعمل "-dec" انجام می‌گیرد، که اندیس استریم خروجی که باید دیکود شود را به عنوان پارامتر می‌پذیرد. هر یک از این دستورالعمل‌ها یک دیکودر بازگشتی جدید ایجاد می‌کند که با اعداد صحیح متوالی با شروع از صفر شماره‌گذاری می‌شوند. این اندیس‌ها سپس باید برای ارجاع به دیکودرهای بازگشتی در برچسب‌های پیوند فیلترگراف‌های پیچیده استفاده شوند، همان‌گونه که در مستندات -filter_complex توضیح داده شده است.

گزینه‌های AVOptions دیکودینگ را می‌توان با قرار دادن آن‌ها پیش از "-dec" به دیکودرهای بازگشتی ارسال نمود، مشابه با گزینه‌های ورودی/خروجی.

برای مثال، دستور زیر:

ffmpeg -i INPUT                                        \
  -map 0:v:0 -c:v libx264 -crf 45 -f null -            \
  -threads 3 -dec 0:0                                  \
  -filter_complex '[0:v][dec:0]hstack[stack]'          \
  -map '[stack]' -c:v ffv1 OUTPUT

یک ویدیوی ورودی را می‌خواند و:

• (خط ۲) آن را با "libx264" با کیفیت پایین انکود می‌کند؛
• (خط ۳) این استریم انکودشده را با استفاده از ۳ ریسه (threads) دیکود می‌نماید؛
• (خط ۴) ویدیوی دیکودشده را در کنار ویدیوی ورودی اصلی قرار می‌دهد؛
• (خط ۵) ویدیوی ترکیبی سپس به صورت بدون اتلاف (lossless) انکود شده و در OUTPUT نوشته می‌شود.

چنین پایپ‌لاین ترنسکدینگی را می‌توان با نمودار زیر نمایش داد:

┌──────────┬───────────────┐
│ demuxer  │               │   ┌─────────┐            ┌─────────┐    ┌────────────────────┐
╞══════════╡ video stream  │   │  video  │            │  video  │    │ null muxer         │
│   INPUT  │               ├──►│ decoder ├──┬────────►│ encoder ├─┬─►│(discards its input)│
│          │               │   └─────────┘  │         │(libx264)│ │  └────────────────────┘
└──────────┴───────────────┘                │         └─────────┘ │
                                 ╭───────◄──╯   ┌─────────┐       │
                                 │              │loopback │       │
                                 │ ╭─────◄──────┤ decoder ├────◄──╯
                                 │ │            └─────────┘
                                 │ │
                                 │ │
                                 │ │  ┌───────────────────┐
                                 │ │  │complex filtergraph│
                                 │ │  ╞═══════════════════╡
                                 │ │  │  ┌─────────────┐  │
                                 ╰─╫─►├─►│   hstack    ├─►├╮
                                   ╰─►├─►│             │  ││
                                      │  └─────────────┘  ││
                                      └───────────────────┘│
                                                           │
┌──────────┬───────────────┐  ┌─────────┐                  │
│ muxer    │               │  │  video  │                  │
╞══════════╡ video stream  │◄─┤ encoder ├───────◄──────────╯
│  OUTPUT  │               │  │ (ffv1)  │
│          │               │  └─────────┘
└──────────┴───────────────┘

توضیحات (Description)

زیربخش‌های زیر قواعد مختلف دخیل در انتخاب استریم را تشریح می‌کنند. مثال‌های پس از آن نشان می‌دهند که چگونه این قواعد در عمل به کار گرفته می‌شوند.

اگرچه نهایت تلاش برای بازتاب دقیق رفتار برنامه صورت گرفته است، اما FFmpeg به طور مداوم در حال توسعه است و ممکن است کد از زمان نگارش این متن تغییر کرده باشد.

انتخاب خودکار استریم (Automatic stream selection)

در صورت عدم وجود هرگونه گزینه map برای یک فایل خروجی خاص، ffmpeg قالب خروجی را بررسی می‌کند تا ببیند چه انواعی از استریم‌ها می‌توانند در آن گنجانده شوند، یعنی ویدیو، صدا و/یا زیرنویس. برای هر نوع استریم قابل قبول، ffmpeg در صورت وجود، یک استریم را از میان تمام ورودی‌ها برمی‌گزیند.

برنامه آن استریم را بر اساس معیارهای زیر انتخاب خواهد کرد:

• برای ویدیو، استریمی است که بالاترین وضوح (resolution) را دارد،
• برای صدا، استریمی است که بیشترین تعداد کانال را دارد،
• برای زیرنویس، اولین استریم زیرنویس یافت‌شده است، اما یک نکته وجود دارد: انکودر پیش‌فرض زیرنویسِ قالب خروجی می‌تواند مبتنی بر متن یا تصویر باشد، و تنها یک استریم زیرنویس از همان نوع برگزیده خواهد شد.

در حالتی که چندین استریم از یک نوع دارای رتبه برابر باشند، استریمی که کمترین اندیس را دارد انتخاب می‌شود.

استریم‌های داده یا پیوست‌ها به صورت خودکار انتخاب نمی‌شوند و تنها می‌توانند با استفاده از "-map" گنجانده شوند.

انتخاب دستی استریم (Manual stream selection)

هنگامی که از "-map" استفاده می‌شود، منحصراً استریم‌های نگاشت‌شده توسط کاربر در آن فایل خروجی گنجانده می‌شوند، با یک استثنای احتمالی برای خروجی‌های فیلترگراف که در ادامه شرح داده شده است.

فیلترگراف‌های پیچیده (Complex filtergraphs)

چنانچه خروجی‌های فیلترگراف پیچیده‌ای دارای پایه‌های (pads) بدون برچسب باشند، به اولین فایل خروجی اضافه خواهند شد. اگر نوع استریم توسط قالب خروجی پشتیبانی نشود، این امر منجر به خطای مرگبار (fatal error) می‌گردد. در صورت عدم وجود گزینه map، گنجاندن این استریم‌ها سبب صرف‌نظر کردن از انتخاب خودکار استریم‌های هم‌نوع آن‌ها می‌شود. اگر گزینه‌های map حضور داشته باشند، این استریم‌های فیلترگراف علاوه بر استریم‌های نگاشت‌شده افزوده می‌گردند.

استریم‌های خروجی فیلترگراف پیچیده با پایه‌های برچسب‌دار باید دقیقاً یک بار نگاشت شوند.

مدیریت استریم (Stream handling)

مدیریت استریم مستقل از انتخاب استریم است، به استثنای زیرنویس‌ها که در زیر توضیح داده شده است. مدیریت استریم از طریق گزینه "-codec" که به استریم‌های درون یک فایل خروجی خاص اشاره دارد تنظیم می‌شود. به ویژه، گزینه‌های کدک توسط ffmpeg پس از فرایند انتخاب استریم اعمال می‌گردند و بنابراین تأثیری بر انتخاب ندارند. اگر هیچ گزینه "-codec" برای یک نوع استریم مشخص نشده باشد، ffmpeg انکودر پیش‌فرض ثبت‌شده توسط ماکسر فایل خروجی را برمی‌گزیند.

یک استثنا برای زیرنویس‌ها وجود دارد. اگر یک انکودر زیرنویس برای یک فایل خروجی تعیین شود، نخستین استریم زیرنویس یافت‌شده از هر نوع (متنی یا تصویری) گنجانده خواهد شد. ابزار ffmpeg بررسی نمی‌کند که آیا انکودر مشخص‌شده قادر به تبدیل استریم انتخاب‌شده است یا این‌که آیا استریم تبدیل‌شده درون قالب خروجی قابل قبول است یا خیر. این نکته به طور کلی نیز صدق می‌کند: هنگامی که کاربر انکودری را به صورت دستی تنظیم می‌کند، فرایند انتخاب استریم نمی‌تواند بررسی کند که آیا استریم انکودشده می‌تواند درون فایل خروجی ماکس (mux) شود یا نه. اگر نتواند، ffmpeg متوقف خواهد شد و پردازش تمامی فایل‌های خروجی با شکست مواجه می‌شود.

مثال‌ها (Examples)

مثال‌های زیر رفتار، ظرافت‌ها و محدودیت‌های روش‌های انتخاب استریم در ffmpeg را به تصویر می‌کشند.

این مثال‌ها سه فایل ورودی زیر را مفروض می‌دارند.

input file 'A.avi'
      stream 0: video 640x360
      stream 1: audio 2 channels

input file 'B.mp4'
      stream 0: video 1920x1080
      stream 1: audio 2 channels
      stream 2: subtitles (text)
      stream 3: audio 5.1 channels
      stream 4: subtitles (text)

input file 'C.mkv'
      stream 0: video 1280x720
      stream 1: audio 2 channels
      stream 2: subtitles (image)

مثال: انتخاب خودکار استریم (automatic stream selection)

ffmpeg -i A.avi -i B.mp4 out1.mkv out2.wav -map 1:a -c:a copy out3.mov

سه فایل خروجی مشخص شده است، و برای دو فایل نخست، هیچ گزینه "-map" تنظیم نشده است، بنابراین ffmpeg استریم‌ها را برای این دو فایل به صورت خودکار انتخاب می‌کند.

فایل out1.mkv یک فایل کانتینر ماتروشکا است و استریم‌های ویدیو، صدا و زیرنویس را می‌پذیرد، بنابراین ffmpeg تلاش می‌کند از هر نوع یک استریم برگزیند. برای ویدیو، "stream 0" از B.mp4 را انتخاب خواهد کرد که بالاترین رزولوشن را در میان تمام استریم‌های ویدیوی ورودی داراست. برای صدا، "stream 3" از B.mp4 را برمی‌گزیند، زیرا بیشترین تعداد کانال را دارد. برای زیرنویس، "stream 2" از B.mp4 را انتخاب خواهد کرد که نخستین استریم زیرنویس از میان A.avi و B.mp4 است.

فایل out2.wav تنها استریم‌های صوتی را می‌پذیرد، بنابراین فقط "stream 3" از B.mp4 انتخاب می‌گردد.

برای out3.mov، از آن‌جا که گزینه "-map" تنظیم شده است، هیچ انتخاب خودکار استریمی رخ نخواهد داد. گزینه "-map 1:a" تمام استریم‌های صوتی را از دومین ورودی یعنی B.mp4 انتخاب می‌کند. هیچ استریم دیگری در این فایل خروجی گنجانده نخواهد شد.

برای دو خروجی اول، تمامی استریم‌های گنجانده‌شده ترنسکد خواهند شد. انکودرهای برگزیده‌شده همان موارد پیش‌فرضی خواهند بود که توسط هر قالب خروجی ثبت شده‌اند، که ممکن است با کدک استریم‌های ورودی انتخاب‌شده مطابقت نداشته باشند.

برای خروجی سوم، گزینه کدک برای استریم‌های صوتی روی "copy" تنظیم شده است، بنابراین هیچ عملیات دیکود-فیلتر-انکودی انجام نخواهد شد، یا نمی‌تواند انجام شود. بسته‌های استریم‌های انتخاب‌شده از فایل ورودی منتقل شده و درون فایل خروجی ماکس می‌شوند.

مثال: انتخاب خودکار زیرنویس‌ها (automatic subtitles selection)

ffmpeg -i C.mkv out1.mkv -c:s dvdsub -an out2.mkv

اگرچه out1.mkv یک فایل کانتینر ماتروشکا است که استریم‌های زیرنویس را می‌پذیرد، تنها یک استریم ویدیو و یک استریم صدا انتخاب خواهند شد. استریم زیرنویسِ C.mkv تصویری است و انکودر پیش‌فرض زیرنویس در ماکسر ماتروشکا متنی است، بنابراین انتظار می‌رود عملیات ترنسکد برای زیرنویس با شکست مواجه شود و در نتیجه این استریم انتخاب نمی‌شود. با این حال، در out2.mkv، یک انکودر زیرنویس در خط فرمان مشخص شده است و بنابراین، استریم زیرنویس علاوه بر استریم ویدیو انتخاب می‌گردد. حضور گزینه "-an" انتخاب استریم صوتی را برای out2.mkv غیرفعال می‌سازد.

مثال: خروجی‌های بدون برچسب فیلترگراف (unlabeled filtergraph outputs)

ffmpeg -i A.avi -i C.mkv -i B.mp4 -filter_complex "overlay" out1.mp4 out2.srt

در اینجا یک فیلترگراف با استفاده از گزینه "-filter_complex" برپا شده است و از یک فیلتر ویدیویی منفرد تشکیل می‌شود. فیلتر "overlay" دقیقاً به دو ورودی ویدیویی نیاز دارد، اما هیچ ورودی مشخص نشده است، بنابراین از دو استریم ویدیویی در دسترس نخست استفاده می‌شود، یعنی استریم‌های مربوط به A.avi و C.mkv. پایه خروجی فیلتر برچسبی ندارد و بنابراین به نخستین فایل خروجی یعنی out1.mp4 ارسال می‌گردد. به همین دلیل، از انتخاب خودکار استریم ویدیو که استریم موجود در B.mp4 را برمی‌گزید صرف‌نظر می‌شود. استریم صوتی با بیشترین کانال یعنی "stream 3" در B.mp4 به صورت خودکار انتخاب می‌شود. با این حال هیچ استریم زیرنویسی انتخاب نمی‌شود، زیرا قالب MP4 انکودر پیش‌فرضی برای زیرنویس ثبت نکرده است و کاربر نیز انکودر زیرنویس تعیین ننموده است.

فایل خروجی دوم، out2.srt، تنها استریم‌های زیرنویس متنی را می‌پذیرد. بنابراین، اگرچه اولین استریم زیرنویسِ در دسترس متعلق به C.mkv است، اما تصویری بوده و از آن صرف‌نظر می‌شود. استریم انتخاب‌شده، یعنی "stream 2" در B.mp4، نخستین استریم زیرنویس متنی است.

مثال: خروجی‌های برچسب‌دار فیلترگراف (labeled filtergraph outputs)

ffmpeg -i A.avi -i B.mp4 -i C.mkv -filter_complex "[1:v]hue=s=0[outv];overlay;aresample" \
       -map '[outv]' -an        out1.mp4 \
                                out2.mkv \
       -map '[outv]' -map 1:a:0 out3.mkv

دستور بالا شکست خواهد خورد، زیرا پایه خروجی برچسب‌گذاری‌شده با "[outv]" دو بار نگاشت شده است. هیچ‌یک از فایل‌های خروجی پردازش نخواهند شد.

ffmpeg -i A.avi -i B.mp4 -i C.mkv -filter_complex "[1:v]hue=s=0[outv];overlay;aresample" \
       -an        out1.mp4 \
                  out2.mkv \
       -map 1:a:0 out3.mkv

این دستور بالا نیز شکست خواهد خورد چرا که خروجی فیلتر hue دارای برچسب "[outv]" است و به هیچ مقصدی نگاشت نشده است.

دستور باید به شکل زیر اصلاح شود:

ffmpeg -i A.avi -i B.mp4 -i C.mkv -filter_complex "[1:v]hue=s=0,split=2[outv1][outv2];overlay;aresample" \
        -map '[outv1]' -an        out1.mp4 \
                                  out2.mkv \
        -map '[outv2]' -map 1:a:0 out3.mkv

استریم ویدیو از B.mp4 به فیلتر hue فرستاده می‌شود که خروجی آن با استفاده از فیلتر split یک بار کلون (تکثیر) شده و هر دو خروجی برچسب‌گذاری می‌شوند. سپس یک نسخه به فایل خروجی اول و نسخه دیگر به فایل خروجی سوم نگاشت می‌گردد.

فیلتر overlay که نیازمند دو ورودی ویدیو است، از دو استریم ویدیویی استفاده‌نشده اول بهره می‌گیرد. این‌ها استریم‌های مربوط به A.avi و C.mkv هستند. خروجی overlay برچسبی ندارد، بنابراین صرف‌نظر از حضور گزینه "-map" به نخستین فایل خروجی یعنی out1.mp4 ارسال می‌شود.

به فیلتر aresample نخستین استریم صوتی استفاده‌نشده، یعنی استریم متعلق به A.avi ارسال می‌گردد. از آنجا که این خروجی فیلتر نیز بدون برچسب است، آن نیز به نخستین فایل خروجی نگاشت می‌شود. حضور گزینه "-an" تنها مانع از انتخاب خودکار یا دستی استریم‌های صوتی می‌شود، نه خروجی‌های ارسالی از فیلترگراف‌ها. هر دوی این استریم‌های نگاشت‌شده پیش از استریم نگاشت‌شده در out1.mp4 مرتب خواهند شد.

استریم‌های ویدیو، صدا و زیرنویس نگاشت‌شده به "out2.mkv" کاملاً بر اساس انتخاب خودکار استریم تعیین می‌شوند.

out3.mkv شامل خروجی ویدیویی کلون‌شده از فیلتر hue و نخستین استریم صوتی از B.mp4 است.

مشخص‌کننده‌های استریم (Stream specifiers)

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

مشخص‌کننده استریم رشته‌ای است که عموماً به انتهای نام گزینه الحاق شده و با دو‌نقطه (:) از آن جدا می‌شود. برای مثال، "-codec:a:1 ac3" حاوی مشخص‌کننده استریم "a:1" است که با دومین استریم صوتی مطابقت دارد. بنابراین، کدک ac3 را برای دومین استریم صوتی انتخاب خواهد کرد.

یک مشخص‌کننده استریم می‌تواند با چندین استریم مطابقت داشته باشد، به طوری که گزینه بر روی تمامی آن‌ها اعمال شود. برای مثال مشخص‌کننده استریم در "-b:a 128k" با تمام استریم‌های صوتی مطابقت دارد.

یک مشخص‌کننده استریم خالی با تمام استریم‌ها مطابقت دارد. برای نمونه، "-codec copy"; یا "-codec: copy" تمامی استریم‌ها را بدون انکود مجدد کپی می‌کند.

شکل‌های ممکن مشخص‌کننده‌های استریم عبارتند از:

stream_index

با استریم دارای این اندیس مطابقت می‌یابد. برای مثال "-threads:1 4" تعداد ریسه‌های دومین استریم را روی 4 تنظیم می‌کند. اگر stream_index به عنوان یک مشخص‌کننده استریم اضافی استفاده شود (به پایین مراجعه کنید)، استریم شماره stream_index را از میان استریم‌های منطبق انتخاب می‌نماید. شماره‌گذاری استریم‌ها بر اساس ترتیب استریم‌ها به گونه‌ای است که توسط libavformat شناسایی شده‌اند، مگر زمانی که مشخص‌کننده گروه استریم یا شناسه برنامه (program ID) نیز مشخص شده باشد. در این حالت بر اساس ترتیب استریم‌ها درون آن گروه یا برنامه خواهد بود.

stream_type[:additional_stream_specifier]

پارامتر stream_type یکی از موارد زیر است: 'v' یا 'V' برای ویدیو، 'a' برای صدا، 's' برای زیرنویس، 'd' برای داده، و 't' برای پیوست‌ها. حرف 'v' با تمام استریم‌های ویدیو مطابقت دارد، در حالی که 'V' تنها با استریم‌های ویدیویی مطابقت دارد که تصاویر پیوست‌شده، تصاویر بندانگشتی (thumbnails) یا طرح جلد نیستند. اگر additional_stream_specifier استفاده شود، با استریم‌هایی مطابقت دارد که هم دارای این نوع باشند و هم با additional_stream_specifier مطابقت داشته باشند. در غیر این صورت، با تمام استریم‌های از نوع مشخص‌شده مطابقت دارد.

g:group_specifier[:additional_stream_specifier]

با استریم‌هایی مطابقت دارد که در گروه دارای مشخص‌کننده group_specifier قرار دارند. اگر additional_stream_specifier استفاده شود، با استریم‌هایی مطابقت دارد که هم بخشی از گروه باشند و هم با additional_stream_specifier تطابق داشته باشند. group_specifier می‌تواند یکی از موارد زیر باشد:

p:program_id[:additional_stream_specifier]

با استریم‌هایی مطابقت دارد که در برنامه با شناسه program_id قرار دارند. اگر additional_stream_specifier استفاده شود، با استریم‌هایی مطابقت دارد که هم بخشی از برنامه باشند و هم با additional_stream_specifier مطابقت داشته باشند.

#stream_id or i:stream_id

تطابق با استریم بر اساس شناسه استریم (مثلاً PID در کانتینر MPEG-TS).

m:key[:value]

با استریم‌هایی مطابقت دارد که تگ متادیتای key آن‌ها دارای مقدار مشخص‌شده باشد. اگر value داده نشود، با استریم‌هایی که حاوی تگ داده‌شده با هر مقداری باشند مطابقت می‌یابد. نویسه دو‌نقطه ':' در key یا value باید با بک‌اسلش گریز داده شود (escape شود).

disp:dispositions[:additional_stream_specifier]

با استریم‌های دارای وضعیت(های) مشخص‌شده مطابقت دارد. dispositions فهرستی از یک یا چند وضعیت (همان‌طور که توسط گزینه -dispositions چاپ می‌شود) است که با '+' به هم پیوسته‌اند.

u

با استریم‌های دارای پیکربندی قابل استفاده مطابقت می‌یابد؛ کدک باید تعریف شده باشد و اطلاعات اساسی مانند ابعاد تصویر یا نرخ نمونه‌برداری صدا باید موجود باشند.

توجه داشته باشید که در ffmpeg، تطابق بر اساس متادیتا تنها برای فایل‌های ورودی به درستی کار خواهد کرد.

گزینه‌های عمومی (Generic options)

این گزینه‌ها میان تمامی ابزارهای مجموعه ff* به اشتراک گذاشته شده‌اند.

-L, -license

نمایش مجوز برنامه.

-h, -?, -help, --help [arg]

نمایش راهنما. یک پارامتر اختیاری می‌تواند برای دریافت راهنما درباره یک مؤلفه خاص مشخص شود. اگر هیچ آرگومانی مشخص نگردد، تنها گزینه‌های پایه (غیرپیشرفته) ابزار نمایش داده می‌شوند.

مقادیر ممکن برای arg عبارتند از:

-version

نمایش نسخه برنامه و کتابخانه‌ها.

-buildconf

نمایش پیکربندی ساخت (build)، یک گزینه در هر خط.

-formats

نمایش قالب‌های در دسترس (شامل دستگاه‌ها).

-demuxers

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

-muxers

نمایش ماکسرهای در دسترس.

-devices

نمایش دستگاه‌های در دسترس.

-codecs

نمایش تمام کدک‌های شناخته‌شده برای کتابخانه libavcodec.

توجه داشته باشید که اصطلاح 'codec' در سرتاسر این مستندات به عنوان یک میان‌بر برای آنچه که به طور دقیق‌تر قالب بیت‌استریم رسانه نامیده می‌شود به کار رفته است.

-decoders

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

-encoders

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

-bsfs

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

-protocols

نمایش پروتکل‌های در دسترس.

-filters

نمایش فیلترهای در دسترس کتابخانه libavfilter.

-pix_fmts

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

-sample_fmts

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

-layouts

نمایش نام‌های کانال و چیدمان‌های استاندارد کانال.

-dispositions

نمایش وضعیت‌های استریم.

-colors

نمایش نام‌های رنگ شناخته‌شده.

-sources device[,opt1=val1[,opt2=val2]...]

نمایش منابع شناسایی‌شده خودکار دستگاه ورودی. برخی دستگاه‌ها ممکن است نام‌های منبع وابسته به سیستم را ارائه دهند که نمی‌توانند به طور خودکار شناسایی شوند. نمی‌توان فرض کرد که فهرست ارائه‌شده همیشه کامل است.

ffmpeg -sources pulse,server=192.168.0.4

-sinks device[,opt1=val1[,opt2=val2]...]

نمایش مقصدهای (sinks) شناسایی‌شده خودکار دستگاه خروجی. برخی دستگاه‌ها ممکن است نام‌های مقصد وابسته به سیستم را ارائه دهند که به صورت خودکار شناسایی نمی‌شوند. نمی‌توان فرض کرد که فهرست ارائه‌شده همیشه کامل است.

ffmpeg -sinks pulse,server=192.168.0.4

-loglevel [flags+]loglevel | -v [flags+]loglevel

تنظیم سطح لاگ‌گیری و فلگ‌های مورد استفاده توسط کتابخانه.

پیشوند اختیاری flags می‌تواند شامل مقادیر زیر باشد:

-report

ذخیره کامل خط فرمان و خروجی لاگ در فایلی با نام "program-YYYYMMDD-HHMMSS.log" در دایرکتوری جاری. این فایل می‌تواند برای گزارش اشکالات بسیار سودمند باشد. این گزینه همچنین "-loglevel debug"; را شامل می‌شود.

تنظیم متغیر محیطی FFREPORT روی هر مقداری اثر یکسانی دارد. اگر این مقدار یک دنباله key=value جداشده با ':' باشد، این گزینه‌ها بر گزارش تأثیر می‌گذارند؛ مقادیر گزینه‌ها چنانچه حاوی نویسه‌های ویژه یا جداکننده گزینه‌ها ':' باشند باید گریز داده شوند (به بخش "Quoting and escaping" در راهنمای ffmpeg-utils مراجعه کنید).

گزینه‌های زیر شناخته شده هستند:

-hide_banner

جلوگیری از چاپ بنر کپی‌رایت و بیلد.

تمامی ابزارهای FFmpeg معمولاً اطلاعیه حق نشر، گزینه‌های ساخت و نسخه‌های کتابخانه‌ها را نمایش می‌دهند. از این گزینه می‌توان برای جلوگیری از چاپ این اطلاعات استفاده کرد.

-cpuflags flags (global)

امکان تنظیم و پاک کردن فلگ‌های پردازنده (CPU) را فراهم می‌سازد. این گزینه برای اهداف آزمایشی در نظر گرفته شده است. از آن استفاده نکنید مگر این‌که بدانید چه کاری انجام می‌دهید.

ffmpeg -cpuflags -sse+mmx ... ffmpeg -cpuflags mmx ... ffmpeg -cpuflags 0 ...

فلگ‌های ممکن برای این گزینه عبارتند از:

-cpucount count (global)

نادیده‌گرفتن تعداد هسته‌های پردازنده شناسایی‌شده. این گزینه برای اهداف آزمایشی در نظر گرفته شده است. از آن استفاده نکنید مگر این‌که بدانید چه کاری انجام می‌دهید.

ffmpeg -cpucount 2

-max_alloc bytes

تنظیم سقف حداکثر اندازه برای تخصیص یک بلوک در حافظه هیپ (heap) توسط خانواده توابع malloc در ffmpeg. هنگام استفاده از این گزینه نهایت احتیاط را به خرج دهید. اگر از تمام عواقب انجام آن آگاهی ندارید از آن استفاده نکنید. مقدار پیش‌فرض INT_MAX است.

AVOptions

این گزینه‌ها مستقیماً توسط کتابخانه‌های libavformat، libavdevice و libavcodec ارائه می‌شوند. برای مشاهده فهرست AVOptions موجود، از گزینه -help استفاده کنید. آن‌ها به دو دسته تقسیم می‌شوند:

generic

این گزینه‌ها را می‌توان برای هر کانتینر، کدک یا دستگاهی تنظیم کرد. گزینه‌های عمومی برای کانتینرها/دستگاه‌ها ذیل گزینه‌های AVFormatContext و برای کدک‌ها ذیل گزینه‌های AVCodecContext فهرست شده‌اند.

private

این گزینه‌ها مختص کانتینر، دستگاه یا کدک داده‌شده هستند. گزینه‌های اختصاصی ذیل کانتینرها/دستگاه‌ها/کدک‌های متناظر خود لیست شده‌اند.

برای مثال جهت نوشتن یک هدر ID3v2.3 به جای هدر پیش‌فرض ID3v2.4 در یک فایل MP3، از گزینه اختصاصی id3v2_version در ماکسر MP3 استفاده کنید:

ffmpeg -i input.flac -id3v2_version 3 out.mp3

تمامی گزینه‌های AVOptions کدک به‌ازای‌هر‌استریم هستند، و بنابراین باید یک مشخص‌کننده استریم به آن‌ها پیوست شود:

ffmpeg -i multichannel.mxf -map 0:v:0 -map 0:a:0 -map 0:a:0 -c:a:0 ac3 -b:a:0 640k -ac:a:1 2 -c:a:1 aac -b:2 128k out.mp4

در مثال فوق، یک استریم صوتی چندکاناله دو بار برای خروجی نگاشت شده است. اولین نمونه با کدک ac3 و نرخ بیت 640k انکود می‌شود. دومین نمونه به ۲ کانال کاهش می‌یابد (downmix) و با کدک aac کدگذاری می‌گردد. نرخ بیت 128k برای آن با استفاده از اندیس مطلق استریم خروجی مشخص شده است.

نکته: ساختار -nooption نمی‌تواند برای AVOptions بولی استفاده شود، از -option 0/-option 1 استفاده کنید.

نکته: شیوه قدیمی و غیرمستند تعیین AVOptions به‌ازای‌هر‌استریم با افزودن پیشوند v/a/s به ابتدای نام گزینه اکنون منسوخ شده است و به زودی حذف خواهد شد.

گزینه‌های اصلی (Main options)

-f fmt (input/output)

اجبار قالب فایل ورودی یا خروجی. قالب معمولاً برای فایل‌های ورودی به طور خودکار تشخیص داده می‌شود و برای فایل‌های خروجی از پسوند فایل حدس زده می‌شود، بنابراین این گزینه در بیشتر موارد مورد نیاز نیست.

-i url (input)

آدرس یا مسیر فایل ورودی

-y (global)

بازنویسی فایل‌های خروجی بدون پرسش از کاربر.

-n (global)

عدم بازنویسی فایل‌های خروجی، و خروج فوری در صورتی که فایل خروجی مشخص‌شده از قبل وجود داشته باشد.

-stream_loop number (input)

تنظیم تعداد دفعاتی که استریم ورودی باید تکرار (loop) شود. مقدار 0 به معنای عدم تکرار و -1 به معنای حلقه نامحدود است.

-recast_media (global)

امکان اجبار یک دیکودر از نوع رسانه‌ای متفاوت با آنچه توسط دی‌ماکسر شناسایی یا تعیین شده است. برای دیکود کردن داده‌های رسانه‌ای که به عنوان استریم‌های داده ماکس شده‌اند مفید است.

-c[:stream_specifier] codec (input/output,per-stream)

-codec[:stream_specifier] codec (input/output,per-stream)

انتخاب یک انکودر (هنگامی که پیش از یک فایل خروجی استفاده شود) یا یک دیکودر (هنگامی که پیش از یک فایل ورودی استفاده شود) برای یک یا چند استریم. پارامتر codec نام یک دیکودر/انکودر است یا مقدار ویژه "copy" (تنها در خروجی) برای این‌که مشخص کند استریم نباید مجدداً انکود شود.

برای مثال

ffmpeg -i INPUT -map 0 -c:v libx264 -c:a copy OUTPUT

تمام استریم‌های ویدیو را با libx264 انکود کرده و تمام استریم‌های صوتی را کپی می‌کند.

برای هر استریم، آخرین گزینه "c" منطبق اعمال می‌شود، بنابراین

ffmpeg -i INPUT -map 0 -c copy -c:v:1 libx264 -c:a:137 libvorbis OUTPUT

تمامی استریم‌ها را به جز دومین استریم ویدیو (که با libx264 انکود می‌شود) و صد و سی و هشتمین استریم صوتی (که با libvorbis انکود می‌گردد) کپی خواهد کرد.

-t duration (input/output)

هنگامی که به عنوان گزینه ورودی استفاده شود (پیش از "-i")، مدت‌زمان داده خوانده‌شده از فایل ورودی را محدود می‌کند.

هنگامی که به عنوان گزینه خروجی استفاده شود (پیش از آدرس خروجی)، پس از رسیدن مدت‌زمان آن به duration نوشتن خروجی را متوقف می‌سازد.

پارامتر duration باید مشخص‌کننده مدت‌زمان باشد، به بخش Time duration در راهنمای ffmpeg-utils(1) مراجعه کنید.

گزینه‌های -to و -t مانعه‌الجمع هستند و -t اولویت دارد.

-to position (input/output)

توقف نوشتن خروجی یا خواندن ورودی در موقعیت زمانی position. پارامتر position باید مشخص‌کننده مدت‌زمان باشد، به بخش Time duration در راهنمای ffmpeg-utils(1) مراجعه کنید.

گزینه‌های -to و -t مانعه‌الجمع هستند و -t اولویت دارد.

-fs limit_size (output)

تنظیم سقف حجم فایل خروجی بر حسب بایت. پس از فراتر رفتن از این سقف، هیچ بخش داده دیگری نوشته نمی‌شود. حجم فایل خروجی اندکی بیشتر از حجم درخواستی فایل خواهد بود.

-ss position (input/output)

هنگام استفاده به عنوان گزینه ورودی (پیش از "-i")، در فایل ورودی به موقعیت position پرش زمانی (seek) انجام می‌دهد. توجه داشته باشید که در بیشتر قالب‌ها پرش زمانی دقیق ممکن نیست، بنابراین ffmpeg به نزدیک‌ترین نقطه پرش پیش از position می‌رود. هنگام ترنسکدینگ و زمانی که -accurate_seek فعال باشد (پیش‌فرض)، این بخش اضافی میان نقطه پرش و position دیکود شده و دور ریخته می‌شود. هنگام کپی استریم یا زمانی که -noaccurate_seek استفاده شود، حفظ خواهد شد.

هنگام استفاده به عنوان گزینه خروجی (پیش از آدرس خروجی)، ورودی را دیکود کرده اما داده‌ها را دور می‌ریزد تا برچسب‌های زمانی به position برسند.

پارامتر position باید مشخص‌کننده مدت‌زمان باشد، به بخش Time duration در راهنمای ffmpeg-utils(1) مراجعه کنید.

-sseof position (input)

مشابه با گزینه "-ss" اما نسبت به "انتهای فایل". به این معنا که مقادیر منفی نقاط پیش از پایان فایل هستند و 0 دقیقاً در انتهای فایل است.

-isync input_index (input)

تعیین یک ورودی به عنوان منبع همگام‌سازی (sync source).

این گزینه تفاوت میان زمان‌های آغازین ورودی‌های هدف و مرجع را محاسبه کرده و برچسب‌های زمانی فایل هدف را با آن تفاوت آفست می‌دهد. برچسب‌های زمانی منبع دو ورودی برای نتایج مورد انتظار باید از یک منبع ساعت مشتق شوند. اگر "copyts" تنظیم شده باشد، "start_at_zero" نیز باید تنظیم گردد. اگر هر یک از ورودی‌ها فاقد برچسب زمانی آغازین باشند، هیچ تنظیم همگام‌سازی انجام نمی‌گیرد.

مقادیر قابل قبول مواردی هستند که به یک اندیس معتبر ورودی در ffmpeg اشاره دارند. اگر مرجع همگام‌سازی خود اندیس هدف یا -1 باشد، هیچ تنظیمی روی برچسب‌های زمانی هدف صورت نمی‌گیرد. یک مرجع همگام‌سازی نباید خود با هیچ ورودی دیگری همگام شده باشد.

مقدار پیش‌فرض -1 است.

-itsoffset offset (input)

تنظیم آفست زمانی ورودی.

پارامتر offset باید مشخص‌کننده مدت‌زمان باشد، به بخش Time duration در راهنمای ffmpeg-utils(1) مراجعه کنید.

این آفست به برچسب‌های زمانی فایل‌های ورودی اضافه می‌شود. تعیین یک آفست مثبت به این معناست که استریم‌های متناظر به میزان مدت‌زمان تعیین‌شده در offset به تأخیر می‌افتند.

-itsscale scale (input,per-stream)

تغییر مقیاس برچسب‌های زمانی ورودی. پارامتر scale باید یک عدد ممیز شناور باشد.

-timestamp date (output)

تنظیم برچسب زمانی ضبط در کانتینر.

پارامتر date باید مشخص‌کننده تاریخ باشد، به بخش Date در راهنمای ffmpeg-utils(1) مراجعه کنید.

-metadata[:metadata_specifier] key=value (output,per-metadata)

تنظیم یک جفت کلید/مقدار در متادیتا.

پارامتر اختیاری metadata_specifier می‌تواند برای تنظیم متادیتا روی استریم‌ها، فصل‌ها یا برنامه‌ها داده شود. برای جزئیات به مستندات "-map_metadata" مراجعه کنید.

این گزینه بر متادیتای تنظیم‌شده با "-map_metadata" اولویت دارد و آن را لغو می‌کند. همچنین حذف متادیتا با استفاده از یک مقدار خالی امکان‌پذیر است.

برای مثال، جهت تنظیم عنوان در فایل خروجی:

ffmpeg -i in.avi -metadata title="my title" out.flv

جهت تنظیم زبان نخستین استریم صوتی:

ffmpeg -i INPUT -metadata:s:a:0 language=eng OUTPUT

-disposition[:stream_specifier] value (output,per-stream)

تنظیم فلگ‌های وضعیت (disposition) برای یک استریم.

مقدار پیش‌فرض: به طور پیش‌فرض، تمامی فلگ‌های disposition از استریم ورودی کپی می‌شوند، مگر این‌که استریم خروجی که این گزینه بر آن اعمال می‌شود از یک فیلترگراف پیچیده تغذیه شود - در این صورت هیچ فلگی به طور پیش‌فرض تنظیم نمی‌گردد.

پارامتر value دنباله‌ای از فلگ‌های disposition جداشده با '+' یا '-' است. یک پیشوند '+' فلگ داده‌شده را اضافه می‌کند و '-' آن را حذف می‌نماید. اگر فلگ اول نیز دارای پیشوند '+' یا '-' باشد، وضعیت حاصل همان مقدار پیش‌فرض به‌روزشده با value است. اگر فلگ اول پیشوند نداشته باشد، وضعیت حاصل همان value خواهد بود. همچنین می‌توان با تنظیم آن روی 0 وضعیت را پاک کرد.

اگر هیچ گزینه "-disposition" برای یک فایل خروجی مشخص نشده باشد، ffmpeg به طور خودکار فلگ 'default' را روی نخستین استریم از هر نوع تنظیم می‌کند، زمانی که چندین استریم از این نوع در فایل خروجی وجود داشته باشند و هیچ استریمی از آن نوع از قبل به عنوان پیش‌فرض علامت‌گذاری نشده باشد.

گزینه "-dispositions" فلگ‌های disposition شناخته‌شده را فهرست می‌کند.

برای مثال، جهت قرار دادن دومین استریم صوتی به عنوان استریم پیش‌فرض:

ffmpeg -i in.mkv -c copy -disposition:a:1 default out.mkv

جهت پیش‌فرض قرار دادن دومین استریم زیرنویس و حذف وضعیت پیش‌فرض از نخستین استریم زیرنویس:

ffmpeg -i in.mkv -c copy -disposition:s:0 0 -disposition:s:1 default out.mkv

جهت افزودن یک طرح جلد/تصویر بندانگشتی تعبیه‌شده:

ffmpeg -i in.mp4 -i IMAGE -map 0 -map 1 -c copy -c:v:1 png -disposition:v:1 attached_pic out.mp4

جهت افزودن فلگ 'original' و حذف فلگ 'comment' از نخستین استریم صوتی بدون حذف سایر فلگ‌های آن:

ffmpeg -i in.mkv -c copy -disposition:a:0 +original-comment out.mkv

جهت حذف فلگ 'original' و افزودن فلگ 'comment' به نخستین استریم صوتی بدون حذف سایر فلگ‌های آن:

ffmpeg -i in.mkv -c copy -disposition:a:0 -original+comment out.mkv

جهت تنظیم انحصاری فلگ‌های 'original' و 'comment' بر روی نخستین استریم صوتی (و حذف سایر فلگ‌های آن):

ffmpeg -i in.mkv -c copy -disposition:a:0 original+comment out.mkv

جهت حذف تمام فلگ‌های disposition از نخستین استریم صوتی:

ffmpeg -i in.mkv -c copy -disposition:a:0 0 out.mkv

همه ماکسرها از تصاویر بندانگشتی تعبیه‌شده پشتیبانی نمی‌کنند، و آن‌هایی هم که پشتیبانی می‌کنند تنها تعداد معدودی فرمت مانند JPEG یا PNG را می‌پذیرند.

-program [title=title:][program_num=program_num:]st=stream[:st=stream...] (output)

یک برنامه با title و program_num مشخص‌شده ایجاد کرده و stream(های) تعیین‌شده را به آن اضافه می‌کند.

-stream_group [map=input_file_id=stream_group][type=type:]st=stream[:st=stream][:stg=stream_group][:id=stream_group_id...] (output)

یک گروه استریم از type و stream_group_id مشخص‌شده، یا از طریق mapping یک گروه ورودی، و افزودن stream(ها) و/یا stream_group(های) قبلاً تعریف‌شده به آن ایجاد می‌کند.

پارامتر type می‌تواند یکی از موارد زیر باشد:

ffmpeg -i front.wav -i back.wav -i center.wav -i lfe.wav
-map 0:0 -map 1:0 -map 2:0 -map 3:0 -c:a opus
-stream_group type=iamf_audio_element:id=1:st=0:st=1:st=2:st=3,
demixing=parameter_id=998,
recon_gain=parameter_id=101,
layer=ch_layout=stereo,
layer=ch_layout=5.1(side),
-stream_group type=iamf_mix_presentation:id=2:stg=0:annotations=en-us=Mix_Presentation,
submix=parameter_id=100:parameter_rate=48000|element=stg=0:parameter_id=100:annotations=en-us=Scalable_Submix|layout=sound_system=stereo|layout=sound_system=5.1(side)
-streamid 0:0 -streamid 1:1 -streamid 2:2 -streamid 3:3 output.iamf

ffmpeg -i input.iamf -c:a copy -stream_group map=0=0:st=0:st=1:st=2:st=3 -stream_group map=0=1:stg=0
-streamid 0:0 -streamid 1:1 -streamid 2:2 -streamid 3:3 output.mp4

-target type (output)

تعیین نوع فایل هدف ("vcd", "svcd", "dvd", "dv", "dv50"). مقدار type می‌تواند با "pal-", "ntsc-" یا "film-" پیشوندگذاری شود تا استاندارد متناظر را به کار گیرد. تمام گزینه‌های قالب (نرخ بیت، کدک‌ها، اندازه بافرها) به طور خودکار تنظیم می‌شوند. کافی است دستور زیر را وارد کنید:

ffmpeg -i myfile.avi -target vcd /tmp/vcd.mpg

با این وجود می‌توانید گزینه‌های اضافی را مشخص کنید تا زمانی که می‌دانید با استاندارد تداخلی ندارند، مانند:

ffmpeg -i myfile.avi -target vcd -bf 2 /tmp/vcd.mpg

پارامترهای تنظیم‌شده برای هر هدف به شرح زیر هستند.

VCD

<pal>:
-f vcd -muxrate 1411200 -muxpreload 0.44 -packetsize 2324
-s 352x288 -r 25
-codec:v mpeg1video -g 15 -b:v 1150k -maxrate:v 1150k -minrate:v 1150k -bufsize:v 327680
-ar 44100 -ac 2
-codec:a mp2 -b:a 224k

<ntsc>:
-f vcd -muxrate 1411200 -muxpreload 0.44 -packetsize 2324
-s 352x240 -r 30000/1001
-codec:v mpeg1video -g 18 -b:v 1150k -maxrate:v 1150k -minrate:v 1150k -bufsize:v 327680
-ar 44100 -ac 2
-codec:a mp2 -b:a 224k

<film>:
-f vcd -muxrate 1411200 -muxpreload 0.44 -packetsize 2324
-s 352x240 -r 24000/1001
-codec:v mpeg1video -g 18 -b:v 1150k -maxrate:v 1150k -minrate:v 1150k -bufsize:v 327680
-ar 44100 -ac 2
-codec:a mp2 -b:a 224k

SVCD

<pal>:
-f svcd -packetsize 2324
-s 480x576 -pix_fmt yuv420p -r 25
-codec:v mpeg2video -g 15 -b:v 2040k -maxrate:v 2516k -minrate:v 0 -bufsize:v 1835008 -scan_offset 1
-ar 44100
-codec:a mp2 -b:a 224k

<ntsc>:
-f svcd -packetsize 2324
-s 480x480 -pix_fmt yuv420p -r 30000/1001
-codec:v mpeg2video -g 18 -b:v 2040k -maxrate:v 2516k -minrate:v 0 -bufsize:v 1835008 -scan_offset 1
-ar 44100
-codec:a mp2 -b:a 224k

<film>:
-f svcd -packetsize 2324
-s 480x480 -pix_fmt yuv420p -r 24000/1001
-codec:v mpeg2video -g 18 -b:v 2040k -maxrate:v 2516k -minrate:v 0 -bufsize:v 1835008 -scan_offset 1
-ar 44100
-codec:a mp2 -b:a 224k

DVD

<pal>:
-f dvd -muxrate 10080k -packetsize 2048
-s 720x576 -pix_fmt yuv420p -r 25
-codec:v mpeg2video -g 15 -b:v 6000k -maxrate:v 9000k -minrate:v 0 -bufsize:v 1835008
-ar 48000
-codec:a ac3 -b:a 448k

<ntsc>:
-f dvd -muxrate 10080k -packetsize 2048
-s 720x480 -pix_fmt yuv420p -r 30000/1001
-codec:v mpeg2video -g 18 -b:v 6000k -maxrate:v 9000k -minrate:v 0 -bufsize:v 1835008
-ar 48000
-codec:a ac3 -b:a 448k

<film>:
-f dvd -muxrate 10080k -packetsize 2048
-s 720x480 -pix_fmt yuv420p -r 24000/1001
-codec:v mpeg2video -g 18 -b:v 6000k -maxrate:v 9000k -minrate:v 0 -bufsize:v 1835008
-ar 48000
-codec:a ac3 -b:a 448k

DV

<pal>:
-f dv
-s 720x576 -pix_fmt yuv420p -r 25
-ar 48000 -ac 2

<ntsc>:
-f dv
-s 720x480 -pix_fmt yuv411p -r 30000/1001
-ar 48000 -ac 2

<film>:
-f dv
-s 720x480 -pix_fmt yuv411p -r 24000/1001
-ar 48000 -ac 2

هدف "dv50" کاملاً مشابه هدف "dv" است، به جز این‌که فرمت پیکسل برای هر سه استاندارد روی "yuv422p" تنظیم می‌شود.

هر مقدار تعیین‌شده توسط کاربر برای پارامترهای بالا، مقدار پیش‌تنظیم هدف را بازنویسی می‌کند. در این حالت، خروجی ممکن است با استاندارد هدف مطابقت نداشته باشد.

-dn (input/output)

به عنوان یک گزینه ورودی، مانع از فیلتر شدن یا انتخاب خودکار یا نگاشت تمام استریم‌های داده یک فایل برای هر خروجی می‌شود. به گزینه "-discard" برای غیرفعال‌سازی جداگانه استریم‌ها مراجعه کنید.

به عنوان یک گزینه خروجی، ضبط داده را غیرفعال می‌سازد، یعنی از انتخاب خودکار یا نگاشت هر استریم داده جلوگیری می‌کند. برای کنترل کامل دستی به گزینه "-map" مراجعه نمایید.

-dframes number (output)

تنظیم تعداد فریم‌های داده برای خروجی. این یک نام مستعار منسوخ برای "-frames:d" است، که باید به جای آن استفاده شود.

-frames[:stream_specifier] framecount (output,per-stream)

توقف نوشتن در استریم پس از framecount فریم.

-q[:stream_specifier] q (output,per-stream)

-qscale[:stream_specifier] q (output,per-stream)

استفاده از مقیاس کیفیت ثابت (VBR). معنای q/qscale وابسته به کدک است. اگر qscale بدون stream_specifier استفاده شود، تنها بر استریم ویدیو اعمال می‌گردد؛ این امر جهت حفظ سازگاری با رفتار پیشین است و از آنجا که تعیین مقدار مشخص کدک یکسان برای دو کدک مختلف صدا و تصویر عموماً زمانی که هیچ stream_specifier مشخص نشده مد نظر نیست.

-filter[:stream_specifier] filtergraph (output,per-stream)

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

پارامتر filtergraph توصیف فیلترگراف برای اعمال بر روی استریم است، و باید دارای یک ورودی منفرد و یک خروجی منفرد از همان نوع استریم باشد. در فیلترگراف، ورودی به برچسب "in" و خروجی به برچسب "out" متصل است. برای اطلاعات بیشتر درباره قواعد فیلترگراف به راهنمای ffmpeg-filters مراجعه کنید.

اگر می‌خواهید فیلترگراف‌هایی با چندین ورودی و/یا خروجی بسازید، به گزینه -filter_complex مراجعه نمایید.

-reinit_filter[:stream_specifier] integer (input,per-stream)

این گزینه بولی مشخص می‌کند که آیا فیلترگراف(هایی) که این استریم به آن‌ها تغذیه می‌شود در صورت تغییر پارامترهای فریم ورودی در میانه استریم مجدداً راه‌اندازی شوند یا خیر. این گزینه به طور پیش‌فرض فعال است زیرا اکثر فیلترهای ویدیو و تمام فیلترهای صوتی نمی‌توانند انحراف در مشخصات فریم ورودی را مدیریت نمایند. پس از راه‌اندازی مجدد، وضعیت فیلتر موجود از دست می‌رود، مانند مرجع تعداد فریم "n" که در برخی فیلترها موجود است. هر فریمی که در زمان راه‌اندازی مجدد بافر شده باشد از بین می‌رود. مشخصاتی که تغییر آن‌ها سبب راه‌اندازی مجدد می‌شود عبارتند از: برای ویدیو: رزولوشن فریم یا فرمت پیکسل؛ برای صدا: فرمت نمونه، نرخ نمونه‌برداری، تعداد کانال یا چیدمان کانال.

-drop_changed[:stream_specifier] integer (input,per-stream)

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

-filter_threads nb_threads (global)

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

-filter_buffered_frames nb_frames (global)

حداکثر تعداد فریم‌های بافرشده مجاز در یک فیلترگراف را تعیین می‌کند. در شرایط عادی، یک فیلترگراف نباید بیش از چند فریم بافر کند، به ویژه اگر فریم‌ها به صورت متوازن به آن داده شده و از آن خوانده شوند (که رفتار مطلوب در ffmpeg است). با این حال، این گزینه به شما اجازه می‌دهد مجموع فریم‌های بافرشده در تمام پیوندهای یک فیلترگراف را محدود کنید. اگر فریم‌های بیشتری تولید شود، فیلترینگ لغو شده و خطایی بازگردانده می‌شود. مقدار پیش‌فرض 0 است، یعنی بدون محدودیت.

-pre[:stream_specifier] preset_name (output,per-stream)

تعیین پیش‌تنظیم (preset) برای استریم(های) منطبق.

-stats (global)

ثبت آمار و پیشرفت انکود به صورت لاگ سطح "info" (به "-loglevel" مراجعه کنید). به طور پیش‌فرض روشن است، برای غیرفعال‌سازی صریح آن باید "-nostats" را مشخص کنید.

-stats_period time (global)

تنظیم بازه زمانی به‌روزرسانی پیشرفت/آمار انکود. پیش‌فرض 0.5 ثانیه است.

-print_graphs (global)

چاپ جزئیات گراف اجرا در stderr بر اساس قالبی که از طریق -print_graphs_format تنظیم شده است.

-print_graphs_file filename (global)

نوشتن جزئیات گراف اجرا در فایل مشخص‌شده بر اساس قالبی که از طریق -print_graphs_format تنظیم شده است.

-print_graphs_format format (global)

تنظیم قالب خروجی (قالب‌های موجود عبارتند از: default, compact, csv, flat, ini, json, xml, mermaid, mermaidhtml). قالب پیش‌فرض json است.

-progress url (global)

ارسال اطلاعات پیشرفت مناسب برای برنامه‌ها به url.

اطلاعات پیشرفت به صورت دوره‌ای و در پایان فرایند انکود نوشته می‌شوند. این اطلاعات از خطوط "key=value" تشکیل شده است. key تنها از نویسه‌های حرفی-عددی تشکیل می‌شود. آخرین کلید در توالی اطلاعات پیشرفت همواره "progress" با مقدار "continue" یا "end" است.

بازه به‌روزرسانی با استفاده از "-stats_period" تنظیم می‌گردد.

برای مثال، لاگ اطلاعات پیشرفت در stdout:

ffmpeg -progress pipe:1 -i in.mkv out.mkv

-stdin

فعال‌سازی تعامل روی ورودی استاندارد. به طور پیش‌فرض روشن است مگر ورودی استاندارد به عنوان یک ورودی استفاده شده باشد. برای غیرفعال‌سازی صریح تعامل باید "-nostdin" را مشخص کنید.

غیرفعال‌سازی تعامل روی ورودی استاندارد زمانی مفید است که برای مثال ffmpeg در گروه فرایندهای پس‌زمینه اجرا شود. تقریباً همان نتیجه را می‌توان با "ffmpeg ... < /dev/null" به دست آورد اما این کار نیازمند پوسته (shell) است.

-debug_ts (global)

چاپ اطلاعات برچسب زمانی / تاخیر (latency). به طور پیش‌فرض خاموش است. این گزینه عمدتاً برای اهداف آزمایش و اشکال‌زدایی مفید است و قالب خروجی ممکن است از یک نسخه به نسخه دیگر تغییر کند، بنابراین نباید توسط اسکریپت‌های پرتابل استفاده شود.

همچنین به گزینه "-fdebug ts"; مراجعه کنید.

-attach filename (output)

افزودن یک پیوست به فایل خروجی. این قابلیت توسط چند قالب مانند ماتروشکا برای مواردی مانند فونت‌های مورد استفاده در رندر زیرنویس‌ها پشتیبانی می‌شود. پیوست‌ها به عنوان نوع خاصی از استریم پیاده‌سازی شده‌اند، بنابراین این گزینه یک استریم جدید به فایل اضافه خواهد کرد. سپس می‌توان گزینه‌های به‌ازای‌هر‌استریم را روی این استریم به شیوه معمول اعمال کرد. استریم‌های پیوست ایجادشده با این گزینه پس از تمام استریم‌های دیگر ساخته خواهند شد (یعنی پس از استریم‌های ایجادشده با "-map" یا نگاشت‌های خودکار).

توجه داشته باشید که برای ماتروشکا همچنین باید تگ متادیتای mimetype را تنظیم کنید:

ffmpeg -i INPUT -attach DejaVuSans.ttf -metadata:s:2 mimetype=application/x-truetype-font out.mkv

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

-dump_attachment[:stream_specifier] filename (input,per-stream)

استخراج استریم پیوست منطبق در فایلی با نام filename. اگر filename خالی باشد، مقدار تگ متادیتای "filename" استفاده خواهد شد.

برای مثال جهت استخراج نخستین پیوست در فایلی با نام 'out.ttf':

ffmpeg -dump_attachment:t:0 out.ttf -i INPUT

جهت استخراج تمام پیوست‌ها در فایل‌هایی که توسط تگ "filename" تعیین شده‌اند:

ffmpeg -dump_attachment:t "" -i INPUT

نکته فنی -- پیوست‌ها به عنوان extradata کدک پیاده‌سازی شده‌اند، بنابراین از این گزینه در واقع می‌توان برای استخراج extradata از هر استریمی استفاده کرد، نه فقط پیوست‌ها.

گزینه‌های ویدیو (Video Options)

-vframes number (output)

تنظیم تعداد فریم‌های ویدیو برای خروجی. این یک نام مستعار منسوخ برای "-frames:v" است، که باید به جای آن استفاده شود.

-r[:stream_specifier] fps (input/output,per-stream)

تنظیم نرخ فریم (مقدار بر حسب هرتز، کسر یا مخفف).

به عنوان یک گزینه ورودی، هرگونه برچسب زمانی ذخیره‌شده در فایل را نادیده می‌گیرد و در عوض برچسب‌های زمانی را با فرض نرخ فریم ثابت fps تولید می‌نماید. این مشابه گزینه -framerate مورد استفاده برای برخی قالب‌های ورودی مانند image2 یا v4l2 نیست (در نسخه‌های قدیمی‌تر FFmpeg یکسان بود). در صورت شک، به جای گزینه ورودی -r از -framerate استفاده کنید.

به عنوان یک گزینه خروجی:

-fpsmax[:stream_specifier] fps (output,per-stream)

تنظیم حداکثر نرخ فریم (مقدار هرتز، کسر یا مخفف).

هنگامی که نرخ فریم خروجی به صورت خودکار تنظیم شود و بالاتر از این مقدار باشد، نرخ فریم خروجی را محدود (clamp) می‌کند. در پردازش دسته‌ای یا هنگامی که نرخ فریم ورودی به اشتباه بسیار بالا تشخیص داده شود مفید است. نمی‌تواند همراه با "-r" تنظیم گردد. در طول کپی استریم نادیده گرفته می‌شود.

-s[:stream_specifier] size (input/output,per-stream)

تنظیم اندازه فریم.

به عنوان یک گزینه ورودی، این یک میان‌بر برای گزینه اختصاصی video_size است، که توسط برخی دی‌ماکسرها شناسایی می‌شود که اندازه فریم برای آن‌ها یا در فایل ذخیره نشده یا قابل پیکربندی است -- مانند ویدیوی خام یا کارت‌های کپچر ویدیو.

به عنوان یک گزینه خروجی، فیلتر ویدیویی "scale" را به انتهای فیلترگراف متناظر درج می‌کند. لطفاً از فیلتر "scale" مستقیماً برای درج آن در ابتدا یا مکان دیگری استفاده کنید.

فرمت به صورت wxh است (پیش‌فرض - همانند منبع).

-aspect[:stream_specifier] aspect (output,per-stream)

تنظیم نسبت ابعاد نمایش ویدیو که توسط aspect مشخص شده است.

پارامتر aspect می‌تواند یک رشته عدد ممیز شناور، یا رشته‌ای به شکل num:den باشد که در آن num و den صورت و مخرج نسبت ابعاد هستند. برای مثال "4:3"، "16:9"، "1.3333" و "1.7777" مقادیر معتبر آرگومان هستند.

اگر همراه با -vcodec copy استفاده شود، بر نسبت ابعاد ذخیره‌شده در سطح کانتینر تأثیر می‌گذارد، اما بر نسبت ابعاد ذخیره‌شده در فریم‌های انکودشده (در صورت وجود) تأثیری ندارد.

-display_rotation[:stream_specifier] rotation (input,per-stream)

تنظیم متادیتای چرخش ویدیو.

پارامتر rotation یک عدد اعشاری است که میزان چرخش در جهت پادساعت‌گرد (بر حسب درجه) را پیش از نمایش ویدیو مشخص می‌کند.

این گزینه متادیتای تبدیل چرخش/نمایش ذخیره‌شده در فایل (در صورت وجود) را بازنویسی می‌کند. هنگامی که ویدیو در حال ترنسکد شدن است (به جای کپی) و "-autorotate" فعال است، ویدیو در مرحله فیلترینگ چرخانده می‌شود. در غیر این صورت، اگر ماکسر از آن پشتیبانی کند، متادیتا در فایل خروجی نوشته خواهد شد.

اگر گزینه‌های "-display_hflip" و/یا "-display_vflip" داده شوند، پس از چرخش مشخص‌شده توسط این گزینه اعمال می‌گردند.

-display_hflip[:stream_specifier] (input,per-stream)

تنظیم این‌که آیا تصویر در هنگام نمایش باید به صورت افقی معکوس (flip) شود یا خیر.

به گزینه "-display_rotation" برای جزئیات بیشتر مراجعه کنید.

-display_vflip[:stream_specifier] (input,per-stream)

تنظیم این‌که آیا تصویر در هنگام نمایش باید به صورت عمودی معکوس (flip) شود یا خیر.

به گزینه "-display_rotation" برای جزئیات بیشتر مراجعه کنید.

-mastering_display[:stream_specifier] G(%u,%u)B(%u,%u)R(%u,%u)WP(%u,%u)L(%u,%u) (input,per-stream)

تنظیم متادیتای نمایش مسترینگ ویدیو (Mastering display metadata).

پارامتر G(%u,%u)B(%u,%u)R(%u,%u)WP(%u,%u)L(%u,%u) رشته‌ای است که مختصات اصلی نمایش X,Y را برای کانال‌های GBR و نقطه سفید (WP) در واحدهای 0.00002، و مقادیر حداکثر-حداقل درخشندگی (L) را در واحدهای 0.0001 کاندلا بر متر مربع مشخص می‌سازد. این مقادیر اعداد صحیح بدون علامت هستند که صورت یک عدد کسری با مخرج ضمنی 50000 برای GBR و (WP)، و مخرج ضمنی 10000 برای (L) را نشان می‌دهند.

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

-content_light[:stream_specifier] %u,%u (input,per-stream)

تنظیم متادیتای روشنایی محتوای ویدیو (Content light metadata).

مقدار %u,%u رشته‌ای است که حداکثر سطح روشنایی محتوا و حداکثر سطح روشنایی میانگین تصویر را مشخص می‌سازد.

این گزینه متادیتای روشنایی محتوای ذخیره‌شده در فایل (در صورت وجود) را بازنویسی می‌کند.

-vn (input/output)

به عنوان یک گزینه ورودی، مانع از فیلتر شدن یا انتخاب خودکار یا نگاشت تمام استریم‌های ویدیوی یک فایل برای هر خروجی می‌شود. به گزینه "-discard" برای غیرفعال‌سازی جداگانه استریم‌ها مراجعه نمایید.

به عنوان یک گزینه خروجی، ضبط ویدیو را غیرفعال می‌سازد، یعنی از انتخاب خودکار یا نگاشت هر استریم ویدیو جلوگیری می‌کند. برای کنترل کامل دستی به گزینه "-map" مراجعه نمایید.

-vcodec codec (output)

تنظیم کدک ویدیو. این یک نام مستعار برای "-codec:v" است.

-pass[:stream_specifier] n (output,per-stream)

انتخاب شماره مرحله (1 یا 2). برای انجام انکود دو مرحله‌ای ویدیو (two-pass) استفاده می‌شود. آمار ویدیو در مرحله نخست درون یک فایل لاگ ثبت می‌گردد (همچنین به گزینه -passlogfile مراجعه کنید)، و در مرحله دوم آن فایل لاگ برای تولید ویدیو با نرخ بیت دقیقاً درخواستی استفاده می‌شود. در مرحله 1، می‌توانید صدا را غیرفعال کرده و خروجی را روی null قرار دهید، مثال‌ها برای ویندوز و یونیکس:

ffmpeg -i foo.mov -c:v libxvid -pass 1 -an -f rawvideo -y NUL
ffmpeg -i foo.mov -c:v libxvid -pass 1 -an -f rawvideo -y /dev/null

-passlogfile[:stream_specifier] prefix (output,per-stream)

تنظیم پیشوند نام فایل لاگ دو مرحله‌ای به prefix، پیشوند نام فایل پیش‌فرض ``ffmpeg2pass'' است. نام کامل فایل به صورت PREFIX-N.log خواهد بود، که در آن N عددی مختص استریم خروجی است.

-vf filtergraph (output)

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

این یک نام مستعار برای "-filter:v" است، به گزینه -filter مراجعه کنید.

-autorotate

چرخاندن خودکار ویدیو بر اساس متادیتای فایل. به طور پیش‌فرض فعال است، از -noautorotate برای غیرفعال‌سازی آن استفاده کنید.

-autoscale

مقیاس‌بندی خودکار ویدیو بر اساس رزولوشن نخستین فریم. به طور پیش‌فرض فعال است، از -noautoscale برای غیرفعال کردن آن استفاده کنید. هنگامی که autoscale غیرفعال باشد، ممکن است تمام فریم‌های خروجی فیلترگراف دارای رزولوشن یکسانی نباشند و برای برخی انکودرها/ماکسرها نامناسب باشند. بنابراین، غیرفعال کردن آن توصیه نمی‌شود مگر این‌که واقعاً بدانید چه کاری انجام می‌دهید. با مسئولیت خودتان autoscale را غیرفعال کنید.

گزینه‌های پیشرفته ویدیو (Advanced Video options)

-pix_fmt[:stream_specifier] format (input/output,per-stream)

تنظیم فرمت پیکسل. از "-pix_fmts" برای نمایش تمام فرمت‌های پیکسل پشتیبانی‌شده استفاده کنید. اگر فرمت پیکسل انتخاب‌شده قابل انتخاب نباشد، ffmpeg یک هشدار چاپ کرده و بهترین فرمت پیکسل پشتیبانی‌شده توسط انکودر را برمی‌گزیند. اگر pix_fmt با یک "+" پیشوندگذاری شود، چنانچه فرمت پیکسل درخواستی قابل انتخاب نباشد ffmpeg با یک خطا خارج خواهد شد، و تبدیل‌های خودکار درون فیلترگراف‌ها غیرفعال می‌گردند. اگر pix_fmt یک "+" تنها باشد، ffmpeg همان فرمت پیکسل ورودی (یا خروجی گراف) را انتخاب می‌کند و تبدیل‌های خودکار غیرفعال می‌شوند.

-sws_flags flags (input/output)

تنظیم فلگ‌های پیش‌فرض برای کتابخانه libswscale. این فلگ‌ها توسط فیلترهای "scale" درج‌شده خودکار و فیلترهای درون فیلترگراف‌های ساده استفاده می‌شوند، چنانچه در تعریف فیلترگراف لغو نشده باشند.

برای فهرستی از گزینه‌های مقیاس‌بندی به راهنمای ffmpeg-scaler مراجعه کنید.

-rc_override[:stream_specifier] override (output,per-stream)

لغو کنترل نرخ بیت (Rate control override) برای بازه‌های مشخص، با ساختار فهرستی از "int,int,int" جداشده با اسلش. دو مقدار اول شماره‌های فریم آغازین و پایانی هستند، و آخرین مقدار در صورت مثبت بودن ضریب کوانتیزه‌سازی (quantizer) مورد استفاده و در صورت منفی بودن ضریب کیفیت است.

-vstats

ثبت آمار کدگذاری ویدیو در vstats_HHMMSS.log. برای شرح فرمت به بخش قالب فایل vstats مراجعه نمایید.

-vstats_file file

ثبت آمار کدگذاری ویدیو در file. برای شرح فرمت به بخش قالب فایل vstats مراجعه نمایید.

-vstats_version file

تعیین این‌که از کدام نسخه قالب vstats استفاده شود. پیش‌فرض 2 است. برای شرح فرمت به بخش قالب فایل vstats مراجعه نمایید.

-vtag fourcc/tag (output)

اجبار تگ ویدیو/fourcc. این یک نام مستعار برای "-tag:v" است.

-force_key_frames[:stream_specifier] time[,time...] (output,per-stream)

-force_key_frames[:stream_specifier] expr:expr (output,per-stream)

-force_key_frames[:stream_specifier] source (output,per-stream)

-force_key_frames[:stream_specifier] scd_metadata (output,per-stream)

پارامتر force_key_frames می‌تواند آرگومان‌هایی به شکل‌های زیر دریافت کند:

-force_key_frames expr:gte(t,n_forced*5)

-force_key_frames expr:if(isnan(prev_forced_t),gte(t,13),gte(t,prev_forced_t+5))

-apply_cropping[:stream_specifier] source (input,per-stream)

برش خودکار (crop) ویدیو پس از دیکود بر اساس متادیتای فایل. مقدار پیش‌فرض all است.

-copyinkf[:stream_specifier] (output,per-stream)

هنگام انجام کپی استریم، فریم‌های غیرکلیدی موجود در ابتدا را نیز کپی می‌کند.

-init_hw_device type[=name][:device[,key=value...]]

راه‌اندازی یک دستگاه سخت‌افزاری جدید از نوع type با نام name، با استفاده از پارامترهای دستگاه داده‌شده. اگر نامی مشخص نشود نام پیش‌فرضی به صورت "type%d" دریافت خواهد کرد.

معنای device و آرگومان‌های پس از آن وابسته به نوع دستگاه است:

-init_hw_device type[=name]@source

راه‌اندازی یک دستگاه سخت‌افزاری جدید از نوع type با نام name، با اشتقاق آن از دستگاه موجود با نام source.

-init_hw_device list

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

-filter_hw_device name

ارسال دستگاه سخت‌افزاری با نام name به تمام فیلترها در هر فیلترگراف. این می‌تواند برای تنظیم دستگاه جهت آپلود با فیلتر "hwupload"، یا دستگاه جهت نگاشت با فیلتر "hwmap" استفاده شود. سایر فیلترها نیز ممکن است در صورت نیاز به یک دستگاه سخت‌افزاری از این پارامتر بهره گیرند. توجه داشته باشید که این گزینه معمولاً تنها زمانی مورد نیاز است که ورودی از قبل در فریم‌های سخت‌افزاری نباشد - در حالتی که باشد، فیلترها دستگاه مورد نیاز خود را از کانتکست فریم‌هایی که به عنوان ورودی دریافت می‌کنند استخراج خواهند کرد.

این یک تنظیم عمومی است، بنابراین تمامی فیلترها همان دستگاه یکسان را دریافت خواهند کرد.

-hwaccel[:stream_specifier] hwaccel (input,per-stream)

استفاده از شتاب سخت‌افزاری برای دیکود کردن استریم(های) منطبق. مقادیر مجاز hwaccel عبارتند از:

-hwaccel_device[:stream_specifier] hwaccel_device (input,per-stream)

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

این گزینه تنها زمانی معنا دارد که گزینه -hwaccel نیز مشخص شده باشد. این گزینه می‌تواند یا به یک دستگاه موجود ایجادشده با -init_hw_device از طریق نام ارجاع دهد، یا می‌تواند یک دستگاه جدید ایجاد کند به گونه‌ای که گویی -init_hw_device type:hwaccel_device بلافاصله پیش از آن فراخوانی شده است.

-hwaccels

فهرست کردن تمامی مؤلفه‌های شتاب سخت‌افزاری فعال‌شده در این ساخت ffmpeg. در دسترس بودن واقعی در زمان اجرا بستگی به سخت‌افزار و نصب درایور مناسب آن دارد.

-fix_sub_duration_heartbeat[:stream_specifier]

تنظیم یک استریم ویدیویی خروجی خاص به عنوان استریم ضربان قلب (heartbeat) که بر اساس آن، زیرنویس در حال پردازش جاری پس از دریافت یک بسته دسترسی تصادفی، تقسیم شده و ارسال گردد.

این گزینه تأخیر (latency) زیرنویس‌هایی را که هنوز بسته پایانی یا زیرنویس بعدی آن‌ها دریافت نشده است کاهش می‌دهد. به عنوان یک نقص، این کار به احتمال زیاد منجر به تکثیر رویدادهای زیرنویس جهت پوشش کل مدت‌زمان خواهد شد، بنابراین در مواردی که تأخیر ارسال رویداد زیرنویس به خروجی اهمیتی ندارد، این گزینه نباید مورد استفاده قرار گیرد.

برای این‌که این گزینه اثری داشته باشد، لازم است -fix_sub_duration برای استریم زیرنویس ورودی مربوطه تنظیم شده باشد، و همچنین استریم زیرنویس ورودی باید مستقیماً به همان خروجی که استریم heartbeat در آن قرار دارد نگاشت شده باشد.

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

-aframes number (خروجی)

تنظیم تعداد فریم‌های صوتی خروجی. این یک نام مستعار منسوخ‌شده برای "-frames:a" است که باید به جای آن استفاده کنید.

-ar[:stream_specifier] freq (ورودی/خروجی،به‌ازای هر استریم)

تنظیم فرکانس نمونه‌برداری صوتی. برای استریم‌های خروجی، به‌طور پیش‌فرض روی فرکانس استریم ورودی مربوطه تنظیم می‌شود. برای استریم‌های ورودی، این گزینه فقط برای دستگاه‌های ضبط صدا و دی‌ماکسرهای خام معنی دارد و به گزینه‌های دی‌ماکسر مربوطه نگاشت می‌شود.

-aq q (خروجی)

تنظیم کیفیت صدا (وابسته به کدک، VBR). این یک نام مستعار برای -q:a است.

-ac[:stream_specifier] channels (ورودی/خروجی،به‌ازای هر استریم)

تنظیم تعداد کانال‌های صوتی. برای استریم‌های خروجی، به‌طور پیش‌فرض روی تعداد کانال‌های صوتی ورودی تنظیم می‌شود. برای استریم‌های ورودی، این گزینه فقط برای دستگاه‌های ضبط صدا و دی‌ماکسرهای خام معنی دارد و به گزینه‌های دی‌ماکسر مربوطه نگاشت می‌شود.

-an (ورودی/خروجی)

به عنوان یک گزینه ورودی، از فیلتر شدن یا انتخاب خودکار یا نگاشت همه استریم‌های صوتی یک پرونده برای هر خروجی جلوگیری می‌کند. برای غیرفعال کردن استریم‌ها به صورت جداگانه، گزینهٔ "-discard" را ببینید.

به عنوان یک گزینه خروجی، ضبط صدا یعنی انتخاب یا نگاشت خودکار هر استریم صوتی را غیرفعال می‌کند. برای کنترل کامل دستی، گزینهٔ "-map" را ببینید.

-acodec codec (ورودی/خروجی)

تنظیم کدک صوتی. این یک نام مستعار برای "-codec:a" است.

-sample_fmt[:stream_specifier] sample_fmt (خروجی،به‌ازای هر استریم)

تنظیم قالب نمونه صوتی. برای دریافت فهرستی از قالب‌های نمونه پشتیبانی‌شده، از "-sample_fmts" استفاده کنید.

-af filtergraph (خروجی)

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

این یک نام مستعار برای "-filter:a" است، گزینهٔ -filter را ببینید.

گزینه‌های پیشرفتهٔ صدا (Advanced Audio options)

-atag fourcc/tag (خروجی)

اجبار تگ صوتی/fourcc. این یک نام مستعار برای "-tag:a" است.

-ch_layout[:stream_specifier] layout (ورودی/خروجی،به‌ازای هر استریم)

نام مستعار برای "-channel_layout".

-channel_layout[:stream_specifier] layout (ورودی/خروجی،به‌ازای هر استریم)

تنظیم چینش کانال‌های صوتی. برای استریم‌های خروجی، به‌طور پیش‌فرض روی چینش کانال ورودی تنظیم می‌شود. برای استریم‌های ورودی، چینش کانال ورودی را بازنویسی می‌کند. همه رمزگشاها از چینش کانال بازنویسی‌شده پیروی نمی‌کنند. این گزینه همچنین چینش کانال را برای دستگاه‌های ضبط صدا و دی‌ماکسرهای خام تنظیم می‌کند و به گزینهٔ دی‌ماکسر مربوطه نگاشت می‌شود.

-guess_layout_max channels (ورودی،به‌ازای هر استریم)

اگر چینش کانال ورودی نامشخص باشد، فقط در صورتی برای حدس زدن تلاش می‌شود که حداکثر با تعداد کانال‌های مشخص‌شده مطابقت داشته باشد. برای مثال، ۲ به ffmpeg می‌گوید که ۱ کانال را مونو و ۲ کانال را استریو تشخیص دهد، اما ۶ کانال را به عنوان ۵.۱ در نظر نگیرد. مقدار پیش‌فرض تلاش همیشگی برای حدس زدن است. برای غیرفعال کردن کامل حدس زدن از 0 استفاده کنید. استفاده از گزینهٔ "-channel_layout" برای تعیین صریح چینش ورودی نیز حدس زدن را غیرفعال می‌کند.

گزینه‌های زیرنویس (Subtitle options)

-scodec codec (ورودی/خروجی)

تنظیم کدک زیرنویس. این یک نام مستعار برای "-codec:s" است.

-sn (ورودی/خروجی)

به عنوان یک گزینه ورودی، از فیلتر شدن یا انتخاب خودکار یا نگاشت همه استریم‌های زیرنویس یک پرونده برای هر خروجی جلوگیری می‌کند. برای غیرفعال کردن استریم‌ها به صورت جداگانه، گزینهٔ "-discard" را ببینید.

به عنوان یک گزینه خروجی، ضبط زیرنویس یعنی انتخاب یا نگاشت خودکار هر استریم زیرنویس را غیرفعال می‌کند. برای کنترل کامل دستی، گزینهٔ "-map" را ببینید.

گزینه‌های پیشرفتهٔ زیرنویس (Advanced Subtitle options)

-fix_sub_duration

اصلاح مدت‌زمان نمایش زیرنویس‌ها. برای هر زیرنویس، منتظر بسته بعدی در همان استریم می‌ماند و مدت‌زمان اولی را برای جلوگیری از هم‌پوشانی تنظیم می‌کند. این کار برای برخی کدک‌های زیرنویس، به ویژه زیرنویس‌های DVB ضروری است، زیرا مدت‌زمان در بسته اصلی صرفاً یک تخمین تقریبی است و پایان آن در واقع با یک فریم زیرنویس خالی مشخص می‌شود. عدم استفاده از این گزینه در صورت لزوم می‌تواند منجر به مدت‌زمان‌های بیش از حد طولانی یا خرابی در ماکس کردن به دلیل برچسب‌های زمانی غیریکنواخت شود.

توجه داشته باشید که این گزینه خروجی تمام داده‌ها را تا زمان رمزگشایی بسته زیرنویس بعدی به تأخیر می‌اندازد: این امر ممکن است مصرف حافظه و تاخیر را بسیار افزایش دهد.

-canvas_size size

تنظیم اندازه بوم (canvas) مورد استفاده برای رندر کردن زیرنویس‌ها.

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

-map [-]input_file_id[:stream_specifier][:view_specifier][:?] | [linklabel] (خروجی)

ایجاد یک یا چند استریم در پرونده خروجی. این گزینه دو شیوه برای تعیین منبع (یا منابع) داده دارد: شیوه اول یک یا چند استریم را از یک پرونده ورودی (مشخص‌شده با "-i") انتخاب می‌کند، و شیوه دوم خروجی را از یک فیلترگراف پیچیده (مشخص‌شده با "-filter_complex") دریافت می‌کند.

در شیوه اول، برای هر استریم از پرونده ورودی با شناسه input_file_id یک استریم خروجی ایجاد می‌شود. اگر stream_specifier داده شود، فقط آن دسته از استریم‌هایی که با مشخص‌کننده مطابقت دارند استفاده می‌شوند (برای نحو stream_specifier بخش مشخص‌کننده‌های استریم (Stream specifiers) را ببینید).

یک نویسهٔ "-" قبل از شناسه استریم یک نگاشت "منفی" ایجاد می‌کند. این کار استریم‌های منطبق را از نگاشت‌های ایجادشده قبلی غیرفعال و حذف می‌نماید.

یک view_specifier اختیاری می‌تواند پس از مشخص‌کننده استریم قرار گیرد که برای ویدیوی چندنمایی (multiview)، نمای مورد استفاده را مشخص می‌کند. مشخص‌کننده نما می‌تواند یکی از قالب‌های زیر را داشته باشد:

-ignore_unknown

نادیده گرفتن استریم‌های ورودی با نوع ناشناخته به جای خطا دادن در هنگام تلاش برای رونوشت چنین استریم‌هایی.

-copy_unknown

اجازه به رونوشت استریم‌های ورودی با نوع ناشناخته به جای خطا دادن در هنگام تلاش برای رونوشت چنین استریم‌هایی.

-map_metadata[:metadata_spec_out] infile[:metadata_spec_in] (خروجی،به‌ازای هر متاداده)

تنظیم اطلاعات متادادهٔ پرونده خروجی بعدی از infile. توجه داشته باشید که این‌ها نمایه‌های پرونده (بر پایه صفر) هستند، نه نام پرونده‌ها. پارامترهای اختیاری metadata_spec_in/out مشخص می‌کنند کدام متاداده رونوشت شود. یک مشخص‌کننده متاداده می‌تواند قالب‌های زیر را داشته باشد:

ffmpeg -i in.ogg -map_metadata 0:s:0 out.mp3

ffmpeg -i in.mkv -map_metadata:s:a 0:g out.mkv

-map_chapters input_file_index (خروجی)

رونوشت فصل‌ها از پرونده ورودی با نمایه input_file_index به پرونده خروجی بعدی. اگر هیچ نگاشت فصلی مشخص نشود، فصل‌ها از اولین پرونده ورودی دارای حداقل یک فصل رونوشت می‌شوند. از یک نمایه پرونده منفی برای غیرفعال کردن هرگونه رونوشت فصل استفاده کنید.

-benchmark (عمومی)

نمایش اطلاعات محک‌زنی (benchmarking) در پایان عملیات انکود. زمان واقعی، سیستم و کاربر مصرف‌شده و حداکثر مصرف حافظه را نمایش می‌دهد. حداکثر مصرف حافظه در تمام سیستم‌ها پشتیبانی نمی‌شود و در صورت عدم پشتیبانی معمولاً 0 نمایش داده می‌شود.

-benchmark_all (عمومی)

نمایش اطلاعات محک‌زنی در حین عملیات انکود. زمان واقعی، سیستم و کاربر مصرف‌شده در مراحل مختلف (انکود/دیکود صوتی و تصویری) را نمایش می‌دهد.

-timelimit duration (عمومی)

خروج پس از اینکه ffmpeg به میزان duration ثانیه در زمان پردازنده (CPU user time) اجرا شد.

-dump (عمومی)

تخلیه (dump) هر بسته ورودی در خروجی استاندارد خطا (stderr).

-hex (عمومی)

هنگام تخلیه بسته‌ها، بار داده (payload) آن‌ها را نیز به صورت هگزادسیمال تخلیه می‌کند.

-readrate speed (ورودی)

محدود کردن سرعت خواندن ورودی.

مقدار آن یک عدد اعشاری مثبت است که حداکثر مدت‌زمان رسانه (به ثانیه) را نشان می‌دهد که باید در یک ثانیه از زمان واقعی ساعت دیواری خوانده شود. مقدار پیش‌فرض صفر است و نشان‌دهنده عدم اعمال محدودیت بر سرعت خواندن است. مقدار 1 نشان‌دهنده سرعت زمان‌واقعی (real-time) است و معادل "-re" می‌باشد.

عمدتاً برای شبیه‌سازی یک دستگاه ضبط یا استریم زنده ورودی (مثلاً هنگام خواندن از یک پرونده) استفاده می‌شود. هنگامی که ورودی یک دستگاه ضبط واقعی یا استریم زنده است نباید با مقدار کم استفاده شود زیرا ممکن است باعث از دست رفتن بسته‌ها گردد.

این گزینه زمانی که سرعت جریان بسته‌های خروجی اهمیت دارد (مانند پخش زنده)، مفید است.

-re (ورودی)

خواندن ورودی با نرخ فریم بومی آن. این معادل تنظیم "-readrate 1"; است.

-readrate_initial_burst seconds

تنظیم زمان اولیه برای انفجار خواندن (burst)، به ثانیه، که پس از آن -re/-readrate اعمال خواهد شد.

-readrate_catchup speed (ورودی)

اگر ورودی یا خروجی مسدود شده و منجر به عقب افتادن سرعت خواندن واقعی از نرخ تعیین‌شده شود، این نرخ اعمال می‌شود تا ورودی به نرخ تعیین‌شده برسد. نباید از نرخ اصلی خواندن کمتر باشد.

-fps_mode[:stream_specifier] parameter (خروجی،به‌ازای هر استریم)

تنظیم روش همگام‌سازی ویدیو / حالت نرخ فریم.

-frame_drop_threshold parameter

آستانه دور انداختن فریم، که مشخص می‌کند فریم‌های ویدیویی چه مقدار می‌توانند عقب بیفتند پیش از اینکه دور ریخته شوند. بر حسب واحدهای نرخ فریم بیان می‌شود، بنابراین 1.0 معادل یک فریم است. مقدار پیش‌فرض -1.1 است. یک کاربرد احتمالی برای جلوگیری از دور انداختن فریم در هنگام وجود نویز در برچسب‌های زمانی، یا افزایش دقت حذف فریم در صورت وجود برچسب‌های زمانی دقیق است.

-apad parameters (خروجی،به‌ازای هر استریم)

پر کردن (Padding) استریم(های) صوتی خروجی. این همانند اعمال "-af apad"; است. آرگومان یک رشته از پارامترهای فیلتر است که همانند فیلتر "apad" ترکیب شده است. برای اعمال این گزینه، باید "-shortest" برای این خروجی تنظیم شده باشد.

-copyts

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

توجه داشته باشید که بسته به گزینهٔ fps_mode یا پردازش‌های خاص ماکسر (مثلاً در صورتی که گزینهٔ قالب avoid_negative_ts فعال باشد)، برچسب‌های زمانی خروجی ممکن است حتی با انتخاب این گزینه نیز با برچسب‌های زمانی ورودی مغایرت داشته باشند.

-start_at_zero

هنگام استفاده با copyts، برچسب‌های زمانی ورودی را طوری شیفت می‌دهد که از صفر شروع شوند.

این بدان معناست که استفاده از مثلاً "-ss 50"; باعث می‌شود برچسب‌های زمانی خروجی از ۵۰ ثانیه شروع شوند، صرف‌نظر از اینکه پرونده ورودی از چه برچسب زمانی آغاز شده است.

-copytb mode

مشخص کردن چگونگی تنظیم مبنای زمانی (timebase) انکودر هنگام رونوشت استریم. mode یک مقدار عددی صحیح است و می‌تواند یکی از مقادیر زیر باشد:

-enc_time_base[:stream_specifier] timebase (خروجی،به‌ازای هر استریم)

تنظیم مبنای زمانی انکودر. timebase می‌تواند یکی از مقادیر زیر باشد:

-bitexact (ورودی/خروجی)

فعال کردن حالت دقیق بیتی (bitexact) برای (دی)ماکسر و (دیکودر/انکودر).

-shortest (خروجی)

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

توجه داشته باشید که این گزینه ممکن است نیازمند بافر کردن فریم‌ها باشد که باعث ایجاد تأخیر اضافی می‌شود. حداکثر میزان این تأخیر می‌تواند با گزینهٔ "-shortest_buf_duration" کنترل شود.

-shortest_buf_duration duration (خروجی)

گزینهٔ "-shortest" ممکن است هنگام وجود حداقل یک استریم با داده‌های پراکنده (sparse) (یعنی دارای فاصله‌های زمانی بزرگ میان فریم‌ها -- که معمولاً برای زیرنویس‌ها این‌گونه است)، نیاز به بافر کردن حجم زیادی از داده‌ها داشته باشد.

این گزینه حداکثر مدت‌زمان فریم‌های بافرشده را بر حسب ثانیه کنترل می‌کند. مقادیر بزرگتر ممکن است به گزینهٔ "-shortest" اجازه دهد نتایج دقیق‌تری تولید کند، اما مصرف حافظه و تاخیر را افزایش می‌دهد.

مقدار پیش‌فرض ۱۰ ثانیه است.

-dts_delta_threshold threshold

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

اصلاح ناپیوستگی برچسب زمانی که توسط این گزینه فعال می‌شود، تنها برای قالب‌های ورودی اعمال می‌گردد که ناپیوستگی برچسب زمانی را می‌پذیرند (که برای آن‌ها پرچم "AVFMT_TS_DISCONT" فعال است)، مانند MPEG-TS و HLS، و هنگام استفاده از گزینهٔ "-copyts" به‌طور خودکار غیرفعال می‌شود (مگر اینکه سرریز یا دور زدن برچسب زمانی شناسایی شود).

اگر ناپیوستگی برچسب زمانی شناسایی شود که مقدار مطلق آن بزرگتر از threshold باشد، ffmpeg ناپیوستگی را با کاهش/افزایش DTS و PTS فعلی به میزان مقدار دلتای مربوطه برطرف می‌کند.

مقدار پیش‌فرض 10 است.

-dts_error_threshold threshold

آستانه دلتای خطای برچسب زمانی، بیان‌شده به عنوان یک عدد اعشاری از ثانیه‌ها.

اصلاح برچسب زمانی که توسط این گزینه فعال می‌شود، تنها برای قالب‌های ورودی اعمال می‌گردد که ناپیوستگی برچسب زمانی را نمی‌پذیرند (که برای آن‌ها پرچم "AVFMT_TS_DISCONT" فعال نیست).

اگر ناپیوستگی برچسب زمانی شناسایی شود که مقدار مطلق آن بزرگتر از threshold باشد، ffmpeg مقدار برچسب زمانی PTS/DTS را دور می‌اندازد.

مقدار پیش‌فرض "3600*30" (۳۰ ساعت) است که به صورت دلخواه و نسبتاً محافظه‌کارانه انتخاب شده است.

-muxdelay seconds (خروجی)

تنظیم حداکثر تأخیر دی‌ماکس-دیکود.

-muxpreload seconds (خروجی)

تنظیم تأخیر اولیه دی‌ماکس-دیکود.

-streamid output-stream-index:new-value (خروجی)

تخصیص یک مقدار شناسهٔ استریم (stream-id) جدید به یک استریم خروجی. این گزینه باید قبل از نام پرونده خروجی که برای آن اعمال می‌شود مشخص گردد. برای شرایطی که چندین پرونده خروجی وجود دارد، یک streamid می‌تواند به یک مقدار متفاوت تخصیص داده شود.

برای مثال، برای تنظیم PID استریم 0 روی 33 و PID استریم 1 روی 36 برای یک پرونده خروجی mpegts:

ffmpeg -i inurl -streamid 0:33 -streamid 1:36 out.ts

-bsf[:stream_specifier] bitstream_filters (ورودی/خروجی،به‌ازای هر استریم)

اعمال فیلترهای جریان بیتی (Bitstream Filters) به استریم‌های منطبق. فیلترها به محض دریافت هر بسته از دی‌ماکسر (هنگامی که به عنوان گزینه ورودی استفاده شود) یا قبل از ارسال آن به ماکسر (هنگامی که به عنوان گزینه خروجی استفاده شود) اعمال می‌شوند.

bitstream_filters یک فهرست با کاما جداشده از مشخصات فیلتر جریان بیتی است که هر کدام به صورت زیر است:

<filter>[=<optname0>=<optval0>:<optname1>=<optval1>:...]

هر یک از نویسه‌های ',=:' که قرار است بخشی از مقدار یک گزینه باشند باید با یک بک‌اسلش اسکیپ شوند.

برای دریافت فهرست فیلترهای جریان بیتی از گزینهٔ "-bsfs" استفاده کنید.

برای مثال:

ffmpeg -bsf:v h264_mp4toannexb -i h264.mp4 -c:v copy -an out.h264

فیلتر جریان بیتی "h264_mp4toannexb" (که استریم H.264 محصور در MP4 را به Annex B تبدیل می‌کند) را روی استریم ویدیویی ورودی اعمال می‌کند.

از سوی دیگر،

ffmpeg -i file.mov -an -vn -bsf:s mov2textsub -c:s copy -f rawvideo sub.txt

فیلتر جریان بیتی "mov2textsub" (که متن را از زیرنویس‌های MOV استخراج می‌کند) را روی استریم زیرنویس خروجی اعمال می‌کند. توجه داشته باشید که از آنجا که هر دو مثال از "-c copy"; استفاده می‌کنند، اهمیت چندانی ندارد که فیلترها روی ورودی یا خروجی اعمال شوند - این موضوع در صورت ترنسکود کردن تغییر می‌کرد.

-tag[:stream_specifier] codec_tag (ورودی/خروجی،به‌ازای هر استریم)

اجبار تگ/fourcc برای استریم‌های منطبق.

-timecode hh:mm:ssSEPff

مشخص کردن کد زمانی (Timecode) برای نوشتن. SEP برای کد زمانی بدون افت فریم ':' و برای حالت دارای افت فریم (drop) ';' (یا '.') است.

ffmpeg -i input.mpg -timecode 01:02:03.04 -r 30000/1001 -s ntsc output.mpg

-filter_complex filtergraph (عمومی)

تعریف یک فیلترگراف پیچیده، یعنی گراف با تعداد دلخواهی از ورودی‌ها و/یا خروجی‌ها. برای گراف‌های ساده -- آن‌هایی که یک ورودی و یک خروجی از همان نوع دارند -- گزینه‌های -filter را ببینید. filtergraph توضیحی از فیلترگراف است، همان‌طور که در بخش "سینتکس فیلترگراف" در راهنمای ffmpeg-filters توضیح داده شده است. این گزینه می‌تواند چندین بار مشخص شود - هر بار استفاده یک فیلترگراف پیچیده جدید ایجاد می‌کند.

ورودی‌های یک فیلترگراف پیچیده می‌توانند از انواع منابع مختلف بیایند که با قالب برچسب پیوند مربوطه متمایز می‌شوند:

ffmpeg -i video.mkv -i image.png -filter_complex '[0:v][1:v]overlay[out]' -map
'[out]' out.mkv

ffmpeg -i video.mkv -i image.png -filter_complex 'overlay[out]' -map
'[out]' out.mkv

ffmpeg -i video.mkv -i image.png -filter_complex 'overlay' out.mkv

ffmpeg -i input.ts -filter_complex \
  '[#0x2ef] setpts=PTS+1/TB [sub] ; [#0x2d0] [sub] overlay' \
  -sn -map '#0x2dc' output.mkv

ffmpeg -filter_complex 'color=c=red' -t 5 out.mkv

-filter_complex_threads nb_threads (عمومی)

تعداد رشته‌های اجرایی (threads) مورد استفاده برای پردازش گراف filter_complex را مشخص می‌کند. مشابه filter_threads است اما فقط برای گراف‌های "-filter_complex" استفاده می‌شود. مقدار پیش‌فرض تعداد CPUهای موجود است.

-lavfi filtergraph (عمومی)

تعریف یک فیلترگراف پیچیده، یعنی گراف با تعداد دلخواهی از ورودی‌ها و/یا خروجی‌ها. معادل با -filter_complex.

-accurate_seek (ورودی)

این گزینه پرش دقیق (accurate seeking) در پرونده‌های ورودی را با گزینهٔ -ss فعال یا غیرفعال می‌کند. به‌طور پیش‌فرض فعال است، بنابراین پرش هنگام ترنسکود کردن دقیق است. برای غیرفعال کردن آن از -noaccurate_seek استفاده کنید که مثلاً هنگام رونوشت برخی استریم‌ها و انکود مجدد سایرین می‌تواند مفید باشد.

-seek_timestamp (ورودی)

این گزینه پرش بر اساس برچسب زمانی را در پرونده‌های ورودی با گزینهٔ -ss فعال یا غیرفعال می‌کند. به‌طور پیش‌فرض غیرفعال است. در صورت فعال بودن، آرگومان گزینهٔ -ss به عنوان یک برچسب زمانی واقعی در نظر گرفته می‌شود و با زمان شروع پرونده آفست نمی‌شود. این فقط برای پرونده‌هایی که از برچسب زمانی 0 شروع نمی‌شوند، مانند transport streams، تفاوت ایجاد می‌کند.

-thread_queue_size size (ورودی/خروجی)

برای ورودی، این گزینه حداکثر تعداد بسته‌های صف‌بندی‌شده هنگام خواندن از پرونده یا دستگاه را تنظیم می‌کند. در استریم‌های زنده با تاخیر کم / نرخ بالا، بسته‌ها در صورتی که به موقع خوانده نشوند ممکن است دور ریخته شوند؛ تنظیم این مقدار می‌تواند ffmpeg را مجبور کند از یک رشته ورودی جداگانه استفاده کند و بسته‌ها را به محض رسیدن بخواند. به‌طور پیش‌فرض ffmpeg تنها در صورتی این کار را انجام می‌دهد که چندین ورودی مشخص شده باشد.

برای خروجی، این گزینه حداکثر تعداد بسته‌هایی را مشخص می‌کند که ممکن است برای هر رشتهٔ ماکس کردن در صف قرار گیرند.

-sdp_file file (عمومی)

چاپ اطلاعات sdp برای یک استریم خروجی در file. این امکان تخلیه اطلاعات sdp را در حالتی که حداقل یکی از خروجی‌ها استریم rtp نیست فراهم می‌کند (نیازمند آن است که حداقل یکی از قالب‌های خروجی rtp باشد).

-discard (ورودی)

اجازه دور انداختن استریم‌ها یا فریم‌های خاصی از استریم‌ها را می‌دهد. هر استریم ورودی می‌تواند با استفاده از مقدار "all" کاملاً دور انداخته شود، در حالی که دور انداختن انتخابی فریم‌ها از یک استریم در دی‌ماکسر رخ می‌دهد و توسط همه دی‌ماکسرها پشتیبانی نمی‌شود.

-abort_on flags (عمومی)

توقف و لغو عملیات در شرایط مختلف. پرچم‌های زیر در دسترس هستند:

-max_error_rate (عمومی)

کسری از خطاهای رمزگشایی فریم در تمام ورودی‌ها را تنظیم می‌کند که با عبور از آن، ffmpeg کد خروج 69 را بازمی‌گرداند. عبور از این آستانه پردازش را متوقف نمی‌کند. محدوده یک عدد اعشاری بین 0 تا 1 است. پیش‌فرض 2/3 است.

-xerror (عمومی)

توقف و خروج به محض بروز خطا.

-max_muxing_queue_size packets (خروجی،به‌ازای هر استریم)

هنگام ترنسکود استریم‌های صوتی و/یا تصویری، ffmpeg نوشتن در خروجی را تا زمانی که حداقل یک بسته برای هر یک از این استریم‌ها داشته باشد شروع نمی‌کند. در حین انتظار برای این رخداد، بسته‌های استریم‌های دیگر بافر می‌شوند. این گزینه اندازه این بافر را بر حسب بسته برای استریم خروجی منطبق تنظیم می‌کند.

مقدار پیش‌فرض این گزینه برای بیشتر کاربردها باید به اندازه کافی بالا باشد، بنابراین فقط در صورتی که مطمئن هستید به آن نیاز دارید این گزینه را تغییر دهید.

-muxing_queue_data_threshold bytes (خروجی،به‌ازای هر استریم)

این یک حداقل آستانه است که تا پیش از آن اندازه صف ماکس کردن در نظر گرفته نمی‌شود. پیش‌فرض ۵۰ مگابایت به‌ازای هر استریم است و بر اساس اندازه کلی بسته‌های ارائه‌شده به ماکسر محاسبه می‌شود.

-auto_conversion_filters (عمومی)

فعال‌سازی درج خودکار فیلترهای تبدیل قالب در تمام فیلترگراف‌ها، از جمله موارد تعریف‌شده توسط -vf، -af، -filter_complex و -lavfi. اگر مذاکره قالب فیلتر به تبدیل نیاز داشته باشد، مقداردهی اولیه فیلترها با شکست مواجه می‌شود. تبدیل‌ها همچنان می‌توانند با درج دستی فیلتر تبدیل مربوطه (scale, aresample) در گراف انجام شوند. به‌طور پیش‌فرض فعال است؛ برای غیرفعال کردن صریح آن باید "-noauto_conversion_filters" را مشخص کنید.

-bits_per_raw_sample[:stream_specifier] value (خروجی،به‌ازای هر استریم)

اعلام تعداد بیت‌ها به‌ازای هر نمونه خام در استریم خروجی معین برابر با value. توجه داشته باشید که این گزینه اطلاعات ارائه‌شده به انکودر/ماکسر را تنظیم می‌کند و استریم را برای انطباق با این مقدار تغییر نمی‌دهد. تنظیم مقادیری که با ویژگی‌های استریم مطابقت ندارند ممکن است منجر به شکست انکود یا پرونده‌های خروجی نامعتبر شود.

-stats_enc_pre[:stream_specifier] path (خروجی،به‌ازای هر استریم)

-stats_enc_post[:stream_specifier] path (خروجی،به‌ازای هر استریم)

-stats_mux_pre[:stream_specifier] path (خروجی،به‌ازای هر استریم)

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

گزینهٔ -stats_enc_pre اطلاعات مربوط به فریم‌های خام ویدیویی یا صوتی را درست قبل از ارسال آن‌ها برای انکود می‌نویسد، در حالی که -stats_enc_post اطلاعات مربوط به بسته‌های انکودشده را به محض دریافت از انکودر می‌نویسد. گزینهٔ -stats_mux_pre اطلاعات مربوط به بسته‌ها را درست هنگامی که قرار است به ماکسر ارسال شوند می‌نویسد. هر فریم یا بسته یک خط در پرونده مشخص‌شده ایجاد می‌کند. قالب این خط توسط -stats_enc_pre_fmt / -stats_enc_post_fmt / -stats_mux_pre_fmt کنترل می‌شود.

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

-stats_enc_pre_fmt[:stream_specifier] format_spec (خروجی،به‌ازای هر استریم)

-stats_enc_post_fmt[:stream_specifier] format_spec (خروجی،به‌ازای هر استریم)

-stats_mux_pre_fmt[:stream_specifier] format_spec (خروجی،به‌ازای هر استریم)

تعیین قالب خطوط نوشته‌شده با -stats_enc_pre / -stats_enc_post / -stats_mux_pre.

format_spec رشته‌ای است که می‌تواند شامل دستورالعمل‌هایی به شکل {fmt} باشد. مقدار format_spec با بک‌اسلش اسکیپ می‌شود ---- از \{، \} و \\ برای نوشتن نویسه‌های واقعی {, } یا \ در خروجی استفاده کنید.

دستورالعمل‌های داده‌شده با fmt می‌توانند یکی از موارد زیر باشند:

پرونده‌های پیش‌تنظیم (Preset files)

یک پرونده پیش‌تنظیم حاوی توالی‌ای از جفت‌های option=value در هر خط است که مجموعه‌ای از گزینه‌ها را مشخص می‌کند که نوشتن آن‌ها در خط فرمان دشوار یا طولانی خواهد بود. خطوطی که با نویسهٔ هش ('#') آغاز می‌شوند نادیده گرفته شده و برای ارائه توضیحات (کامنت) استفاده می‌شوند. برای نمونه‌ها دایرکتوری presets را در درخت منبع FFmpeg بررسی کنید.

دو نوع پرونده پیش‌تنظیم وجود دارد: پرونده‌های ffpreset و پرونده‌های avpreset.

پرونده‌های ffpreset

پرونده‌های ffpreset با گزینه‌های "vpre"، "apre"، "spre" و "fpre" مشخص می‌شوند. گزینهٔ "fpre" نام پرونده پیش‌تنظیم را به جای نام پیش‌تنظیم به عنوان ورودی می‌گیرد و می‌تواند برای هر نوع کدکی استفاده شود. برای گزینه‌های "vpre"، "apre" و "spre"، گزینه‌های مشخص‌شده در پرونده پیش‌تنظیم برای کدک انتخاب‌شده فعلی از همان نوع اعمال می‌شوند.

آرگومان ارائه‌شده به گزینه‌های پیش‌تنظیم "vpre"، "apre" و "spre"، پرونده پیش‌تنظیم مورد استفاده را بر اساس قواعد زیر شناسایی می‌کند:

ابتدا ffmpeg به دنبال پرونده‌ای به نام arg.ffpreset در دایرکتوری‌های $FFMPEG_DATADIR (در صورت تنظیم)، و $HOME/.ffmpeg، و در datadir تعریف‌شده در زمان پیکربندی (معمولاً PREFIX/share/ffmpeg) یا در یک پوشهٔ ffpresets در کنار فایل اجرایی در win32، به همان ترتیب می‌گردد. برای مثال، اگر آرگومان "libvpx-1080p" باشد، به دنبال پروندهٔ libvpx-1080p.ffpreset خواهد گشت.

اگر چنین پرونده‌ای پیدا نشود، ffmpeg به دنبال پرونده‌ای به نام codec_name-arg.ffpreset در دایرکتوری‌های فوق‌الذکر می‌گردد، که در آن codec_name نام کدکی است که گزینه‌های پرونده پیش‌تنظیم روی آن اعمال خواهد شد. برای مثال، اگر کدک ویدیو را با "-vcodec libvpx"; انتخاب کرده و از "-vpre 1080p"; استفاده کنید، به دنبال پروندهٔ libvpx-1080p.ffpreset می‌گردد.

پرونده‌های avpreset

پرونده‌های avpreset با گزینهٔ "pre" مشخص می‌شوند. عملکرد آن‌ها شبیه به پرونده‌های ffpreset است، اما تنها گزینه‌های خاص انکودر را مجاز می‌دانند. بنابراین، یک جفت option=value که انکودر را مشخص کند نمی‌تواند استفاده شود.

هنگامی که گزینهٔ "pre" مشخص شود، ffmpeg به دنبال پرونده‌هایی با پسوند avpreset. در دایرکتوری‌های $AVCONV_DATADIR (در صورت تنظیم)، و $HOME/.avconv، و در datadir تعریف‌شده در زمان پیکربندی (معمولاً PREFIX/share/ffmpeg)، به همان ترتیب می‌گردد.

ابتدا ffmpeg به دنبال پرونده‌ای به نام codec_name-arg.avpreset در دایرکتوری‌های فوق‌الذکر می‌گردد، که در آن codec_name نام کدکی است که گزینه‌های پرونده پیش‌تنظیم روی آن اعمال خواهد شد. برای مثال، اگر کدک ویدیو را با "-vcodec libvpx"; انتخاب کنید و از "-pre 1080p"; استفاده نمایید، به دنبال پروندهٔ libvpx-1080p.avpreset خواهد گشت.

اگر چنین پرونده‌ای پیدا نشود، ffmpeg به دنبال پرونده‌ای به نام arg.avpreset در همان دایرکتوری‌ها می‌گردد.

قالب پرونده vstats (vstats file format)

گزینه‌های "-vstats" و "-vstats_file" ایجاد پرونده‌ای حاوی آمار درباره خروجی‌های ویدیویی تولیدشده را فعال می‌کنند.

گزینهٔ "-vstats_version" نسخه قالب پرونده تولیدشده را کنترل می‌کند.

در نسخهٔ 1 قالب به صورت زیر است:

frame= <FRAME> q= <FRAME_QUALITY> PSNR= <PSNR> f_size= <FRAME_SIZE> s_size= <STREAM_SIZE>kB time= <TIMESTAMP> br= <BITRATE>kbits/s avg_br= <AVERAGE_BITRATE>kbits/s

در نسخهٔ 2 قالب به صورت زیر است:

out= <OUT_FILE_INDEX> st= <OUT_FILE_STREAM_INDEX> frame= <FRAME_NUMBER> q= <FRAME_QUALITY>f PSNR= <PSNR> f_size= <FRAME_SIZE> s_size= <STREAM_SIZE>kB time= <TIMESTAMP> br= <BITRATE>kbits/s avg_br= <AVERAGE_BITRATE>kbits/s

مقدار مربوط به هر کلید در زیر شرح داده شده است:

avg_br

نرخ بیت میانگین بیان‌شده بر حسب Kbits/s

br

نرخ بیت بیان‌شده بر حسب Kbits/s

frame

شماره فریم انکودشده

out

نمایه پرونده خروجی

PSNR

نسبت بیشینه سیگنال به نویز (Peak Signal to Noise Ratio)

q

کیفیت فریم

f_size

اندازه بسته انکودشده بیان‌شده بر حسب تعداد بایت‌ها

s_size

اندازه استریم بیان‌شده بر حسب KiB

st

نمایه استریم پرونده خروجی

time

زمان بسته

type

نوع تصویر (picture type)

همچنین گزینه‌های -stats_enc را برای روشی جایگزین جهت نمایش آمار انکود ببینید.

ضبط ویدیو و صدا (Video and Audio grabbing)

اگر قالب ورودی و دستگاه را مشخص کنید، ffmpeg می‌تواند صدا و تصویر را مستقیماً ضبط کند:

ffmpeg -f oss -i /dev/dsp -f video4linux2 -i /dev/video0 /tmp/out.mpg

یا با یک منبع صوتی ALSA (ورودی مونو، شناسه کارت 1) به جای OSS:

ffmpeg -f alsa -ac 1 -i hw:1 -f video4linux2 -i /dev/video0 /tmp/out.mpg

توجه داشته باشید که باید منبع ویدیویی و کانال مناسب را قبل از اجرای ffmpeg با یک برنامه‌ی نمایشگر تلویزیون مانند http://linux.bytesex.org/xawtv اثر Gerd Knorr فعال کرده باشید. همچنین باید سطوح ضبط صدا را به درستی با یک میکسر استاندارد تنظیم کنید.

ضبط از X11 (X11 grabbing)

ضبط صفحه نمایش X11 با ffmpeg از طریق:

ffmpeg -f x11grab -video_size cif -framerate 25 -i :0.0 /tmp/out.mpg

مقدار 0.0 شماره display.screen کارساز X11 شماست، همانند متغیر محیطی DISPLAY.

ffmpeg -f x11grab -video_size cif -framerate 25 -i :0.0+10,20 /tmp/out.mpg

مقدار 0.0 شماره display.screen کارساز X11 شماست، همانند متغیر محیطی DISPLAY. مقدار 10 آفست x و 20 آفست y برای ضبط است.

تبدیل قالب پرونده‌های ویدیویی و صوتی (Video and Audio file format conversion)

هر قالب پرونده و پروتکل پشتیبانی‌شده می‌تواند به عنوان ورودی برای ffmpeg استفاده شود:

مثال‌ها:

• می‌توانید از پرونده‌های YUV به عنوان ورودی استفاده کنید:

  ffmpeg -i /tmp/test%d.Y -i /tmp/out.mpg

  از پرونده‌های زیر استفاده خواهد شد:

  /tmp/test0.Y, /tmp/test0.U, /tmp/test0.V,
  /tmp/test1.Y, /tmp/test1.U, /tmp/test1.V, etc...

  پرونده‌های Y از دو برابر وضوح پرونده‌های U و V استفاده می‌کنند. آن‌ها پرونده‌های خام بدون هدر هستند. این پرونده‌ها می‌توانند توسط تمام رمزگشاهای ویدیویی مناسب تولید شوند. اگر ffmpeg نتواند اندازه تصویر را حدس بزند، باید اندازه را با گزینهٔ -s مشخص کنید.

• می‌توانید از یک پرونده خام YUV420P ورودی بگیرید:

  ffmpeg -i /tmp/test.yuv /tmp/out.avi

  پروندهٔ test.yuv پرونده‌ای شامل داده‌های صفحه‌ای (planar) خام YUV است. هر فریم از صفحهٔ Y و به دنبال آن صفحه‌های U و V در نصف وضوح عمودی و افقی تشکیل شده است.

• می‌توانید به یک پرونده خام YUV420P خروجی بگیرید:

  ffmpeg -i mydivx.avi hugefile.yuv

• می‌توانید چندین پرونده ورودی و خروجی تعیین کنید:

  ffmpeg -i /tmp/a.wav -s 640x480 -i /tmp/a.yuv /tmp/a.mpg

  پرونده صوتی a.wav و پرونده ویدیویی خام YUV به نام a.yuv را به پرونده MPEG به نام a.mpg تبدیل می‌کند.

• می‌توانید تبدیلات صوتی و تصویری را همزمان انجام دهید:

  ffmpeg -i /tmp/a.wav -ar 22050 /tmp/a.mp2

  پرونده a.wav را با نرخ نمونه‌برداری 22050 هرتز به صدای MPEG تبدیل می‌کند.

• می‌توانید همزمان به چندین قالب انکود کنید و یک نگاشت از استریم‌های ورودی به استریم‌های خروجی تعریف نمایید:

  ffmpeg -i /tmp/a.wav -map 0:a -b:a 64k /tmp/a.mp2 -map 0:a -b:a 128k /tmp/b.mp2

  پرونده a.wav را با نرخ ۶۴ کیلوبیت به a.mp2 و با نرخ ۱۲۸ کیلوبیت به b.mp2 تبدیل می‌کند. عبارت '-map file:index' مشخص می‌کند کدام استریم ورودی برای هر استریم خروجی استفاده شود، به ترتیب تعریف استریم‌های خروجی.

• می‌توانید VOBهای رمزگشایی‌شده را ترنسکود کنید:

  ffmpeg -i snatch_1.vob -f avi -c:v mpeg4 -b:v 800k -g 300 -bf 2 -c:a libmp3lame -b:a 128k snatch.avi

  این یک مثال متداول ریپ کردن DVD است؛ ورودی یک پرونده VOB است و خروجی یک پرونده AVI با ویدیوی MPEG-4 و صدای MP3. توجه داشته باشید که در این دستور از فریم‌های B استفاده می‌کنیم تا استریم MPEG-4 با DivX5 سازگار باشد، و اندازه GOP برابر با ۳۰۰ است که به معنی یک فریم اینترا در هر ۱۰ ثانیه برای ویدیوی ورودی 29.97 فریم بر ثانیه است. علاوه بر این، استریم صوتی با MP3 انکود شده است بنابراین باید پشتیبانی از LAME را با ارسال "--enable-libmp3lame" به اسکریپت پیکربندی فعال کرده باشید. نگاشت به ویژه برای ترنسکود کردن DVD جهت دریافت زبان صوتی دلخواه بسیار مفید است.

  نکته: برای مشاهده قالب‌های ورودی پشتیبانی‌شده، از "ffmpeg -demuxers" استفاده کنید.

• می‌توانید تصاویر را از یک ویدیو استخراج کنید، یا از چندین تصویر یک ویدیو ایجاد نمایید:

  برای استخراج تصاویر از یک ویدیو:

  ffmpeg -i foo.avi -r 1 -s WxH -f image2 foo-%03d.jpeg

  این دستور یک فریم ویدیویی در هر ثانیه از ویدیو استخراج کرده و آن‌ها را در پرونده‌هایی به نام‌های foo-001.jpeg، foo-002.jpeg و غیره خروجی می‌دهد. تصاویر برای انطباق با مقادیر WxH جدید تغییر اندازه داده می‌شوند.

  اگر می‌خواهید تنها تعداد محدودی فریم استخراج کنید، می‌توانید دستور بالا را در ترکیب با گزینهٔ "-frames:v" یا "-t"، یا در ترکیب با -ss برای شروع استخراج از یک نقطه زمانی خاص استفاده کنید.

  برای ایجاد یک ویدیو از تصاویر متعدد:

  ffmpeg -f image2 -framerate 12 -i foo-%03d.jpeg -s WxH foo.avi

  سینتکس "foo-%03d.jpeg" استفاده از یک عدد ده‌دهی متشکل از سه رقم با پیش‌پرکردن صفر برای بیان شماره توالی را مشخص می‌کند. این همان سینتکس پشتیبانی‌شده توسط تابع printf در زبان C است، اما تنها قالب‌هایی که یک عدد صحیح معمولی را می‌پذیرند مناسب هستند.

  هنگام وارد کردن یک توالی تصویر، -i همچنین از گسترش الگوهای عام شبیه به پوسته (globbing) در داخل خود، با انتخاب گزینهٔ مخصوص image2 یعنی "-pattern_type glob"; پشتیبانی می‌کند.

  برای مثال، جهت ساخت یک ویدیو از نام پرونده‌هایی که با الگوی glob تطبیق دارند: "foo-*.jpeg":

  ffmpeg -f image2 -pattern_type glob -framerate 12 -i 'foo-*.jpeg' -s WxH foo.avi

• می‌توانید چندین استریم از همان نوع را در خروجی قرار دهید:

  ffmpeg -i test1.avi -i test2.avi -map 1:1 -map 1:0 -map 0:1 -map 0:0 -c copy -y test12.nut

  پرونده خروجی حاصل test12.nut شامل چهار استریم اول از پرونده‌های ورودی به ترتیب معکوس خواهد بود.

• برای تحمیل خروجی ویدیوی با نرخ بیت ثابت (CBR):

  ffmpeg -i myfile.avi -b 4000k -minrate 4000k -maxrate 4000k -bufsize 1835k out.m2v

• چهار گزینهٔ lmin، lmax، mblmin و mblmax از واحدهای 'lambda' استفاده می‌کنند، اما می‌توانید از ثابت QP2LAMBDA برای تبدیل آسان از واحدهای 'q' استفاده کنید:

  ffmpeg -i src.ext -lmax 21*QP2LAMBDA dst.ext

نقل‌قول و گریز (Quoting and escaping)

ابزار FFmpeg سازوکار نقل‌قول و گریز (Quoting and Escaping) زیر را به کار می‌گیرد، مگر اینکه صریحاً چیز دیگری مشخص شده باشد. قواعد زیر اعمال می‌شوند:

• ' و \ نویسه‌های ویژه هستند (به ترتیب برای نقل‌قول و گریز/اسکیپ استفاده می‌شوند). علاوه بر آن‌ها، بسته به سینتکس خاصی که اسکیپ و نقل‌قول در آن به کار می‌رود ممکن است نویسه‌های ویژهٔ دیگری نیز وجود داشته باشند.
• یک نویسهٔ ویژه با قرار دادن پیشوند \ قبل از آن اسکیپ می‌شود.
• تمام نویسه‌های محصور میان '' به صورت تحت‌اللفظی (literal) در رشتهٔ پردازش‌شده گنجانده می‌شوند. خود نویسهٔ نقل‌قول ' نمی‌تواند داخل نقل‌قول قرار گیرد، بنابراین ممکن است لازم باشد نقل‌قول را ببندید و آن را اسکیپ کنید.
• فاصله‌های خالی (whitespaces) ابتدایی و انتهایی، مگر اینکه اسکیپ یا در نقل‌قول قرار گرفته باشند، از رشتهٔ پردازش‌شده حذف می‌شوند.

توجه داشته باشید که هنگام استفاده از خط فرمان یا یک اسکریپت، ممکن است لازم باشد یک سطح دوم از اسکیپ کردن را اضافه کنید، که به سینتکس زبان پوسته (shell) مورد استفاده بستگی دارد.

تابع "av_get_token" تعریف‌شده در libavutil/avstring.h می‌تواند برای تجزیه توکنی که بر اساس قواعد تعریف‌شده در بالا نقل‌قول یا اسکیپ شده است استفاده شود.

ابزار tools/ffescape در درخت منبع FFmpeg می‌تواند برای نقل‌قول یا اسکیپ کردن خودکار یک رشته در اسکریپت استفاده شود.

مثال‌ها

• اسکیپ کردن رشتهٔ "Crime d'Amour" شامل نویسهٔ ویژهٔ "'":

  Crime d\'Amour

• رشته بالا شامل یک کوتیشن است، بنابراین هنگام قرار دادن آن در نقل‌قول، "'" باید اسکیپ شود:

  'Crime d'\''Amour'

• گنجاندن فاصله‌های خالی ابتدایی یا انتهایی با استفاده از نقل‌قول:

  '  this string starts and ends with whitespaces  '

• اسکیپ کردن و نقل‌قول می‌توانند با هم ترکیب شوند:

  ' The string '\'string\'' is a string '

• برای گنجاندن یک \ واقعی می‌توانید از اسکیپ کردن یا نقل‌قول استفاده کنید:

  'c:\foo' can be written as c:\\foo

تاریخ (Date)

سینتکس پذیرفته‌شده عبارت است از:

[(YYYY-MM-DD|YYYYMMDD)[T|t| ]]((HH:MM:SS[.m...]]])|(HHMMSS[.m...]]]))[Z]
now

اگر مقدار برابر با "now" باشد، زمان فعلی را می‌گیرد.

زمان به عنوان زمان محلی تفسیر می‌شود مگر اینکه Z به آن اضافه شود، که در این صورت به عنوان UTC در نظر گرفته می‌شود. اگر بخش سال-ماه-روز مشخص نشود، سال-ماه-روز فعلی را در نظر می‌گیرد.

مدت زمان (Time duration)

دو سینتکس پذیرفته‌شده برای بیان مدت زمان وجود دارد:

[-][<HH>:]<MM>:<SS>[.<m>...]

HH تعداد ساعت‌ها، MM تعداد دقیقه‌ها را با حداکثر ۲ رقم، و SS تعداد ثانیه‌ها را با حداکثر ۲ رقم بیان می‌کند. مقدار m در انتها مقدار اعشاری را برای SS بیان می‌نماید.

یا

[-]<S>+[.<m>...][s|ms|us]

S تعداد ثانیه‌ها را همراه با بخش اعشاری اختیاری m بیان می‌کند. پسوندهای اختیاری s، ms یا us به ترتیب نشان‌دهنده تفسیر مقدار بر حسب ثانیه، میلی‌ثانیه یا میکروثانیه هستند.

در هر دو عبارت، علامت اختیاری - نشان‌دهنده مدت زمان منفی است.

مثال‌ها

مثال‌های زیر همگی مدت زمان‌های معتبر هستند:

55

55 ثانیه

0.2

0.2 ثانیه

200ms

200 میلی‌ثانیه، یعنی 0.2s

200000us

200000 میکروثانیه، یعنی 0.2s

12:03:45

12 ساعت و 03 دقیقه و 45 ثانیه

23.189

23.189 ثانیه

اندازه ویدیو (Video size)

اندازه ویدیوی منبع را مشخص می‌کند، می‌تواند رشته‌ای به شکل widthxheight یا نام یکی از اختصارات اندازه باشد.

اختصارات زیر شناخته‌شده هستند:

ntsc

720x480

pal

720x576

qntsc

352x240

qpal

352x288

sntsc

640x480

spal

768x576

film

352x240

ntsc-film

352x240

sqcif

128x96

qcif

176x144

cif

352x288

4cif

704x576

16cif

1408x1152

qqvga

160x120

qvga

320x240

vga

640x480

svga

800x600

xga

1024x768

uxga

1600x1200

qxga

2048x1536

sxga

1280x1024

qsxga

2560x2048

hsxga

5120x4096

wvga

852x480

wxga

1366x768

wsxga

1600x1024

wuxga

1920x1200

woxga

2560x1600

wqsxga

3200x2048

wquxga

3840x2400

whsxga

6400x4096

whuxga

7680x4800

cga

320x200

ega

640x350

hd480

852x480

hd720

1280x720

hd1080

1920x1080

2k

2048x1080

2kflat

1998x1080

2kscope

2048x858

4k

4096x2160

4kflat

3996x2160

4kscope

4096x1716

nhd

640x360

hqvga

240x160

wqvga

400x240

fwqvga

432x240

hvga

480x320

qhd

960x540

2kdci

2048x1080

4kdci

4096x2160

uhd2160

3840x2160

uhd4320

7680x4320

نرخ فریم ویدیو (Video rate)

نرخ فریم ویدیو را مشخص می‌کند که بر حسب تعداد فریم‌های تولیدشده در هر ثانیه بیان می‌شود. باید رشته‌ای در قالب frame_rate_num/frame_rate_den، یک عدد صحیح، یک عدد اعشاری یا یک اختصار معتبر نرخ فریم ویدیو باشد.

اختصارات زیر شناخته‌شده هستند:

ntsc

30000/1001

pal

25/1

qntsc

30000/1001

qpal

25/1

sntsc

30000/1001

spal

25/1

film

24/1

ntsc-film

24000/1001

نسبت ابعاد (Ratio)

یک نسبت می‌تواند به صورت یک عبارت محاسباتی، یا به شکل numerator:denominator بیان شود.

توجه داشته باشید که نسبت با مقدار بی‌نهایت (1/0) یا منفی معتبر در نظر گرفته می‌شود، بنابراین اگر می‌خواهید این مقادیر را مستثنی کنید باید مقدار بازگردانده‌شده را بررسی نمایید.

مقدار تعریف‌نشده می‌تواند با استفاده از رشتهٔ "0:0" بیان شود.

رنگ (Color)

می‌تواند نام یک رنگ همان‌طور که در زیر تعریف شده است (تطبیق غیرحساس به حروف بزرگ و کوچک) یا یک توالی "[0x|#]RRGGBB[AA]" باشد که ممکن است با @ و یک رشته به عنوان مولفهٔ آلفا دنبال شود.

مولفهٔ آلفا ممکن است رشته‌ای متشکل از "0x" و به دنبال آن یک عدد هگزادسیمال یا یک عدد اعشاری بین 0.0 و 1.0 باشد که مقدار شفافیت (opacity) را نشان می‌دهد (0x00 یا 0.0 به معنی کاملاً شفاف، 0xff یا 1.0 به معنی کاملاً مات است). اگر مولفهٔ آلفا مشخص نشود، 0xff در نظر گرفته می‌شود.

رشتهٔ random منجر به یک رنگ تصادفی خواهد شد.

نام‌های رنگ‌های زیر شناخته‌شده هستند:

AliceBlue

0xF0F8FF

AntiqueWhite

0xFAEBD7

Aqua

0x00FFFF

Aquamarine

0x7FFFD4

Azure

0xF0FFFF

Beige

0xF5F5DC

Bisque

0xFFE4C4

Black

0x000000

BlanchedAlmond

0xFFEBCD

Blue

0x0000FF

BlueViolet

0x8A2BE2

Brown

0xA52A2A

BurlyWood

0xDEB887

CadetBlue

0x5F9EA0

Chartreuse

0x7FFF00

Chocolate

0xD2691E

Coral

0xFF7F50

CornflowerBlue

0x6495ED

Cornsilk

0xFFF8DC

Crimson

0xDC143C

Cyan

0x00FFFF

DarkBlue

0x00008B

DarkCyan

0x008B8B

DarkGoldenRod

0xB8860B

DarkGray

0xA9A9A9

DarkGreen

0x006400

DarkKhaki

0xBDB76B

DarkMagenta

0x8B008B

DarkOliveGreen

0x556B2F

Darkorange

0xFF8C00

DarkOrchid

0x9932CC

DarkRed

0x8B0000

DarkSalmon

0xE9967A

DarkSeaGreen

0x8FBC8F

DarkSlateBlue

0x483D8B

DarkSlateGray

0x2F4F4F

DarkTurquoise

0x00CED1

DarkViolet

0x9400D3

DeepPink

0xFF1493

DeepSkyBlue

0x00BFFF

DimGray

0x696969

DodgerBlue

0x1E90FF

FireBrick

0xB22222

FloralWhite

0xFFFAF0

ForestGreen

0x228B22

Fuchsia

0xFF00FF

Gainsboro

0xDCDCDC

GhostWhite

0xF8F8FF

Gold

0xFFD700

GoldenRod

0xDAA520

Gray

0x808080

Green

0x008000

GreenYellow

0xADFF2F

HoneyDew

0xF0FFF0

HotPink

0xFF69B4

IndianRed

0xCD5C5C

Indigo

0x4B0082

Ivory

0xFFFFF0

Khaki

0xF0E68C

Lavender

0xE6E6FA

LavenderBlush

0xFFF0F5

LawnGreen

0x7CFC00

LemonChiffon

0xFFFACD

LightBlue

0xADD8E6

LightCoral

0xF08080

LightCyan

0xE0FFFF

LightGoldenRodYellow

0xFAFAD2

LightGreen

0x90EE90

LightGrey

0xD3D3D3

LightPink

0xFFB6C1

LightSalmon

0xFFA07A

LightSeaGreen

0x20B2AA

LightSkyBlue

0x87CEFA

LightSlateGray

0x778899

LightSteelBlue

0xB0C4DE

LightYellow

0xFFFFE0

Lime

0x00FF00

LimeGreen

0x32CD32

Linen

0xFAF0E6

Magenta

0xFF00FF

Maroon

0x800000

MediumAquaMarine

0x66CDAA

MediumBlue

0x0000CD

MediumOrchid

0xBA55D3

MediumPurple

0x9370D8

MediumSeaGreen

0x3CB371

MediumSlateBlue

0x7B68EE

MediumSpringGreen

0x00FA9A

MediumTurquoise

0x48D1CC

MediumVioletRed

0xC71585

MidnightBlue

0x191970

MintCream

0xF5FFFA

MistyRose

0xFFE4E1

Moccasin

0xFFE4B5

NavajoWhite

0xFFDEAD

Navy

0x000080

OldLace

0xFDF5E6

Olive

0x808000

OliveDrab

0x6B8E23

Orange

0xFFA500

OrangeRed

0xFF4500

Orchid

0xDA70D6

PaleGoldenRod

0xEEE8AA

PaleGreen

0x98FB98

PaleTurquoise

0xAFEEEE

PaleVioletRed

0xD87093

PapayaWhip

0xFFEFD5

PeachPuff

0xFFDAB9

Peru

0xCD853F

Pink

0xFFC0CB

Plum

0xDDA0DD

PowderBlue

0xB0E0E6

Purple

0x800080

Red

0xFF0000

RosyBrown

0xBC8F8F

RoyalBlue

0x4169E1

SaddleBrown

0x8B4513

Salmon

0xFA8072

SandyBrown

0xF4A460

SeaGreen

0x2E8B57

SeaShell

0xFFF5EE

Sienna

0xA0522D

Silver

0xC0C0C0

SkyBlue

0x87CEEB

SlateBlue

0x6A5ACD

SlateGray

0x708090

Snow

0xFFFAFA

SpringGreen

0x00FF7F

SteelBlue

0x4682B4

Tan

0xD2B48C

Teal

0x008080

Thistle

0xD8BFD8

Tomato

0xFF6347

Turquoise

0x40E0D0

Violet

0xEE82EE

Wheat

0xF5DEB3

White

0xFFFFFF

WhiteSmoke

0xF5F5F5

Yellow

0xFFFF00

YellowGreen

0x9ACD32

چینش کانال‌ها (Channel Layout)

چینش کانال‌ها آرایش مکانی کانال‌ها را در یک استریم صوتی چندکاناله مشخص می‌کند. برای مشخص کردن چینش کانال، FFmpeg از سینتکس ویژه‌ای استفاده می‌نماید.

کانال‌های منفرد با یک شناسه همان‌طور که در جدول زیر آمده است مشخص می‌شوند:

FL

جلوی چپ (front left)

FR

جلوی راست (front right)

FC

جلوی مرکز (front center)

LFE

فرکانس پایین / ساب‌ووفر (low frequency)

BL

عقب چپ (back left)

BR

عقب راست (back right)

FLC

جلوی متمایل به چپِ مرکز

FRC

جلوی متمایل به راستِ مرکز

BC

عقب مرکز

SL

سمت چپ (side left)

SR

سمت راست (side right)

TC

بالای مرکز

TFL

بالای جلو چپ

TFC

بالای جلو مرکز

TFR

بالای جلو راست

TBL

بالای عقب چپ

TBC

بالای عقب مرکز

TBR

بالای عقب راست

DL

داون‌میکس چپ

DR

داون‌میکس راست

WL

عریض چپ

WR

عریض راست

SDL

فراگیر مستقیم چپ

SDR

فراگیر مستقیم راست

LFE2

فرکانس پایین ۲

ترکیب‌های استاندارد چینش کانال را می‌توان با شناسه‌های زیر مشخص کرد:

mono

FC

stereo

FL+FR

2.1

FL+FR+LFE

3.0

FL+FR+FC

3.0(back)

FL+FR+BC

4.0

FL+FR+FC+BC

quad

FL+FR+BL+BR

quad(side)

FL+FR+SL+SR

3.1

FL+FR+FC+LFE

5.0

FL+FR+FC+BL+BR

5.0(side)

FL+FR+FC+SL+SR

4.1

FL+FR+FC+LFE+BC

5.1

FL+FR+FC+LFE+BL+BR

5.1(side)

FL+FR+FC+LFE+SL+SR

6.0

FL+FR+FC+BC+SL+SR

6.0(front)

FL+FR+FLC+FRC+SL+SR

3.1.2

FL+FR+FC+LFE+TFL+TFR

hexagonal

FL+FR+FC+BL+BR+BC

6.1

FL+FR+FC+LFE+BC+SL+SR

6.1

FL+FR+FC+LFE+BL+BR+BC

6.1(front)

FL+FR+LFE+FLC+FRC+SL+SR

7.0

FL+FR+FC+BL+BR+SL+SR

7.0(front)

FL+FR+FC+FLC+FRC+SL+SR

7.1

FL+FR+FC+LFE+BL+BR+SL+SR

7.1(wide)

FL+FR+FC+LFE+BL+BR+FLC+FRC

7.1(wide-side)

FL+FR+FC+LFE+FLC+FRC+SL+SR

5.1.2

FL+FR+FC+LFE+BL+BR+TFL+TFR

octagonal

FL+FR+FC+BL+BR+BC+SL+SR

cube

FL+FR+BL+BR+TFL+TFR+TBL+TBR

5.1.4

FL+FR+FC+LFE+BL+BR+TFL+TFR+TBL+TBR

7.1.2

FL+FR+FC+LFE+BL+BR+SL+SR+TFL+TFR

7.1.4

FL+FR+FC+LFE+BL+BR+SL+SR+TFL+TFR+TBL+TBR

7.2.3

FL+FR+FC+LFE+BL+BR+SL+SR+TFL+TFR+TBC+LFE2

9.1.4

FL+FR+FC+LFE+BL+BR+FLC+FRC+SL+SR+TFL+TFR+TBL+TBR

9.1.6

FL+FR+FC+LFE+BL+BR+FLC+FRC+SL+SR+TFL+TFR+TBL+TBR+TSL+TSR

hexadecagonal

FL+FR+FC+BL+BR+BC+SL+SR+WL+WR+TBL+TBR+TBC+TFC+TFL+TFR

binaural

BIL+BIR

downmix

DL+DR

22.2

FL+FR+FC+LFE+BL+BR+FLC+FRC+BC+SL+SR+TC+TFL+TFC+TFR+TBL+TBC+TBR+LFE2+TSL+TSR+BFC+BFL+BFR

یک چینش کانال سفارشی می‌تواند به صورت توالی‌ای از عبارت‌ها که با '+' جدا شده‌اند مشخص شود. هر عبارت می‌تواند یکی از موارد زیر باشد:

•

نام یک کانال منفرد (مانند FL، FR، FC، LFE و غیره)، که هر کدام اختیاری می‌تواند شامل یک نام سفارشی پس از '@' باشد (مانند FL@Left، FR@Right، FC@Center، LFE@Low_Frequency و غیره)

یک چینش کانال استاندارد می‌تواند با موارد زیر مشخص شود:

• نام یک کانال منفرد (مانند FL، FR، FC، LFE و غیره)
• نام یک چینش کانال استاندارد (مانند mono، stereo، 4.0، quad، 5.0 و غیره)
• تعداد کانال‌ها، به صورت ده‌دهی، به همراه 'c' در انتها، که چینش کانال پیش‌فرض را برای آن تعداد کانال ایجاد می‌کند (تابع "av_channel_layout_default" را ببینید). توجه داشته باشید که همه تعداد کانال‌ها چینش پیش‌فرض ندارند.
• تعداد کانال‌ها، به صورت ده‌دهی، به همراه 'C' در انتها، که یک چینش کانال ناشناخته را با تعداد کانال مشخص‌شده ارائه می‌دهد. توجه داشته باشید که همه رشته‌های تعیین چینش کانال از چینش‌های کانال ناشناخته پشتیبانی نمی‌کنند.
• یک ماسک چینش کانال، به صورت هگزادسیمال که با "0x" شروع می‌شود (ماکروهای "AV_CH_*" را در libavutil/channel_layout.h ببینید).

قبل از نسخه 53 کتابخانه libavutil نویسهٔ انتهایی "c" برای مشخص کردن تعداد کانال‌ها اختیاری بود، اما اکنون الزامی است، در حالی که ماسک چینش کانال می‌تواند به صورت یک عدد ده‌دهی نیز مشخص شود (تنها در صورتی که با "c" یا "C" دنبال نشده باشد).

همچنین تابع "av_channel_layout_from_string" تعریف‌شده در libavutil/channel_layout.h را ببینید.