RYGEL(1) Rygel User Manual RYGEL(1)

rygel - مجموعه‌ای از خدمات صوتی و تصویری DLNA/UPnP

rygel [گزینه‌ها]

rygel یک راهکار چندرسانه‌ای خانگی است که به شما امکان می‌دهد به‌سادگی صوت، ویدیو و تصاویر را به اشتراک بگذارید و پخش‌کننده‌های چندرسانه‌ای را در شبکه خانگی خود کنترل کنید. از نظر فنی، این برنامه هم یک MediaServer و هم یک MediaRenderer تحت استاندارد UPnP AV است که از طریق یک سازوکار افزونه (plug-in) پیاده‌سازی شده است. سازگاری با سایر دستگاه‌های موجود در بازار از طریق انطباق با الزامات بسیار سخت‌گیرانهٔ DLNA و تبدیل بلادرنگ رسانه‌ها به قالب‌هایی که دستگاه‌های کلاینت قادر به مدیریت آن باشند به دست می‌آید.

این برنامه از نحو معمول خط فرمان گنو پیروی می‌کند، که در آن گزینه‌های طولانی با دو خط تیره (`-') شروع می‌شوند. خلاصه‌ای از گزینه‌ها در زیر آمده است.

-h, --help

نمایش خلاصه‌ای از گزینه‌ها.

--version

نمایش نسخهٔ برنامه.

-n, --network-interface=INTERFACE

تنظیم رابط‌های شبکه‌ای که rygel روی آن‌ها گوش می‌دهد. می‌تواند چندین بار برای پیکربندی چند رابط به کار رود. INTERFACE می‌تواند یک نشانی IP، نام دستگاه یا یک ESSID (فقط در لینوکس) باشد.

-p, --port=PORT

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

-t, --disable-transcoding

غیرفعال کردن هرگونه تبدیل کُد (transcoding).

-U, --disallow-upload

غیرفعال کردن بارگذاری فایل‌های چندرسانه‌ای از طریق UPnP.

-D, --disallow-deletion

کلاینت‌های UPnP مجاز به حذف فایل‌های چندرسانه‌ای روی سرور نیستند.

-g, --log-level=LEVEL

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

-u, --plugin-path=PATH

تنظیم مسیر جستجوی پلاگین‌ها.

-e, --engine-path=ENGINE_PATH

تنظیم مسیر جستجوی موتور پخش جاری و تبدیل کد رسانه.

-d, --disable-plugin=PLUGIN_NAME

غیرفعال کردن پلاگین PLUGIN_NAME.

-i, --title=PLUGIN_NAME:TITLE

تنظیم عنوان پلاگین PLUGIN_NAME به TITLE. می‌توانید از این گزینه بیش از یک بار برای هر پلاگینی که می‌خواهید نامش را تنظیم کنید استفاده نمایید.

-o, --plugin-option=PLUGIN_NAME: OPTION:VALUE1[,VALUE2,...]

تنظیم گزینه‌ها برای یک پلاگین.

-P, --disable-upnp

غیرفعال کردن اعلان از طریق UPnP و قرار دادن rygel در حالت فقط پخش جاری (streaming-only).

-c, --config=CONFIG_FILE

استفاده از CONFIG_FILE به جای ${XDG_CONFIG_DIR}/rygel.conf.

-s, --shutdown

خاموش کردن یک نمونهٔ در حال اجرای rygel.

-r, --replace

جایگزین کردن نمونهٔ در حال اجرای rygel با این نمونه. معادل کوتاه شدهٔ rygel -s && rygel.

/etc/rygel.conf

فایل پیکربندی سراسری سیستم برای کنترل رفتار rygel. برای جزئیات بیشتر به rygel.conf(5) مراجعه کنید.

${XDG_CONFIG_DIR}/rygel.conf

فایل پیکربندی اختصاصی کاربر برای کنترل رفتار rygel. برای جزئیات بیشتر به rygel.conf(5) مراجعه کنید.

${XDG_CONFIG_DIR}/Rygel/*.xml

فایل‌های کَش‌شدهٔ توصیف دستگاه UPnP.

RYGEL_DISABLE_UPNP

غیرفعال کردن اعلان از طریق UPnP و قرار دادن rygel در حالت فقط پخش جاری (streaming-only).

RYGEL_IFACE

تنظیم رابط‌های شبکه برای اتصال (bind).

RYGEL_PORT

تعریف درگاه شبکه برای اتصال (bind).

RYGEL_DISABLE_TRANSCODING

غیرفعال کردن تبدیل کد (transcoding) به صورت سراسری.

RYGEL_LOG

تنظیم سطح لاگ (log level) برای rygel.

RYGEL_PLUGIN_PATH

تنظیم مسیر جستجوی پلاگین برای rygel.

RYGEL_ENGINE_PATH

تنظیم مسیر جستجوی موتور پخش جاری و تبدیل کد برای rygel.

RYGEL_MEDIA_ENGINE

تعیین یک موتور پخش جاری رسانهٔ خاص برای انتخاب از مسیر جستجوی موتور رسانه.

RYGEL_DISABLE_UPLOAD

غیرفعال کردن بارگذاری فایل‌های رسانه‌ای از طریق UPnP.

RYGEL_DISABLE_DELETION

غیرفعال کردن حذف از راه دور فایل‌ها از طریق UPnP.

RYGEL_PLUGIN_TIMEOUT

تنظیم مهلت زمانی (time-out) برای یافتن پلاگین‌ها. افزایش آن هنگام اجرا در محیط valgrind مفید است.

RYGEL_DATABASE_DEBUG

اگر روی ۱ تنظیم شود، کتابخانه پایگاه داده دستورات SQL استفاده‌شده را چاپ خواهد کرد.

همچنین برای هر پلاگین می‌توانید متغیرهای محیطی زیر را تنظیم کنید:

RYGEL_PLUGIN_NAME_TITLE

تنظیم عنوان پلاگین.

RYGEL_PLUGIN_NAME_ENABLED

فعال یا غیرفعال کردن پلاگین.

سامانه ردیابی اشکالات (BTS) در نشانی زیر در دسترس است: https://gitlab.gnome.org/GNOME/rygel/issues.

rygel.conf(5)

Jens Georg <mail@jensge.org>

نگارش این صفحه راهنما.
05/24/2026 rygel