GMEDIASERVER(1) 					      General Commands Manual						   GMEDIASERVER(1)

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 avail-
       able 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 cur-
       rently 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 identi-
	      fied 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 transla-
	      tion 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 PRO-
	      FILES 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 (C) 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 PARTICU-
       LAR PURPOSE.

								 February 10, 2006						   GMEDIASERVER(1)