4.1 Command line options

GMediaServer follow the usual GNU command line syntax, with long options starting with two dashes (--).

--friendly-name=NAME

Set the name which other media players sees us as.

--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 ¹ 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, it is assumed that the player device uses UTF-8.

--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, that is, how much information is displayed on standard out. Valid values are 0 (minimum output) to 4 (maximum output).

--pid-file=FILE

Write pid to FILE when GMediaServer is up and running.

-i, --interface=NAME

Make GMediaServer listen on a specific interface. NAME can be either an IP address (IPv4) or the name of a network device.

-p, --port=PORT

Make GMediaServer listen on a specific port number.

-o, --output=LOGFILE

Write output to specified file rather than standard out.

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

--profile=NAME

Specify which profile to use. Profiles control what settings are enabled for a certain control point (the player device). See 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 \fBFILE TYPES\fP 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.