نام (NAME)

mid3v2 - ویرایشگر برچسب صوتی مشابه 'id3v2'

خلاصه دستور (SYNOPSIS)

mid3v2 [گزینه‌ها] نام‌فایل ...

توضیحات (DESCRIPTION)

برنامه mid3v2 یک جایگزین مبتنی بر Mutagen برای id3v2 متعلق به id3lib است. این برنامه از ID3v2.4 و فریم‌های بیشتری پشتیبانی می‌کند؛ همچنین فاقد باگ‌های بی‌شماری است که id3v2 با آن‌ها دست‌به‌گریبان است.

این برنامه عمدتاً برای سازگاری با برنامه‌هایی وجود دارد که می‌خواهند فایل‌ها را با استفاده از id3v2 برچسب‌گذاری کنند. برای داشتن رابط کاربری کاربردی‌تر، ما Ex Falso را پیشنهاد می‌کنیم.

گزینه‌ها (OPTIONS)

-q, --quiet: حالت بی‌صدا: عملیات‌های فایلی را که درخواست کاربر را انجام می‌دهند گزارش نمی‌کند. هشدارها همچنان چاپ خواهند شد.
-v, --verbose: حالت پرگو: تمام عملیات‌های انجام‌شده را بیان می‌کند. این گزینه برعکس --quiet است و حالت پیش‌فرض می‌باشد.
-e, --escape: فعال‌سازی تفسیر نویسه‌های گریز ممیز وارونه (backslash) برای مقادیر برچسب. امکان گریز از دونقطه جداکننده در مقادیر TXXX، WXXX و COMM مانند '\:' و درج دنباله‌های گریز مانند '\n'، '\t' و غیره را فراهم می‌کند.
-f, --list-frames: نمایش تمام فریم‌های پشتیبانی‌شده ID3v2.3/2.4 و معانی آن‌ها.
-L, --list-genres: فهرست کردن تمام سبک‌های عددی ID3v1. از این مقادیر می‌توان برای تنظیم فریم‌های TCON استفاده کرد، اما توصیه نمی‌شود.
-l, --list: فهرست کردن تمام برچسب‌های موجود در فایل‌ها. قالب خروجی همانند id3v2 نیست؛ بلکه به آسانی قابل تجزیه و خوانا است. برخی برچسب‌ها ممکن است بازنمایی خوانا برای انسان نداشته باشند.
--list-raw: فهرست کردن تمام برچسب‌های موجود در فایل‌ها در قالب خام. اگرچه این قالب به صورت اسمی برای انسان خوانا است، در صورتی که برچسب حاوی داده‌های دودویی جاسازی‌شده باشد ممکن است بسیار طولانی شود.
-d, --delete-v2: حذف برچسب‌های ID3v2.
-s, --delete-v1: حذف برچسب‌های ID3v1.
-D, --delete-all: حذف تمام برچسب‌های ID3.
--delete-frames=FRAMES: حذف فریم‌های مشخص ID3v2 (یا گروه‌هایی از فریم‌ها) از فایل‌ها. FRAMES فهرستی از نام‌های فریم است که با «,» جدا شده‌اند، مانند "TPE1,TALB".
-C, --convert: تبدیل برچسب‌های ID3v1 به برچسب‌های ID3v2. این کار در حین هرگونه ویرایشی نیز به طور خودکار انجام خواهد شد.
-a,--artist=ARTIST: تنظیم اطلاعات هنرمند (TPE1).
-A,--album=ALBUM: تنظیم اطلاعات آلبوم (TALB).
-t,--song=TITLE: تنظیم اطلاعات عنوان (TIT2).
-c,--comment=<DESCRIPTION:COMMENT:LANGUAGE>: تنظیم یک نظر (COMM). زبان و توضیحات را می‌توان حذف کرد، که در این صورت زبان به صورت پیش‌فرض انگلیسی و توضیحات یک رشته خالی خواهد بود.
-p,--picture=<FILENAME:DESCRIPTION:IMAGE-TYPE:MIME-TYPE>: تنظیم تصویر پیوست‌شده (APIC). همه موارد به جز نام فایل را می‌توان حذف کرد که در این صورت از مقادیر پیش‌فرض استفاده خواهد شد.
-g,--genre=GENRE: تنظیم اطلاعات سبک (TCON).
-y,--year=<YYYY>, --date=<YYYY-[MM-DD]>: تنظیم اطلاعات سال/تاریخ (TDRC).
-T,--track=<NUM/NUM>: تنظیم شماره قطعه (TRCK).

هر فریم متنی یا نشانی وب (URL) (آن‌هایی که با T یا W آغاز می‌شوند) را می‌توان با افزودن پیشوند «--» به ابتدای نام فریم اصلاح یا اضافه کرد. به عنوان مثال، --TIT3 "Monkey!" فریم TIT3 (عنوان فرعی) را بر روی Monkey! تنظیم می‌کند.

فریم TXXX دارای قالب <DESCRIPTION:TEXT> است؛ تا زمانی که کلیدهای متفاوتی داشته باشند می‌توان فریم‌های TXXX متعددی را در فایل تنظیم کرد. برای تنظیم این کلید، کافی است متن را با دونقطه جدا کنید، مانند --TXXX "ALBUMARTISTSORT:Examples, The". بخش توضیحات را می‌توان نادیده گرفت که در این صورت پیش‌فرض آن یک رشته خالی است.

فریم WXXX قالبی مشابه TXXX دارد، اما از آنجا که نشانی‌های وب معمولاً حاوی «:» هستند باید توضیحات ارائه دهید یا ویژگی گریز (-e) را فعال کنید: --WXXX "desc:http://foo.bar" یا -e --WXXX "http\\://foo.bar"

فریم USLT دارای قالب <DESCRIPTION:TEXT:LANGUAGE> است. زبان و توضیحات را می‌توان حذف کرد، که در این حالت زبان به طور پیش‌فرض انگلیسی و توضیحات یک رشته خالی خواهد بود.

فریم ویژه POPM را می‌توان به روش مشابهی تنظیم کرد: --POPM "bob@example.com:128:2" برای تنظیم امتیاز Bob روی 128/255 با ۲ بار پخش.

گزارش باگ‌ها (BUGS)

هیچ بررسی اعتبارسنجی روی عملیات‌های ویرایشی انجام‌شده توسط شما اعمال نمی‌شود، بنابراین mid3v2 هنگام ویرایش یک فریم ID3v2.4 گزینه --TSIZ را با کمال میل می‌پذیرد. با این حال، در طول عملیات ویرایش بعدی نیز به طور خودکار آن را دور خواهد انداخت.

نویسندگان (AUTHORS)

‏Joe Wreschnig نویسنده mid3v2 است، اما ترجیح می‌دهد به آن اعتراف نکند.