نام (NAME)

pianobar - پخش‌کننده موسیقی تحت کنسول برای pandora.com

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

pianobar

توضیحات (DESCRIPTION)

pianobar یک پخش‌کننده موسیقی سبک تحت کنسول برای رادیوی اینترنتی شخصی‌سازی‌شده pandora.com است.

فایل‌ها (FILES)

$XDG_CONFIG_HOME/pianobar/config یا ~/.config/pianobar/config

فایل پیکربندی اختصاصی کاربر. بخش پیکربندی (CONFIGURATION) را ببینید.

/etc/libao.conf یا ~/.libao

پیکربندی سراسری/کاربری خروجی صوتی. مستندات libao را در نشانی زیر ببینید: http://xiph.org/ao/doc/config.html

پیکربندی (CONFIGURATION)

فایل پیکربندی از خطوط ساده key = value تشکیل شده است که هر کدام با یک نویسه خط جدید (\n) پایان می‌یابند. کلیدها به حروف بزرگ و کوچک حساس هستند.

کلیدهای *act_ کلیدهای میانبر pianobar را کنترل می‌کنند. هر نویسه یک‌بایتی به جز \x00 و مقدار ویژه disabled در اینجا مجاز هستند.

act_help = ?: نمایش کلیدهای میانبر.
act_songlove = +: پسندیدن آهنگ در حال پخش.
act_songban = -: مسدود کردن قطعه جاری. این قطعه دیگر پخش نخواهد شد و فقط از طریق رابط وب pandora.com قابل بازگردانی است.
act_stationaddmusic = a: افزودن موسیقی بیشتر به ایستگاه جاری. از شما یک عبارت جستجو خواسته می‌شود. دستورالعمل‌ها را دنبال کنید. در صورت نیاز '?' (بدون نقل‌قول) را امتحان کنید.
act_bookmark = b: نشانه‌گذاری آهنگ یا هنرمند جاری.
act_stationcreate = c: ایجاد ایستگاه جدید. باید یک عبارت جستجو وارد کنید و آهنگ یا هنرمند مورد نظر خود را انتخاب نمایید.
act_stationdelete = d: حذف ایستگاه جاری.
act_songexplain = e: توضیح دلیل پخش این آهنگ.
act_stationaddbygenre = g: افزودن ایستگاه بر اساس سبک ارائه‌شده توسط pandora.
act_history = h: نمایش تاریخچه.
act_songinfo = i: چاپ اطلاعات درباره آهنگ/ایستگاه در حال پخش.
act_addshared = j: افزودن ایستگاه هم‌رسانی‌شده بر اساس شناسه. شناسه یک عدد صحیح بسیار طولانی بدون "sh" در ابتدا است.
act_managestation = =: حذف بذرها (seeds) یا بازخوردهای هنرمند/آهنگ.
act_songnext = n: پرش از روی آهنگ جاری.
act_songpause = S: توقف موقت پخش.
act_songpausetoggle = p
act_songpausetoggle2 = <Space>: توقف موقت/ادامه پخش.
act_songplay = P: ادامه پخش.
act_quit = q: خروج از pianobar.
act_stationrename = r: تغییر نام ایستگاه در حال پخش.
act_stationchange = s: انتخاب ایستگاهی دیگر. لیست ایستگاه‌ها مانند بیشتر لیست‌ها می‌تواند با وارد کردن یک عبارت جستجو به‌جای شماره ایستگاه فیلتر شود.
act_songtired = t: ممنوع کردن پخش آهنگ به مدت یک ماه.
act_upcoming = u: نمایش آهنگ‌های بعدی در فهرست پخش.
act_stationcreatefromsong = v: ایجاد ایستگاه جدید از روی آهنگ یا هنرمند جاری.
act_stationselectquickmix = x: انتخاب ایستگاه‌های ترکیب سریع (quickmix). می‌توانید وضعیت انتخاب را با 't' تغییر دهید، همه را با 'a' انتخاب کنید یا هیچ‌کدام را با 'n' برگزینید.
act_voldown = (: کاهش بلندی صدا.
act_volreset = ^: بازنشانی بلندی صدا.
act_volup = ): افزایش بلندی صدا.
act_settings = !: تغییر تنظیمات Pandora.
at_icon = @: جایگزین برای %@ در رشته قالب ایستگاه. به طور پیش‌فرض " @ " است.
audio_quality = {high, medium, low}: انتخاب کیفیت صدا.
audio_pipe = /path/to/fifo: ارسال نمونه‌های صوتی خام و رمزگشایی‌شده به یک لوله (pipe) به‌جای دستگاه صوتی پیش‌فرض. از گزینه sample_rate برای اعمال نرخ نمونه‌برداری ثابت استفاده کنید.
autoselect = {1,0}: انتخاب خودکار آخرین مورد باقی‌مانده از لیست فیلترشده. در حال حاضر فقط برای انتخاب ایستگاه فعال است.
autostart_station = stationid: پخش این ایستگاه هنگام شروع برنامه. می‌توانید stationid را با فشردن i یا کلیدی که در act_songinfo تعریف کرده‌اید دریافت کنید.
ban_icon = </3: نماد برای آهنگ‌های مسدودشده.
bind_to = {if!tunX,host!x.x.x.x,..}: تنظیم نام رابط شبکه برای استفاده به عنوان رابط خروجی. این نام می‌تواند نام یک رابط، نشانی IP یا نام میزبان باشد (برگرفته از CURLOPT_INTERFACE).

