.TH tagmp3 1 "APRIL 2001" Linux "راهنمای کاربر"
.SH "نام (NAME)"
tagmp3 \- دستکاری و ویرایش برچسب‌های ID3v1
.SH "خلاصه دستور (SYNOPSIS)"
.B tagmp3 [
.I -n
.B ]
.I mode
.B [
.I format
.B ] [
.I file
.B ] ...
.SH "توضیحات (DESCRIPTION)"
دستور
.B tagmp3
به شما امکان می‌دهد برچسب‌های ID3v1 را در فایل‌های mp3 تنظیم یا حذف کنید. علاوه بر این، حالت
.B move
می‌تواند برای انتقال فایل‌های mp3 بر اساس برچسب ID3v1 آن‌ها استفاده شود. برچسب ID3v1 تکه‌ای از اطلاعات اضافی مانند نام هنرمند، آلبوم و سبک موسیقی است. برچسب‌های ID3v1 توسط اکثر پخش‌کننده‌های mp3 نمایش داده می‌شوند.
.SH "حالت (MODE)"
.IP show
نمایش برچسب ID3v1 فایل.
.IP set 
تنظیم برچسب ID3v1 فایل بر اساس format.
.IP move 
انتقال فایل به یک مقصد بر اساس FORMAT.
.IP del 
حذف برچسب ID3v1 فایل (در صورت وجود).
.IP list
نمایش شناسه‌های عددی سبک‌های موسیقی به همراه معنای آن‌ها.
.IP -h
چاپ یک پیام راهنمای (نه چندان) کوتاه.
.IP -v
چاپ نسخه برنامه و خروج.
.SH "گزینه‌ها (OPTIONS)"
.IP -n
نمایش کارهایی که انجام خواهد شد، بدون تغییر در هیچ فایلی.

.SH "رشته قالب‌بندی (FORMAT STRING)"
رشته قالب‌بندی، رشته‌ای از نویسه‌ها شامل صفر یا چند دستورالعمل است: نویسه‌های معمولی (غیر از %)، که تفسیر نمی‌شوند، و مشخصات تبدیل که هر یک از آن‌ها با فیلد متناظر برچسب ID3v1 جایگزین می‌شوند. هر مشخصه تبدیل با نویسه % مشخص می‌شود. خطوط زیر هر مشخصه تبدیل را به همراه فیلد ID3v1 مرتبط با آن شرح می‌دهد. توالی ویژه %% با یک نویسه % تکی جایگزین می‌شود.
.IP %A
نام هنرمند
.IP %a 
نام آلبوم
.IP %t
عنوان قطعه
.IP %T
شماره قطعه
.IP %y 
سال
.IP %g 
سبک موسیقی (ژانر)
.IP %c
توضیحات
.SH "رشته قالب‌بندی برای حالت set (FORMAT STRING FOR SET MODE)"
برای حالت set، رشته قالب‌بندی فهرستی از فیلدهای ID3v1 است که پس از آن‌ها یک ':' (نویسه‌های بعدی مقدار فیلد هستند) یا یک '?' (درخواست مقدار فیلد از کاربر) قرار می‌گیرد.
.IP 
مثال: tagmp3 set "%A:Pink Floyd %a:The Wall %t? %T?" *.mp3
.br
.br
به ازای هر فایل mp3 در این دایرکتوری، نام هنرمند به Pink Floyd و نام آلبوم به The Wall تنظیم می‌شود. برای هر فایل، عنوان آهنگ و شماره قطعه از کاربر پرسیده می‌شود و سایر فیلدها دست‌نخورده باقی می‌مانند. توجه داشته باشید که فیلد سبک موسیقی (genre) نیازمند یک مقدار عددی است. سبک‌های موسیقی شناخته‌شده را می‌توان با حالت list مشاهده کرد.

.SH "رشته قالب‌بندی برای حالت move (FORMAT STRING FOR MOVE MODE)"
رشته قالب‌بندی، مسیر مقصدی است که در آن هر شناسه فیلد با مقدار برچسب متناظر جایگزین می‌شود.
.IP
مثال: tagmp3 move "/home/foo/mp3/%A/%a/%T-%t.mp3" *.mp3
.br
با توجه به مثال set در بالا، تمام فایل‌های mp3 را به مسیر "/home/foo/mp3/Pink Floyd/The Wall/{track}-{title}.mp3" منتقل می‌کند.
.br
اگر طرح نام‌گذاری «تخت» (بدون ساختار درختی دایرکتوری‌ها) را ترجیح می‌دهید، می‌توانید از دستوری شبیه به این استفاده کنید:
.br
tagmp3 move "%A-%t.mp3" *.mp3
.SH "نکات (NOTES)"
حالت move هرگز فایل‌ها را رونویسی نمی‌کند.
.br
حالت move دایرکتوری‌های میانی مشخص‌شده در رشته قالب‌بندی را ایجاد می‌کند. ایجاد هر دایرکتوری باید توسط کاربر تأیید شود.
.br
برچسب‌های ID3v2 تاکنون پشتیبانی نمی‌شوند.
.br
اگر فایلی قابل انتقال نباشد (نوع فایل نادرست باشد، برچسب ID3v1 وجود نداشته باشد یا فیلد خالی باشد و...)، دست‌نخورده باقی می‌ماند.
.br
فایل‌های mp3 ساختگی (مانند فایل‌های Wave با پسوند .mp3) در حالت move به دایرکتوری "fake-mp3/" منتقل می‌شوند. حالت set از برچسب‌گذاری آن‌ها خودداری می‌کند، زیرا این عمل باعث ایجاد نویز صوتی در انتهای آهنگ می‌شود.
.SH "گزارش باگ‌ها (BUGS)"
بسیار زیاد :)
.br
برای حالت move، مبدأ و مقصد باید روی یک سیستم‌فایل یا پارتیشن یکسان قرار داشته باشند.
.SH "نویسندگان (AUTHORS)"
Laurent Alacoque <laureck@users.sourceforge.net> کپی‌لفت 2001
.br
ارسال باگ‌ها، وصله‌ها، اطلاعات و انتشار‌های جدید به:
.br
http://mpgtx.sourceforge.net