.\" Continuation line for .TP header.
.de TQ
.  br
.  ns
.  TP \\$1\" no doublequotes around argument!
..
.TH pianobar 1

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

.SH "خلاصه دستور (SYNOPSIS)"
.B pianobar

.SH "توضیحات (DESCRIPTION)"
.B pianobar
یک پخش‌کننده موسیقی سبک تحت کنسول برای رادیوی اینترنتی شخصی‌سازی‌شده
pandora.com
است.

.SH "فایل‌ها (FILES)"
.I $XDG_CONFIG_HOME/pianobar/config
یا
.I ~/.config/pianobar/config
.RS
فایل پیکربندی اختصاصی کاربر. بخش
.B "پیکربندی (CONFIGURATION)"
را ببینید.
.RE

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

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

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

.TP
.B act_help = ?
نمایش کلیدهای میانبر.

.TP
.B act_songlove = +
پسندیدن آهنگ در حال پخش.

.TP
.B act_songban = -
مسدود کردن قطعه جاری. این قطعه دیگر پخش نخواهد شد و فقط از طریق رابط وب
pandora.com
قابل بازگردانی است.

.TP
.B act_stationaddmusic = a
افزودن موسیقی بیشتر به ایستگاه جاری. از شما یک عبارت جستجو خواسته می‌شود. دستورالعمل‌ها را دنبال کنید. در صورت نیاز '?' (بدون نقل‌قول) را امتحان کنید.

.TP
.B act_bookmark = b
نشانه‌گذاری آهنگ یا هنرمند جاری.

.TP
.B act_stationcreate = c
ایجاد ایستگاه جدید. باید یک عبارت جستجو وارد کنید و آهنگ یا هنرمند مورد نظر خود را انتخاب نمایید.

.TP
.B act_stationdelete = d
حذف ایستگاه جاری.

.TP
.B act_songexplain = e
توضیح دلیل پخش این آهنگ.

.TP
.B act_stationaddbygenre = g
افزودن ایستگاه بر اساس سبک ارائه‌شده توسط pandora.

.TP
.B act_history = h
نمایش تاریخچه.

.TP
.B act_songinfo = i
چاپ اطلاعات درباره آهنگ/ایستگاه در حال پخش.

.TP
.B act_addshared = j
افزودن ایستگاه هم‌رسانی‌شده بر اساس شناسه. شناسه یک عدد صحیح بسیار طولانی بدون "sh" در ابتدا است.

.TP
.B act_managestation = =
حذف بذرها (seeds) یا بازخوردهای هنرمند/آهنگ.

.TP
.B act_songnext = n
پرش از روی آهنگ جاری.

.TP
.B act_songpause = S
توقف موقت پخش.

.TP
.B act_songpausetoggle = p
.TQ
.B act_songpausetoggle2 = <Space>
توقف موقت/ادامه پخش.

.TP
.B act_songplay = P
ادامه پخش.

.TP
.B act_quit = q
خروج از
.B pianobar.

.TP
.B act_stationrename = r
تغییر نام ایستگاه در حال پخش.

.TP
.B act_stationchange = s
انتخاب ایستگاهی دیگر. لیست ایستگاه‌ها مانند بیشتر لیست‌ها می‌تواند با وارد کردن یک عبارت جستجو به‌جای شماره ایستگاه فیلتر شود.

.TP
.B act_songtired = t
ممنوع کردن پخش آهنگ به مدت یک ماه.

.TP
.B act_upcoming = u
نمایش آهنگ‌های بعدی در فهرست پخش.

.TP
.B act_stationcreatefromsong = v
ایجاد ایستگاه جدید از روی آهنگ یا هنرمند جاری.

.TP
.B act_stationselectquickmix = x
انتخاب ایستگاه‌های ترکیب سریع (quickmix). می‌توانید وضعیت انتخاب را با 't' تغییر دهید، همه را با 'a' انتخاب کنید یا هیچ‌کدام را با 'n' برگزینید.

