RYGEL(1)                       Rygel User Manual                      RYGEL(1)

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

خلاصه دستور (SYNOPSIS)
       rygel [گزینه‌ها]

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

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

       -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.

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

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

       ${XDG_CONFIG_DIR}/Rygel/*.xml
           فایل‌های کَش‌شدهٔ توصیف دستگاه UPnP.

محیط (ENVIRONMENT)
       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
           فعال یا غیرفعال کردن پلاگین.

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

همچنین ببینید (SEE ALSO)
       rygel.conf(5)

نویسنده (AUTHOR)
       Jens Georg <mail@jensge.org>
           نگارش این صفحه راهنما.

rygel                             05/24/2026                          RYGEL(1)