tagmp3(1) راهنمای کاربر tagmp3(1)

tagmp3 - دستکاری و ویرایش برچسب‌های ID3v1

tagmp3 [ -n ] mode [ format ] [ file ] ...

دستور tagmp3 به شما امکان می‌دهد برچسب‌های ID3v1 را در فایل‌های mp3 تنظیم یا حذف کنید. علاوه بر این، حالت move می‌تواند برای انتقال فایل‌های mp3 بر اساس برچسب ID3v1 آن‌ها استفاده شود. برچسب ID3v1 تکه‌ای از اطلاعات اضافی مانند نام هنرمند، آلبوم و سبک موسیقی است. برچسب‌های ID3v1 توسط اکثر پخش‌کننده‌های mp3 نمایش داده می‌شوند.

نمایش برچسب ID3v1 فایل.
تنظیم برچسب ID3v1 فایل بر اساس format.
انتقال فایل به یک مقصد بر اساس FORMAT.
حذف برچسب ID3v1 فایل (در صورت وجود).
نمایش شناسه‌های عددی سبک‌های موسیقی به همراه معنای آن‌ها.
چاپ یک پیام راهنمای (نه چندان) کوتاه.
چاپ نسخه برنامه و خروج.

نمایش کارهایی که انجام خواهد شد، بدون تغییر در هیچ فایلی.

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

%A
نام هنرمند
%a
نام آلبوم
%t
عنوان قطعه
%T
شماره قطعه
%y
سال
%g
سبک موسیقی (ژانر)
%c
توضیحات

برای حالت set، رشته قالب‌بندی فهرستی از فیلدهای ID3v1 است که پس از آن‌ها یک ':' (نویسه‌های بعدی مقدار فیلد هستند) یا یک '?' (درخواست مقدار فیلد از کاربر) قرار می‌گیرد.

مثال: tagmp3 set "%A:Pink Floyd %a:The Wall %t? %T?" *.mp3
به ازای هر فایل mp3 در این دایرکتوری، نام هنرمند به Pink Floyd و نام آلبوم به The Wall تنظیم می‌شود. برای هر فایل، عنوان آهنگ و شماره قطعه از کاربر پرسیده می‌شود و سایر فیلدها دست‌نخورده باقی می‌مانند. توجه داشته باشید که فیلد سبک موسیقی (genre) نیازمند یک مقدار عددی است. سبک‌های موسیقی شناخته‌شده را می‌توان با حالت list مشاهده کرد.

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

مثال: tagmp3 move "/home/foo/mp3/%A/%a/%T-%t.mp3" *.mp3
با توجه به مثال set در بالا، تمام فایل‌های mp3 را به مسیر "/home/foo/mp3/Pink Floyd/The Wall/{track}-{title}.mp3" منتقل می‌کند.
اگر طرح نام‌گذاری «تخت» (بدون ساختار درختی دایرکتوری‌ها) را ترجیح می‌دهید، می‌توانید از دستوری شبیه به این استفاده کنید:
tagmp3 move "%A-%t.mp3" *.mp3

حالت move هرگز فایل‌ها را رونویسی نمی‌کند.
حالت move دایرکتوری‌های میانی مشخص‌شده در رشته قالب‌بندی را ایجاد می‌کند. ایجاد هر دایرکتوری باید توسط کاربر تأیید شود.
برچسب‌های ID3v2 تاکنون پشتیبانی نمی‌شوند.
اگر فایلی قابل انتقال نباشد (نوع فایل نادرست باشد، برچسب ID3v1 وجود نداشته باشد یا فیلد خالی باشد و...)، دست‌نخورده باقی می‌ماند.
فایل‌های mp3 ساختگی (مانند فایل‌های Wave با پسوند .mp3) در حالت move به دایرکتوری "fake-mp3/" منتقل می‌شوند. حالت set از برچسب‌گذاری آن‌ها خودداری می‌کند، زیرا این عمل باعث ایجاد نویز صوتی در انتهای آهنگ می‌شود.

بسیار زیاد :)
برای حالت move، مبدأ و مقصد باید روی یک سیستم‌فایل یا پارتیشن یکسان قرار داشته باشند.

Laurent Alacoque <laureck@users.sourceforge.net> کپی‌لفت 2001
ارسال باگ‌ها، وصله‌ها، اطلاعات و انتشار‌های جدید به:
http://mpgtx.sourceforge.net

APRIL 2001 Linux