.TP
.B act_voldown = (
کاهش بلندی صدا.

.TP
.B act_volreset = ^
بازنشانی بلندی صدا.

.TP
.B act_volup = )
افزایش بلندی صدا.

.TP
.B act_settings = !
تغییر تنظیمات Pandora.

.TP
.B at_icon =  @
جایگزین برای %@ در رشته قالب ایستگاه. به طور پیش‌فرض " @ " است.

.TP
.B audio_quality = {high, medium, low}
انتخاب کیفیت صدا.

.TP
.B audio_pipe = /path/to/fifo
ارسال نمونه‌های صوتی خام و رمزگشایی‌شده به یک لوله (pipe) به‌جای دستگاه صوتی پیش‌فرض. از گزینه
.B sample_rate
برای اعمال نرخ نمونه‌برداری ثابت استفاده کنید.

.TP
.B autoselect = {1,0}
انتخاب خودکار آخرین مورد باقی‌مانده از لیست فیلترشده. در حال حاضر فقط برای انتخاب ایستگاه فعال است.

.TP
.B autostart_station = stationid
پخش این ایستگاه هنگام شروع برنامه. می‌توانید
.B stationid
را با فشردن
.B i
یا کلیدی که در
.B act_songinfo
تعریف کرده‌اید دریافت کنید.

.TP
.B ban_icon =  </3
نماد برای آهنگ‌های مسدودشده.

.TP
.B bind_to = {if!tunX,host!x.x.x.x,..}
تنظیم نام رابط شبکه برای استفاده به عنوان رابط خروجی. این نام می‌تواند نام یک رابط، نشانی IP یا نام میزبان باشد (برگرفته از CURLOPT_INTERFACE).
.PP
می‌توان از این گزینه به عنوان جایگزینی برای
.B control_proxy
در کنار گزینه
.B route-nopull
در OpenVPN استفاده کرد.

.TP
.B buffer_seconds = 5
اندازه بافر صوتی بر حسب ثانیه.

.TP
.B ca_bundle = /etc/ssl/certs/ca-certificates.crt
مسیر بسته گواهی‌های CA، شامل گواهی‌های ریشه و میانی مورد نیاز برای اعتبارسنجی گواهی SSL پاندورا.

.TP
.B control_proxy = http://user:password@host:port/
کاربران غیرآمریکایی برای استفاده از pandora.com به یک پروکسی نیاز دارند. فقط رابط xmlrpc از این پروکسی استفاده خواهد کرد. موسیقی مستقیماً دریافت می‌شود.

.TP
.B decrypt_password = R=U!LH$O2B#

.TP
.B device = android-generic

.TP
.B encrypt_password = 6#26FRL$ZWD

.TP
.B event_command = path
فایلی که هنگام رخ دادن یک رویداد اجرا می‌شود. بخش
.B "دستور رویداد (EVENTCMD)"
را ببینید.

.TP
.B fifo = $XDG_CONFIG_HOME/pianobar/ctl
محل لوله کنترل (fifo). بخش
.B "کنترل از راه دور (REMOTE CONTROL)"
را ببینید.

.TP
.B format_list_song = %i) %a - %t%r
نویسه‌های قالب‌بندی در دسترس:

.B %i
شماره آهنگ

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

.B %t
عنوان آهنگ

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

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

.B %@
نماد at_icon

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

.TP
.B format_msg_none = %s
.TQ
.B format_msg_info = (i) %s
.TQ
.B format_msg_nowplaying = |>  %s
.TQ
.B format_msg_time = #   %s
.TQ
.B format_msg_err = /!\\\\ %s
.TQ
.B format_msg_question = [?] %s
.TQ
.B format_msg_list = \\t%s
رشته‌های قالب پیام.
.B %s
با پیام واقعی جایگزین می‌شود.

