نام (NAME)

rygel.conf - فایل پیکربندی Rygel

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

$XDG_CONFIG_DIR/rygel.conf

/etc/rygel.conf

توضیحات (DESCRIPTION)

rygel مقادیر پیکربندی خود را از فایل $XDG_CONFIG_DIR/rygel.conf یا فایلی که در خط فرمان با گزینهٔ --config مشخص شده است، می‌خواند. اگر آن فایل وجود نداشته باشد، از فایل /etc/rygel.conf استفاده می‌کند.

بیشتر گزینه‌ها را می‌توان با آرگومان‌های خط فرمان یا متغیرهای محیطی بازنویسی کرد. برای جزئیات بیشتر دربارهٔ آن‌ها به rygel(1) مراجعه کنید.

دستورالعمل‌های عمومی (GENERAL DIRECTIVES)

فهرست‌ها در فایل‌های پیکربندی با نقطه-ویرگول (;) از یکدیگر جدا می‌شوند. مقادیر بولی می‌توانند true یا false باشند.

ipv6

برای غیرفعال کردن اتصال به آدرس‌های IPv6، این گزینه را روی false تنظیم کنید.

interface=INTERFACE

فهرستی از رابط‌های شبکه که با نقطه-ویرگول جدا شده‌اند و rygel باید روی آن‌ها شنود کند. می‌تواند یک IP، نام رابط شبکه یا در لینوکس حتی ESSID یک شبکهٔ بی‌سیم باشد.

port=PORT

درگاه شنود (listen-port) را تنظیم می‌کند.

enable-transcoding

برای فعال‌سازی تبدیل کد (transcoding) به‌طور کلی، روی true تنظیم کنید.

log-level=DOMAIN:LEVEL[,DOMAIN:LEVEL,...]

فهرستی جدا شده با کاما از جفت‌های DOMAIN:LEVEL که امکان تنظیم سطح گزارش‌گیری را به‌صورت جداگانه برای هر دامنه فراهم می‌کند؛ جایی که DOMAIN می‌تواند "*"، "rygel" یا نام یک افزونه باشد. سطوح مجاز گزارش عبارتند از: 1=خطا (error)، 2=بحرانی (critical)، 3=هشدار (warning)، 4=پیام/اطلاعات (message/info)، 5=اشکال‌زدایی (debug). توجه داشته باشید که در نسخه‌های اخیر GLib (>= 2.36) برای دریافت هرگونه خروجی اشکال‌زدایی، تنظیم متغیر محیطی G_MESSAGES_DEBUG روی all الزامی است.

plugin-path=PATH

مسیر جستجوی افزونه‌ها را تنظیم می‌کند.

engine-path=PATH

مسیر جستجوی موتور رسانه را تنظیم می‌کند.

media-engine=ENGINE

نام ماژول قابل بارگیری برای استفاده به‌عنوان پسانهٔ (back-end) موتور رسانه.

allow-upload

اجازه بارگذاری فایل‌های رسانه‌ای از طریق UPnP را می‌دهد.

allow-deletion

اجازه حذف فایل‌های رسانه‌ای از راه دور را از طریق UPnP می‌دهد.

video-upload-folder

اگر allow-upload روی true تنظیم شده باشد، از این پوشه برای ذخیرهٔ ویدیوهای بارگذاری‌شده استفاده می‌شود. مقدار پیش‌فرض آن @VIDEOS@ است که به دایرکتوری پیش‌فرض فایل‌های ویدیویی (معمولاً $HOME/Videos) بسط می‌یابد.

music-upload-folder

اگر allow-upload روی true تنظیم شده باشد، از این پوشه برای ذخیرهٔ فایل‌های موسیقی بارگذاری‌شده استفاده می‌شود. مقدار پیش‌فرض آن @MUSIC@ است که به دایرکتوری پیش‌فرض فایل‌های موسیقی (معمولاً $HOME/Music) بسط می‌یابد.

picture-upload-folder