می‌توان از این گزینه به عنوان جایگزینی برای control_proxy در کنار گزینه route-nopull در OpenVPN استفاده کرد.

buffer_seconds = 5

اندازه بافر صوتی بر حسب ثانیه.

ca_bundle = /etc/ssl/certs/ca-certificates.crt

مسیر بسته گواهی‌های CA، شامل گواهی‌های ریشه و میانی مورد نیاز برای اعتبارسنجی گواهی SSL پاندورا.

control_proxy = http://user:password@host:port/

کاربران غیرآمریکایی برای استفاده از pandora.com به یک پروکسی نیاز دارند. فقط رابط xmlrpc از این پروکسی استفاده خواهد کرد. موسیقی مستقیماً دریافت می‌شود.

decrypt_password = R=U!LH$O2B#

device = android-generic

encrypt_password = 6#26FRL$ZWD

event_command = path

فایلی که هنگام رخ دادن یک رویداد اجرا می‌شود. بخش دستور رویداد (EVENTCMD) را ببینید.

fifo = $XDG_CONFIG_HOME/pianobar/ctl

محل لوله کنترل (fifo). بخش کنترل از راه دور (REMOTE CONTROL) را ببینید.

format_list_song = %i) %a - %t%r

نویسه‌های قالب‌بندی در دسترس:

%i شماره آهنگ

%a هنرمند آهنگ

%t عنوان آهنگ

%r نماد امتیاز

%d مدت‌زمان آهنگ

%@ نماد at_icon

%s ایستگاه آهنگ، در صورتی که ایستگاه جاری نباشد.

format_msg_none = %s

format_msg_info = (i) %s

format_msg_nowplaying = |> %s

format_msg_time = # %s

format_msg_err = /! %s

format_msg_question = [?] %s

format_msg_list = %s

رشته‌های قالب پیام. %s با پیام واقعی جایگزین می‌شود.

format_nowplaying_song = "%t" by "%a" on "%l"%r%@%s

قالب پیام آهنگ در حال پخش. نویسه‌های قالب‌بندی در دسترس عبارتند از:

%t عنوان آهنگ

%a هنرمند آهنگ

%l نام آلبوم

%r نماد امتیاز

%@ at_icon اگر ایستگاه از نوع quickmix باشد، در غیر این صورت خالی است.

%s نام واقعی ایستگاه در صورتی که quickmix باشد

%u نشانی اینترنتی جزئیات آهنگ

format_nowplaying_station = Station "%n" (%i)

قالب ایستگاه در حال پخش. نویسه‌های قالب‌بندی در دسترس عبارتند از:

%n نام ایستگاه

%i شناسه ایستگاه

format_time = %s%r/%t

قالب زمان.

%e زمان سپری‌شده

%r زمان باقی‌مانده

%s علامت

%t زمان کل

gain_mul = 1.0

پاندورا همراه با هر آهنگ یک مقدار ReplayGain ارسال می‌کند. این گزینه یک ضریب تعیین می‌کند تا میزان تنظیم بهره (gain) کاهش یابد. مقدار 0.0 به معنای عدم تنظیم بهره، 1.0 به معنای تنظیم کامل بهره و مقادیر مابین آن‌ها شدت تنظیم بهره را کاهش می‌دهند.

history = 5

نگه‌داری تاریخچه‌ای از n آهنگ اخیر (به طور پیش‌فرض ۵). می‌توانید به این آهنگ‌ها امتیاز دهید.

love_icon = <3

