AUDTOOL(1) General Commands Manual AUDTOOL(1)

audtool - ابزار خط فرمانی برای کنترل پخش‌کننده صوتی Audacious

audtool [instance] command [parameter ...] ...

برنامه audtool دستورات را به یک نمونه در حال اجرای Audacious ارسال می‌کند.

این ابزار می‌تواند دستورات رایج متعددی را ارسال کند، مانند پرش به آهنگ بعدی در فهرست پخش، و همچنین می‌تواند اطلاعات وضعیت مانند عنوان آهنگ فعلی را چاپ کند.

شناسه instance می‌تواند به صورت -1، -2 و غیره (تا -9) مشخص شود تا تعیین کند در زمانی که چندین نمونه راه‌اندازی شده‌اند، کدام نمونه از Audacious باید کنترل شود.

عنوان قالب‌بندی‌شده آهنگ فعلی را چاپ می‌کند. بسته به تنظیمات Audacious، این ممکن است شامل اطلاعاتی مانند نام هنرمند و نام آلبوم باشد. برای چاپ فقط عنوان آهنگ، به جای آن از --current-song-tuple-data title استفاده کنید.
نام فایل (مسیر کامل یا URI) آهنگ فعلی را چاپ می‌کند.
مدت زمان آهنگ فعلی را در قالب M:SS چاپ می‌کند.
مدت زمان آهنگ فعلی را به ثانیه چاپ می‌کند.
مدت زمان آهنگ فعلی را به میلی‌ثانیه چاپ می‌کند.
شمارنده زمان پخش را در قالب M:SS چاپ می‌کند.
شمارنده زمان پخش را به ثانیه چاپ می‌کند.
شمارنده زمان پخش را به میلی‌ثانیه چاپ می‌کند.
بیت‌ریت جریان (استریم) را به بیت بر ثانیه چاپ می‌کند.
بیت‌ریت جریان را به کیلوبیت بر ثانیه چاپ می‌کند (۱ کیلوبیت = ۱۰۰۰ بیت).
نرخ نمونه‌برداری را به هرتز چاپ می‌کند.
نرخ نمونه‌برداری را به کیلوهرتز چاپ می‌کند.
تعداد کانال‌های صوتی را چاپ می‌کند.
مقدار یک فیلد مشخص‌شده (artist، year، genre و غیره) را برای آهنگ فعلی چاپ می‌کند. اگر نام فیلد حذف شود، فهرستی از فیلدهای مجاز چاپ خواهد شد.
بیت‌ریت جریان، نرخ نمونه‌برداری و تعداد کانال‌های صوتی را چاپ می‌کند.

شروع پخش. در صورت متوقف موقت (pause) بودن، پخش از همان نقطه ادامه می‌یابد. اگر در حال حاضر فعال باشد و متوقف نشده باشد، از ابتدای آهنگ مجدداً پخش می‌شود.
توقف موقت پخش، یا از سرگیری در صورت توقف موقت بودن.
معادل --playback-pause در صورت فعال بودن پخش، و در غیر این صورت معادل --playback-play.
توقف پخش.
در صورت فعال بودن پخش، کد خروج 0 (درست) را برمی‌گرداند.
در صورت متوقف موقت بودن پخش، کد خروج 0 (درست) را برمی‌گرداند.
در صورت غیرفعال بودن پخش، کد خروج 0 (درست) را برمی‌گرداند.
وضعیت پخش را چاپ می‌کند («playing»، «paused» یا «stopped»).
پرش به زمان داده‌شده به ثانیه، نسبت به ابتدای آهنگ.
پرش به زمان داده‌شده به ثانیه، نسبت به شمارنده زمان فعلی.
تغییر وضعیت ضبط جریان خروجی (با استفاده از FileWriter).
در صورت فعال بودن ضبط جریان، کد خروج 0 (درست) را برمی‌گرداند.

مشخص می‌کند که هر دستور بعدی فهرست پخش باید روی فهرست پخشی که در حال حاضر توسط Audacious نمایش داده می‌شود اعمال گردد، صرف‌نظر از اینکه کدام فهرست پخش در حال پخش است. این تنظیم تا زمانی که با --select-playing بازنویسی شود یا Audacious مجدداً راه‌اندازی شود، معتبر خواهد بود.

دستورات زیر نیز تحت تأثیر قرار می‌گیرند:

