Filtering synchronization by file type

Client applications can filter the types of media files and playlists that get synchronized. The <extensions> element contains the <library> and <playlists> elements, which list the extensions that media files and playlists must have to be synchronized. Mediastore files with unlisted extensions don't get synchronized.

Both of these contained elements are required, and must list all extensions supported for that content type. This is done by defining an <extension> element for each supported file extension, within the <library> or <playlists> element.

The contents of the <extensions> element are:
Tag name Attribute Default Description
<extensions>/<playlists>     Specifies which file extensions are used for playlists. For each extension you want to support, define a separate <extension> element.
<extensions>/<playlists>/<extension> value (none) Names the extension of a media file type to synchronize. Usually, the extension is a three- or four-letter abbreviation of the format, but longer extensions are accepted. The matching ignores case, so an attribute setting of m3u8 means playlists with the extension M3U8 get synchronized.

For the list of supported playlist formats, see the product release notes.

<extensions>/<library>     Specifies which file extensions are used for media files. For each extension you want to support, define a separate <extension> element.
<extensions>/<library>/<extension> value (none) Names the extension of a media file type to synchronize. Usually, the extension is a three- or four-letter abbreviation of the format, but longer extensions are accepted. The matching ignores case, so an attribute setting of mpeg4 means playlists with the extension MPeg4 get synchronized.

For the list of supported file extensions for audio, photo, and video files, see the product release notes.

ftype (none)

Names the default media type associated with the file extension. Acceptable values are audio, video, and photo.

The ftype may change during the metadata pass of synchronization. For example, a file with an mp4 extension can be an audio or video file. The customer must specify an ftype of audio or video to be used when mm-sync parses the file's information during the files pass. However, the ftype may change during the metadata pass if the actual file type is found to be different than the specified default type.

flex_ftype off

Names the default media type associated with the file extension. Valid values are audio, video, and photo.

Suppose you want the database to hold photo metadata from compact bitmap (rasterized) file formats (and no audio or video metadata). You would then put the following in your configuration file:

<extensions>    
    <library>    
        <extension value="png" ftype="photo" />    
        <extension value="jpg" ftype="photo" />    
        <extension value="jpeg" ftype="photo" />    
        <extension value="gif" ftype="photo" />    
    </library>    
</extensions>

Only media files with one of these four listed extensions will have their metadata extracted and uploaded to the database.