| ogg123(1) | Vorbis Tools | ogg123(1) |
نام (NAME)
ogg123 - پخش فایل‌های Ogg و FLAC
خلاصه دستور (SYNOPSIS)
ogg123 [ -vqrzZVh ] [ -k seconds ] [ -x nth ] [ -y ntimes ] [ -b buffer_size ] [ -d driver [ -o option:value ] [ -f filename ] ] file ... | directory ... | URL ...
توضیحات (DESCRIPTION)
برنامهٔ ogg123 فایل‌های صوتی Ogg/Vorbis، Ogg/Speex، Ogg/Opus، Ogg/FLAC و FLAC بومی را می‌خواند و آن‌ها را برای دستگاه‌های مشخص‌شده در خط فرمان رمزگشایی می‌کند. به‌طور پیش‌فرض، ogg123 در دستگاه صوتی استاندارد می‌نویسد، اما خروجی می‌تواند به هر تعدادی از دستگاه‌ها ارسال شود. فایل‌ها می‌توانند از سیستم فایل خوانده شوند، یا نشانی‌های URL از طریق HTTP پخش جریانی (استریم) گردند. در صورت مشخص شدن یک دایرکتوری، تمام فایل‌های موجود در آن یا زیردایرکتوری‌هایش پخش خواهند شد.
گزینه‌ها (OPTIONS)
- --audio-buffer n
- استفاده از یک بافر صوتی خروجی با اندازهٔ تقریبی 'n' کیلوبایت.
- -@ playlist, --list playlist
- پخش تمام فایل‌های نام‌برده‌شده در فایل 'playlist'. فهرست پخش باید در هر سطر شامل یک نام فایل، نام دایرکتوری یا نشانی URL باشد. خطوط خالی مجاز هستند. با دایرکتوری‌ها دقیقاً به همان روش خط فرمان رفتار خواهد شد.
- -b n, --buffer n
- استفاده از یک بافر ورودی با اندازهٔ تقریبی 'n' کیلوبایت. گزینه‌ای فقط برای HTTP.
- -p n, --prebuffer n
- پیش‌بافر کردن 'n' درصد از بافر ورودی. پخش تا زمان تکمیل این پیش‌بافر آغاز نخواهد شد. گزینه‌ای فقط برای HTTP.
- -d device, --device device
- مشخص کردن دستگاه خروجی. برای فهرستی از دستگاه‌ها بخش DEVICES را ببینید. امکان تعیین هر تعداد دستگاه وجود دارد.
- -f filename, --file filename
- مشخص کردن فایل خروجی برای دستگاه فایلی که پیش‌تر با --device تعیین شده است. نام فایل "-" در خروجی استاندارد می‌نویسد. اگر فایل از قبل موجود باشد، ogg123 آن را بازنویسی خواهد کرد.
- -h, --help
- نمایش راهنمای دستور.
- -k n, --skip n
- پرش از 'n' ثانیه نخست. 'n' همچنین می‌تواند در قالب minutes:seconds یا hours:minutes:seconds باشد.
- -K n, --end n
- توقف پخش در 'n' ثانیه از ابتدای استریم. 'n' همچنین می‌تواند همان قالبی را داشته باشد که در گزینهٔ --skip استفاده می‌شود.
- -o option[:value], --device-option option[:value]
- تنظیم گزینهٔ option روی مقدار value برای دستگاه قبلی. برای فهرستی از گزینه‌های معتبر برای هر دستگاه، بخش DEVICES را ببینید.
- -q, --quiet
- حالت بی‌صدا. هیچ پیامی نمایش داده نمی‌شود.
- -V, --version
- نمایش اطلاعات نسخه.
- -v, --verbose
- افزایش پرگویی (نمایش جزئیات بیشتر).
- -x n, --nth
- پخش هر 'n'-اُمین بلوک رمزگشایی‌شده. اثر آن پخش صدا با سرعت 'n' برابر سریع‌تر از سرعت عادی است.
- -y n, --ntimes
- تکرار هر بلوک پخش‌شده به تعداد 'n' بار. اثر آن پخش صدا با سرعت 'n' برابر کندتر از سرعت عادی است. می‌تواند برای سرعت‌های کسری جالب با -x همراه شود.
- -r, --repeat
- تکرار فهرست پخش به صورت نامحدود.
- -z, --shuffle
- پخش فایل‌ها با ترتیبی شبه‌تصادفی.
- -Z, --random
- پخش
فایل‌ها با
ترتیبی
شبه‌تصادفی
تا ابد..SH
"دستگاه‌ها
(DEVICES)"
دستور ogg123 از طریق libao از انواع دستگاه‌های خروجی صوتی پشتیبانی می‌کند. تنها دستگاه‌هایی در دسترس خواهند بود که توسط سکوی هدف پشتیبانی شوند. گزینهٔ -f تنها می‌تواند با دستگاه‌هایی استفاده شود که در فایل‌ها می‌نویسند.
گزینه‌های پشتیبانی‌شده توسط تمام دستگاه‌ها:
- debug
- فعال کردن خروجی اشکال‌زدایی [در صورت وجود] برای راه‌انداز انتخاب‌شده.
- matrix:value
- اجبار یک ترتیب کانال خروجی خاص برای دستگاه مشخص‌شده. value فهرستی جداشده با کاما از نام کانال‌ها به سبک AO است، مانند L,R,C,LFE,BL,BR,SL,SR.
- verbose
- فعال کردن خروجی پرگو برای راه‌انداز انتخاب‌شده. گزینهٔ -v نیز گزینهٔ verbose را برای راه‌انداز تنظیم می‌کند.
- quiet
- اجبار راه‌انداز انتخاب‌شده به سکوت کامل. حتی خطاها نیز هیچ خروجی تولید نخواهند کرد. گزینهٔ -q نیز گزینهٔ quiet را برای راه‌انداز تنظیم می‌کند.
- aixs
- راه‌انداز خروجی زندهٔ AIX. گزینه‌ها:
- dev:value
- تنظیم دستگاه خروجی AIX روی value
- alsa
- راه‌انداز خروجی زندهٔ Advanced Linux Sound Architecture. گزینه‌ها:
- buffer_time:value
- بازنویسی اندازه پیش‌فرض بافر سخت‌افزاری (به میلی‌ثانیه).
- dev:value
- برچسب دستگاه ALSA برای استفاده. برای نمونه "hw:0" برای اولین کارت صدا و "hw:1" برای دومی. راه‌انداز alsa معمولاً بسته به تعداد کانال‌های خروجی، به‌طور خودکار یکی از "surround71" ، "surround51" ، "surround40" یا "default" را انتخاب می‌کند. برای اطلاعات بیشتر، پیوند زیر را ببینید: http://alsa.opensrc.org/ALSA+device+labels
- period_time:value
- بازنویسی اندازه پیش‌فرض دوره سخت‌افزاری (به میکروثانیه).
- period_time:value
- بازنویسی اندازه پیش‌فرض دوره سخت‌افزاری (به میکروثانیه).
- use_mmap:value
- مقدار value روی "yes" یا "no" تنظیم می‌شود تا پیش‌فرض زمان ترجمه برای استفاده یا عدم استفاده از دسترسی mmap به دستگاه را بازنویسی کند. در گذشته، برخی از راه‌اندازهای دارای باگ alsa در هنگام عدم استفاده از دسترسی mmap رفتار بهتری نشان می‌دادند، به بهای مصرف اندکی بیشتر CPU.
- arts
- راه‌انداز خروجی زندهٔ شبح صوتی aRts. گزینه‌ها:
- multi:value
- مقدار value روی "yes" یا "no" تنظیم می‌شود تا امکان باز کردن دستگاه پخش aRts برای پخش‌های هم‌زمان چندگانه فراهم شود. اگرچه این راه‌انداز در حالت چندگانه به درستی کار می‌کند، اما شناخته شده است که گهگاه خود سرور aRts را دچار فروپاشی می‌کند. رفتار پیش‌فرض "no" است.
- au
- خروجی فایل صوتی Sun. نمونه‌های صوتی را در قالب AU می‌نویسد. قالب AU از نوشتن در فایل‌های غیرقابل پیمایش مانند خروجی استاندارد پشتیبانی می‌کند. در چنین شرایطی، سرآیند AU قالب نمونه را مشخص می‌کند، اما طول ضبط را مشخص نخواهد کرد.
- esd
- خروجی زندهٔ Enlightened Sound Daemon. گزینه‌ها:
- host:value
- مقدار value نام میزبانی را که esd روی آن اجرا می‌شود مشخص می‌کند. این مقدار می‌تواند شامل یک شماره درگاه پس از دو‌نقطه باشد، مانند "whizbang.com:555". (پیش‌فرض = localhost)
- client_name:value
- تنظیم نام کلاینت برای جریان صوتی جدید. پیش‌فرض "libao client" است.
- irix
- راه‌انداز صوتی خروجی زندهٔ IRIX.
- macosx
- راه‌انداز خروجی زندهٔ 'AUHAL' در MacOS X. این راه‌انداز از MacOS X نسخهٔ 10.5 و بالاتر پشتیبانی می‌کند (10.4 و پیش از آن از یک واسط قدیمی‌تر و ناسازگار استفاده می‌کنند). گزینه‌ها:
- buffer_time:value
- تنظیم اندازه بافر سخت‌افزاری به معادل value میلی‌ثانیه.
- nas
- راه‌انداز خروجی زندهٔ Network Audio Server. گزینه‌ها:
- buf_size:value
- تنظیم اندازه بافر صوتی در سرور بر حسب بایت.
- host:value
- تنظیم مکان سرور NAS؛ برای ساختار به nas(1) مراجعه کنید.
- null
- راه‌انداز تهی (Null). تمام داده‌های صوتی دور ریخته می‌شوند. (توجه: داده‌های صوتی در /dev/null نوشته نمی‌شوند!) می‌توانید از این راه‌انداز برای سنجش سرعت رمزگشایی خام بدون بار اضافی خروجی استفاده کنید.
- oss
- راه‌انداز Open Sound System برای Linux و FreeBSD، نسخه‌های 2، 3 و 4. گزینه‌ها:
- dsp:value
- دستگاه DSP برای کارت صدا. مقدار پیش‌فرض /dev/dsp است.
- pulse
- راه‌انداز صوتی خروجی زندهٔ Pulseaudio. گزینه‌ها:
- server:value
- مکان سرور دوردست یا جایگزین Pulseaudio را مشخص می‌کند.
- sink:value
- یک سینک غیرپیش‌فرض Pulseaudio را برای جریان صوتی مشخص می‌کند.
- raw
- خروجی فایل خام. نمونه‌های صوتی خام را در یک فایل می‌نویسد. گزینه‌ها:
- byteorder:value
- ترتیب بایتی بزرگ‌پایان ("big")، کوچک‌پایان ("little") یا بومی ("native") را انتخاب می‌کند. پیش‌فرض ترتیب بومی است.
- roar
- راه‌انداز خروجی زندهٔ شبح صوتی RoarAudio. گزینه‌ها:
- server:value, host:value
- مکان سرور دوردست RoarAudio را برای استفاده مشخص می‌کند.
- id:value, dev:value
- یک میکسر غیرپیش‌فرض را در سرور RoarAudio برای جریان صوتی مشخص می‌کند.
- role:value
- تنظیم نقش (role) را برای جریان صوتی تعیین می‌کند.
- client_name:value
- تنظیم نام کلاینت برای جریان صوتی جدید. پیش‌فرض "libao client" است.
- sndio
- راه‌انداز خروجی زندهٔ SNDIO در OpenBSD. گزینه‌ها:
- dev:value
- دستگاه صوتی مورد استفاده برای بازپخش را مشخص می‌کند.
- sun
- راه‌انداز خروجی زندهٔ Sun Audio برای NetBSD، OpenBSD و Solaris. گزینه‌ها:
- dev:value
- دستگاه صوتی برای کارت صدا. مقدار پیش‌فرض /dev/audio است.
خروجی فایل WAV. داده‌های صوتی را به صورت فشرده‌نشده روی دیسک می‌نویسد. اگر چند فایل پخش شوند، همگی آن‌ها به یکدیگر متصل شده و درون یک فایل WAV قرار می‌گیرند. فایل‌های WAV را نمی‌توان روی فایل‌های غیرقابل جستجو (unseekable) مانند خروجی استاندارد نوشت. در عوض از قالب AU استفاده کنید.
- wmm
- راه‌انداز خروجی زندهٔ Windows MultiMedia برای Win98 و بعد از آن. گزینه‌ها:
مثال‌ها (EXAMPLES)
خط فرمان ogg123 بسیار منعطف است، شاید حتی تا حدی گیج‌کننده باشد. در اینجا چند خط فرمان نمونه و توضیحی در مورد کارکرد آن‌ها آورده شده است.
پخش روی کارت صدای پیش‌فرض:
پخش تمام فایل‌های موجود در دایرکتوری ~/music و زیردایرکتوری‌های آن:
پخش یک فایل با استفاده از راه‌انداز OSS:
ارسال گزینهٔ «dsp» به راه‌انداز OSS:
استفاده از راه‌انداز ESD:
استفاده از راه‌انداز WAV با فایل خروجی «test.wav»:
گوش دادن به یک فایل هم‌زمان با نوشتن آن در یک فایل WAV:
توجه داشته باشید که گزینه‌ها به دستگاهی که در سمت چپ آن‌ها تعریف شده اعمال می‌شوند:
آزمون فشار (Stress test) روی دیسک سخت شما:
ایجاد جلوهٔ پژواک (echo) با esd و یک رایانهٔ کُند:
توجه داشته باشید که ممکن است اثر فشردن Ctrl-C به دلیل بافر شدن داده‌های صوتی در دستگاه صوتی، بلافاصله شنیده نشود. این تأخیر وابسته به سیستم است، اما معمولاً بیش از یک یا دو ثانیه طول نمی‌کشد.
فایل‌ها (FILES)
- /etc/libao.conf
- می‌تواند برای تعیین دستگاه خروجی پیش‌فرض برای تمامی برنامه‌های libao استفاده شود.
- ~/.libao
- فایل پیکربندی برای هر کاربر جهت بازنویسی تنظیمات سراسری دستگاه خروجی سیستم.
گزارش باگ‌ها (BUGS)
هدایت فایل‌های WAV از طریق پایپ (pipe) ممکن است رفتارهای غیرمنتظره‌ای در برنامه‌های دیگر ایجاد کند؛ زیرا فایل‌های WAV طول داده‌ها را در سرایند (header) خود ذخیره می‌کنند. با این حال، راه‌انداز خروجی در هنگام نوشتن سرایند از طول داده‌ها اطلاعی ندارد و هیچ مقداری هم به معنای «طول نامشخص» تعریف نشده است. اگر نیاز به استفاده از ogg123 در یک پایپ دارید، از راه‌انداز خروجی raw یا au استفاده کنید.
نویسندگان (AUTHORS)
- نویسندگان برنامه:
-
Kenneth Arnold <kcarnold-xiph@arnoldnet.net>
Stan Seibert <volsung@xiph.org> - نویسنده صفحه راهنما:
-
Stan Seibert <volsung@xiph.org>
همچنین ببینید (SEE ALSO)
| 2010 March 24 | Xiph.Org Foundation |