.Dd January 16, 2026
.Dt WVTAG 1
.Os
.Sh "نام (NAME)"
.Nm wvtag
.Nd دستکاری متاداده‌های WavPack
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm wvtag
.Op Fl options
.Ar
.Sh "توضیحات (DESCRIPTION)"
.Nm
عملیات‌های متاداده تعیین‌شده را
به این ترتیب بر روی هر یک از فایل‌های منبع WavPack مشخص‌شده اعمال می‌کند:
پاک‌سازی (clean)، درون‌ریزی (import)، حذف (delete)، نوشتن (write)، استخراج (extract)، فهرست‌کردن (list).
توجه داشته باشید که متاداده‌های WavPack در برچسب‌های APEv2 ذخیره می‌شوند، و
.Nm
اگر برچسب ID3v1 تنها برچسب موجود در فایل منبع باشد،
به‌طور خودکار داده‌ها را از آن درون‌ریزی خواهد کرد،
و در صورت درخواست ویرایش، آن برچسب ID3v1 حذف شده و با یک برچسب APEv2 جایگزین می‌شود.
.Ss "گزینه‌ها (OPTIONS)"
.Bl -tag -width Ds
.It Fl -allow-huge-tags
اجازه دادن به داده‌های برچسب تا سقف ۱۶ مگابایت.
جاسازی بیش از ۱ مگابایت برای دستگاه‌های قابل حمل توصیه نمی‌شود
و ممکن است در برخی برنامه‌ها، از جمله نسخه‌های قدیمی‌تر WavPack، کار نکند.
.It Fl c
استخراج برگه نشانه‌گذاری (cuesheet) فقط در
.Pa stdout
(معادل
.Fl x
.Dq cuesheet )
.It Fl cc
استخراج برگه نشانه‌گذاری در فایل
.Pa source-name.cue
در همان دایرکتوری فایل منبع
(معادل
.Fl xx
.Dq cuesheet=%a.cue )
.It Fl -clean , Fl -clear
پاک‌سازی تمام موارد از برچسب (در ابتدا انجام می‌شود)
.It Fl d Do Ar Field Dc
حذف مورد متاداده مشخص‌شده (متنی یا باینری)
.It Fl h , Fl -help
نمایش این راهنما
.It Fl -import-file Ar infile.wv
درون‌ریزی تمام موارد برچسب از فایل WavPack مشخص‌شده به برچسب APEv2.
توجه داشته باشید که موارد برچسب درون‌ریزی‌شده به برچسب‌های موجود اضافه می‌شوند مگر اینکه
.Fl -clean
قید شده باشد.
اگر تصاویر روی جلد با حجم بیش از ۱ مگابایت وجود دارد،
.Fl -allow-huge-tags
را برای گنجاندن آن‌ها اضافه کنید.
.It Fl -import-id3
درون‌ریزی موارد برچسب قابل اعمال از برچسب ID3v2.3
موجود در DSF و احتمالاً سایر فایل‌ها به برچسب APEv2.
توجه داشته باشید که موارد برچسب درون‌ریزی‌شده به برچسب‌های موجود اضافه می‌شوند مگر اینکه
.Fl -clean
قید شده باشد.
اگر تصاویر روی جلد با حجم بیش از ۱ مگابایت وجود دارد،
.Fl -allow-huge-tags
را برای گنجاندن آن‌ها اضافه کنید.
.It Fl l , Fl -list
فهرست کردن تمام موارد برچسب (در انتها انجام می‌شود)
.It Fl -no-utf8-convert
عدم بازکدگذاری برچسب‌های ارائه‌شده از کدگذاری محلی به UTF-8؛
فرض می‌شود که آن‌ها از قبل در قالب UTF-8 هستند
.It Fl q
حالت بی‌صدا: به حداقل رساندن خروجی کنسول.
.It Fl v , Fl -version
نوشتن نسخه برنامه در
.Pa stdout
.It Fl w Do Ar Field Ns = Dc
حذف مورد متاداده مشخص‌شده (متنی یا باینری)
.It Fl w Do Ar Field Ns = Ns Ar Value Dc
نوشتن متاداده متنی مشخص‌شده در برچسب APEv2
.It Fl w Do Ar Field Ns =@ Ns Ar file.ext Dc
نوشتن متاداده متنی مشخص‌شده از فایل در برچسب APEv2؛
معمولاً برای برگه نشانه‌گذاری و گزارش‌های تعبیه‌شده استفاده می‌شود
(نام فیلدهای
.Dq Cuesheet
و
.Dq Log )
.It Fl -write-binary-tag Do Ar Field Ns =@ Ns Ar file.ext Dc
نوشتن فایل متاداده باینری مشخص‌شده در برچسب APEv2؛
معمولاً برای تصویر روی جلد با نام فیلد مشخص‌شده
.Dq Cover Art (Front)
استفاده می‌شود
.It Fl x Do Ar Field Dc
استخراج فیلد برچسب مشخص‌شده فقط در
.Pa stdout
.It Fl xx Do Ar Field Ns [= Ns Ar filename ] Dc
استخراج فیلد برچسب مشخص‌شده در فایلی با نام معین
در همان دایرکتوری فایل منبع.
یک الگوی نام‌گذاری اختیاری
.Ar filename
می‌تواند شامل این موارد باشد:
.Sq %a
که با نام پایه فایل صوتی جایگزین می‌شود؛
.Sq %t
که با نام فیلد برچسب جایگزین می‌شود
(توجه داشته باشید که برای برچسب‌های باینری، این مقدار از خود داده‌ها می‌آید)؛
و
.Sq %e
که با پسوند فایل منبع برچسب باینری
(یا
.Dq txt
برای یک برچسب متنی)
جایگزین می‌شود.
.It Fl y
پاسخ بله به تمام هشدارها؛
.Sy با احتیاط استفاده شود!
.El
.Sh "همچنین ببینید (SEE ALSO)"
.Xr wavpack 1 ,
.Xr wvgain 1 ,
.Xr wvunpack 1 ,
.Lk www.wavpack.com
.Sh "نویسندگان (AUTHORS)"
.An David Bryant Aq Mt david@wavpack.com
.An Jan Starý Aq Mt hans@stare.cz