.TH AUDTOOL "1" "September 2017" "Version 4.6.1" .SH "نام (NAME)" audtool \- ابزار خط فرمانی برای کنترل پخش‌کننده صوتی Audacious .SH "خلاصه دستور (SYNOPSIS)" .B audtool [\fIinstance\fR] \fIcommand\fR [\fIparameter\fR ...] ... .SH "توضیحات (DESCRIPTION)" برنامه .B audtool دستورات را به یک نمونه در حال اجرای Audacious ارسال می‌کند. .PP این ابزار می‌تواند دستورات رایج متعددی را ارسال کند، مانند پرش به آهنگ بعدی در فهرست پخش، و همچنین می‌تواند اطلاعات وضعیت مانند عنوان آهنگ فعلی را چاپ کند. .PP شناسه \fIinstance\fR می‌تواند به صورت \fB-1\fR، \fB-2\fR و غیره (تا \fB-9\fR) مشخص شود تا تعیین کند در زمانی که چندین نمونه راه‌اندازی شده‌اند، کدام نمونه از Audacious باید کنترل شود. .SH "دستورات (COMMANDS)" .SS "اطلاعات آهنگ فعلی:" .TP .B --current-song عنوان قالب‌بندی‌شده آهنگ فعلی را چاپ می‌کند. بسته به تنظیمات Audacious، این ممکن است شامل اطلاعاتی مانند نام هنرمند و نام آلبوم باشد. برای چاپ فقط عنوان آهنگ، به جای آن از \fB--current-song-tuple-data title\fR استفاده کنید. .TP .B --current-song-filename نام فایل (مسیر کامل یا URI) آهنگ فعلی را چاپ می‌کند. .TP .B --current-song-length مدت زمان آهنگ فعلی را در قالب M:SS چاپ می‌کند. .TP .B --current-song-length-seconds مدت زمان آهنگ فعلی را به ثانیه چاپ می‌کند. .TP .B --current-song-length-frames مدت زمان آهنگ فعلی را به میلی‌ثانیه چاپ می‌کند. .TP .B --current-song-output-length شمارنده زمان پخش را در قالب M:SS چاپ می‌کند. .TP .B --current-song-output-length-seconds شمارنده زمان پخش را به ثانیه چاپ می‌کند. .TP .B --current-song-output-length-frames شمارنده زمان پخش را به میلی‌ثانیه چاپ می‌کند. .TP .B --current-song-bitrate بیت‌ریت جریان (استریم) را به بیت بر ثانیه چاپ می‌کند. .TP .B --current-song-bitrate-kbps بیت‌ریت جریان را به کیلوبیت بر ثانیه چاپ می‌کند (۱ کیلوبیت = ۱۰۰۰ بیت). .TP .B --current-song-frequency نرخ نمونه‌برداری را به هرتز چاپ می‌کند. .TP .B --current-song-frequency-khz نرخ نمونه‌برداری را به کیلوهرتز چاپ می‌کند. .TP .B --current-song-channels تعداد کانال‌های صوتی را چاپ می‌کند. .TP .B --current-song-tuple-data \fIfield\fR مقدار یک فیلد مشخص‌شده (\fBartist\fR، \fByear\fR، \fBgenre\fR و غیره) را برای آهنگ فعلی چاپ می‌کند. اگر نام فیلد حذف شود، فهرستی از فیلدهای مجاز چاپ خواهد شد. .TP .B --current-song-info بیت‌ریت جریان، نرخ نمونه‌برداری و تعداد کانال‌های صوتی را چاپ می‌کند. .SS "دستورات پخش:" .TP .B --playback-play شروع پخش. در صورت متوقف موقت (pause) بودن، پخش از همان نقطه ادامه می‌یابد. اگر در حال حاضر فعال باشد و متوقف نشده باشد، از ابتدای آهنگ مجدداً پخش می‌شود. .TP .B --playback-pause توقف موقت پخش، یا از سرگیری در صورت توقف موقت بودن. .TP .B --playback-playpause معادل \fB--playback-pause\fR در صورت فعال بودن پخش، و در غیر این صورت معادل \fB--playback-play\fR. .TP .B --playback-stop توقف پخش. .TP .B --playback-playing در صورت فعال بودن پخش، کد خروج 0 (درست) را برمی‌گرداند. .TP .B --playback-paused در صورت متوقف موقت بودن پخش، کد خروج 0 (درست) را برمی‌گرداند. .TP .B --playback-stopped در صورت غیرفعال بودن پخش، کد خروج 0 (درست) را برمی‌گرداند. .TP .B --playback-status وضعیت پخش را چاپ می‌کند («playing»، «paused» یا «stopped»). .TP .B --playback-seek \fItime\fR پرش به زمان داده‌شده به ثانیه، نسبت به ابتدای آهنگ. .TP .B --playback-seek-relative \fItime\fR پرش به زمان داده‌شده به ثانیه، نسبت به شمارنده زمان فعلی. .TP .B --playback-record تغییر وضعیت ضبط جریان خروجی (با استفاده از FileWriter). .TP .B --playback-recording در صورت فعال بودن ضبط جریان، کد خروج 0 (درست) را برمی‌گرداند. .SS "انتخاب فهرست پخش:" .TP .B --select-displayed مشخص می‌کند که هر دستور بعدی فهرست پخش باید روی فهرست پخشی که در حال حاضر توسط Audacious نمایش داده می‌شود اعمال گردد، صرف‌نظر از اینکه کدام فهرست پخش در حال پخش است. این تنظیم تا زمانی که با \fB--select-playing\fR بازنویسی شود یا Audacious مجدداً راه‌اندازی شود، معتبر خواهد بود. دستورات زیر نیز تحت تأثیر قرار می‌گیرند: .RS .RS --current-song .br --current-song-filename .br --current-song-length[-seconds,-frames] .br --current-song-tuple-data .RE .RE .TP .B --select-playing مشخص می‌کند که در زمان فعال بودن پخش، هر دستور بعدی فهرست پخش باید روی فهرست پخشی که در حال حاضر در حال پخش است اعمال گردد. زمانی که پخش متوقف باشد، رفتار آن مشابه \fB--select-displayed\fR خواهد بود. این تنظیم پیش‌فرض است. .SS "دستورات فهرست پخش:" .TP .B --playlist-advance پرش به آهنگ بعدی در فهرست پخش. .TP .B --playlist-reverse پرش به آهنگ قبلی در فهرست پخش. .TP .B --playlist-addurl \fIpath\fR افزودن یک آهنگ به انتهای فهرست پخش. می‌توان یک URI یا یک مسیر فایل محلی (مطلق یا نسبی) مشخص کرد. .TP .B --playlist-insurl \fIpath\fR \fIposition\fR درج یک آهنگ در موقعیت داده‌شده (مبتنی بر ۱) در فهرست پخش. .TP .B --playlist-addurl-to-new-playlist \fIpath\fR افزودن یک آهنگ به فهرست پخش «در حال پخش» (Now Playing)، ایجاد فهرست پخش در صورت نیاز، و شروع پخش آهنگ. بسته به تنظیمات Audacious، ممکن است ابتدا فهرست پخش پاک شود. .TP .B --playlist-delete \fIposition\fR حذف آهنگ در موقعیت داده‌شده از فهرست پخش. .TP .B --playlist-length تعداد آهنگ‌های موجود در فهرست پخش را چاپ می‌کند. .TP .B --playlist-song \fIposition\fR عنوان قالب‌بندی‌شده یک آهنگ در فهرست پخش را چاپ می‌کند. .TP .B --playlist-song-filename \fIposition\fR نام فایل (مسیر کامل یا URI) یک آهنگ در فهرست پخش را چاپ می‌کند. .TP .B --playlist-song-length \fIposition\fR مدت زمان یک آهنگ در فهرست پخش را در قالب M:SS چاپ می‌کند. .TP .B --playlist-song-length-seconds \fIposition\fR مدت زمان یک آهنگ در فهرست پخش را به ثانیه چاپ می‌کند. .TP .B --playlist-song-length-frames \fIposition\fR مدت زمان یک آهنگ در فهرست پخش را به میلی‌ثانیه چاپ می‌کند. .TP .B --playlist-tuple-data \fIfield\fR \fIposition\fR مقدار یک فیلد مشخص‌شده را برای یک آهنگ در فهرست پخش چاپ می‌کند. .TP .B --playlist-display عنوان تمام آهنگ‌های موجود در فهرست پخش را چاپ می‌کند. .TP .B --playlist-position موقعیت آهنگ فعلی در فهرست پخش را چاپ می‌کند. .TP .B --playlist-jump \fIposition\fR پرش به آهنگ در موقعیت داده‌شده در فهرست پخش. .TP .B --playlist-clear پاک کردن فهرست پخش. .TP .B --playlist-auto-advance-status وضعیت پیشروی خودکار فهرست پخش را چاپ می‌کند («on» یا «off»). .TP .B --playlist-auto-advance-toggle تغییر وضعیت پیشروی خودکار فهرست پخش. .TP .B --playlist-repeat-status وضعیت تکرار فهرست پخش را چاپ می‌کند («on» یا «off»). .TP .B --playlist-repeat-toggle تغییر وضعیت تکرار فهرست پخش. .TP .B --playlist-shuffle-status وضعیت پخش تصادفی فهرست پخش را چاپ می‌کند («on» یا «off»). .TP .B --playlist-shuffle-toggle تغییر وضعیت پخش تصادفی فهرست پخش. .TP .B --playlist-stop-after-status وضعیت گزینه «توقف پس از آهنگ فعلی» را چاپ می‌کند («on» یا «off»). .TP .B --playlist-stop-after-toggle تغییر وضعیت گزینه «توقف پس از آهنگ فعلی». .TP .B --playlist-save \fIpath\fR ذخیره فهرست پخش در مسیر فایل داده‌شده. قالب بر اساس پسوند فایل تعیین می‌شود. .SS "دستورات بیشتر فهرست پخش:" .TP .B --number-of-playlists تعداد فهرست‌های پخش باز را چاپ می‌کند. .TP .B --current-playlist شماره فهرست پخش فعلی را چاپ می‌کند، که در آن «فعلی» بر اساس \fB--select-displayed\fR یا \fB--select-playing\fR تفسیر می‌شود. .TP .B --play-current-playlist شروع پخش در فهرست پخش فعلی، و در صورت امکان از سرگیری از آخرین نقطه پخش‌شده. زمانی که \fB--select-displayed\fR فعال باشد، می‌توان از این دستور برای انتقال پخش به فهرست پخش نمایش‌داده‌شده استفاده کرد. .TP .B --set-current-playlist \fIplaylist\fR نمایش فهرست پخش داده‌شده. زمانی که \fB--select-playing\fR فعال باشد و فهرست پخش دیگری در حال پخش باشد، این دستور همچنین پخش را به فهرست پخش داده‌شده تغییر می‌دهد. گزینه \fB--select-displayed\fR این رفتار را غیرفعال می‌کند. .TP .B --current-playlist-name عنوان فهرست پخش فعلی را چاپ می‌کند. .TP .B --set-current-playlist-name \fItitle\fR تنظیم عنوان فهرست پخش فعلی. .TP .B --new-playlist درج یک فهرست پخش جدید پس از فهرست پخش فعلی و تغییر وضعیت به آن، همانند زمانی که از \fB--set-current-playlist\fR استفاده شده باشد. .TP .B --delete-current-playlist حذف فهرست پخش فعلی. .SS "دستورات صف فهرست پخش:" .TP .B --playqueue-add \fIposition\fR افزودن آهنگ واقع در موقعیت داده‌شده از فهرست پخش به صف. .TP .B --playqueue-remove \fIposition\fR حذف آهنگ واقع در موقعیت داده‌شده از فهرست پخش از صف. .TP .B --playqueue-is-queued \fIposition\fR در صورت قرار داشتن آهنگ موقعیت داده‌شده در صف، کد خروج 0 (درست) را برمی‌گرداند. .TP .B --playqueue-get-queue-position \fIposition\fR موقعیت در صف را برای آهنگ واقع در موقعیت داده‌شده از فهرست پخش چاپ می‌کند. .TP .B --playqueue-get-list-position \fIposition\fR موقعیت در فهرست پخش را برای آهنگ واقع در موقعیت داده‌شده در صف چاپ می‌کند. .TP .B --playqueue-length تعداد آهنگ‌های موجود در صف را چاپ می‌کند. .TP .B --playqueue-display عنوان تمام آهنگ‌های موجود در صف را چاپ می‌کند. .TP .B --playqueue-clear پاک کردن صف. .SS "کنترل صدا و اکولایزر:" .TP .B --get-volume میزان بلندی صدای فعلی را به درصد چاپ می‌کند. .TP .B --set-volume \fIlevel\fR تنظیم میزان بلندی صدای فعلی به درصد. .TP .B --equalizer-activate [on|off] فعال یا غیرفعال کردن اکولایزر. .TP .B --equalizer-get تنظیمات اکولایزر (پیش‌تقویت‌کننده و بهره برای همه باندها) را به دسی‌بل چاپ می‌کند. .TP .B --equalizer-set \fIpreamp\fR \fIband0\fR \fIband1\fR \fIband2\fR \fIband3\fR \fIband4\fR \fIband5\fR \fIband6\fR \fIband7\fR \fIband8\fR \fIband9\fR اعمال تنظیمات اکولایزر (پیش‌تقویت‌کننده و بهره برای همه باندها) به دسی‌بل. .TP .B --equalizer-get-preamp میزان پیش‌تقویت‌کننده اکولایزر را به دسی‌بل چاپ می‌کند. .TP .B --equalizer-set-preamp \fIpreamp\fR تنظیم میزان پیش‌تقویت‌کننده اکولایزر به دسی‌بل. .TP .B --equalizer-get-band \fIband\fR میزان بهره باند مشخص‌شده اکولایزر (0-9) را به دسی‌بل چاپ می‌کند. .TP .B --equalizer-set-band \fIband\fR \fIgain\fR تنظیم میزان بهره باند مشخص‌شده اکولایزر (0-9) به دسی‌بل. .SS "متفرقه:" .TP .B --mainwin-show [on|off] نمایش یا مخفی کردن پنجره Audacious. .TP .B --filebrowser-show [on|off] نمایش یا مخفی کردن پنجره افزودن فایل‌ها (Add Files). .TP .B --jumptofile-show [on|off] نمایش یا مخفی کردن پنجره پرش به آهنگ (Jump to Song). .TP .B --preferences-show [on|off] نمایش یا مخفی کردن پنجره تنظیمات (Settings). .TP .B --about-show [on|off] نمایش یا مخفی کردن پنجره درباره (About). .TP .B --version چاپ اطلاعات نسخه. .TP .B --plugin-is-enabled \fIplugin\fR در صورت فعال بودن افزونه مشخص‌شده، کد خروج 0 (درست) را برمی‌گرداند. افزونه با استفاده از نام فایل نصب‌شده بدون مسیر پوشه و پسوند مشخص می‌شود: به عنوان مثال، \fBcrossfade\fR برای \fIlib/audacious/Effect/crossfade.so\fR. .TP .B --plugin-enable \fIplugin\fR [on|off] فعال یا غیرفعال کردن افزونه مشخص‌شده. توجه داشته باشید که افزونه‌های رابط کاربری و خروجی را نمی‌توان مستقیماً غیرفعال کرد زیرا همیشه باید یکی از هر کدام فعال باشد. فعال کردن یک افزونه رابط یا خروجی به طور خودکار افزونه قبلی را غیرفعال می‌کند. .TP .B --config-get [\fIsection\fR:]\fIname\fR مقدار یک تنظیم پیکربندی را چاپ می‌کند. هرگونه استفاده از این دستور کاملاً پشتیبانی‌نشده است. نحوه یافتن \fIsection\fR و \fIname\fR یک تنظیم مشخص به عنوان تمرین به خواننده واگذار شده است. .TP .B --config-set [\fIsection\fR:]\fIname\fR \fIvalue\fR تغییر مقدار یک تنظیم پیکربندی. این دستور پشتیبانی‌نشده و خطرناک است. ممکن است اثرات جانبی غیرمنتظره‌ای (مانند کرش کردن Audacious) داشته باشد، یا اصلاً هیچ اثری نداشته باشد. مسئولیت استفاده از آن بر عهده خودتان است! .TP .B --shutdown بستن و خاموش کردن Audacious. .TP .B --help چاپ خلاصه‌ای کوتاه از دستورات audtool. .PP دستورات می‌توانند با پیشوند «\-\-» (گزینه‌های طولانی به سبک گنو) یا بدون آن استفاده شوند، انتخاب با شماست. .SH "اشکالات (BUGS)" در حال حاضر هیچ اشکال شناخته‌شده‌ای در audtool وجود ندارد؛ در صورت مشاهده هرگونه اشکال، لطفاً آن را در \fIhttps://github.com/audacious-media-player/audacious/issues\fR گزارش دهید. .SH "نویسندگان (AUTHORS)" برنامه .B audtool توسط George Averill و Ariadne Conill نوشته شده است. .PP این صفحه راهنما توسط Adam Cecile و Kiyoshi Aman نوشته شده است. تغییرات جزئی دیگری توسط Ariadne Conill و Tony Vroon انجام شد. این صفحه راهنما برای Audacious نسخه 3.7 و بالاتر توسط John Lindgren به‌روزرسانی شد. .PP این اثر تحت مجوز Creative Commons Attribution 3.0 Unported License منتشر شده است. .SH "همچنین ببینید (SEE ALSO)" .BR audacious (1) .SH "وب‌سایت (WEBSITE)" .I https://audacious-media-player.org