.Dd January 16, 2026
.Dt WVUNPACK 1
.Os
.Sh "نام (NAME)"
.Nm wvunpack
.Nd رمزگشایی فایل‌های کدگذاری‌شده با WavPack
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm wvunpack
.Op Fl options
.Op Fl o Ar output
.Ar
.Sh "توضیحات (DESCRIPTION)"
برنامه
.Nm wvunpack
فایل‌های WavPack را به حالت غیرفشرده اصلی‌شان رمزگشایی می‌کند.
مگر اینکه با سوییچ
.Fl o
تغییر داده شود، نام فایل خروجی همان نام فایل مبدأ خواهد بود که پسوند اصلی فایل جایگزین پسوند
.Dq .wv
مربوط به WavPack می‌شود.
همچنین می‌توان با استفاده از گزینه
.Fl -raw
صدای خام بدون سرایند تولید کرد.
می‌توان چندین فایل ورودی WavPack را مشخص کرد که منجر به تولید چندین فایل خروجی می‌شود؛ در این حالت می‌توان از
.Fl o
برای تعیین دایرکتوری مقصد جایگزین استفاده کرد.
نام فایل
.Dq -
مشخص‌کننده
.Pa stdin
یا
.Pa stdout
است.
همچنین امکان خروجی گرفتن در یکی از قالب‌های فایل جایگزین زیر وجود دارد، اما در این حالت اطلاعات موجود در سرایندها و تریلرهای اصلی از دست خواهد رفت، حتی اگر قالب جایگزین همان قالب فایل منبع باشد.
فایل‌های WavPack معمولاً با برنامه
.Nm wavpack
ساخته می‌شوند.
.Pp
اگر چندین فایل ورودی همراه با خروجی هدایت‌شده (piped)
.Pf ( Dq -o - )
مشخص شوند، خروجی تمام فایل‌ها به یکدیگر الحاق می‌شود.
این کار می‌تواند به عنوان روشی آسان برای متصل کردن فایل‌های WavPack به یکدیگر به کار رود (به فرض اینکه خروجی متعاقباً به
.Nm wavpack
هدایت شود)، اما این روش تنها همراه با خروجی خام
.Pf ( Fl -raw )
منطقی است تا از تداخل سرایندها در بین داده‌های صوتی جلوگیری شود.
.Pp
در سیستم‌های چند‌هسته‌ای
.Nm wvunpack
تلاش خواهد کرد برای افزایش سرعت عملیات (اغلب تا ۳ برابر یا بیشتر) از چندین ریسه (thread) استفاده کند.
برای اجبار به عملکرد تک‌ریسه‌ای از گزینه
.Fl -no-threads
استفاده کنید، یا از گزینه
.Fl -threads
برای تنظیم دقیق تعداد ریسه‌های مورد استفاده بهره ببرید.
.Ss "قالب‌های خروجی (OUTPUT FORMATS)"
.Bl -bullet -compact
.It
Microsoft RIFF
.Pq Dq .wav ,
اجبار با
.Fl -wav ,
ایجاد RF64 در صورت بزرگ‌تر بودن از ۴ گیگابایت
.It
Sony Wave64
.Pq Dq .w64 ,
اجبار با
.Fl -w64
.It
Apple AIFF
.Pq Dq .aif ,
اجبار با
.Fl -aif
یا
.Fl -aif-le
.It
Apple Core Audio
.Pq Dq .caf ,
اجبار با
.Fl -caf-be
یا
.Fl -caf-le
.It
PCM یا DSD خام
.Pq Dq .raw ,
اجبار با
.Fl r
یا
.Fl -raw
.It
Philips DSDIFF
.Pq Dq .dff ,
اجبار با
.Fl -dsdiff
یا
.Fl -dff
.It
Sony DSD Stream
.Pq Dq .dsf ,
اجبار با
.Fl -dsf
.El
.Ss "گزینه‌ها (OPTIONS)"
.Bl -tag -width Ds
.It Fl -aif , Fl -aif-le
اجبار خروجی به Apple AIFF (یا AIFF-C/sowt)، با پسوند
.Dq .aif
.It Fl b
رمزگشایی کورکورانه تمام بلوک‌های جریان داده و نادیده گرفتن اطلاعات طول (length)
.It Fl c
عدم رمزگشایی صدا و در عوض صرفاً استخراج cuesheet ذخیره‌شده در برچسب APEv2 به
.Pa stdout
(معادل
.Fl x
.Dq cuesheet )
.It Fl cc
استخراج cuesheet ذخیره‌شده در برچسب APEv2 در فایل
.Pa source-name.cue
در همان دایرکتوری فایل صوتی رمزگشایی‌شده
(معادل
.Fl xx
.Dq cuesheet=%a.cue )
.It Fl -caf-be , Fl -caf-le
اجبار خروجی به Core Audio با ترتیب بایت بزرگ‌انتها (big-endian) یا کوچک‌انتها (little-endian)، با پسوند
.Dq .caf
.It Fl d
حذف فایل مبدأ در صورت موفقیت‌آمیز بودن عملیات؛
.Sy با احتیاط استفاده شود!
.It Fl -dff , Fl -dsdiff
اجبار خروجی به Philips DSDIFF، فقط برای منبع صوتی DSD، با پسوند
.Dq .dff
.It Fl -dsf
اجبار خروجی به Sony DSF، فقط برای منبع صوتی DSD، با پسوند
.Dq .dsf
.It Fl f
عدم رمزگشایی صدا و صرفاً نمایش خلاصه اطلاعات فایل WavPack در
.Pa stdout
با قالبی مناسب برای تجزیه ماشینی (برای جزئیات بیشتر به
.Pa doc/wavpack_doc.html
یا
.Pa cli/wvunpack.c
مراجعه کنید)
.It Fl -help
نمایش راهنمای گسترده
.It Fl i
نادیده گرفتن فایل .wvc (اجبار به فشرده‌گشایی اتلافیِ ترکیبی/hybrid)
.It Fl m
محاسبه و نمایش امضای MD5؛ اعتبارسنجی در صورت بدون‌اتلاف (lossless) بودن
.It Fl n
عدم رمزگشایی صدا (استفاده همراه با
.Fl xx
تنها برای استخراج برچسب‌ها)
.It Fl -no-overwrite
هرگز فایلی که از پیش موجود است را رونویسی نمی‌کند و برای آن سؤالی نمی‌پرسد.
این گزینه برای از سر گرفتن یک عملیات دسته‌ایِ لغوشده بسیار مفید است و آشکارا نمی‌تواند همراه با گزینه
.Fl y
به کار رود.
.It Fl -normalize-floats
نرمال‌سازی صدای اعشاری (float) به بازه +/-1.0 در صورتی که از قبل نرمال نشده باشد
(به‌ندرت پیش می‌آید، اما صدا را دگرگون می‌کند و آزمون MD5 با شکست مواجه می‌شود)
.It Fl -no-threads
اجبار به عملکرد تک‌ریسه‌ای، معادل
.Fl -threads=1
.It Fl -no-utf8-convert
باقی گذاشتن برچسب‌های متنی استخراج‌شده در کدگذاری UTF-8 در حین استخراج یا نمایش
.It Fl o Ar OUTFILE
مشخص کردن نام فایل خروجی (تنها در صورت وجود یک فایل مبدأ)
یا دایرکتوری مقصد (باید از قبل وجود داشته باشد)
.It Fl q
حالت ساکت (به حداقل رساندن خروجی کنسول)
.It Fl r , Fl -raw
اجبار به رمزگشایی صدای خام PCM یا DSD با نادیده گرفتن سرایندها و تریلرها، که به تولید
.Pa source-name.raw
می‌انجامد
.It Fl -raw-pcm
مشابه
.Fl r
و
.Fl -raw
در بالا، با این تفاوت که صدای DSD به PCM بیست‌وچهار بیتی تبدیل خواهد شد (کاهش نمونه‌برداری به میزان 8x)
.It Fl s
عدم رمزگشایی صدا و صرفاً نمایش خلاصه اطلاعات درباره فایل WavPack در
.Pa stdout
.It Fl ss
عدم رمزگشایی صدا و صرفاً نمایش اطلاعات خلاصه و برچسب‌های فایل WavPack در
.Pa stdout
.It Fl -skip=[-][ Ns Ar sample Ns | Ns Ar hh : Ns Ar mm : Ns Ar ss.ss ]
شروع رمزگشایی از نمونه یا نمایه زمانی مشخص‌شده؛ تعیین یک
.Sq -
باعث می‌شود نمونه/زمان نسبت به پایان فایل (EOF) محاسبه شود
.It Fl t
کپی کردن مهر زمانی فایل ورودی به فایل(های) خروجی
.It Fl -threads= Ns Ar n
فعال (یا غیرفعال) کردن عملیات چندریسه‌ای از
.Ar n=1
(بدون ریسه‌بندی) تا
.Ar n=12
(حداکثر ریسه‌ها).
کارایی تمام حالت‌ها، از جمله اعتبارسنجی را به طور چشمگیری افزایش می‌دهد.
حذف این پارامتر تعداد بهینه ریسه‌ها را انتخاب خواهد کرد.
.It Fl -until=[+|-][ Ns Ar sample Ns | Ns Ar hh : Ns Ar mm : Ns Ar ss.ss ]
توقف رمزگشایی در نمونه یا نمایه زمانی مشخص‌شده؛ تعیین یک
.Sq +
باعث می‌شود نمونه/زمان نسبت به نقطه
.Fl -skip
سنجیده شود، و تعیین یک
.Sq -
باعث می‌شود نمونه/زمان نسبت به پایان فایل (EOF) محاسبه گردد
.It Fl v
صرفاً اعتبارسنجی داده‌های مبدأ (هیچ فایل خروجی ساخته نمی‌شود)
.It Fl vv
اعتبارسنجی سریع (بدون تولید خروجی، تنها برای فایل‌های نسخه ۵ به بالا)
.It Fl -version
نوشتن نسخه برنامه در
.Pa stdout
.It Fl w , Fl -wav
اجبار خروجی به Microsoft RIFF/RF64، با پسوند
.Dq .wav
.It Fl -w64
اجبار خروجی به Sony Wave64، با پسوند
.Dq .w64
.It Fl x Do Ar Field Dc
عدم رمزگشایی صدا و در عوض صرفاً استخراج فیلد برچسب مشخص‌شده به
.Pa stdout
.It Fl xx Do Ar Field Ns [= Ns Ar file ] Dc
استخراج فیلد برچسب مشخص‌شده درون فایلی به همین نام در همان دایرکتوری فایل صوتی رمزگشایی‌شده؛ مشخصات اختیاری نام فایل می‌تواند شامل
.Sq %a
باشد که با نام پایه فایل صوتی جایگزین می‌شود،
.Sq %t
که با نام فیلد برچسب جایگزین می‌شود (توجه: برای برچسب‌های باینری از داده‌ها می‌آید) و
.Sq %e
که با پسوند فایل مبدأ برچسب باینری (یا
.Dq txt
برای برچسب متنی) جایگزین می‌گردد.
.It Fl y
پاسخ بله به هشدار رونویسی؛
.Sy با احتیاط استفاده شود!
.It Fl z[ Ns Ar n ]
عدم تنظیم (n = 0 یا بدون مقدار) یا تنظیم (n = 1) عنوان کنسول برای نمایش میزان پیشرفت (عبارت "WvUnpack Completed" را بر جای می‌گذارد)
.El
.Sh "همچنین ببینید (SEE ALSO)"
.Xr wavpack 1 ,
.Xr wvgain 1 ,
.Xr wvtag 1 ,
.Lk www.wavpack.com
.Sh "نویسندگان (AUTHORS)"
.An David Bryant Aq Mt david@wavpack.com
.An Sebastian Dröge Aq Mt slomo@debian.org
.An Jan Starý Aq Mt hans@stare.cz