نماد برای آهنگ‌های پسندیده‌شده.

max_retry = 3

حداکثر دفعات تلاش ناموفق برای عملیات‌های مختلف پیش از انصراف.

partner_password = AC7IBG09A3DTSYM4R41UJWL07VLN8JI7

partner_user = android

password = plaintext_password

گذرواژه شما در pandora.com به صورت متن ساده.

password_command = gpg --decrypt ~/password

استفاده از خروجی یک دستور به عنوان گذرواژه. این تنظیم با مشخص کردن گذرواژه از طریق گزینه password نادیده گرفته می‌شود.

proxy = http://user:password@host:port/

استفاده از یک پروکسی http. توجه داشته باشید که این تنظیم متغیر محیطی http_proxy را لغو می‌کند. تنها احراز هویت http از نوع "Basic" پشتیبانی می‌شود.

rpc_host = tuner.pandora.com

rpc_tls_port = 443

sample_rate = 0

اجبار به استفاده از یک نرخ نمونه‌برداری ثابت برای خروجی. مقدار پیش‌فرض، 0، از نرخ نمونه‌برداری جریان استفاده می‌کند.

sort = {name_az, name_za, quickmix_01_name_az, quickmix_01_name_za, quickmix_10_name_az, quickmix_10_name_za}

مرتب‌سازی لیست ایستگاه‌ها بر اساس نام یا نوع (ترکیب سریع بودن) و نام. به عنوان مثال name_az بر اساس نام از a تا z مرتب می‌کند و quickmix_01_name_za بر اساس نوع (ترکیب سریع در پایین) و نام از z تا a مرتب می‌نماید.

timeout = 30

مهلت زمانی عملیات شبکه.

tired_icon = zZ

نماد برای آهنگ‌هایی که موقتاً تعلیق شده‌اند.

user = your@user.name

نام کاربری شما در pandora.com.

volume = 0

میزان تصحیح اولیه صدا بر حسب دسی‌بل (dB). معمولاً مقداری بین -30 و +5 است.

کنترل از راه دور (REMOTE CONTROL)

pianobar می‌تواند از طریق یک fifo کنترل شود. باید خودتان با اجرای دستور زیر آن را ایجاد کنید:

mkfifo ~/.config/pianobar/ctl

در صورتی که متغیر $XDG_CONFIG_HOME را تنظیم کرده‌اید یا تنظیم fifo را تغییر داده‌اید، مسیر را تنظیم کنید. پس از آن می‌توانید دستورات را مستقیماً درون fifo بنویسید. به عنوان مثال (آهنگ بعدی):

echo -n 'n' > ~/.config/pianobar/ctl

n کلید میانبر برای "آهنگ بعدی" است. اگر کلیدهای میانبر خود را سفارشی‌سازی کرده‌اید، باید از آن نویسه‌ها برای کنترل pianobar استفاده کنید. این رفتار ممکن است در آینده تغییر کند!

مثالی دیگر:

while true; do;
   nc -l -p 12345 -s localhost localhost > ~/.config/pianobar/ctl;
   sleep 1;
done
echo -ne 'n\x1a' | nc -q 0 127.0.0.1 12345

دستور رویداد (EVENTCMD)

pianobar می‌تواند "رویدادها"ی خاصی را به یک برنامه خارجی گزارش دهد (بخش پیکربندی (CONFIGURATION) را ببینید). این برنامه با نام رویداد به عنوان نخستین آرگومان خود راه‌اندازی می‌شود. اطلاعات بیشتر مانند کد خطا و شرح آن، و همچنین اطلاعات آهنگ مرتبط با رویداد جاری، از طریق ورودی استاندارد (stdin) ارائه می‌شود.

رویدادهایی که در حال حاضر پشتیبانی می‌شوند عبارتند از: artistbookmark, settingschange, settingsget, songban, songbookmark, songexplain, songfinish, songlove, songshelf, songstart, stationaddgenre, stationaddmusic, stationaddshared, stationcreate, stationdelete, stationdeleteartistseed, stationdeletefeedback, stationdeletesongseed, stationdeletestationseed, stationfetchgenre, stationfetchinfo, stationfetchplaylist, stationgetmodes, stationquickmixtoggle, stationrename, stationsetmode, usergetstations, userlogin

یک اسکریپت نمونه را می‌توانید در دایرکتوری contrib/ از توزیع کد منبع pianobar بیابید.

نویسنده (AUTHOR)

Lars-Dominik Braun <lars@6xq.net>