Man Linux: Main Page and Category List


       GMediaServer - A UPnP compatible media server


       gmediaserver [OPTIONS]... DIRECTORIES...


       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.


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

              Set display name for media server.

              Do not scan files for tags.

              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

              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

              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).

              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).

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

              Prepend timestamp with optional time format.

              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".

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

              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.

              Output version information and exit.


       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-

              All other devices. Implies no custom settings.


       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

       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’.

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


       Report bugs to <>.


       GMediaServer was written by Oskar Liljeblad <>.




       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

                               February 10, 2006