1RYGEL(1)                       Rygel User Manual                      RYGEL(1)
2
3
4

NAME

6       rygel - a collection of DLNA/UPnP AV services
7

SYNOPSIS

9       rygel [options]
10

DESCRIPTION

12       rygel is a home media solution that allows you to easily share audio,
13       video and pictures, and control of media player on your home network.
14       In technical terms it is both a UPnP AV MediaServer and MediaRenderer
15       implemented through a plug-in mechanism. Interoperability with other
16       devices in the market is achieved by conformance to very strict
17       requirements of DLNA and on the fly conversion of media to format that
18       client devices are capable of handling.
19

OPTIONS

21       The program follows the usual GNU command line syntax, with long
22       options starting with two dashes (`-'). A summary of options is
23       included below.
24
25       -h, --help
26           Show summary of options.
27
28       --version
29           Show version of program.
30
31       -n, --network-interface=INTERFACE
32           Set the network interfaces rygel listens on. Can be used multiple
33           times for to configure multiple interfaces.  INTERFACE can be an
34           IP, a device name or an ESSID (Linux only).
35
36       -p, --port=PORT
37           Set the listen-port.
38
39       -t, --disable-transcoding
40           Disable any transcoding.
41
42       -U, --disallow-upload
43           Disable uploading of media files via UPnP.
44
45       -D, --disallow-deletion
46           UPnP clients are not allowed to delete media files on the server.
47
48       -g, --log-level=LEVEL
49           Comma-separated list of DOMAIN:LEVEL pairs, allowing to set the log
50           level individually for each domain, where DOMAIN is eiher "*",
51           "rygel" or the name of a plugin. Allowed log levels are 1=critical,
52           2=error, 3=warning, 4=message/info, 5=debug.
53
54       -u, --plugin-path=PATH
55           Set the plugin search path.
56
57       -e, --engine-path=ENGINE_PATH
58           Set the media streaming and transcoding engine search path.
59
60       -d, --disable-plugin=PLUGIN_NAME
61           Disable the plugin PLUGIN_NAME.
62
63       -i, --title=PLUGIN_NAME:TITLE
64           Set the title of plugin PLUGIN_NAME to TITLE You can use this
65           option more than once for every plugin you want to set the name of.
66
67       -o, --plugin-option=PLUGIN_NAME: OPTION:VALUE1[,VALUE2,...]
68           Set options for a plugin.
69
70       -P, --disable-upnp
71           Disable advertisement via UPnP and set rygel into streaming-only
72           mode.
73
74       -c, --config=CONFIG_FILE
75           Use CONFIG_FILE instead of ${XDG_CONFIG_DIR}/rygel.conf.
76
77       -s, --shutdown
78           Shutdown a currently running instance of rygel
79
80       -r, --replace
81           Replace the currently running instance of rygel with this instance.
82           Short for rygel -s && rygel
83

FILES

85       /etc/rygel.conf
86           The system-wide configuration file to control the behaviour of
87           rygel. See rygel.conf(5) for further details.
88
89       ${XDG_CONFIG_DIR}/rygel.conf
90           The per-user configuration file to control the behaviour of rygel.
91           See rygel.conf(5) for further details.
92
93       ${XDG_CONFIG_DIR}/Rygel/*.xml
94           Cached UPnP device description files.
95

ENVIRONMENT

97       RYGEL_DISABLE_UPNP
98           Disable advertisement via UPnP and set rygel into streaming-only
99           mode.
100
101       RYGEL_IFACE
102           Set the network interfaces to bind to.
103
104       RYGEL_PORT
105           Define the network port to bind to.
106
107       RYGEL_DISABLE_TRANSCODING
108           Disable transcoding globally.
109
110       RYGEL_LOG
111           Set the log level of rygel.
112
113       RYGEL_PLUGIN_PATH
114           Set the plugin search path of rygel.
115
116       RYGEL_ENGINE_PATH
117           Set the media streaming and transcoding engine search path for
118           rygel.
119
120       RYGEL_MEDIA_ENGINE
121           Set a specific media streaming engine to pick up from the media
122           engine search path.
123
124       RYGEL_DISABLE_UPLOAD
125           Disable media file upload via UPnP.
126
127       RYGEL_DISABLE_DELETION
128           Disable remote file deletion via UPnP.
129
130       RYGEL_PLUGIN_TIMEOUT
131           Set the time-out for finding the plugins. Useful to increase when
132           running inside valgrind.
133
134       RYGEL_DATABASE_DEBUG
135           If set to 1, the database library will print the used SQL
136           statements.
137
138       Also for every plugin you can set the following environment variables:
139
140       RYGEL_PLUGIN_NAME_TITLE
141           Set the title of the plugin.
142
143       RYGEL_PLUGIN_NAME_ENABLED
144           Enable or disable the plugin.
145

BUGS

147       The BTS can be found at https://gitlab.gnome.org/GNOME/rygel/issues.
148

SEE ALSO

150       rygel.conf(5)
151

AUTHOR

153       Jens Georg <mail@jensge.org>
154           Wrote this manpage.
155
156
157
158rygel                             08/02/2023                          RYGEL(1)
Impressum