نام (NAME)

vorbiscomment - فهرست کردن یا ویرایش توضیحات در فایل‌های Ogg Vorbis

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

vorbiscomment [-l] [-R] [-e] file.ogg
vorbiscomment -a [ -c commentfile | -t “name=value” | -d “name=value” ] [-q] [-R] [-e] in.ogg [out.ogg]
vorbiscomment -w [ -c commentfile | -t “name=value” ] [-q] [-R] [-e] in.ogg [out.ogg]

توضیحات (DESCRIPTION)

دستور vorbiscomment برچسب‌های فرادادهٔ فایل صوتی Ogg Vorbis را می‌خواند، تغییر می‌دهد و اضافه می‌کند.

گزینه‌ها (OPTIONS)

-a, --append

توضیحات را به‌روزرسانی (الحاق) می‌کند.

-c file, --commentfile file

توضیحات را از یک فایل می‌گیرد. این فایل همان قالبی را دارد که توسط گزینهٔ -l تولید می‌شود یا به گزینهٔ -t داده می‌شود: در هر سطر یک مورد در قالب 'tag=value'. اگر فایل ‎/dev/null‎ باشد و -w داده شده باشد، توضیحات موجود حذف خواهند شد.

-h, --help

نمایش راهنمای دستور.

-l, --list

فهرست کردن توضیحات موجود در فایل Ogg Vorbis.

-q, --quiet

حالت بی‌صدا. هیچ پیامی نمایش داده نمی‌شود.

-t 'name=value', --tag 'name=value'

مشخص کردن یک برچسب جدید در خط فرمان. هر برچسب به صورت یک رشتهٔ واحد ارائه می‌شود. بخش قبل از '=' به عنوان نام برچسب و بخش بعد از آن به عنوان مقدار در نظر گرفته می‌شود.

-d 'name[=value]', --rm 'name[=value]'

مشخص کردن یک برچسب در خط فرمان برای حذف. هر برچسب به عنوان یک رشتهٔ واحد ارائه می‌شود. بخش قبل از '=' به عنوان نام برچسب و بخش بعد از آن به عنوان مقدار در نظر گرفته می‌شود. اگر مقداری داده نشود، تمام برچسب‌های دارای نام مشخص‌شده حذف می‌شوند. در غیر این صورت تنها مواردی که دارای مقدار منطبق هستند حذف خواهند شد.

-w, --write

جایگزین کردن توضیحات با مجموعهٔ جدیدی که در خط فرمان با -t یا از طریق یک فایل با -c مشخص شده است. اگر هیچ‌یک از گزینه‌های -c یا -t مشخص نشوند، مجموعهٔ جدید از ورودی استاندارد خوانده خواهد شد.

-R, --raw

خواندن و نوشتن توضیحات با کدگذاری UTF-8، به جای تبدیل به مجموعه نویسه‌های کاربر.

-e, --escapes

گریزدهی/لغو گریزدهی خطوط جدید و بک‌اسلش‌ها در توضیحات. این کار تضمین می‌کند که هر توضیح در خروجی (یا ورودی) دقیقاً یک سطر باشد، که امکان فیلتر کردن و انتقال رفت‌وبرگشتی آن‌ها را فراهم می‌کند. بدون این گزینه، تنها با استفاده از -t می‌توانید توضیحات چندسطری بنویسید و نمی‌توانید آن‌ها را با اطمینان از چند توضیح تک‌سطری تشخیص دهید.

توالی‌های گریز پشتیبانی‌شده به سبک زبان C عبارتند از "\n"، "\r"، "\\" و "\0". قرار گرفتن یک بک‌اسلش قبل از هر چیز دیگری یک خطا محسوب می‌شود.

نکته: در حال حاضر، هنگام نوشتن، هر چیزی پس از اولین "\0" دور ریخته می‌شود. این یک باگ است - قالب Vorbis می‌تواند نویسه‌های null را به طور ایمن ذخیره کند، اما بیشتر ابزارهای دیگر به هر حال قادر به کار با آن‌ها نیستند.

-V, --version

نمایش نسخهٔ vorbiscomment.

مثال‌ها (EXAMPLES)

برای صرفاً مشاهدهٔ برچسب‌های توضیح درون یک فایل:

vorbiscomment -l file.ogg

برای ویرایش آن توضیحات:

vorbiscomment -l file.ogg > file.txt
[ویرایش توضیحات درون file.txt به شکل دلخواه]
vorbiscomment -w -c file.txt file.ogg newfile.ogg

برای اضافه کردن سادهٔ یک توضیح:

vorbiscomment -a -t 'ARTIST=No One You Know' file.ogg newfile.ogg

برای افزودن مجموعه‌ای از توضیحات از ورودی استاندارد:

vorbiscomment -a file.ogg
ARTIST=No One You Know
ALBUM=The Famous Album
<ctrl-d>

قالب برچسب (TAG FORMAT)

برای مستندات مربوط به قالب برچسب‌های Ogg Vorbis، از جمله فهرستی پیشنهادی از نام‌های استاندارد برچسب‌ها، https://xiph.org/vorbis/doc/v-comment.html را ببینید.

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

نویسندگان برنامه:

Michael Smith <msmith@xiph.org>
Ralph Giles <giles@xiph.org>

نویسنده صفحه راهنما:

Christopher L Cheney <ccheney@debian.org>

همچنین ببینید (SEE ALSO)

oggenc(1), oggdec(1), ogg123(1), ogginfo(1)