--current-song
--current-song-filename
--current-song-length[-seconds,-frames]
--current-song-tuple-data
مشخص می‌کند که در زمان فعال بودن پخش، هر دستور بعدی فهرست پخش باید روی فهرست پخشی که در حال حاضر در حال پخش است اعمال گردد. زمانی که پخش متوقف باشد، رفتار آن مشابه --select-displayed خواهد بود. این تنظیم پیش‌فرض است.

پرش به آهنگ بعدی در فهرست پخش.
پرش به آهنگ قبلی در فهرست پخش.
افزودن یک آهنگ به انتهای فهرست پخش. می‌توان یک URI یا یک مسیر فایل محلی (مطلق یا نسبی) مشخص کرد.
درج یک آهنگ در موقعیت داده‌شده (مبتنی بر ۱) در فهرست پخش.
افزودن یک آهنگ به فهرست پخش «در حال پخش» (Now Playing)، ایجاد فهرست پخش در صورت نیاز، و شروع پخش آهنگ. بسته به تنظیمات Audacious، ممکن است ابتدا فهرست پخش پاک شود.
حذف آهنگ در موقعیت داده‌شده از فهرست پخش.
تعداد آهنگ‌های موجود در فهرست پخش را چاپ می‌کند.
عنوان قالب‌بندی‌شده یک آهنگ در فهرست پخش را چاپ می‌کند.
نام فایل (مسیر کامل یا URI) یک آهنگ در فهرست پخش را چاپ می‌کند.
مدت زمان یک آهنگ در فهرست پخش را در قالب M:SS چاپ می‌کند.
مدت زمان یک آهنگ در فهرست پخش را به ثانیه چاپ می‌کند.
مدت زمان یک آهنگ در فهرست پخش را به میلی‌ثانیه چاپ می‌کند.
مقدار یک فیلد مشخص‌شده را برای یک آهنگ در فهرست پخش چاپ می‌کند.
عنوان تمام آهنگ‌های موجود در فهرست پخش را چاپ می‌کند.
موقعیت آهنگ فعلی در فهرست پخش را چاپ می‌کند.
پرش به آهنگ در موقعیت داده‌شده در فهرست پخش.
پاک کردن فهرست پخش.
وضعیت پیشروی خودکار فهرست پخش را چاپ می‌کند («on» یا «off»).
تغییر وضعیت پیشروی خودکار فهرست پخش.
وضعیت تکرار فهرست پخش را چاپ می‌کند («on» یا «off»).
تغییر وضعیت تکرار فهرست پخش.
وضعیت پخش تصادفی فهرست پخش را چاپ می‌کند («on» یا «off»).
تغییر وضعیت پخش تصادفی فهرست پخش.
وضعیت گزینه «توقف پس از آهنگ فعلی» را چاپ می‌کند («on» یا «off»).
تغییر وضعیت گزینه «توقف پس از آهنگ فعلی».
ذخیره فهرست پخش در مسیر فایل داده‌شده. قالب بر اساس پسوند فایل تعیین می‌شود.

تعداد فهرست‌های پخش باز را چاپ می‌کند.
شماره فهرست پخش فعلی را چاپ می‌کند، که در آن «فعلی» بر اساس --select-displayed یا --select-playing تفسیر می‌شود.
شروع پخش در فهرست پخش فعلی، و در صورت امکان از سرگیری از آخرین نقطه پخش‌شده. زمانی که --select-displayed فعال باشد، می‌توان از این دستور برای انتقال پخش به فهرست پخش نمایش‌داده‌شده استفاده کرد.
نمایش فهرست پخش داده‌شده. زمانی که --select-playing فعال باشد و فهرست پخش دیگری در حال پخش باشد، این دستور همچنین پخش را به فهرست پخش داده‌شده تغییر می‌دهد. گزینه --select-displayed این رفتار را غیرفعال می‌کند.
عنوان فهرست پخش فعلی را چاپ می‌کند.
تنظیم عنوان فهرست پخش فعلی.
درج یک فهرست پخش جدید پس از فهرست پخش فعلی و تغییر وضعیت به آن، همانند زمانی که از --set-current-playlist استفاده شده باشد.
حذف فهرست پخش فعلی.

