| AUDTOOL(1) | General Commands Manual | AUDTOOL(1) |
نام (NAME)
audtool - ابزار خط فرمانی برای کنترل پخشکننده صوتی Audacious
خلاصه دستور (SYNOPSIS)
audtool [instance] command [parameter ...] ...
توضیحات (DESCRIPTION)
برنامه audtool دستورات را به یک نمونه در حال اجرای Audacious ارسال میکند.
این ابزار میتواند دستورات رایج متعددی را ارسال کند، مانند پرش به آهنگ بعدی در فهرست پخش، و همچنین میتواند اطلاعات وضعیت مانند عنوان آهنگ فعلی را چاپ کند.
شناسه instance میتواند به صورت -1، -2 و غیره (تا -9) مشخص شود تا تعیین کند در زمانی که چندین نمونه راهاندازی شدهاند، کدام نمونه از Audacious باید کنترل شود.
دستورات (COMMANDS)
اطلاعات آهنگ فعلی:
- --current-song
- عنوان قالببندیشده آهنگ فعلی را چاپ میکند. بسته به تنظیمات Audacious، این ممکن است شامل اطلاعاتی مانند نام هنرمند و نام آلبوم باشد. برای چاپ فقط عنوان آهنگ، به جای آن از --current-song-tuple-data title استفاده کنید.
- --current-song-filename
- نام فایل (مسیر کامل یا URI) آهنگ فعلی را چاپ میکند.
- --current-song-length
- مدت زمان آهنگ فعلی را در قالب M:SS چاپ میکند.
- --current-song-length-seconds
- مدت زمان آهنگ فعلی را به ثانیه چاپ میکند.
- --current-song-length-frames
- مدت زمان آهنگ فعلی را به میلیثانیه چاپ میکند.
- --current-song-output-length
- شمارنده زمان پخش را در قالب M:SS چاپ میکند.
- --current-song-output-length-seconds
- شمارنده زمان پخش را به ثانیه چاپ میکند.
- --current-song-output-length-frames
- شمارنده زمان پخش را به میلیثانیه چاپ میکند.
- --current-song-bitrate
- بیتریت جریان (استریم) را به بیت بر ثانیه چاپ میکند.
- --current-song-bitrate-kbps
- بیتریت جریان را به کیلوبیت بر ثانیه چاپ میکند (۱ کیلوبیت = ۱۰۰۰ بیت).
- --current-song-frequency
- نرخ نمونهبرداری را به هرتز چاپ میکند.
- --current-song-frequency-khz
- نرخ نمونهبرداری را به کیلوهرتز چاپ میکند.
- --current-song-channels
- تعداد کانالهای صوتی را چاپ میکند.
- --current-song-tuple-data field
- مقدار یک فیلد مشخصشده (artist، year، genre و غیره) را برای آهنگ فعلی چاپ میکند. اگر نام فیلد حذف شود، فهرستی از فیلدهای مجاز چاپ خواهد شد.
- --current-song-info
- بیتریت جریان، نرخ نمونهبرداری و تعداد کانالهای صوتی را چاپ میکند.
دستورات پخش:
- --playback-play
- شروع پخش. در صورت متوقف موقت (pause) بودن، پخش از همان نقطه ادامه مییابد. اگر در حال حاضر فعال باشد و متوقف نشده باشد، از ابتدای آهنگ مجدداً پخش میشود.
- --playback-pause
- توقف موقت پخش، یا از سرگیری در صورت توقف موقت بودن.
- --playback-playpause
- معادل --playback-pause در صورت فعال بودن پخش، و در غیر این صورت معادل --playback-play.
- --playback-stop
- توقف پخش.
- --playback-playing
- در صورت فعال بودن پخش، کد خروج 0 (درست) را برمیگرداند.
- --playback-paused
- در صورت متوقف موقت بودن پخش، کد خروج 0 (درست) را برمیگرداند.
- --playback-stopped
- در صورت غیرفعال بودن پخش، کد خروج 0 (درست) را برمیگرداند.
- --playback-status
- وضعیت پخش را چاپ میکند («playing»، «paused» یا «stopped»).
- --playback-seek time
- پرش به زمان دادهشده به ثانیه، نسبت به ابتدای آهنگ.
- --playback-seek-relative time
- پرش به زمان دادهشده به ثانیه، نسبت به شمارنده زمان فعلی.
- --playback-record
- تغییر وضعیت ضبط جریان خروجی (با استفاده از FileWriter).
- --playback-recording
- در صورت فعال بودن ضبط جریان، کد خروج 0 (درست) را برمیگرداند.
انتخاب فهرست پخش:
- --select-displayed
- مشخص
میکند که
هر دستور
بعدی فهرست
پخش باید
روی فهرست
پخشی که در
حال حاضر
توسط Audacious
نمایش داده
میشود
اعمال
گردد،
صرفنظر از
اینکه کدام
فهرست پخش
در حال پخش
است. این
تنظیم تا
زمانی که با
--select-playing
بازنویسی
شود یا Audacious
مجدداً
راهاندازی
شود، معتبر
خواهد بود.
دستورات زیر نیز تحت تأثیر قرار میگیرند:
--current-song-filename
--current-song-length[-seconds,-frames]
--current-song-tuple-data
- --select-playing
- مشخص میکند که در زمان فعال بودن پخش، هر دستور بعدی فهرست پخش باید روی فهرست پخشی که در حال حاضر در حال پخش است اعمال گردد. زمانی که پخش متوقف باشد، رفتار آن مشابه --select-displayed خواهد بود. این تنظیم پیشفرض است.
دستورات فهرست پخش:
- --playlist-advance
- پرش به آهنگ بعدی در فهرست پخش.
- --playlist-reverse
- پرش به آهنگ قبلی در فهرست پخش.
- --playlist-addurl path
- افزودن یک آهنگ به انتهای فهرست پخش. میتوان یک URI یا یک مسیر فایل محلی (مطلق یا نسبی) مشخص کرد.
- --playlist-insurl path position
- درج یک آهنگ در موقعیت دادهشده (مبتنی بر ۱) در فهرست پخش.
- --playlist-addurl-to-new-playlist path
- افزودن یک آهنگ به فهرست پخش «در حال پخش» (Now Playing)، ایجاد فهرست پخش در صورت نیاز، و شروع پخش آهنگ. بسته به تنظیمات Audacious، ممکن است ابتدا فهرست پخش پاک شود.
- --playlist-delete position
- حذف آهنگ در موقعیت دادهشده از فهرست پخش.
- --playlist-length
- تعداد آهنگهای موجود در فهرست پخش را چاپ میکند.
- --playlist-song position
- عنوان قالببندیشده یک آهنگ در فهرست پخش را چاپ میکند.
- --playlist-song-filename position
- نام فایل (مسیر کامل یا URI) یک آهنگ در فهرست پخش را چاپ میکند.
- --playlist-song-length position
- مدت زمان یک آهنگ در فهرست پخش را در قالب M:SS چاپ میکند.
- --playlist-song-length-seconds position
- مدت زمان یک آهنگ در فهرست پخش را به ثانیه چاپ میکند.
- --playlist-song-length-frames position
- مدت زمان یک آهنگ در فهرست پخش را به میلیثانیه چاپ میکند.
- --playlist-tuple-data field position
- مقدار یک فیلد مشخصشده را برای یک آهنگ در فهرست پخش چاپ میکند.
- --playlist-display
- عنوان تمام آهنگهای موجود در فهرست پخش را چاپ میکند.
- --playlist-position
- موقعیت آهنگ فعلی در فهرست پخش را چاپ میکند.
- --playlist-jump position
- پرش به آهنگ در موقعیت دادهشده در فهرست پخش.
- --playlist-clear
- پاک کردن فهرست پخش.
- --playlist-auto-advance-status
- وضعیت پیشروی خودکار فهرست پخش را چاپ میکند («on» یا «off»).
- --playlist-auto-advance-toggle
- تغییر وضعیت پیشروی خودکار فهرست پخش.
- --playlist-repeat-status
- وضعیت تکرار فهرست پخش را چاپ میکند («on» یا «off»).
- --playlist-repeat-toggle
- تغییر وضعیت تکرار فهرست پخش.
- --playlist-shuffle-status
- وضعیت پخش تصادفی فهرست پخش را چاپ میکند («on» یا «off»).
- --playlist-shuffle-toggle
- تغییر وضعیت پخش تصادفی فهرست پخش.
- --playlist-stop-after-status
- وضعیت گزینه «توقف پس از آهنگ فعلی» را چاپ میکند («on» یا «off»).
- --playlist-stop-after-toggle
- تغییر وضعیت گزینه «توقف پس از آهنگ فعلی».
- --playlist-save path
- ذخیره فهرست پخش در مسیر فایل دادهشده. قالب بر اساس پسوند فایل تعیین میشود.
دستورات بیشتر فهرست پخش:
- --number-of-playlists
- تعداد فهرستهای پخش باز را چاپ میکند.
- --current-playlist
- شماره فهرست پخش فعلی را چاپ میکند، که در آن «فعلی» بر اساس --select-displayed یا --select-playing تفسیر میشود.
- --play-current-playlist
- شروع پخش در فهرست پخش فعلی، و در صورت امکان از سرگیری از آخرین نقطه پخششده. زمانی که --select-displayed فعال باشد، میتوان از این دستور برای انتقال پخش به فهرست پخش نمایشدادهشده استفاده کرد.
- --set-current-playlist playlist
- نمایش فهرست پخش دادهشده. زمانی که --select-playing فعال باشد و فهرست پخش دیگری در حال پخش باشد، این دستور همچنین پخش را به فهرست پخش دادهشده تغییر میدهد. گزینه --select-displayed این رفتار را غیرفعال میکند.
- --current-playlist-name
- عنوان فهرست پخش فعلی را چاپ میکند.
- --set-current-playlist-name title
- تنظیم عنوان فهرست پخش فعلی.
- --new-playlist
- درج یک فهرست پخش جدید پس از فهرست پخش فعلی و تغییر وضعیت به آن، همانند زمانی که از --set-current-playlist استفاده شده باشد.
- --delete-current-playlist
- حذف فهرست پخش فعلی.
دستورات صف فهرست پخش:
- --playqueue-add position
- افزودن آهنگ واقع در موقعیت دادهشده از فهرست پخش به صف.
- --playqueue-remove position
- حذف آهنگ واقع در موقعیت دادهشده از فهرست پخش از صف.
- --playqueue-is-queued position
- در صورت قرار داشتن آهنگ موقعیت دادهشده در صف، کد خروج 0 (درست) را برمیگرداند.
- --playqueue-get-queue-position position
- موقعیت در صف را برای آهنگ واقع در موقعیت دادهشده از فهرست پخش چاپ میکند.
- --playqueue-get-list-position position
- موقعیت در فهرست پخش را برای آهنگ واقع در موقعیت دادهشده در صف چاپ میکند.
- --playqueue-length
- تعداد آهنگهای موجود در صف را چاپ میکند.
- --playqueue-display
- عنوان تمام آهنگهای موجود در صف را چاپ میکند.
- --playqueue-clear
- پاک کردن صف.
کنترل صدا و اکولایزر:
- --get-volume
- میزان بلندی صدای فعلی را به درصد چاپ میکند.
- --set-volume level
- تنظیم میزان بلندی صدای فعلی به درصد.
- --equalizer-activate [on|off]
- فعال یا غیرفعال کردن اکولایزر.
- --equalizer-get
- تنظیمات اکولایزر (پیشتقویتکننده و بهره برای همه باندها) را به دسیبل چاپ میکند.
- --equalizer-set preamp band0 band1 band2 band3 band4 band5 band6 band7 band8 band9
- اعمال تنظیمات اکولایزر (پیشتقویتکننده و بهره برای همه باندها) به دسیبل.
- --equalizer-get-preamp
- میزان پیشتقویتکننده اکولایزر را به دسیبل چاپ میکند.
- --equalizer-set-preamp preamp
- تنظیم میزان پیشتقویتکننده اکولایزر به دسیبل.
- --equalizer-get-band band
- میزان بهره باند مشخصشده اکولایزر (0-9) را به دسیبل چاپ میکند.
- --equalizer-set-band band gain
- تنظیم میزان بهره باند مشخصشده اکولایزر (0-9) به دسیبل.
متفرقه:
- --mainwin-show [on|off]
- نمایش یا مخفی کردن پنجره Audacious.
- --filebrowser-show [on|off]
- نمایش یا مخفی کردن پنجره افزودن فایلها (Add Files).
- --jumptofile-show [on|off]
- نمایش یا مخفی کردن پنجره پرش به آهنگ (Jump to Song).
- --preferences-show [on|off]
- نمایش یا مخفی کردن پنجره تنظیمات (Settings).
- --about-show [on|off]
- نمایش یا مخفی کردن پنجره درباره (About).
- --version
- چاپ اطلاعات نسخه.
- --plugin-is-enabled plugin
- در صورت فعال بودن افزونه مشخصشده، کد خروج 0 (درست) را برمیگرداند. افزونه با استفاده از نام فایل نصبشده بدون مسیر پوشه و پسوند مشخص میشود: به عنوان مثال، crossfade برای lib/audacious/Effect/crossfade.so.
- --plugin-enable plugin [on|off]
- فعال یا غیرفعال کردن افزونه مشخصشده. توجه داشته باشید که افزونههای رابط کاربری و خروجی را نمیتوان مستقیماً غیرفعال کرد زیرا همیشه باید یکی از هر کدام فعال باشد. فعال کردن یک افزونه رابط یا خروجی به طور خودکار افزونه قبلی را غیرفعال میکند.
- --config-get [section:]name
- مقدار یک تنظیم پیکربندی را چاپ میکند. هرگونه استفاده از این دستور کاملاً پشتیبانینشده است. نحوه یافتن section و name یک تنظیم مشخص به عنوان تمرین به خواننده واگذار شده است.
- --config-set [section:]name value
- تغییر مقدار یک تنظیم پیکربندی. این دستور پشتیبانینشده و خطرناک است. ممکن است اثرات جانبی غیرمنتظرهای (مانند کرش کردن Audacious) داشته باشد، یا اصلاً هیچ اثری نداشته باشد. مسئولیت استفاده از آن بر عهده خودتان است!
- --shutdown
- بستن و خاموش کردن Audacious.
- --help
- چاپ خلاصهای کوتاه از دستورات audtool.
دستورات میتوانند با پیشوند «--» (گزینههای طولانی به سبک گنو) یا بدون آن استفاده شوند، انتخاب با شماست.
اشکالات (BUGS)
در حال حاضر هیچ اشکال شناختهشدهای در audtool وجود ندارد؛ در صورت مشاهده هرگونه اشکال، لطفاً آن را در https://github.com/audacious-media-player/audacious/issues گزارش دهید.
نویسندگان (AUTHORS)
برنامه 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 منتشر شده است.
همچنین ببینید (SEE ALSO)
وبسایت (WEBSITE)
| September 2017 | Version 4.6.1 |