OptionalfieldsKeys each row carries; omitted, every key of a library track row. Names are matched case-sensitively against those keys: index, handle, title, artist, artists, album, albumId, albumArtist, albumArtists, genre, date, trackNumber, discNumber, duration, path, absolutePath, fileSize, bitrate, sampleRate, channels, codec, subsong and rating. An unknown name fails with INVALID_PARAMS and is listed in details.unknownFields. The optional albumId is omitted when the track has none, even when requested.
OptionallimitMost rows to return; total still counts every match.
foobar2000 query expression.
OptionalsortTitle Formatting expression to sort the matches by before limit applies; empty keeps library order, and an expression that fails to compile is ignored.
Parameters for
library.query. Tracks matching a foobar2000 query, optionally sorted bysort, up tolimit. A query the parser rejects fails withINVALID_PARAMSanddetails.paramquery, and so does one carryingSORT BY; many malformed queries are not rejected but simply match nothing. The rows are written off the main thread. Fails withLIBRARY_DISABLEDwhen the library is disabled.