'\" t
.\"     Title: mkvextract
.\"    Author: Moritz Bunkus <moritz@bunkus.org>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 2026-08-24
.\"    Manual: User Commands
.\"    Source: MKVToolNix 101.0
.\"  Language: English
.\"
.TH "MKVEXTRACT" "1" "2026\-08\-24" "MKVToolNix 101\&.0" "User Commands"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
mkvextract \- استخراج قطعه‌ها از فایل‌های ماتروشکا (Matroska(TM)) به فایل‌های دیگر
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBmkvextract\fR\ 'u
\fBmkvextract\fR {source\-filename} {mode1} [options] [extraction\-spec1] [mode2] [options] [extraction\-spec2] [\&...]
.SH "توضیحات (DESCRIPTION)"
.PP
این برنامه بخش‌های مشخصی را از یک فایل
Matroska(TM)
به قالب‌های مفید دیگر استخراج می‌کند\&. اولین آرگومان، نام فایل منبع است که باید یک فایل
Matroska(TM)
باشد\&.
.PP
سایر آرگومان‌ها یا به یک حالت استخراج مشخص تغییر وضعیت می‌دهند، یا گزینه‌های حالت فعال فعلی را تغییر می‌دهند، یا مشخص می‌کنند چه چیزی در کدام فایل استخراج شود\&. در یک فراخوانی mkvextract می‌توان از چندین حالت استفاده کرد که امکان استخراج چندین مورد را در یک نوبت پردازش فراهم می‌کند\&. بیشتر گزینه‌ها فقط در حالت‌های خاصی قابل استفاده هستند و تعداد کمی از گزینه‌ها برای همه حالت‌ها کاربرد دارند\&.
.PP
در حال حاضر استخراج موارد زیر پشتیبانی می‌شود:
قطعه‌ها (tracks)،
برچسب‌ها (tags)،
پیوست‌ها (attachments)،
فصل‌ها (chapters)،
برگه‌های نشانه (CUE sheets)،
مهرهای زمانی (timestamps)
و
نشانه‌ها (cues)\&.
.SS "گزینه‌های عمومی (Common options)"
.PP
گزینه‌های زیر در تمامی حالت‌ها در دسترس هستند و تنها یک بار در این بخش توضیح داده شده‌اند\&.
.PP
\fB\-f\fR, \fB\-\-parse\-fully\fR
.RS 4
حالت تجزیه را روی \*(Aqfull\*(Aq تنظیم می‌کند\&. حالت پیش‌فرض کل فایل را تجزیه نمی‌کند بلکه از عناصر جستجوی فراداده (meta seek) برای یافتن عناصر مورد نیاز در فایل منبع استفاده می‌کند\&. در ۹۹٪ موارد این کار کافی است\&. اما برای فایل‌هایی که فاقد عناصر meta seek هستند یا آسیب دیده‌اند، ممکن است کاربر مجبور به استفاده از این حالت باشد\&. پویش کامل یک فایل می‌تواند چند دقیقه طول بکشد، در حالی که پویش سریع تنها چند ثانیه زمان می‌برد\&.
.RE
.PP
\fB\-\-command\-line\-charset\fR \fIcharacter\-set\fR
.RS 4
مجموعه نویسه‌ای را تعیین می‌کند که رشته‌های ارائه‌شده در خط فرمان از آن تبدیل می‌شوند\&. پیش‌فرض آن مجموعه نویسه‌ای است که توسط محلی‌سازی فعلی سیستم مشخص شده است\&.
.RE
.PP
\fB\-\-output\-charset\fR \fIcharacter\-set\fR
.RS 4
مجموعه نویسه‌ای را تعیین می‌کند که رشته‌های خروجی به آن تبدیل می‌شوند\&. پیش‌فرض آن مجموعه نویسه‌ای است که توسط محلی‌سازی فعلی سیستم مشخص شده است\&.
.RE
.PP
\fB\-r\fR, \fB\-\-redirect\-output\fR \fIfile\-name\fR
.RS 4
تمام پیام‌ها را به جای کنسول در فایل
\fIfile\-name\fR
می‌نویسد\&. هرچند این کار را می‌توان به سادگی با تغییر مسیر خروجی انجام داد، اما در مواردی به این گزینه نیاز است: زمانی که ترمینال خروجی را پیش از نوشتن در فایل دوباره تفسیر می‌کند\&. مجموعه نویسه‌ای که با
\fB\-\-output\-charset\fR
تنظیم شده باشد رعایت می‌شود\&.
.RE
.PP
\fB\-\-no\-bom\fR
.RS 4
به طور معمول، فایل‌های متنی که در یکی از گونه‌های UTF ایجاد و کدگذاری می‌شوند با یک نشانگر ترتیب بایت (BOM) آغاز می‌شوند\&. استفاده از این گزینه، نوشتن آن نشانگر ترتیب بایت را غیرفعال می‌کند\&.
.RE
.PP
\fB\-\-flush\-on\-close\fR
.RS 4
به برنامه دستور می‌دهد که هنگام بستن فایل‌های بازشده برای نوشتن، تمام داده‌های ذخیره‌شده در حافظه را به فضای ذخیره‌سازی منتقل کند (flush)\&. این قابلیت می‌تواند برای جلوگیری از دست رفتن داده‌ها در هنگام قطعی برق یا دور زدن برخی مشکلات در سیستم‌عامل یا درایورها استفاده شود\&. جنبه منفی این است که تسهیم‌سازی طولانی‌تر خواهد شد زیرا mkvmerge پیش از خروج منتظر می‌ماند تا تمام داده‌ها روی فضای ذخیره‌سازی نوشته شوند\&. برای بحث‌های عمیق درباره مزایا و معایب این مورد، گزارش‌های شماره #2469 و #2480 را در سامانه ردیابی باگ MKVToolNix ببینید\&.
.RE
.PP
\fB\-\-ui\-language\fR \fIcode\fR
.RS 4
استفاده از ترجمه‌های زبان
\fIcode\fR
را اجباری می‌کند (برای نمونه \*(Aqde_DE\*(Aq برای ترجمه‌های آلمانی)\&. وارد کردن \*(Aqlist\*(Aq به عنوان
\fIcode\fR
باعث می‌شود برنامه فهرستی از ترجمه‌های موجود را خروجی دهد\&.
.RE
.PP
\fB\-\-abort\-on\-warnings\fR
.RS 4
به برنامه دستور می‌دهد پس از صدور نخستین هشدار متوقف شود\&. کد خروج برنامه برابر با 1 خواهد بود\&.
.RE
.PP
\fB\-\-debug\fR \fItopic\fR
.RS 4
اشکال‌زدایی را برای یک ویژگی خاص فعال می‌کند\&. این گزینه تنها برای توسعه‌دهندگان مفید است\&.
.RE
.PP
\fB\-\-engage\fR \fIfeature\fR
.RS 4
ویژگی‌های آزمایشی را فعال می‌کند\&. فهرستی از ویژگی‌های موجود را می‌توان با
\fBmkvextract \-\-engage list\fR
درخواست کرد\&. این ویژگی‌ها برای استفاده در شرایط عادی در نظر گرفته نشده‌اند\&.
.RE
.PP
\fB\-\-gui\-mode\fR
.RS 4
حالت واسط گرافیکی (GUI) را فعال می‌کند\&. در این حالت ممکن است خطوطی با قالب‌بندی ویژه خروجی داده شوند که به یک واسط گرافیکی کنترل‌کننده اطلاع می‌دهند چه اتفاقی در حال رخ دادن است\&. این پیام‌ها از قالب \*(Aq#GUI#message\*(Aq پیروی می‌کنند\&. این پیام ممکن است با جفت‌های کلید/مقدار همراه باشد، مانند \*(Aq#GUI#message#key1=value1#key2=value2\&...\*(Aq\&. نه این پیام‌ها و نه کلیدها هرگز ترجمه نمی‌شوند و همواره به انگلیسی نمایش می‌یابند\&.
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
فعال کردن پرگویی و نمایش تمامی عناصر مهم
Matroska(TM)
همگام با خوانده شدن آن‌ها\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش اطلاعات نحوه استفاده و خروج\&.
.RE
.PP
\fB\-V\fR, \fB\-\-version\fR
.RS 4
نمایش اطلاعات نسخه و خروج\&.
.RE
.PP
\fB@\fR\fIoptions\-file\&.json\fR
.RS 4
آرگومان‌های اضافی خط فرمان را از فایل
\fIoptions\-file\fR
می‌خواند\&. برای توضیحات کامل درباره قالب‌های پشتیبانی‌شده برای این فایل‌ها، بخش «Option files» را در صفحه راهنمای
\fBmkvmerge\fR(1)
ببینید\&.
.RE
.SS "حالت استخراج قطعه‌ها (Track extraction mode)"
.PP
نحو:
\fBmkvextract \fR\fB\fIsource\-filename\fR\fR\fB \fR\fB\fBtracks\fR\fR\fB \fR\fB[\fIoptions\fR]\fR\fB \fR\fB\fITID1:dest\-filename1\fR\fR\fB \fR\fB[\fITID2:dest\-filename2\fR \&.\&.\&.]\fR
.PP
گزینه‌های خط فرمان زیر برای هر قطعه در حالت استخراج \*(Aqtracks\*(Aq در دسترس هستند\&. آن‌ها باید پیش از مشخصات قطعه‌ای (در زیر ببینید) که قرار است روی آن اعمال شوند، قرار گیرند\&.
.PP
\fB\-c\fR \fIcharacter\-set\fR
.RS 4
مجموعه نویسه‌ای را تعیین می‌کند که قطعه زیرنویس متنی بعدی به آن تبدیل شود\&. تنها در صورتی معتبر است که شناسه قطعه بعدی به یک قطعه زیرنویس متنی اشاره داشته باشد\&. مقدار پیش‌فرض UTF\-8 است\&.
.RE
.PP
\fB\-\-blockadd\fR \fIlevel\fR
.RS 4
تنها BlockAdditions را تا این سطح نگه می‌دارد\&. پیش‌فرض نگه‌داشتن تمامی سطوح است\&. این گزینه تنها بر انواع خاصی از کدک‌ها مانند WAVPACK4 تأثیر می‌گذارد\&.
.RE
.PP
\fB\-\-cuesheet\fR
.RS 4
باعث می‌شود
\fBmkvextract\fR(1)
یک برگه
CUE
را از اطلاعات فصل‌ها و داده‌های برچسب مربوط به قطعهٔ بعدی در فایلی استخراج کند که نام آن همان نام خروجی قطعه همراه با \*(Aq\&.cue\*(Aq است\&.
.RE
.PP
\fB\-\-raw\fR
.RS 4
داده‌های خام را بدون هیچ‌گونه داده‌های ظرف (container) در یک فایل استخراج می‌کند\&. بر خلاف فلگ
\fB\-\-fullraw\fR،
این فلگ باعث نمی‌شود محتویات عنصر
CodecPrivate
در فایل نوشته شوند\&. این حالت با تمامی
CodecIDها
کار می‌کند، حتی مواردی که
\fBmkvextract\fR(1)
در حالت عادی از آن‌ها پشتیبانی نمی‌کند، اما ممکن است فایل‌های حاصل قابل استفاده نباشند\&.
.RE
.PP
\fB\-\-fullraw\fR
.RS 4
داده‌های خام را بدون هیچ‌گونه داده‌های ظرف در یک فایل استخراج می‌کند\&. در صورتی که قطعه حاوی چنین عنصر سرایندی باشد، محتوای عنصر
CodecPrivate
ابتدا در فایل نوشته خواهد شد\&. این حالت با تمامی
CodecIDها
کار می‌کند، حتی مواردی که
\fBmkvextract\fR(1)
در حالت عادی از آن‌ها پشتیبانی نمی‌کند، اما ممکن است فایل‌های حاصل قابل استفاده نباشند\&.
.RE
.PP
\fITID:outname\fR
.RS 4
در صورتی که چنین قطعه‌ای در فایل منبع وجود داشته باشد، باعث استخراج قطعه با شناسه
\fITID\fR
در فایل
\fIoutname\fR
می‌شود\&. این گزینه می‌تواند چندین بار مشخص شود\&. شناسه‌های قطعه همان شناسه‌هایی هستند که توسط گزینه
\fB\-\-identify\fR
در
\fBmkvmerge\fR(1)
خروجی داده می‌شوند\&.
.sp
هر نام خروجی باید تنها یک بار استفاده شود\&. استثنا در این مورد، قطعه‌های RealAudio و RealVideo هستند\&. اگر از یک نام یکسان برای قطعه‌های مختلف استفاده کنید، آن قطعه‌ها در همان فایل ذخیره خواهند شد\&. مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvextract input\&.mkv tracks 0:video\&.h264 2:output\-two\-vobsub\-tracks\&.idx 3:output\-two\-vobsub\-tracks\&.idx
.fi
.if n \{\
.RE
.\}
.RE
.SS "حالت استخراج پیوست‌ها (Attachments extraction mode)"
.PP
نحو:
\fBmkvextract \fR\fB\fIsource\-filename\fR\fR\fB \fR\fB\fBattachments\fR\fR\fB \fR\fB[\fIoptions\fR]\fR\fB \fR\fB\fIAID1:outname1\fR\fR\fB \fR\fB[\fIAID2:outname2\fR \&.\&.\&.]\fR
.PP
\fIAID\fR:\fIoutname\fR
.RS 4
در صورتی که چنین پیوستی در فایل منبع وجود داشته باشد، باعث استخراج پیوست با شناسه
\fIAID\fR
در فایل
\fIoutname\fR
می‌شود\&. اگر
\fIoutname\fR
خالی رها شود، نام خود پیوست در داخل فایل منبع
Matroska(TM)
به جای آن استفاده خواهد شد\&. این گزینه می‌تواند چندین بار مشخص شود\&. شناسه‌های پیوست همان شناسه‌هایی هستند که توسط گزینه
\fB\-\-identify\fR
در
\fBmkvmerge\fR(1)
خروجی داده می‌شوند\&.
.RE
.SS "حالت استخراج فصل‌ها (Chapters extraction mode)"
.PP
نحو:
\fBmkvextract \fR\fB\fIsource\-filename\fR\fR\fB \fR\fB\fBchapters\fR\fR\fB \fR\fB[\fIoptions\fR]\fR\fB \fR\fB\fIoutput\-filename\&.xml\fR\fR
.PP
\fB\-s\fR, \fB\-\-simple\fR
.RS 4
اطلاعات فصل را در قالب ساده مورد استفاده در ابزارهای
OGM
(مانند CHAPTER01=\&.\&.\&., CHAPTER01NAME=\&.\&.\&.) صادر می‌کند\&. در این حالت برخی اطلاعات باید نادیده گرفته شوند\&. حالت پیش‌فرض خروجی دادن فصل‌ها در قالب
XML
است\&.
.RE
.PP
\fB\-\-simple\-language\fR \fIlanguage\fR
.RS 4
اگر قالب ساده فعال باشد،
\fBmkvextract\fR(1)
تنها یک ورودی منفرد برای هر اتم فصل یافت‌شده خروجی می‌دهد، حتی اگر یک اتم فصل شامل بیش از یک نام فصل باشد\&. به طور پیش‌فرض
\fBmkvextract\fR(1)
نخستین نام فصل یافت‌شده برای هر اتم را صرف‌نظر از زبان آن استفاده می‌کند\&.
.sp
استفاده از این گزینه به کاربر امکان می‌دهد تعیین کند که در صورت وجود بیش از یک نام برای هر اتم فصل، کدام نام‌های فصل خروجی داده شوند\&. پارامتر
\fIlanguage\fR
باید یک کد ISO 639\-1 یا ISO 639\-2 باشد\&.
.RE
.PP
فصل‌ها در فایل خروجی مشخص‌شده نوشته می‌شوند\&. به طور پیش‌فرض از قالب
XML
که برای
\fBmkvmerge\fR(1)
قابل فهم است استفاده می‌شود\&. اگر هیچ فصلی در فایل یافت نشود، فایل خروجی ایجاد نمی‌گردد\&.
.SS "حالت استخراج برچسب‌ها (Tags extraction mode)"
.PP
نحو:
\fBmkvextract \fR\fB\fIsource\-filename\fR\fR\fB \fR\fB\fBtags\fR\fR\fB \fR\fB[\fIoptions\fR]\fR\fB \fR\fB\fIoutput\-filename\&.xml\fR\fR
.PP
\fB\-T\fR, \fB\-\-no\-track\-tags\fR
.RS 4
تنها برچسب‌هایی را صادر می‌کند که مختص به قطعه نیستند\&.
.RE
.PP
برچسب‌ها در قالب
XML
قابل فهم برای
\fBmkvmerge\fR(1)
در فایل خروجی مشخص‌شده نوشته می‌شوند\&. اگر هیچ برچسبی در فایل یافت نشود، فایل خروجی ایجاد نخواهد شد\&.
.SS "حالت استخراج برگه نشانه (Cue sheet extraction mode)"
.PP
نحو:
\fBmkvextract \fR\fB\fIsource\-filename\fR\fR\fB \fR\fB\fBcuesheet\fR\fR\fB \fR\fB[\fIoptions\fR]\fR\fB \fR\fB\fIoutput\-filename\&.cue\fR\fR
.PP
برگه نشانه در فایل خروجی مشخص‌شده نوشته می‌شود\&. اگر هیچ فصل یا برچسبی در فایل یافت نشود، فایل خروجی ایجاد نخواهد شد\&.
.SS "حالت استخراج مهر زمانی (Timestamp extraction mode)"
.PP
نحو:
\fBmkvextract \fR\fB\fIsource\-filename\fR\fR\fB \fR\fB\fBtimestamps_v2\fR\fR\fB \fR\fB[\fIoptions\fR]\fR\fB \fR\fB\fITID1:dest\-filename1\fR\fR\fB \fR\fB[\fITID2:dest\-filename2\fR \&.\&.\&.]\fR
.PP
\fITID:outname\fR
.RS 4
در صورتی که چنین قطعه‌ای در فایل منبع وجود داشته باشد، باعث استخراج مهرهای زمانی برای قطعه با شناسه
\fITID\fR
در فایل
\fIoutname\fR
می‌شود\&. این گزینه می‌تواند چندین بار مشخص شود\&. شناسه‌های قطعه همان شناسه‌هایی هستند که توسط گزینه
\fB\-\-identify\fR
در
\fBmkvmerge\fR(1)
خروجی داده می‌شوند\&.
.sp
مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvextract input\&.mkv timestamps_v2 1:ts\-track1\&.txt 2:ts\-track2\&.txt
.fi
.if n \{\
.RE
.\}
.RE
.SS "حالت استخراج نشانه‌ها (Cues extraction mode)"
.PP
نحو:
\fBmkvextract \fR\fB\fIsource\-filename\fR\fR\fB \fR\fB\fBcues\fR\fR\fB \fR\fB[\fIoptions\fR]\fR\fB \fR\fB\fITID1:dest\-filename1\fR\fR\fB \fR\fB[\fITID2:dest\-filename2\fR \&.\&.\&.]\fR
.PP
\fITID:dest\-filename\fR
.RS 4
در صورتی که چنین قطعه‌ای در فایل منبع وجود داشته باشد، باعث استخراج نشانه‌ها برای قطعه با شناسه
\fITID\fR
در فایل
\fIoutname\fR
می‌شود\&. این گزینه می‌تواند چندین بار مشخص شود\&. شناسه‌های قطعه همان شناسه‌هایی هستند که توسط گزینه
\fB\-\-identify\fR
در
\fBmkvmerge\fR(1)
خروجی داده می‌شوند و نه اعدادی که در عنصر
CueTrack
قرار دارند\&.
.RE
.PP
قالب خروجی یک قالب متنی ساده است: یک خط به ازای هر عنصر
CuePoint
با جفت‌های
key=value
(کلید=مقدار)\&. اگر یک عنصر اختیاری در یک
CuePoint
وجود نداشته باشد (مانند
CueDuration)،
یک خط تیره به عنوان مقدار خروجی داده خواهد شد\&.
.PP
مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
timestamp=00:00:13\&.305000000 duration=\- cluster_position=757741 relative_position=11
.fi
.if n \{\
.RE
.\}
.PP
کلیدهای ممکن عبارتند از:
.PP
timestamp
.RS 4
مهر زمانی نقطه نشانه با دقت نانوثانیه\&. قالب آن
HH:MM:SS\&.nnnnnnnnn
است\&. این عنصر همیشه تنظیم شده است\&.
.RE
.PP
duration
.RS 4
مدت زمان نقطه نشانه با دقت نانوثانیه\&. قالب آن
HH:MM:SS\&.nnnnnnnnn
است\&.
.RE
.PP
cluster_position
.RS 4
موقعیت مطلق بر حسب بایت در داخل فایل
Matroska(TM)
که خوشه‌ای (cluster) که حاوی عنصر ارجاع‌شده است از آنجا آغاز می‌شود\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته\fR
.ps -1
.br
در داخل فایل
Matroska(TM)،
عنصر
CueClusterPosition
نسبت به آفست شروع داده‌های قطعه (segment) محاسبه می‌شود\&. با این حال، مقدار خروجی حالت استخراج نشانه در
\fBmkvextract\fR(1)
از قبل شامل آن آفست بوده و یک آفست مطلق از ابتدای فایل است\&.
.sp .5v
.RE
.RE
.PP
relative_position
.RS 4
موقعیت نسبی بر حسب بایت در داخل خوشه که عنصر
BlockGroup
یا
SimpleBlock
مورد ارجاع نقطه نشانه از آنجا آغاز می‌شود\&.
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBنکته\fR
.ps -1
.br
در داخل فایل
Matroska(TM)،
عنصر
CueRelativePosition
نسبت به آفست شروع داده‌های خوشه است\&. با این حال، مقدار خروجی حالت استخراج نشانه در
\fBmkvextract\fR(1)
نسبت به شناسه خوشه است\&. موقعیت مطلق در داخل فایل را می‌توان با جمع زدن
cluster_position
و
relative_position
محاسبه کرد\&.
.sp .5v
.RE
.RE
.PP
مثال:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvextract input\&.mkv cues 1:cues\-track1\&.txt 2:cues\-track2\&.txt
.fi
.if n \{\
.RE
.\}
.SH "مثال‌ها (EXAMPLES)"
.PP
استخراج همزمان فصل‌ها و برچسب‌ها در قالب‌های
XML
مربوطه:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvextract movie\&.mkv chapters movie\-chapters\&.xml tags movie\-tags\&.xml
.fi
.if n \{\
.RE
.\}
.PP
استخراج همزمان چند قطعه و مهرهای زمانی مربوط به آن‌ها:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvextract "Another Movie\&.mkv" tracks 0:video\&.h265 "1:main audio\&.aac" "2:director\*(Aqs comments\&.aac" timestamps_v2 "0:timestamps video\&.txt" "1:timestamps main audio\&.txt" "2:timestamps director\*(Aqs comments\&.txt"
.fi
.if n \{\
.RE
.\}
.PP
استخراج فصل‌ها در قالب Ogg/OGM و تبدیل مجدد کدگذاری یک قطعه زیرنویس متنی به یک مجموعه نویسه دیگر:
.sp
.if n \{\
.RS 4
.\}
.nf
$ mkvextract "My Movie\&.mkv" chapters \-\-simple "My Chapters\&.txt" tracks \-c MS\-ANSI "2:My Subtitles\&.srt"
.fi
.if n \{\
.RE
.\}
.SH "فایل‌های متنی و تبدیل مجموعه‌های نویسه (TEXT FILES AND CHARACTER SET CONVERSIONS)"
.PP
برای بررسی دقیق درباره نحوه مدیریت تبدیل مجموعه‌های نویسه، کدگذاری ورودی/خروجی، کدگذاری خط فرمان و کدگذاری کنسول در تمامی ابزارهای مجموعه MKVToolNix، لطفاً بخشی با همین نام را در صفحه راهنمای
\fBmkvmerge\fR(1)
مشاهده کنید\&.
.SH "قالب‌های فایل خروجی (OUTPUT FILE FORMATS)"
.PP
تصمیم‌گیری درباره قالب خروجی بر اساس نوع قطعه انجام می‌شود، نه بر اساس پسوند به‌کاررفته برای نام فایل خروجی\&. در حال حاضر انواع قطعه‌های زیر پشتیبانی می‌شوند:
.PP
A_AAC/MPEG2/*, A_AAC/MPEG4/*, A_AAC
.RS 4
تمامی فایل‌های
AAC
در یک فایل
AAC
همراه با سرایندهای
ADTS
پیش از هر بسته نوشته می‌شوند\&. سرایندهای
ADTS
شامل فیلد منسوخ‌شده emphasis نخواهند بود\&.
.RE
.PP
A_AC3, A_EAC3
.RS 4
این موارد به صورت فایل‌های خام
AC\-3
استخراج خواهند شد\&.
.RE
.PP
A_ALAC
.RS 4
قطعه‌های
ALAC
در فایل‌های
CAF
نوشته می‌شوند\&.
.RE
.PP
A_DTS
.RS 4
این موارد به صورت فایل‌های خام
DTS
استخراج خواهند شد\&.
.RE
.PP
A_FLAC
.RS 4
قطعه‌های
FLAC
در فایل‌های خام
FLAC
نوشته می‌شوند\&.
.RE
.PP
A_MPEG/L2
.RS 4
جریان‌های صوتی MPEG\-1 Audio Layer II به صورت فایل‌های خام
MP2
استخراج می‌شوند\&.
.RE
.PP
A_MPEG/L3
.RS 4
این موارد به صورت فایل‌های خام
MP3
استخراج می‌شوند\&.
.RE
.PP
A_OPUS
.RS 4
قطعه‌های
Opus(TM)
در فایل‌های
OggOpus(TM)
نوشته می‌شوند\&.
.RE
.PP
A_PCM/INT/LIT, A_PCM/INT/BIG
.RS 4
داده‌های خام
PCM
در یک فایل
WAV
نوشته می‌شوند\&. داده‌های عددی صحیح با ترتیب بایت big\-endian در این فرآیند به little\-endian تبدیل خواهند شد\&.
.RE
.PP
A_REAL/*
.RS 4
قطعه‌های
RealAudio(TM)
در فایل‌های
RealMedia(TM)
نوشته می‌شوند\&.
.RE
.PP
A_TRUEHD, A_MLP
.RS 4
این موارد به صورت فایل‌های خام
TrueHD/MLP
استخراج خواهند شد\&.
.RE
.PP
A_TTA1
.RS 4
قطعه‌های
TrueAudio(TM)
در فایل‌های
TTA
نوشته می‌شوند\&. لطفاً توجه داشته باشید که به دلیل دقت محدود مهر زمانی در
Matroska(TM)،
سرایند فایل استخراج‌شده در دو فیلد متفاوت خواهد بود:
\fIdata_length\fR
(تعداد کل نمونه‌ها در فایل) و
CRC\&.
.RE
.PP
A_VORBIS
.RS 4
صدای Vorbis در یک فایل
OggVorbis(TM)
نوشته خواهد شد\&.
.RE
.PP
A_WAVPACK4
.RS 4
قطعه‌های
WavPack(TM)
در فایل‌های
WV
نوشته می‌شوند\&.
.RE
.PP
S_HDMV/PGS
.RS 4
زیرنویس‌های
PGS
به صورت فایل‌های
SUP
نوشته می‌شوند\&.
.RE
.PP
S_HDMV/TEXTST
.RS 4
زیرنویس‌های
TextST
به عنوان یک قالب فایل ویژه که برای
\fBmkvmerge\fR(1)
و
\fBmkvextract\fR(1)
ابداع شده نوشته خواهند شد\&.
.RE
.PP
S_KATE
.RS 4
جریان‌های
Kate(TM)
درون یک ظرف
Ogg(TM)
نوشته می‌شوند\&.
.RE
.PP
S_TEXT/SSA, S_TEXT/ASS, S_SSA, S_ASS
.RS 4
زیرنویس‌های متنی
SSA
و
ASS
به ترتیب به عنوان فایل‌های
SSA/ASS
نوشته می‌شوند\&.
.RE
.PP
S_TEXT/UTF8, S_TEXT/ASCII
.RS 4
زیرنویس‌های متنی ساده به صورت فایل‌های
SRT
نوشته می‌شوند\&.
.RE
.PP
S_VOBSUB
.RS 4
زیرنویس‌های
VobSub(TM)
به صورت فایل‌های
SUB
به همراه فایل‌های نمایه مربوطه، به عنوان فایل‌های
IDX
نوشته می‌شوند\&.
.RE
.PP
S_TEXT/USF
.RS 4
زیرنویس‌های متنی
USF
به عنوان فایل‌های
USF
نوشته می‌شوند\&.
.RE
.PP
S_TEXT/WEBVTT
.RS 4
زیرنویس‌های متنی
WebVTT
به صورت فایل‌های
WebVTT
نوشته می‌شوند\&.
.RE
.PP
V_MPEG1, V_MPEG2
.RS 4
قطعه‌های ویدیویی
MPEG\-1
و
MPEG\-2
به صورت جریان‌های ابتدایی
MPEG
نوشته خواهند شد\&.
.RE
.PP
V_MPEG4/ISO/AVC
.RS 4
قطعه‌های ویدیویی
H\&.264
/
AVC
در جریان‌های ابتدایی
H\&.264
نوشته می‌شوند که می‌توان آن‌ها را مثلاً با
MP4Box(TM)
از بسته
GPAC(TM)
بیشتر پردازش کرد\&.
.RE
.PP
V_MPEG4/ISO/HEVC
.RS 4
قطعه‌های ویدیویی
H\&.265
/
HEVC
در جریان‌های ابتدایی
H\&.265
نوشته می‌شوند که می‌توان آن‌ها را مثلاً با
MP4Box(TM)
از بسته
GPAC(TM)
بیشتر پردازش کرد\&.
.RE
.PP
V_MS/VFW/FOURCC
.RS 4
قطعه‌های ویدیویی با نرخ فریم ثابت (Fixed
FPS)
دارای این
CodecID
در فایل‌های
AVI
نوشته می‌شوند\&.
.RE
.PP
V_REAL/*
.RS 4
قطعه‌های
RealVideo(TM)
در فایل‌های
RealMedia(TM)
نوشته می‌شوند\&.
.RE
.PP
V_THEORA
.RS 4
جریان‌های
Theora(TM)
درون یک ظرف
Ogg(TM)
نوشته می‌شوند\&.
.RE
.PP
V_VP8, V_VP9
.RS 4
قطعه‌های
VP8
/
VP9
در فایل‌های
IVF
نوشته می‌شوند\&.
.RE
.PP
برچسب‌ها (Tags)
.RS 4
برچسب‌ها به یک قالب
XML
تبدیل می‌شوند\&. این قالب همان قالبی است که
\fBmkvmerge\fR(1)
برای خواندن برچسب‌ها پشتیبانی می‌کند\&.
.RE
.PP
پیوست‌ها (Attachments)
.RS 4
پیوست‌ها به همان صورتی که هستند در فایل خروجی نوشته می‌شوند\&. هیچ‌گونه تبدیلی انجام نمی‌گیرد\&.
.RE
.PP
فصل‌ها (Chapters)
.RS 4
فصل‌ها به یک قالب
XML
تبدیل می‌شوند\&. این قالب همان قالبی است که
\fBmkvmerge\fR(1)
برای خواندن فصل‌ها پشتیبانی می‌کند\&. از طرف دیگر، یک نسخه خلاصه‌شده را می‌توان در قالب ساده به سبک
OGM
خروجی گرفت\&.
.RE
.PP
مهرهای زمانی (Timestamps)
.RS 4
مهرهای زمانی ابتدا مرتب شده و سپس به عنوان فایلی سازگار با قالب timestamp v2 آماده برای ارائه به
\fBmkvmerge\fR(1)
خروجی داده می‌شوند\&. استخراج به سایر قالب‌ها (v1، v3 و v4) پشتیبانی نمی‌شود\&.
.RE
.SH "کدهای خروج (EXIT CODES)"
.PP
دستور
\fBmkvextract\fR(1)
با یکی از سه کد خروج زیر به کار خود پایان می‌دهد:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB0\fR
\-\- این کد خروج به این معناست که استخراج با موفقیت به پایان رسیده است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB1\fR
\-\- در این حالت
\fBmkvextract\fR(1)
حداقل یک هشدار صادر کرده است، اما استخراج ادامه یافته است\&. هشدارها با پیشوند متنی \*(AqWarning:\*(Aq مشخص می‌شوند\&. بسته به نوع مشکل، فایل‌های حاصل ممکن است سالم باشند یا خیر\&. مؤکداً به کاربر توصیه می‌شود هم هشدارها و هم فایل‌های حاصل را بررسی کند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB2\fR
\-\- این کد خروج پس از وقوع خطا استفاده می‌شود\&.
\fBmkvextract\fR(1)
بلافاصله پس از نمایش پیام خطا متوقف می‌شود\&. پیام‌های خطا گستره‌ای از آرگومان‌های اشتباه در خط فرمان تا خطاهای خواندن/نوشتن و فایل‌های آسیب‌دیده را در بر می‌گیرند\&.
.RE
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.PP
دستور
\fBmkvextract\fR(1)
از متغیرهای پیش‌فرضی که تعیین‌کننده محلی‌سازی سیستم هستند (مانند
\fILANG\fR
و خانواده
\fILC_*\fR)
استفاده می‌کند\&. متغیرهای اضافی:
.PP
\fIMKVEXTRACT_DEBUG\fR, \fIMKVTOOLNIX_DEBUG\fR و شکل کوتاه آن \fIMTX_DEBUG\fR
.RS 4
محتوای آن به گونه‌ای تلقی می‌شود که گویی از طریق گزینه
\fB\-\-debug\fR
ارسال شده است\&.
.RE
.PP
\fIMKVEXTRACT_ENGAGE\fR, \fIMKVTOOLNIX_ENGAGE\fR و شکل کوتاه آن \fIMTX_ENGAGE\fR
.RS 4
محتوای آن به گونه‌ای تلقی می‌شود که گویی از طریق گزینه
\fB\-\-engage\fR
ارسال شده است\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBmkvmerge\fR(1),
\fBmkvinfo\fR(1),
\fBmkvpropedit\fR(1),
\fBmkvtoolnix-gui\fR(1)
.SH "WWW"
.PP
همیشه می‌توانید جدیدترین نسخه را در
\m[blue]\fBوبگاه MKVToolNix\fR\m[]\&\s-2\u[1]\d\s+2 پیدا کنید\&.
.SH "نویسنده (AUTHOR)"
.PP
\fBMoritz Bunkus\fR <\&moritz@bunkus\&.org\&>
.RS 4
توسعه‌دهنده
.RE
.SH "نکات (NOTES)"
.IP " 1." 4
وبگاه MKVToolNix
.RS 4
\%https://mkvtoolnix.download
.RE