افزودن آهنگ واقع در موقعیت داده‌شده از فهرست پخش به صف.
حذف آهنگ واقع در موقعیت داده‌شده از فهرست پخش از صف.
در صورت قرار داشتن آهنگ موقعیت داده‌شده در صف، کد خروج 0 (درست) را برمی‌گرداند.
موقعیت در صف را برای آهنگ واقع در موقعیت داده‌شده از فهرست پخش چاپ می‌کند.
موقعیت در فهرست پخش را برای آهنگ واقع در موقعیت داده‌شده در صف چاپ می‌کند.
تعداد آهنگ‌های موجود در صف را چاپ می‌کند.
عنوان تمام آهنگ‌های موجود در صف را چاپ می‌کند.
پاک کردن صف.

میزان بلندی صدای فعلی را به درصد چاپ می‌کند.
تنظیم میزان بلندی صدای فعلی به درصد.
فعال یا غیرفعال کردن اکولایزر.
تنظیمات اکولایزر (پیش‌تقویت‌کننده و بهره برای همه باندها) را به دسی‌بل چاپ می‌کند.
اعمال تنظیمات اکولایزر (پیش‌تقویت‌کننده و بهره برای همه باندها) به دسی‌بل.
میزان پیش‌تقویت‌کننده اکولایزر را به دسی‌بل چاپ می‌کند.
تنظیم میزان پیش‌تقویت‌کننده اکولایزر به دسی‌بل.
میزان بهره باند مشخص‌شده اکولایزر (0-9) را به دسی‌بل چاپ می‌کند.
تنظیم میزان بهره باند مشخص‌شده اکولایزر (0-9) به دسی‌بل.

نمایش یا مخفی کردن پنجره Audacious.
نمایش یا مخفی کردن پنجره افزودن فایل‌ها (Add Files).
نمایش یا مخفی کردن پنجره پرش به آهنگ (Jump to Song).
نمایش یا مخفی کردن پنجره تنظیمات (Settings).
نمایش یا مخفی کردن پنجره درباره (About).
چاپ اطلاعات نسخه.
در صورت فعال بودن افزونه مشخص‌شده، کد خروج 0 (درست) را برمی‌گرداند. افزونه با استفاده از نام فایل نصب‌شده بدون مسیر پوشه و پسوند مشخص می‌شود: به عنوان مثال، crossfade برای lib/audacious/Effect/crossfade.so.
فعال یا غیرفعال کردن افزونه مشخص‌شده. توجه داشته باشید که افزونه‌های رابط کاربری و خروجی را نمی‌توان مستقیماً غیرفعال کرد زیرا همیشه باید یکی از هر کدام فعال باشد. فعال کردن یک افزونه رابط یا خروجی به طور خودکار افزونه قبلی را غیرفعال می‌کند.
مقدار یک تنظیم پیکربندی را چاپ می‌کند. هرگونه استفاده از این دستور کاملاً پشتیبانی‌نشده است. نحوه یافتن section و name یک تنظیم مشخص به عنوان تمرین به خواننده واگذار شده است.
تغییر مقدار یک تنظیم پیکربندی. این دستور پشتیبانی‌نشده و خطرناک است. ممکن است اثرات جانبی غیرمنتظره‌ای (مانند کرش کردن Audacious) داشته باشد، یا اصلاً هیچ اثری نداشته باشد. مسئولیت استفاده از آن بر عهده خودتان است!
بستن و خاموش کردن Audacious.
چاپ خلاصه‌ای کوتاه از دستورات audtool.

دستورات می‌توانند با پیشوند «--» (گزینه‌های طولانی به سبک گنو) یا بدون آن استفاده شوند، انتخاب با شماست.

در حال حاضر هیچ اشکال شناخته‌شده‌ای در audtool وجود ندارد؛ در صورت مشاهده هرگونه اشکال، لطفاً آن را در https://github.com/audacious-media-player/audacious/issues گزارش دهید.

برنامه audtool توسط George Averill <nhjm@nhjm.net> و Ariadne Conill <ariadne@dereferenced.org> نوشته شده است.

این صفحه راهنما توسط Adam Cecile <gandalf@le-vert.net> و Kiyoshi Aman <kiyoshi@atheme.org> نوشته شده است. تغییرات جزئی دیگری توسط Ariadne Conill <ariadne@dereferenced.org> و Tony Vroon <chainsaw@gentoo.org> انجام شد. این صفحه راهنما برای Audacious نسخه 3.7 و بالاتر توسط John Lindgren <john@jlindgren.net> به‌روزرسانی شد.

این اثر تحت مجوز Creative Commons Attribution 3.0 Unported License https://creativecommons.org/licenses/by/3.0 منتشر شده است.

audacious(1)

https://audacious-media-player.org

September 2017 Version 4.6.1