NAME

       gmediarender - UPNP-AV renderer daemon

SYNOPSIS

       gmediarender [options] files...

DESCRIPTION

       This manual page documents briefly the gmediarender command.

       gmediarender  is  a  daemon  which acts as a UPNP-AV renderer on the local network.  It can be controlled
       from a UPNP-AV control point to play media files from a UPNP-AV media server through an audio  device  on
       the local system.

OPTIONS

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

   Application options:
       -d, --daemon
              Runs the program as a daemon.

       -f, --friendly-name <name>
              Friendly name to advertise on the network.

              Usually, it is desirable for the renderer to show up  on  controllers  under  a  recognisable  and
              unique name. This is the option to set that name.

       -I, --interface-name <interface-name>
              The local interface name the service is running and advertised on.

       -p, --port <port>
              Port to listen to. [49152..65535].

              libupnp does not use SO_REUSEADDR, so it might be necessary to increment this number.

       -P, --pid-file <pidfile>
              Name of the file which the process ID should be written to.

       -u, --uuid <uuid>
              UUID to advertise on the network in the form user:group.

              This  sets  the  UPNP  UUID  that  is  advertised and used by controllers to distinguish different
              renderers.  Usually, gmediarender uses a built-in static id.   If  there  are  multiple  renderers
              running  on  the  local  network,  they will all share the same static ID.  With this option, each
              renderer can be given its own id.  One way to generate a UUID is to create a UUID once by  running
              the uuidgen tool.

       --mime-filter <filter>
              Filters the advertised MIME types supported by the renderer.

              Normally, gmediarender advertises all MIME types (media formats) supported by the output. Use this
              option to limit the advertised media support or add/remove support for a specific type.

              Filters take 3 forms. Multiple filters are separated by a comma.

              • Prefix filters will only advertise MIME types that match the supplied prefix. e.g. audio, video,
              image.

              • Inclusion filters will add the supplied type to the supported list. e.g. +audio/x-flac

              • Removal filters will remove the supplied type from the supported list. e.g. -audio/x-flac

              e.g.   To   allow  only  audio,  without  FLAC  but  include  FLV.  --mime-filter  audio,-audio/x-
              flac,+video/x-flv

   Audio options:
       --gstout-audiosink <sink>
              Set the audio sink.

       --gstout-audiodevice <device>
              Set the audio device.

              The --gstout-audio... options allow the user to configure where the sound output from gmediarender
              is  sent.   The  correct  values  will depend on which method of audio output (e.g. ALSA) is being
              used.

       --gstout-initial-volume-db <volume>
              Sets the initial volume on startup in decibels.

              Values range from 0 (maximum volume) to -60 (minimum volume.  The  decibel  scale  is  non-linear:
              -20db represents roughly half volume.  The default value is 0.

              Note  that  this  does  not  influence  the  hardware  (e.g. ALSA) volume level, but only internal
              attenuation.  It is advisable to set the hardware level to 100 where possible.

       --list-outputs
              List available output modules and exit.

       -o, --output <module>
              Output module to use.

              Use --output to obtain a list of valid modules.

   Debug options:
       --dump-devicedesc
              Dump device descriptor XML and exit.

       --dump-connmgr-scpd
              Dump Connection Manager service description XML and exit.

       --dump-control-scpd
              Dump Rendering Control service description XML and exit.

       --dump-transport-scpd
              Dump A/V Transport service description XML and exit.

       --logfile <logfile>
              Name of a file to log output of the program to.

              To log to the terminal use use --logfile devstdout This file can get quite large over time, so  it
              is only recommended to use this option for debugging purposes.

   Help options
       -h, --help
              Show summary of options.

       --help-all
              Show all help options.

       --help-gstout
              Show GStreamer Output Options.

       --help-gst
              Show GStreamer Options.

       -v, --version
              Show the program version.

SEE ALSO

       uuidgen(1).

                                                February  4, 2014                                GMEDIARENDER(1)