Revision as of 07:07, 30 October 2006

Contents

Introduction

uShare (http://ushare.geexbox.org/) is a Upnp (TM) A/V Media Server. It implements the server component that provides UPnP media devices with information on available multimedia files. uShare uses the built-in http server of libupnp to stream the files to clients.
uShare is written for the GeeXboX project. It is designed to provide access to multimedia contents to GeeXboX but can of course be used by any other UPnP client device. It should compile and run on any modern POSIX compatible system such as Linux
uShare is free software - it is licensed under the terms of the GNU General Public License (GPL).

Usage

At first you need to be sure that you have setup a multicast route for UPnP messages. If you don't but have a default route attributed, then this later will be used. Otherwise, simply declare a new route for UPnP multicasts (for example using eth0 interface) :

route add -net 239.0.0.0 netmask 255.0.0.0 eth0

uShare runs from the console only. It supports the usual --help option which displays usage and option information.

Options:
-n, --name=NAME Set UPnP Friendly Name (default is 'uShare')
-i, --interface=IFACE Use IFACE Network Interface (default is 'eth0')
-p, --port=PORT Forces the HTTP server to run on PORT
-c, --content=DIR Share the content of DIR directory (default is './')
-w, --no-web Disable the control web page (enabled by default)
-v, --verbose Set verbose display.
-D, --daemon Run as a daemon.
-V, --version Display the version of uShare and exit
-h, --help Display this help

uShare expects at least one directory argument (-c argument), specifying where multimedia files are stored. You should probably also use the -i option to specify which interface uShare should listen on.

ushare -c /shares
ushare -c /shares1 --content=/shares2

Configuration

To complete the installation, you must edit /opt/etc/ushare.conf to add the location(s) of your media files