نام (NAME)

xmms2d - دیمن XMMS2 برای مدیریت پخش موسیقی و ذخیره‌سازی فراداده‌های صوتی

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

xmms2d [-v|-q] [-p dir] [-o plugin] [-i url] [-c file] [-s fd] [--yes-run-as-root]
xmms2d -?
xmms2d -V

توضیحات (DESCRIPTION)

پروژه XMMS2 بازطراحیِ پخش‌کننده موسیقی XMMS (https://en.wikipedia.org/wiki/XMMS) است. این برنامه از مدل کلاینت-سرور بهره می‌برد که امکان استفاده از چندین رابط کاربری متنی و گرافیکی (حتی به صورت هم‌زمان!) را فراهم می‌کند. تمامی قالب‌های صوتی رایج با استفاده از پلاگین‌ها پشتیبانی می‌شوند. علاوه بر این، یک کتابخانه رسانه‌ای منعطف برای سازماندهی موسیقی‌های شما در نظر گرفته شده است.

xmms2d دیمنی است که کلاینت‌های XMMS2 از طریق آن موسیقی را پخش و مدیریت می‌کنند. کتابخانه کلاینت ارائه‌شده به توسعه‌دهندگان شخص ثالث اجازه می‌دهد به سادگی، به ویژه با استفاده از بایندینگ‌های Python و Ruby، برای XMMS2 کلاینت بنویسند.

xmms2d برای پخش موسیقی از یک سازوکار سه‌بخشی استفاده می‌کند. دسترسی به داده‌های موسیقی از روی دیسک یا شبکه توسط یک پلاگین انتقال (transport) انجام می‌شود، سپس داده‌ها به یک پلاگین رمزگشا (decoder) تحویل داده می‌شوند تا صوت به قالبی تبدیل شود که توسط یک پلاگین خروجی (output) قابل پخش باشد.

گزینه‌ها (OPTIONS)

گزینه‌های عمومی

-v, --verbose: افزایش جزئیات خروجی.
-q, --quiet: کاهش جزئیات خروجی.
-p dir, --plugindir=dir: استفاده از دایرکتوری پلاگین dir.
-o plugin, --output=plugin: استفاده از پلاگین خروجی plugin.
-i url, --ipc-socket=url: گوش دادن به سوکت در url. می‌توان چندین سوکت را با جدا کردن توسط نویسه ; مشخص کرد. بخش سوکت IPC (IPC SOCKET) را ببینید.
-c file, --conf=file: استفاده از فایل پیکربندی file.
-s fd, --status-fd=fd: نوشتن در توصیف‌گر فایل fd هنگام آغاز به کار. این گزینه می‌تواند برای انتظار تا زمان برقراری ارتباط بین‌فرآیندی (IPC) استفاده شود، مشابه کاری که xmms2-launcher(1) انجام می‌دهد.
--yes-run-as-root: اجازه به xmms2d برای اجرا با دسترسی ریشه (root).

دریافت راهنما

-h, -?, --help: نمایش اطلاعات راهنمای اولیه و خروج.
-V, --version: نمایش اطلاعات نسخه.

سوکت IPC (IPC SOCKET)

کلاینت‌های XMMS2 برای ارتباط با xmms2d از سوکت‌های IPC استفاده می‌کنند. این سوکت‌های IPC در قالبی مبتنی بر URL و با سه روش انتقال ممکن مشخص می‌شوند: unix، tcp و tcp6.

روش‌های TCP به کلاینت‌ها امکان می‌دهند از طریق IPv4 و IPv6 به xmms2d متصل شوند و در نتیجه کنترل از راه دور XMMS2 را ممکن می‌سازند. یک نشانی متداول برای سوکت IPC با استفاده از پروتکل TCP به صورت tcp://127.0.0.1:9667 است.

روش انتقال UNIX تنها برای کلاینت‌های محلی است و فایلی ایجاد می‌کند که کلاینت‌های XMMS2 از طریق آن به xmms2d دسترسی می‌یابند. یک مسیر متداول برای سوکت IPC با استفاده از روش انتقال UNIX به صورت unix:///tmp/xmms-ipc-foobar است.

فایل‌ها (FILES)

در ادامه، در سیستم‌های یونیکس در صورتی که متغیر محیطی XDG_CONFIG_HOME تنظیم شده باشد، CONFDIR همان $XDG_CONFIG_HOME/xmms2 است. در غیر این صورت برابر با $HOME/.config/xmms2 (در یونیکس به‌جز Darwin) یا $HOME/Library/xmms2 (در Darwin) خواهد بود. در Win32 نیز برابر با %APPDATA%/xmms2 است.

CONFDIR/xmms2.conf: فایل پیکربندی در قالب XML که امکان تغییر تنظیمات xmms2d را فراهم می‌آورد.
CONFDIR/startup.d/: دایرکتوری شامل برنامه‌هایی که هنگام اجرای xmms2d فراخوانی می‌شوند. مسیر جایگزین را می‌توان در فایل پیکربندی مشخص کرد.
CONFDIR/shutdown.d/: دایرکتوری شامل برنامه‌هایی که هنگام متوقف شدن درستِ xmms2d فراخوانی می‌شوند. مسیر جایگزین را می‌توان در فایل پیکربندی مشخص کرد.
CONFDIR/medialib.db: یک پایگاه‌داده sqlite3(1) شامل اطلاعات تمام آهنگ‌هایی که به کتابخانه رسانه‌ای XMMS2 افزوده شده‌اند. مسیر جایگزین را می‌توان در فایل پیکربندی مشخص کرد.
CONFDIR/bindata/: دایرکتوری حاوی فایل‌هایی با داده‌های باینری سپرده‌شده به کتابخانه رسانه‌ای XMMS2، مانند تصویر جلد آلبوم‌ها. مسیر جایگزین را می‌توان در فایل پیکربندی مشخص کرد.
/tmp/xmms-ipc-USER: مکان متداول برای سوکت IPC یونیکس. در اینجا USER نام کاربری است که xmms2d را اجرا کرده است.

محیط (ENVIRONMENT)

XDG_CONFIG_HOME: مسیری که فایل‌های پیکربندی و منابع XMMS2 در آن قرار دارند.
XMMS_PATH: نشانی نخستین سوکتی که xmms2d به آن گوش می‌دهد. این متغیر محیطی برای برنامه‌های موجود در دایرکتوری‌های startup و shutdown تنظیم می‌شود.
XMMS_PATH_FULL: فهرستی جداشده با نویسه ; از مسیرهایی که xmms2d به آن‌ها گوش می‌دهد. این متغیر محیطی برای برنامه‌های موجود در دایرکتوری‌های startup و shutdown تنظیم می‌شود.

همچنین ببینید (SEE ALSO)

xmms2(1), xmms2-launcher(1), https://github.com/xmms2.

تاریخچه (HISTORY)

پروژه XMMS2 توسط Tobias Rundström و Anders Waldenborg آغاز شد. این پروژه توسط گروه کوچکی از مشارکت‌کنندگان در سراسر جهان توسعه می‌یابد.

نویسندگان (AUTHORS)

این صفحه راهنما در ابتدا توسط Alexander Botero-Lowry <alex@foxybanana.com> نوشته شد. سپس ساختاربندی مجدد آن و افزودن پاره‌ای از بخش‌ها توسط Erik Massop <e.massop@hccnet.nl> انجام گرفت.