Skip to content

list_composer_albums

Ronald Record edited this page Aug 4, 2023 · 1 revision

NAME

list_composer_albums - List Roon Library Composer's Albums

SYNOPSIS

list_composer_albums [ COMPOSER ] [ ALBUM ] [ EXCOMPOSER ] [ EXALBUM ]

DESCRIPTION

Lists Roon Library composer's albums matching the specified album name or substring. The special string "all" can be used to retrieve all albums by the specified composer. This command is invoked by "roon -l comalbums -C composer [-A album] [-x excomposer] [-X exalbum]".

COMMAND LINE OPTIONS

COMPOSER : Provide an composer name, in quotes if it contains spaces, or a case-sensitive substring. All Roon library composer names matching the provided composer name or containing the substring will be searched for albums

ALBUM : Provide an album name, in quotes if it contains spaces, or a case-sensitive substring. All Roon library album names matching the provided album name or containing the substring will be returned

EXCOMPOSER : Provide a composer exclusion string, in quotes if it contains spaces. No Roon library composer names including the provided composer exclusion string will be searched

EXALBUM : Provide an album exclusion string, in quotes if it contains spaces. No Roon library album names including the provided album exclusion string will be listed

EXAMPLES

list_composer_albums Mozart all : Will return a list of all Roon library album names by the composers whose name contains "Mozart"

list_composer_albums Bach Brandenburg : Will return a list of Roon library album names by composers whose name contains "Bach", one per line, displaying only those albums that contain the string "Brandenburg"

list_composer_albums Bach Little Sebastian Book : Will return a list of Roon library album names by composers whose name contains "Bach" but not "Sebastian", one per line, displaying only those albums that contain the string "Little" but not "Book". This will ignore all albums by Johann Sebastian Bach, return albums by Burt Bacharach, ignore those with "Book" in their name, and list those with "Little" in their name. This would be invoked with the command:

roon -l comalbums -C Bach -A Little -x Sebastian -X Book

AUTHORS

Written by Ronald Record [email protected]

LICENSING

LIST_COMPOSER_ALBUMS is distributed under an Open Source license. See the file LICENSE in the LIST_COMPOSER_ALBUMS source distribution for information on terms & conditions for accessing and otherwise using LIST_COMPOSER_ALBUMS and for a DISCLAIMER OF ALL WARRANTIES.

BUGS

Submit bug reports online at: https://github.com/doctorfree/RoonCommandLine/issues

SEE ALSO

clone_pyroon(1), get_core_ip(1), get_zone_info(1), get_zones(1), list_albums(1), list_composer_albums(1), list_composers(1), list_composers(1), list_genre_albums(1), list_genre_composers(1), list_genres(1), list_playlists(1), list_radio(1), list_tags(1), list_zones(1), play_album(1), play_composer(1), play_composer_album(1), play_composer_track(1), play_composer(1), play_genre(1), play_genre_album(1), play_genre_composer(1), play_playlist(1), play_radio(1), play_tag(1), roon(1), set_zone(1), set_zone_group(1), zone_command(1)

Full documentation and sources at: https://github.com/doctorfree/RoonCommandLine

The corresponding Python script, /usr/local/Roon/api/list_composer_albums.py, can be invoked directly as:

python3 /usr/local/Roon/api/list_composer_albums.py [ options]

Where [ options ] are described in the following usage message:

usage: list_composer_albums.py [-h] [-a ALBUM] [-c COMPOSER] [-X EXALBUM]
                               [-x EXCOMPOSER] [-z ZONE]

optional arguments:
  -h, --help            show this help message and exit
  -a ALBUM, --album ALBUM
                        album search term
  -c COMPOSER, --composer COMPOSER
                        composer search term
  -X EXALBUM, --exalbum EXALBUM
                        album exclude search term
  -x EXCOMPOSER, --excomposer EXCOMPOSER
                        composer exclude search term
  -z ZONE, --zone ZONE  zone selection
Clone this wiki locally