'\" t
.\"     Title: RYGEL
.\"    Author: Jens Georg <mail@jensge.org>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 05/24/2026
.\"    Manual: Rygel User Manual
.\"    Source: rygel
.\"  Language: English
.\"
.TH "RYGEL" "1" "05/24/2026" "rygel" "Rygel User Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
rygel \- مجموعه‌ای از خدمات صوتی و تصویری DLNA/UPnP
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBrygel\fR\ 'u
\fBrygel\fR [\fBگزینه‌ها\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
\fBrygel\fR
یک راهکار چندرسانه‌ای خانگی است که به شما امکان می‌دهد به‌سادگی صوت، ویدیو و تصاویر را به اشتراک بگذارید و پخش‌کننده‌های چندرسانه‌ای را در شبکه خانگی خود کنترل کنید\&. از نظر فنی، این برنامه هم یک MediaServer و هم یک MediaRenderer تحت استاندارد UPnP AV است که از طریق یک سازوکار افزونه (plug\-in) پیاده‌سازی شده است\&. سازگاری با سایر دستگاه‌های موجود در بازار از طریق انطباق با الزامات بسیار سخت‌گیرانهٔ DLNA و تبدیل بلادرنگ رسانه‌ها به قالب‌هایی که دستگاه‌های کلاینت قادر به مدیریت آن باشند به دست می‌آید\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
این برنامه از نحو معمول خط فرمان گنو پیروی می‌کند، که در آن گزینه‌های طولانی با دو خط تیره (`\-\*(Aq) شروع می‌شوند\&. خلاصه‌ای از گزینه‌ها در زیر آمده است\&.
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
نمایش خلاصه‌ای از گزینه‌ها\&.
.RE
.PP
\fB\-\-version\fR
.RS 4
نمایش نسخهٔ برنامه\&.
.RE
.PP
\fB\-n\fR, \fB\-\-network\-interface=\fR\fB\fIINTERFACE\fR\fR
.RS 4
تنظیم رابط‌های شبکه‌ای که rygel روی آن‌ها گوش می‌دهد\&. می‌تواند چندین بار برای پیکربندی چند رابط به کار رود\&.
\fBINTERFACE\fR
می‌تواند یک نشانی IP، نام دستگاه یا یک ESSID (فقط در لینوکس) باشد\&.
.RE
.PP
\fB\-p\fR, \fB\-\-port=\fR\fB\fIPORT\fR\fR
.RS 4
تنظیم درگاه شنود (listen\-port)\&.
.RE
.PP
\fB\-t\fR, \fB\-\-disable\-transcoding\fR
.RS 4
غیرفعال کردن هرگونه تبدیل کُد (transcoding)\&.
.RE
.PP
\fB\-U\fR, \fB\-\-disallow\-upload\fR
.RS 4
غیرفعال کردن بارگذاری فایل‌های چندرسانه‌ای از طریق UPnP\&.
.RE
.PP
\fB\-D\fR, \fB\-\-disallow\-deletion\fR
.RS 4
کلاینت‌های UPnP مجاز به حذف فایل‌های چندرسانه‌ای روی سرور نیستند\&.
.RE
.PP
\fB\-g\fR, \fB\-\-log\-level=\fR\fB\fILEVEL\fR\fR
.RS 4
فهرستی از جفت‌های
\fIDOMAIN\fR:\fILEVEL\fR
جداشده با کاما، که امکان تنظیم سطح لاگ را به صورت جداگانه برای هر دامنه فراهم می‌کند؛ که در آن
\fIDOMAIN\fR
می‌تواند
\fB"*"\fR، "\fBrygel\fR" یا نام یک پلاگین باشد\&. سطوح مجاز لاگ عبارتند از: 1=بحرانی (critical)، 2=خطا (error)، 3=هشدار (warning)، 4=پیام/اطلاعات (message/info)، 5=اشکال‌زدایی (debug)\&.
.RE
.PP
\fB\-u\fR, \fB\-\-plugin\-path=\fR\fB\fIPATH\fR\fR
.RS 4
تنظیم مسیر جستجوی پلاگین‌ها\&.
.RE
.PP
\fB\-e\fR, \fB\-\-engine\-path=\fR\fB\fIENGINE_PATH\fR\fR
.RS 4
تنظیم مسیر جستجوی موتور پخش جاری و تبدیل کد رسانه\&.
.RE
.PP
\fB\-d\fR, \fB\-\-disable\-plugin=\fR\fB\fIPLUGIN_NAME\fR\fR
.RS 4
غیرفعال کردن پلاگین
\fIPLUGIN_NAME\fR\&.
.RE
.PP
\fB\-i\fR, \fB\-\-title=\fR\fB\fIPLUGIN_NAME\fR\fR\fB:\fR\fB\fITITLE\fR\fR
.RS 4
تنظیم عنوان پلاگین
\fIPLUGIN_NAME\fR
به
\fITITLE\fR\&.
می‌توانید از این گزینه بیش از یک بار برای هر پلاگینی که می‌خواهید نامش را تنظیم کنید استفاده نمایید\&.
.RE
.PP
\fB\-o\fR, \fB\-\-plugin\-option=\fR\fB\fIPLUGIN_NAME\fR\fR\fB:\fR \fB\fIOPTION\fR\fR\fB:\fR\fB\fIVALUE1[,VALUE2,\&...]\fR\fR
.RS 4
تنظیم گزینه‌ها برای یک پلاگین\&.
.RE
.PP
\fB\-P\fR, \fB\-\-disable\-upnp\fR
.RS 4
غیرفعال کردن اعلان از طریق UPnP و قرار دادن
rygel
در حالت فقط پخش جاری (streaming\-only)\&.
.RE
.PP
\fB\-c\fR, \fB\-\-config=\fR\fB\fICONFIG_FILE\fR\fR
.RS 4
استفاده از
\fICONFIG_FILE\fR
به جای
${XDG_CONFIG_DIR}/rygel\&.conf\&.
.RE
.PP
\fB\-s\fR, \fB\-\-shutdown\fR
.RS 4
خاموش کردن یک نمونهٔ در حال اجرای rygel\&.
.RE
.PP
\fB\-r\fR, \fB\-\-replace\fR
.RS 4
جایگزین کردن نمونهٔ در حال اجرای rygel با این نمونه\&. معادل کوتاه شدهٔ
\fBrygel \-s && rygel\fR\&.
.RE
.SH "فایل‌ها (FILES)"
.PP
/etc/rygel\&.conf
.RS 4
فایل پیکربندی سراسری سیستم برای کنترل رفتار
rygel\&.
برای جزئیات بیشتر به
\fBrygel.conf\fR(5)
مراجعه کنید\&.
.RE
.PP
${XDG_CONFIG_DIR}/rygel\&.conf
.RS 4
فایل پیکربندی اختصاصی کاربر برای کنترل رفتار
rygel\&.
برای جزئیات بیشتر به
\fBrygel.conf\fR(5)
مراجعه کنید\&.
.RE
.PP
${XDG_CONFIG_DIR}/Rygel/*\&.xml
.RS 4
فایل‌های کَش‌شدهٔ توصیف دستگاه UPnP\&.
.RE
.SH "محیط (ENVIRONMENT)"
.PP
\fBRYGEL_DISABLE_UPNP\fR
.RS 4
غیرفعال کردن اعلان از طریق UPnP و قرار دادن
rygel
در حالت فقط پخش جاری (streaming\-only)\&.
.RE
.PP
\fBRYGEL_IFACE\fR
.RS 4
تنظیم رابط‌های شبکه برای اتصال (bind)\&.
.RE
.PP
\fBRYGEL_PORT\fR
.RS 4
تعریف درگاه شبکه برای اتصال (bind)\&.
.RE
.PP
\fBRYGEL_DISABLE_TRANSCODING\fR
.RS 4
غیرفعال کردن تبدیل کد (transcoding) به صورت سراسری\&.
.RE
.PP
\fBRYGEL_LOG\fR
.RS 4
تنظیم سطح لاگ (log level) برای
rygel\&.
.RE
.PP
\fBRYGEL_PLUGIN_PATH\fR
.RS 4
تنظیم مسیر جستجوی پلاگین برای
rygel\&.
.RE
.PP
\fBRYGEL_ENGINE_PATH\fR
.RS 4
تنظیم مسیر جستجوی موتور پخش جاری و تبدیل کد برای
rygel\&.
.RE
.PP
\fBRYGEL_MEDIA_ENGINE\fR
.RS 4
تعیین یک موتور پخش جاری رسانهٔ خاص برای انتخاب از مسیر جستجوی موتور رسانه\&.
.RE
.PP
\fBRYGEL_DISABLE_UPLOAD\fR
.RS 4
غیرفعال کردن بارگذاری فایل‌های رسانه‌ای از طریق UPnP\&.
.RE
.PP
\fBRYGEL_DISABLE_DELETION\fR
.RS 4
غیرفعال کردن حذف از راه دور فایل‌ها از طریق UPnP\&.
.RE
.PP
\fBRYGEL_PLUGIN_TIMEOUT\fR
.RS 4
تنظیم مهلت زمانی (time\-out) برای یافتن پلاگین‌ها\&. افزایش آن هنگام اجرا در محیط valgrind مفید است\&.
.RE
.PP
\fBRYGEL_DATABASE_DEBUG\fR
.RS 4
اگر روی ۱ تنظیم شود، کتابخانه پایگاه داده دستورات SQL استفاده‌شده را چاپ خواهد کرد\&.
.RE
.PP
همچنین برای هر پلاگین می‌توانید متغیرهای محیطی زیر را تنظیم کنید:
.PP
.PP
\fBRYGEL_PLUGIN_NAME_TITLE\fR
.RS 4
تنظیم عنوان پلاگین\&.
.RE
.PP
\fBRYGEL_PLUGIN_NAME_ENABLED\fR
.RS 4
فعال یا غیرفعال کردن پلاگین\&.
.RE
.SH "اشکالات (BUGS)"
.PP
سامانه ردیابی اشکالات (BTS) در نشانی زیر در دسترس است:
\m[blue]\fB\%https://gitlab.gnome.org/GNOME/rygel/issues\fR\m[]\&.
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBrygel.conf\fR(5)
.SH "نویسنده (AUTHOR)"
.PP
\fBJens Georg\fR <\&mail@jensge\&.org\&>
.RS 4
نگارش این صفحه راهنما\&.
.RE