اگر allow-upload روی true تنظیم شده باشد، از این پوشه برای ذخیرهٔ تصاویر بارگذاری‌شده استفاده می‌شود. مقدار پیش‌فرض آن @PICTURES@ است که به دایرکتوری پیش‌فرض فایل‌های تصویر (معمولاً $HOME/Pictures) بسط می‌یابد.

force-downgrade-for

فهرستی جدا شده با نقطه-ویرگول از عامل‌های کاربر (user-agents) دستگاه‌ها (یا بخش‌هایی از آن‌ها) که به تنزل اجباری به MediaServer:1 و/یا ContentDirectory:1 نیاز دارند.

هشدار
فقط در صورتی از این پارامتر استفاده کنید که می‌دانید چه کاری انجام می‌دهید یا به شما گفته شده است چنین کنید؛ بازنویسی مقدار پیش‌فرض ممکن است باعث ناسازگاری شود. اگر متوجه شدید که افزودن دستگاه شما در اینجا امکان استفاده از آن با Rygel را فراهم می‌کند، لطفاً یک باگ IOP ثبت کنید[1] تا بتوانیم آن را در پیکربندی پیش‌فرض قرار دهیم.

acl-fallback-policy

این سیاست پیش‌فرضی است که در صورت عدم یافتن ارائه‌دهندهٔ کنترل دسترسی در D-Bus استفاده می‌شود. از true برای اجازه دادن به دسترسی از سوی همهٔ همتایان، و از false برای رد همهٔ دسترسی‌ها استفاده کنید. اگر مشخص نشود، سیاست جایگزین پیش‌فرض true خواهد بود.

strict-dlna

به‌طور پیش‌فرض غیرفعال است. از true برای غیرفعال کردن مجموعه‌ای از ویژگی‌ها استفاده کنید که سازگاری با بسیاری از کلاینت‌ها را بهبود می‌بخشند، اما انطباق با استاندارد را از بین می‌برند.

تنظیمات پایگاه داده (DATABASE SETTINGS)

تنظیمات بخش [Database] مربوط به کتابخانهٔ پشتیبانی از پایگاه داده است.

debug

برای نمایش دستورات SQL استفاده‌شده، روی true تنظیم کنید.

تنظیمات موتور رسانه GSTREAMER (GSTREAMER MEDIA ENGINE SETTINGS)

تنظیمات بخش [GstMediaEngine] مخصوص موتور رسانهٔ GStreamer است که موتور رسانهٔ پیش‌فرض می‌باشد. تنظیم media-engine را ببینید. گزینه‌های زیر برای موتور رسانهٔ GStreamer[2] در دسترس هستند.

transcoders

فهرستی از تبدیل‌کننده‌های کد (transcoders) فعال که با نقطه-ویرگول از هم جدا شده‌اند. اگر enable-transcoding روی false تنظیم شده باشد، این تنظیم هیچ اثری ندارد. مقادیر ممکن عبارتند از: lpcm,mp3,mp2ts,aac,avc یا wmv. مقدار پیش‌فرض آن lpcm;mp3;mp2ts;aac;wmv است.

تنظیمات اختصاصی افزونه‌ها (PLUGIN-SPECIFIC SETTINGS)

بخش‌های مربوط به افزونه‌ها با [PluginName] مشخص می‌شوند و می‌توانند شامل گزینه‌های خاص یک افزونه (به زیر مراجعه کنید) و همچنین این گزینه‌های مشترک باشند:

title=TITLE

عنوان دستگاه پیاده‌سازی‌شده توسط این افزونه. متغیرهایی وجود دارند که توسط rygel جایگزین خواهند شد. @REALNAME@ با نام واقعی کاربر، @USERNAME@ با شناسهٔ ورود کاربر و @HOSTNAME@ با نام دستگاهی که rygel روی آن اجرا می‌شود، جایگزین خواهد شد.

enabled

می‌توانید با تنظیم این گزینه روی true یا false افزونه‌ها را به‌صورت جداگانه فعال یا غیرفعال کنید.

energy-management

اگر می‌خواهید دستگاه UPnP شامل سرویس EnergyManagement باشد، روی true تنظیم کنید. توجه داشته باشید که پیکربندی اضافی مورد نیاز است؛ به تنظیمات EnergyManagement مراجعه کنید.

