NAME¶

upmpdcli - UPnP Media Renderer and Media Server

SYNOPSIS¶

upmpdcli [options]

DESCRIPTION¶

upmpdcli implements both an UPnP Media Renderer and Media Server.

As an UPnP Media Renderer, upmpdcli uses the Music Player Daemon, mpd, for processing the audio streams (playing the music). This allows integrating the high quality and widely ported MPD inside an UPnP music network, and controlling it from an UPnP Control Point, typically running on a tablet or phone.

As an UPnP Media Server, upmpdcli provides both an interface to a local media library and a set of proxy interfaces for external sources, such as streaming services or radio catalogs. All supported and activated functions are presented as entries in the root directory of the Media Server.

OPTIONS¶

The program uses short command line options. A summary of options is included below. Most of the configuration though is performed through parameters in a configuration file. See upmpdcli.conf(5). Except for the -c option which designates the configuration file, the command line options are little used and kept for backward compatibility.

-c configfile

Use the configuration from configfile. The configuration file has a simple name = value format and can set the same values as the command line options (with a lower priority). The parameter names are mpdhost, mpdport, friendlyname, logfilename, loglevel, upnpiface, upnpport. The configuration file can also be used to set the MPD password (mpdpassword), and the UPnP IP address (instead of interface name, upnpip). See upmpdcli.conf(5). Note that if this option is not given, no configuration file is read and the program runs entirely from its defaults, command line options, and environment.

-h host

Define the host machine on which mpd runs.

-f friendly_name

Set the name which will be displayed by controllers for this instance after they search the network.

-p port

Define the IP port used by mpd.

-q 0|1

Decide if we own the MPD queue (-q 1) or not (-q 0). We own it by default, and clear it fearlessly.

-d logfilename

Send debug/trace messages to logfilename.

-l level

Set the log verbosity (0-4).

-D

Daemonize (fork and run in background). Using -D for this is the reverse from usual convention, but the authors found it better to avoid surprising naïve users with an unexpected disparition of the program...

-i iface

Define the network interface to use for UPnP.

-O /0

Start the OpenHome ohMedia services (esp. PlayList), or not.

-P port

Define the IP port to use for UPnP.

SEE ALSO¶

mpd(1),upmpdcli.conf(5)