Configuration File

The libmmplaylist configuration file lists the playlist plugins (PLPs) that the library can use to manage playlists as well as the configuration settings for those plugins.

The libmmplaylist library is shipped with a default configuration file whose path is /etc/mm/mm-playlist.conf. You can modify this included file or create your own. Your client must call mmplaylist_init() exactly once and supply either a full path to your own configuration file or a path of NULL to use the default configuration file.

Note: You can define the MM_PLAYLIST environment variable to override the default path that libmmplaylist examines to find its configuration file. When you call mmplaylist_init() with a path of NULL, the library uses the configuration file at the path given in MM_PLAYLIST. Defining this variable is useful when launching applications such as mm-renderer that use libmmplaylist but don't allow you to specify the configuration path.

Each section that defines settings for an individual PLP must begin with a line of the form:

[plugin]

The settings are listed on the lines that follow, one per line. A dll setting is required in every section to name the library file that implements the PLP. The syntax for a PLP setting consists of a field name, followed by the equal sign (=), followed by the field value. For example, the following lines name the library file and assign a rating of 20 for the iTunes plugin: 

[plugin]
dll=mm-plp-itunes.so
rating=20

You can also place comments in the configuration file by starting lines with the number sign (#).

Default configuration file

The contents of the default configuration file look like this:

# libmmplaylist config file

[plugin]
dll=mm-plp-qdb.so

[plugin]
dll=mm-plp-m3u.so

[plugin]
dll=mm-plp-asx.so

[plugin]
dll=mm-plp-itunes.so

[plugin]
dll=mm-plp-pls.so

[plugin]
dll=mm-plp-rmp.so

[plugin]
dll=mm-plp-wpl.so

[plugin]
dll=mm-plp-xspf.so

[plugin]
dll=mm-plp-filelist.so
# The filelist delimiter can be changed here noting that
# characters starting with '\' will be converted to
# their escapled equivalent if they exist.  If \xZZ is
# used, the ascii value for the two hexidecimal digits
# following the 'x' character will be used. Because PPS
# treats newlines as a special character, \n will not
# be escaped. Examples:
# 
# delimiter=\x1e	-- Hex character 0x1e (default).
# delimiter=\t\t	-- Two tabs