RYGEL.CONF(5) Rygel User Manual RYGEL.CONF(5) نام (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 این صفحهٔ راهنما را نوشته است. یادداشت‌ها (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 rygel 05/24/2026 RYGEL.CONF(5)