RYGEL(1)

NAME
rygel - a collection of DLNA/UPnP AV services

SYNOPSIS

rygel [options]

DESCRIPTION

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

OPTIONS

The program follows the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below.

-h, --help
    Show summary of options.

--help-all
    Show all help options.

--help-gst
    Show GStreamer related help options.

--version
    Show version of program.

-n, --network-interface=INTERFACE
    Set the network-interface rygel listens on.

-p, --port=PORT
    Set the listen-port.

-t, --disable-transcoding
    Disable any transcoding.

-m, --disable-mp3-transcoder
    Disable transcoding to MP3.

-s, --disable-mp2ts-transcoder
    Disable transcoding to MPEG2 in TS container.

-l, --disable-lpcm-transcoder
    Disable transcoding to Linear PCM.

-w, --disable-wmv-transcoder
    Disable transcoding to WMV.

-a, --disable-aac-transcoder
    Disable transcoding to AAC.

-z, --disable-avc-transcoder
    Disable transcoding to AVC.

-U, --disallow-upload
    Disable uploading of media files via UPnP.

-D, --disallow-deletion
    UPnP clients are not allowed to delete media files on the server.

-g, --log-level=LEVEL
    Comma-separated list of DOMAIN:LEVEL pairs, allowing to set the log level individually for each domain, where DOMAIN is eiher "*", "rygel" or the name of a plugin. Allowed log levels are 1=critical, 2=error, 3=warning, 4=message/info, 5=debug.

-u, --plugin-path=PATH
    Set the plugin search path.

-d, --disable-plugin=PLUGIN_NAME
    Disable the plugin PLUGIN_NAME.

-i, --title=PLUGIN_NAME:TITLE
    Set the title of plugin PLUGIN_NAME to TITLE You can use this option more than once for every plugin you want to set the name of.

-o, --plugin-option=PLUGIN_NAME: OPTION:VALUE1[,VALUE2,...]
    Set options for a plugin.

-P, --disable-upnp
    Disable advertisement via UPnP and set rygel into streaming-only mode.

-c --config=CONFIG_FILE
    Use CONFIG_FILE instead of ${XDG_CONFIG_DIR}/rygel.conf.

FILES

/etc/rygel.conf
    The system-wide configuration file to control the behaviour of rygel. See rygel.conf(5) for further details.

${XDG_CONFIG_DIR}/rygel.conf
    The per-user configuration file to control the behaviour of rygel. See rygel.conf(5) for further details.

${XDG_CONFIG_DIR}/Rygel/*.xml
    Cached UPnP device description files.

ENVIONMENT

RYGEL_DISABLE_UPNP
    Disable advertisement via UPnP and set rygel into streaming-only mode.

RYGEL_IFACE
    Set the network interface to bind to.

RYGEL_PORT
    Define the network port to bind to.

RYGEL_DISABLE_TRANSCODING
    Disable transcoding globally.

RYGEL_DISABLE_MP3_TRANS
    Disable the MP3 transcoder.

RYGEL_DISABLE_LPCM_TRANS
    Disable the Linear PCM transcoder.

RYGEL_DISABLE_MP2TS_TRANS
    Disable the MPEG2 in TS transcoder.

RYGEL_DISABLE_WMV_TRANS
    Disable transcoding to WMV format.

RYGEL_DISABLE_AAC_TRANS
    Disable transcoding to AAC format.

RYGEL_DISABLE_AVC_TRANS
    Disable transcoding to AVC format.

RYGEL_LOG
    Set the log level of rygel.

RYGEL_PLUGIN_PATH
    Set the plugin search path of rygel.

RYGEL_DISABLE_UPLOAD
    Disable media file upload via UPnP.

RYGEL_DISABLE_DELETION
    Disable remote file deletion via UPnP.

RYGEL_PLUGIN_TIMEOUT
    Set the time-out for finding the plugins. Useful to increase when running inside valgrind.

Also for every plugin you can set the following environment variables:

RYGEL_PLUGIN_NAME_TITLE
    Set the title of the plugin.

RYGEL_PLUGIN_NAME_ENABLED
    Enable or disable the plugin.

BUGS

The BTS can be found at https://bugzilla.gnome.org/buglist.cgi?product=rygel.

SEE ALSO

rygel.conf(5)

AUTHOR

Jens Georg <mail@jensge.org>
    Wrote this manpage.