Media Library

Essentials

Songbird keeps track of all media as media items. A media item associates metadata with a GUID, such as user-relevant properties like "Artist Name" and "Track Name", internally relevant metadata such as "isList" or "hidden" and potentially custom metadata like "color". This information is tracked by properties.

Media lists are themselves extensions of media items, and are stored in a library. A media list is, in essence, a list of pointers to media items and cannot store any information about those items other than a sequencing.

Media lists are displayed on media pages. 

Media Items

Interface: [sbIMediaItem]

Media items are uniquely identified by GUID, though the same underlying media resource may have different GUIDs if it originates from different libraries, servers, songbirds or file formats.

Properties

Interface: [sbIProperties] Useful Code: sbProperties.jsm

Properties are the collection of metadata on a mediaitem. Using sbProperties.jsm you can get this information like this:

var artist  = myMediaItem.getProperty(SBProperties.artistName);
artist = "Van Halen";
myMediaItem.setProperty(SBProperties.artistName, artist);

Media Lists

Interface: [sbIMediaList]

Media lists are ordered lists of media items, and the same item may appear more than once in the list.

'Note': All created media lists are added permanently to a library and appear in the Service Pane's list of playlists unless you explicitly set them to hidden and/or remove them when you are finished with them.

Library

Interface: [sbILibrary]

A library is an unordered list of media items in which each media item may only appear once.