GMediaServer - Introduction
===========================

GMediaServer is a UPnP compatible media server for the GNU system. It is
part of the GNU project.

GMediaServer serves audio and video files to certain network connected
media players. Most hardware media players only play music and/or
video--they don't provide the media themselves. Those media files have
to come from a device on the network. GMediaServer is a server for such
UPnP compatible media players, including:

   * NETGEAR Wireless Digital Music Player (MP101)
   * Linksys Wireless-B Music System (WMLS11B), 
     Wireless-B Media Link for Music (WML11B)
   * Philips Streamium SL300i, Streamium RC9800i, Streamium SLA5520,
     SLA5500
   * Omnifi DMS1
   * SMC EZ Stream 11Mbps Wireless Audio Adaptor (SMCWAA-B)
   * D-Link DSM-520 Wireless HD Media Player
   * Roku SoundBridge Network Music Player M1000
   * Terratec NOXON audio, NOXON 2 audio
   * Pinnacle ShowCenter 200
   * Logik IR100
   * Denon AVR-4306
   * Nokia 770 Internet Tablet

Other UPnP media players (including software based) may work as
well--see the manual for a more complete list.

GMediaServer is written in C by Oskar Liljeblad. It should compile
and run on any modern POSIX compatible system such as GNU/Linux.
GMediaServer is a console based application which is usually run in the
background. It is free software, licensed under the terms of the GNU
General Public License (http://www.gnu.org/copyleft/gpl.html).

Copyright and License
=====================

GMediaServer is copyright (C) 2005, 2006, 2007 Oskar Liljeblad.

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License
(http://www.gnu.org/copyleft/gpl.html) as published by the Free
Software Foundation (http://www.fsf.org/); either version 3 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.

See the manual for further details on licensing and copyright.

Requirements
============

The following programs are required to build GMediaServer:

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

The following libraries are required to build and run GMediaServer:

 * Linux SDK for UPnP Devices (libupnp), 1.2.1 or later

 * libmagic from file ("The Fine Free File Command"), 4.02 or later

The following libraries are optional:

 * ID3v1/ID3v2 Tagging Library (id3lib), 3.8 or later

 * TagLib Audio Meta-Data Library (taglib), 1.4 or later

 * Ext2 Filesystem Utilities (E2fsprogs), 1.36 or later

See the manual for further details.

Quick Start
===========

Compile GMediaServer by running configure and then make. This should
produce an executable gmediaserver in the src subdirectory, which can be
used right away. No extra files need to be installed.

GMediaServer is run from the command line. It supports the usual
`--help' option which displays usage and option information.
GMediaServer expects one or more directory arguments, specifying where
audio files are stored. You should probably also use the `-i'
(`--interface') option to specify which interface GMediaServer should
listen on. The first times you run GMediaServer it would also be a good
idea to increase the verbosity. Example:

     ./gmediaserver -ieth1 -v4 /audio

Check out the `--profile' option, which allows settings for certain
devices to be automaticly enabled. See the manual for more details:

  info ./doc/gmediaserver.info

Homepage
========

The home page of GMediaServer is located on
`http://www.gnu.org/software/gmediaserver/'.

Feedback
========

The author of GMediaServer and this document, Oskar Liljeblad, can be
contacted by e-mail on <oskar@osk.mine.nu>.

You can also write to the mailing list as well. See the manual for more
details.

-
