'\" t
.\"     Title: listenbrainz-mpd
.\"    Author: listenbrainz-mpd contributors
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-08-26
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "LISTENBRAINZ\-MPD" "1" "2026-08-26" "\ \&" "\ \&"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
listenbrainz-mpd \- کلاینت ثبت اطلاعات شنیداری در ListenBrainz برای MPD
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBlistenbrainz\-mpd\fP [\fIOPTION\fP].\|.\|.
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه کلاینت MPD که قطعه‌های موسیقی شنیده‌شده شما را به‌طور خودکار به \c
.URL "https://listenbrainz.org" "" ""
یا هر مقصد دیگری که با این API سازگار باشد ارسال می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-c, \-\-config\fP \fICONFIG_FILE\fP
.RS 4
استفاده از \fICONFIG_FILE\fP به‌جای فایل پیکربندی پیش‌فرض.
.RE
.sp
\fB\-\-create\-default\-config\fP
.RS 4
ایجاد فایل پیکربندی پیش‌فرض در مسیر پیش‌فرض و خروج.
.RE
.sp
\fB\-\-send\-feedback love|hate|clear\fP
.RS 4
ارسال بازخورد ListenBrainz برای آهنگ در حال پخش، در صورت وجود.
.sp
\fBlove\fP
.RS 4
نشانه‌گذاری آهنگ در حال پخش به‌عنوان «پسندیده‌شده» (loved).
.RE
.sp
\fBhate\fP
.RS 4
نشانه‌گذاری آهنگ در حال پخش به‌عنوان «نپسندیده‌شده» (hated).
.RE
.sp
\fBclear\fP
.RS 4
پاک کردن بازخورد ارسال‌شده قبلی برای آهنگ در حال پخش.
.RE
.RE
.sp
\fB\-h, \-\-help\fP
.RS 4
نمایش راهنما و خروج.
.RE
.sp
\fB\-V, \-\-version\fP
.RS 4
نمایش اطلاعات نسخه و خروج.
.RE
.SH "پیکربندی (CONFIGURATION)"
.sp
پیکربندی از مسیر \fB$XDG_CONFIG_HOME/listenbrainz\-mpd/config.toml\fP بارگذاری می‌شود، یا در صورت تنظیم نبودن \fBXDG_CONFIG_HOME\fP، از مسیر \fB$HOME/.config/listenbrainz\-mpd/config.toml\fP خوانده خواهد شد.
یک فایل پیکربندی جایگزین را می‌توان با استفاده از گزینه \fB\-\-config\fP مشخص کرد.
.sp
برای جزئیات درباره کلیدهای پیکربندی پشتیبانی‌شده، فایل پیکربندی نمونه را بررسی کنید.
.SH "محیط (ENVIRONMENT)"
.sp
متغیرهای محیطی مقادیر معادل موجود در پیکربندی را بازنویسی (override) می‌کنند.
.sp
\fBLISTENBRAINZ_TOKEN\fP
.RS 4
توکن کاربری ListenBrainz.
.RE
.sp
\fBMPD_HOST\fP
.RS 4
میزبان سرور MPD.
می‌تواند یک نام میزبان یا یک آدرس IP خالص باشد.
آدرس‌های IPv6 نباید داخل براکت کروشه قرار گیرند.
برای استفاده از گذرواژه سرور، مقداری مانند \fIpassword\fP\fB@\fP\fIhost\fP را تعیین کنید.
اگر نام میزبان با \fB/\fP آغاز شود، نشان‌دهنده مسیر یک سوکت یونیکس است.
اگر نام میزبان با \fB@\fP آغاز شود، نشان‌دهنده نام یک سوکت انتزاعی (abstract socket) است (تنها در لینوکس).
.RE
.sp
\fBMPD_PORT\fP
.RS 4
درگاه TCP سرور MPD.
.RE
.SH "منابع (RESOURCES)"
.sp
کد منبع و سامانه پیگیری مشکلات:
.RS 4
.URL "https://codeberg.org/elomatreb/listenbrainz\-mpd" "" ""
.RE
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.sp
حق نشر \(co 2023 مشارکت‌کنندگان listenbrainz\-mpd.
.br
.sp
این برنامه یک نرم‌افزار آزاد است: شما می‌توانید آن را تحت شرایط نسخه ۳ مجوز عمومی همگانی آفرو گنو (GNU AGPL) که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، بازتوزیع کرده یا تغییر دهید.
.sp
این برنامه با این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به مجوز عمومی همگانی آفرو گنو مراجعه کنید.
.sp
شما باید به همراه این برنامه یک نسخه از مجوز عمومی همگانی آفرو گنو را دریافت کرده باشید. در غیر این صورت، ببینید: \c
.URL "https://www.gnu.org/licenses" "" "."
.SH "نویسندگان (AUTHORS)"
.sp
مشارکت‌کنندگان listenbrainz-mpd