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