1RYGEL(1) Rygel User Manual RYGEL(1)
2
3
4
6 rygel - a collection of DLNA/UPnP AV services
7
9 rygel [options]
10
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
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
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
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
147 The BTS can be found at https://gitlab.gnome.org/GNOME/rygel/issues.
148
150 rygel.conf(5)
151
153 Jens Georg <mail@jensge.org>
154 Wrote this manpage.
155
156
157
158rygel 09/18/2021 RYGEL(1)