SetBrowseFilterArtist
Syntax:
SetBrowseFilterArtist filter-string
Classification:
Synchronous
Result Type:
No results
Responses:
ParameterError – no filter string given
OK – indicates success
Example:
SetBrowseFilterArtist Led Zeppelin
SetBrowseFilterArtist: OK
SetBrowseFilterArtist sets the RCP session's current artist browse filter to the
filter-string given as a parameter. Browse filters may be used to limit the results
of the browse listing commands. The artist filter will affect the results returned by
ListSongs, ListAlbums, and on some servers, ListComposers and ListGenres.
Browse filters are case-sensitive and do not perform partial-matches. The filter
term given for SetBrowseFilterArtist should be a result string from the ListArtists
or SearchArtists commands.
ISSUE: After setting browse filter, there is no way to clear it until calling one of
the browse listing commands (like ListSongs, ListArtists, etc.).
HISTORICAL NOTE: Until software version 2.5.155, the browse filters were
global across all RCP sessions.
Copyright© 2006 Roku, LLC
Page 56
www.rokulabs.com