diagnostics

اگر می‌خواهید دستگاه UPnP شامل یک سرویس BasicManagement:2 باشد که اجرای ابزارهایی مانند ping، nslookup و traceroute را از راه دور فراهم می‌کند، روی true تنظیم کنید.

server-name

رشته‌ای که به‌عنوان هدر "Server:" در پاسخ HTTP ارسال می‌شود.

تنظیمات مدیریت انرژی (ENERGYMANAGEMENT SETTINGS)

تنظیمات موجود در بخش‌های [EnergyManagement-IFACENAME] تنظیمات مربوط به سرویس‌های EnergyManagement روی این رابط را مشخص می‌کنند. مثال: [EnergyManagement-eth0].

mode-on-suspend

مقدار NetworkInterfaceMode که باید هنگام تعلیق استفاده شود. پیش‌فرض "Unimplemented" است؛ سایر مقادیر معتبر عبارتند از: "IP-up-Periodic"، "IP-down-no-Wake"، "IP-down-with-WakeOn"، "IP-down-with-WakeAuto"، "IP-down-with-WakeOnAuto".

supported-transport

مقدار اختیاری WakeSupportedTransport که سرویس باید اعلان کند. مقادیر معتبر عبارتند از "UDP-Broadcast"، "UDP-Unicast"، "TCP-Unicast"، "Other".

password

گذرواژهٔ شانزده‌شانزدهی (هگزادسیمال) اختیاری که برای ساخت WakeOnPattern استفاده خواهد شد.

افزونه TRACKER (TRACKER PLUGIN)

افزونهٔ Tracker از پایگاه دادهٔ متمرکز اطلاعات متا از پروژهٔ tracker استفاده می‌کند. برای اطلاعات بیشتر دربارهٔ tracker به وب‌سایت پروژهٔ tracker[3] مراجعه کنید.

share-pictures

فعال یا غیرفعال کردن اشتراک‌گذاری تمام تصاویر موجود در پایگاه دادهٔ Tracker.

share-videos

فعال یا غیرفعال کردن اشتراک‌گذاری تمام ویدیوهای موجود در پایگاه دادهٔ Tracker.

share-music

فعال یا غیرفعال کردن اشتراک‌گذاری تمام موسیقی‌های موجود در پایگاه دادهٔ Tracker.

افزونه MEDIAEXPORT (MEDIAEXPORT PLUGIN)

افزونهٔ MediaExport جایگزینی برای صادرات رسانهٔ متکی بر tracker است. این افزونه فراداده‌ها را خودش استخراج کرده و در پلتفرم‌های یونیکس در یک پایگاه دادهٔ SQLite[4] در $XDG_CACHE_DIR/rygel/media-export.db ذخیره می‌کند.

نکته

اگر هر دو افزونهٔ Tracker و MediaExport فعال باشند، MediaExport خود را به نفع افزونهٔ Tracker غیرفعال می‌کند.

چندین گزینه توسط این افزونه پشتیبانی می‌شوند:

uris

فهرستی از URIها برای ارائه از طریق UPnP. می‌تواند فایل‌ها، پوشه‌ها یا هر چیزی باشد که توسط GVFS پشتیبانی می‌شود. اگر خالی رها شود، به‌طور پیش‌فرض پوشه‌های موسیقی، ویدیو و تصاویر کاربر را طبق مشخصات دایرکتوری‌های ویژهٔ کاربر در XDG صادر می‌کند. این پوشه‌های پیش‌فرض را می‌توان با @MUSIC@، @PICTURES@ و @VIDEOS@ ارجاع داد. مکان‌ها را می‌توان به‌صورت URIهای کاملاً فرار داده‌شده (escaped) یا مسیرهای عادی وارد کرد.

نکته
اگر یک مسیر عادی وارد کنید که شامل فاصله‌های خالی است، نیازی به فرار دادن آن‌ها با بک‌اسلش یا قرار دادن رشته درون گیومه نیست.

