gmediaserver - UPnP music media server

gmediaserver [OPTIONS]... DIRECTORIES...

Run the UPnP 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 (`-').

--friendly-name=NAME

Set display name for media server.

--disable-id3

Do not scan files for ID3 information.

--in-charset=CHARSET

Specify character set used in file names, ID3 information etc. Normally this is identified automaticly from the current locale, but that in some cases that may not work and then you will need to specify this option.

Run `iconv --list' for a list of accepted character encoding set 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.

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

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

--help

Display this help and exit.

--version

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-types=mp3,wma,m3u,pls.

generic

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

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

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

kill(2)

Copyright © 2005 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.

Windows is a registered trademark of Microsoft Corporation in the United States and other countries.