NAME

       GMediaServer - A UPnP compatible media server

SYNOPSIS

       gmediaserver [OPTIONS]... DIRECTORIES...

DESCRIPTION

       Run  the UPnP compatible media server. The directories arguments specify where audio files
       are located.

       GMediaServer is a UPnP music  media  server.  It  implements  the  server  component  that
       provides  UPnP  media devices with information on available audio files. GMediaServer uses
       the built-in http server of libupnp to stream the audio files to clients.

       When the main process receives the USR1 signal, all directories specified on  the  command
       line  will be rescanned. This functionality is currently quite crude in that all files are
       rescanned even if they were not changed.

OPTIONS

       This program follow the usual GNU command line syntax, with long options starting with two
       dashes (`-').

       --friendly-name=NAME
              Set display name for media server.

       --disable-tags
              Do not scan files for tags.

       --fs-charset=CHARSET
              Specify   character   set   used   in  file  names.  If  the  environment  variable
              `G_BROKEN_FILENAMES' (1) is set, this is if possible  identified  automaticly  from
              the  current  locale  (usually  the  environment variable `LC_CTYPE' affects this).
              Otherwise UTF-8 is assumed. Use this option to specify character set manually.

              Run `iconv --list' for a list of accepted character encoding names.

       --device-charset=CHARSET
              Specify character set used in the data passed to  the  control  point  (the  player
              device). If this option is not specified, no translation will occur.

              Run `iconv --list' for a list of accepted character encoding set names.

       --log-charset=CHARSET
              Specify  character set used in messages printed to standard out and to the log file
              (if applicable). If this option is not specified,  it  is  if  possible  identified
              automaticly from the current locale.

       -v, --verbose[=LEVEL]
              Set verbosity level (0-4).

       --pid-file=FILE
              Write pid to FILE when up and running.

       -i, --interface=NAME
              Listen on a specific interface. NAME can be either an IP address (IPv4) or the name
              of a network device.

       -p, --port=PORT
              Listen on a specific port.

       -o, --output=LOGFILE
              File for logging.

       -b, --background
              Go to background (detach).

       --no-timestamp
              Do not prepend timestamp to log entries.  See strftime(3) for  description  of  the
              timestamp format.

       --timestamp[=FORMAT]
              Prepend timestamp with optional time format.

       --profile=NAME
              Specify  which  profile  to  use.  Profiles control what settings are enabled for a
              certain control point (the player device). See PROFILES below for a list  of  valid
              values for --profile. The default is "generic".

       --expire-time=SECONDS
              Set  UPnP  advertisement  expire time. This may be necessary for some devices.  The
              default is 100 seconds.

       --file-types=TYPE[,..]
              Specify which types of files are accepted by the control point.  The argument is  a
              comma  separated  list of accepted types. File types are identified by contents and
              not file name (i.e. the extension).  See FILE TYPES below for a list of valid types
              for --file-types.  The default is "mp3,wma,m3u,pls".

       --help Display this help and exit.

       --version
              Output version information and exit.

PROFILES

       The following values are valid for --profile:

       mp101  Netgear MP101. Implies --file-types=mp3,wma,m3u,pls.

       dms1   Omnify DMS1. Implies --expire-time=600 --file-types=mp3,wma,m3u,pls.

       generic
              All other devices. Implies no custom settings.

FILE TYPES

       The following types can be specified for --file-types:

       mp3    The  regular  MP3  files, or to be more specific `MPEG ADTS, layer III, v1'. At the
              moment this does also include MP3 files beginning with an ID3 tag.

       wma    `Windows Media Audio' data encapsulated in Microsoft ASF files.

       wav    Wave sound data encapsulated in RIFF files.

       m4a    `iTunes AAC-LC' data encapsulated in an ISO Media MPEG v4 system file.

       ogg    Vorbis audio data encapsulated in an Ogg file.

       pls    A playlist format used by Winamp and other programs.

       m3u    Simple and extended M3U playlists used by Winamp and other programs.  Extended  M3U
              playlists start with `#EXTM3U'.

       unknown
              Unidentified  files  (all  other).  Normally  these  files are not served, but when
              unknown is included in the file types list they will be.

REPORTING BUGS

       Report bugs to <oskar@osk.mine.nu>.

AUTHOR

       GMediaServer was written by Oskar Liljeblad <oskar@osk.mine.nu>.

SEE ALSO

       kill(2)

COPYRIGHT

       Copyright © 2005, 2006 Oskar Liljeblad

       This is free software; see the source for copying conditions.  There is NO  warranty;  not
       even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

                                        February 10, 2006                         GMEDIASERVER(1)