نکته
اکیداً توصیه می‌شود هنگامی که extract-metadata فعال است، از پوشهٔ صادرشده به‌عنوان مقصد بارگیری‌ها استفاده نکنید. در این حالت Rygel به احتمال زیاد فایل‌ها را نادیده می‌گیرد زیرا استخراج فراداده از آن‌ها با شکست مواجه خواهد شد.

مثال ۱. مقادیر ممکن برای uris

uris=@MUSIC@;/home/user/My Pictures;file:///home/user/My%20Videos

extract-metadata

اگر مدت زمان یا سایر فراداده‌ها مانند نام هنرمند برایتان مهم نیست، روی false تنظیم کنید. این کار سرعت پیمایش اولیهٔ رسانه را بسیار افزایش می‌دهد. از آن برای اشتراک‌گذاری سریع برخی فایل‌ها از طریق UPnP استفاده کنید. مطمئن شوید که یک include-filter تعریف کرده‌اید، در غیر این صورت با فایل‌های زیادی مواجه خواهید شد که کلاینت به‌هرحال نمی‌تواند آن‌ها را نمایش دهد.

monitor-changes

اگر نمی‌خواهید فایل‌های جدید به‌طور خودکار توسط rygel شناسایی شوند، روی false تنظیم کنید.

monitor-grace-timeout

زمان بر حسب ثانیه برای انتظار پس از شناسایی یک فایل جدید، قبل از تلاش برای استخراج فراداده از آن. اگر در حال بارگیری در دایرکتوری تحت نظارت rygel هستید بسیار مفید است. مقدار پیش‌فرض ۵ ثانیه است.

virtual-folders

اگر نیازی به سلسله‌مراتب پوشه‌های مجازی ندارید، روی false تنظیم کنید.

افزونه PLAYBIN (PLAYBIN PLUGIN)

افزونهٔ Playbin یک ارائه‌دهندهٔ رسانه (Digital Media Renderer یا DMR در اصطلاحات DLNA) را پیاده‌سازی می‌کند. این افزونه پیش‌تر با نام GstRenderer شناخته می‌شد.

اکیداً توصیه می‌شود انتخاب سینک (sink) را به playbin بسپارید. با این حال، اگر انتخاب‌های پیش‌فرض برای شما مناسب نیستند، می‌توان آن‌ها را به‌صورت زیر مجدداً پیکربندی کرد:

audio-sink

تعریف سینک صوتی مورد استفاده. می‌تواند یک عنصر تکی یا تعریفی از یک خط‌لولهٔ جزئی در نحو gst-launch باشد.

video-sink

تعریف سینک ویدیویی مورد استفاده. می‌تواند یک عنصر تکی یا تعریفی از یک خط‌لولهٔ جزئی در نحو gst-launch باشد.

افزونه LIGHTMEDIASCANNER (LIGHTMEDIASCANNER PLUGIN)

افزونهٔ LightMediaScanner محتویات دیمن lightmediascanner[5] را صادر می‌کند.

این افزونه هیچ گزینهٔ خاصی ندارد.

افزونه GSTLAUNCH (GSTLAUNCH PLUGIN)

افزونهٔ GstLaunch امکان ارائهٔ خطوط لولهٔ GStreamer را با استفاده از همان نحو ابزار gst-launch فراهم می‌کند. می‌توانید موارد متعددی را در این افزونه پیکربندی کنید.

launch-items

فهرستی از شناسه‌ها برای خطوط لوله‌ای که باید ارائه شوند.

identifier-title

عنوان دستگاهی که توسط این خط‌لوله نمایش داده می‌شود. Identifier همان شناسه‌ای است که در launch-items تنظیم شده است.

identifier-mime

نوع MIME خط‌لوله.

identifier-launch

تعریف خط‌لوله در نحو gst-launch. برای مشاهدهٔ چند مثال در نوشتن خطوط لوله، به gst-launch(1) مراجعه کنید.

identifier-dlnaprofile

نمایهٔ DLNA برای جریان (stream).

یک نمونه پیکربندی در فایل پیکربندی توزیع‌شدهٔ /etc/rygel.conf موجود است.

خارجی (EXTERNAL)

