The music database

count {TAG} {NEEDLE}

Counts the number of songs and their total playtime in the db matching TAG exactly.

find {TYPE} {WHAT}

Finds songs in the db that are exactly WHAT. TYPE should be album, artist, or title. WHAT is what to find.

list {TYPE} [ARTIST]

Lists all tags of the specified type. TYPE should be album or artist.

ARTIST is an optional parameter when type is album, this specifies to list albums by an artist.

listall [URI]

Lists all songs and directories in URI.

listallinfo [URI]

Same as listall, except it also returns metadata info in the same format as lsinfo.

lsinfo [URI]

Lists the contents of the directory URI.

When listing the root directory, this currently returns the list of stored playlists. This behavior is deprecated; use "listplaylists" instead.

search {TYPE} {WHAT}

Searches for any song that contains WHAT. TYPE can be title, artist, album or filename. Search is not case sensitive.

update [URI]

Updates the music database.

URI is a particular directory or song/file to update.

Prints "updating_db: JOBID" where JOBID is the job id requested for your update, and is displayed in status, while the requested update is happening.

To update a number of paths/songs at once, use command_list, it will be much more faster/efficient. Also, if you use a command_list for updating, only one update job id will be returned per sequence of updates.