README

GMediaRender
============

Introduction
------------

GMediaRender is a UPnP(tm) media renderer for POSIX(r)-compliant
systems, such as Linux(r) or UNIX(r). It implements the server
component that provides UPnP controllers a means to render media
content (audio, video and images) from a UPnP media server.

Copyright
---------

GMediaRender is copyright (C) 2005-2007 Ivo Clarysse.
Continuation of this project (C) 2012-2013 Henner Zeller.

License
-------

GMediaRender is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2 of the License, or (at your option)
any later version.

This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
more details.

You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc., 51
Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Note that GMediaRender links with libupnp, which is licensed under the
terms of a modified BSD license (i.e. the original BSD license without the
advertising clause). This license is compatible with the GNU GPL.

Note that GMediaRender does not ship with any codecs, and is licensed
without exception to the GNU GPL. For more info, contact your lawyer,
check out the FSF website, or have a look at:

       http://gstreamer.freedesktop.org/documentation/licensing.html

The source code of this project may contain files from other projects, and
files generated by other projects, including:

 * GMediaServer (http://www.nongnu.org/gmediaserver/)


Binary files license
--------------------

The files 'grender-128x128.png' and 'grender-64x64.png', included in this
package, are Copyright (C) 2005 Ivo Clarysse.  Copying and distribution
of these files, with or without modification, are permitted in any medium
without royalty provided this notice is preserved.


Requirements
------------

The following programs are required to build GMediaRender:

    * GNU C Compiler (gcc), 2.95 or later.

The following libraries are required to build and run GMediaRender:

    * Portable SDK for UPnP Devices (libupnp), 1.6.0 or later, including
      the latest 1.8.x versions (BSD license).
        http://pupnp.sourceforge.net/

    * GStreamer 1.x (LGPL).
         https://gstreamer.freedesktop.org/


Note that GMediaRender completely relies on GStreamer for rendering
content, so if your GStreamer environment does not support a given
media format, GMediaRender won't either.

You can test this from the command line:

   gst-launch-0.10 playbin uri=file:///path/to/file


Trademarks
----------

UPnP(tm) is a trademark of the UPnP Implementers Corporation.
"POSIX" is a registered trademark of the IEEE in the United States.
Linux(r) is the registered trademark of Linus Torvalds in the U.S.
and other countries. UNIX(r) is a registered trademark of The Open
Group. All other trademarks are the property of their respective
owners.