.TP
.B format_nowplaying_song = \[dq]%t\[dq] by \[dq]%a\[dq] on \[dq]%l\[dq]%r%@%s
قالب پیام آهنگ در حال پخش. نویسه‌های قالب‌بندی در دسترس عبارتند از:

.B %t
عنوان آهنگ

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

.B %l
نام آلبوم

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

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

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

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

.TP
.B format_nowplaying_station = Station \[dq]%n\[dq] (%i)
قالب ایستگاه در حال پخش. نویسه‌های قالب‌بندی در دسترس عبارتند از:

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

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

.TP
.B format_time = %s%r/%t
قالب زمان.

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

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

.B %s
علامت

.B %t
زمان کل

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

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

.TP
.B love_icon =  <3
نماد برای آهنگ‌های پسندیده‌شده.

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

.TP
.B partner_password = AC7IBG09A3DTSYM4R41UJWL07VLN8JI7

.TP
.B partner_user = android

.TP
.B password = plaintext_password
گذرواژه شما در pandora.com به صورت متن ساده.

.TP
.B password_command = gpg --decrypt ~/password
استفاده از خروجی یک دستور به عنوان گذرواژه. این تنظیم با مشخص کردن گذرواژه از طریق گزینه
.B password
نادیده گرفته می‌شود.

.TP
.B proxy = http://user:password@host:port/
استفاده از یک پروکسی http. توجه داشته باشید که این تنظیم متغیر محیطی http_proxy را لغو می‌کند. تنها احراز هویت http از نوع "Basic" پشتیبانی می‌شود.

.TP
.B rpc_host = tuner.pandora.com

.TP
.B rpc_tls_port = 443

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

.TP
.B 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 مرتب می‌نماید.

.TP
.B timeout = 30
مهلت زمانی عملیات شبکه.

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

.TP
.B user = your@user.name
نام کاربری شما در pandora.com.

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

.SH "کنترل از راه دور (REMOTE CONTROL)"
.B pianobar
می‌تواند از طریق یک fifo کنترل شود. باید خودتان با اجرای دستور زیر آن را ایجاد کنید:
.PP
.nf
 mkfifo ~/.config/pianobar/ctl
.fi
.PP
در صورتی که متغیر $XDG_CONFIG_HOME را تنظیم کرده‌اید یا تنظیم fifo را تغییر داده‌اید، مسیر را تنظیم کنید. پس از آن می‌توانید دستورات را مستقیماً درون fifo بنویسید. به عنوان مثال (آهنگ بعدی):
.PP
.nf
 echo -n 'n' > ~/.config/pianobar/ctl
.fi
.PP
.B n
کلید میانبر برای "آهنگ بعدی" است. اگر کلیدهای میانبر خود را سفارشی‌سازی کرده‌اید، باید از آن نویسه‌ها برای کنترل
.B pianobar
استفاده کنید.
.I این رفتار ممکن است در آینده تغییر کند!
.PP
مثالی دیگر:
.PP
.nf
 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
.fi

.SH "دستور رویداد (EVENTCMD)"

.B pianobar
می‌تواند "رویدادها"ی خاصی را به یک برنامه خارجی گزارش دهد (بخش
.B "پیکربندی (CONFIGURATION)"
را ببینید). این برنامه با نام رویداد به عنوان نخستین آرگومان خود راه‌اندازی می‌شود. اطلاعات بیشتر مانند کد خطا و شرح آن، و همچنین اطلاعات آهنگ مرتبط با رویداد جاری، از طریق ورودی استاندارد (stdin) ارائه می‌شود.
.PP
رویدادهایی که در حال حاضر پشتیبانی می‌شوند عبارتند از:
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
.PP
یک اسکریپت نمونه را می‌توانید در دایرکتوری contrib/ از توزیع کد منبع
.B pianobar
بیابید.

.SH "نویسنده (AUTHOR)"
Lars-Dominik Braun <lars@6xq.net>