افزونهٔ External یک مصرف‌کننده از مشخصات رابط DBus بنام MediaServer2[6] است. این به برنامه‌های خارجی اجازه می‌دهد تا با پیاده‌سازی این مشخصات DBus، داده‌های خود را از طریق UPnP به اشتراک بگذارند. افزونه هرگونه پیاده‌سازی از این رابط را در گذرگاه نشست (session bus) دریافت کرده و رسانهٔ ارائه‌شده را از طریق UPnP در معرض نمایش قرار می‌دهد. پیاده‌سازان شناخته‌شدهٔ این مشخصات عبارتند از gnome-dvb-daemon[7]، Rhythmbox[8] و Grilo[9] از طریق پروژهٔ grilo-ms2.

می‌توانید کل این قابلیت را با تنظیم enabled=false در بخش [External] فایل پیکربندی غیرفعال کنید.

همتایان تکی را می‌توان با ایجاد بخش‌هایی متناظر با نام‌های D-Bus آن همتا فعال یا غیرفعال کرد:

[org.gnome.UPnP.MediaServer2.Rhythmbox]
enabled=false

این افزونه گزینه‌های اضافی دیگری ندارد.

افزونه MPRIS (MPRIS)

افزونهٔ MPRIS یک مصرف‌کننده از مشخصات رابط DBus بنام MPRIS2[10] است. این پیاده‌سازی با نسخهٔ 2.0 استاندارد مطابقت دارد.

rygel پخش‌کننده‌های رسانه‌ای را که بخش ارائه‌دهندهٔ این مشخصات DBus را پیاده‌سازی کرده‌اند، همانند افزونهٔ Playbin به‌عنوان ارائه‌دهندگان رسانهٔ دیجیتال DLNA (یا DMR) در معرض دسترسی قرار می‌دهد. این بدان معناست که شما می‌توانید به سادگی با پیاده‌سازی این مشخصات DBus، پخش‌کنندهٔ رسانهٔ خود را به یک DMR تبدیل کنید.

پخش‌کننده‌هایی که این مشخصات را پیاده‌سازی کرده و عملکرد آن‌ها با rygel شناخته شده است عبارتند از: Banshee[11]، Rhythmbox[8] و GNOME Videos (که قبلاً با نام Totem شناخته می‌شد)[12]

می‌توانید کل این قابلیت را با تنظیم enabled=false در بخش [MRPIS] فایل پیکربندی غیرفعال کنید.

پیکربندی این افزونه خاص است. پیکربندی روی خود افزونه انجام نمی‌شود، بلکه به‌ازای هر همتایی که رابط MPRIS2 را ارائه می‌دهد صورت می‌گیرد. برای تنظیم عنوان Banshee در MPRIS به مثال زیر نگاه کنید:

[org.mpris.MediaPlayer2.banshee]
title=@REALNAME@'s Banshee on @HOSTNAME@

این افزونه گزینه‌های اضافی دیگری ندارد.

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

rygel(1), gst-launch(1)

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

Jens Georg <mail@jensge.org>

این صفحهٔ راهنما را نوشته است.

یادداشت‌ها (NOTES)

1.: یک باگ IOP ثبت کنید

https://gitlab.gnome.org/GNOME/rygel/issues/new/?issuable_template=IOP

2.: GStreamer

http://gstreamer.freedesktop.org

3.: وب‌سایت پروژهٔ tracker

https://wiki.gnome.org/Projects/Tracker

4.: SQLite

http://sqlite.org

5.: دیمن lightmediascanner

https://github.com/profusion/lightmediascanner

6.: مشخصات رابط DBus بنام MediaServer2

https://wiki.gnome.org/Projects/Rygel/MediaServer2Spec

7.: gnome-dvb-daemon

https://wiki.gnome.org/Projects/DVBDaemon

8.: Rhythmbox

http://www.rhythmbox.org

9.: Grilo

https://wiki.gnome.org/Projects/Grilo

10.: مشخصات رابط DBus بنام MPRIS2

https://specifications.freedesktop.org/mpris-spec/latest/

11.: Banshee

http://banshee.fm

12.: GNOME Videos (که قبلاً با نام Totem شناخته می‌شد)

https://wiki.gnome.org/Apps/Videos