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.