Skip to content

list_artist_tracks

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

NAME

list_artist_tracks - List Roon Library Tracks by Artist

SYNOPSIS

list_artist_tracks [ ARTIST ] [ TRACK ] [ EXARTIST ] [ EXTRACK ]

DESCRIPTION

Lists Roon Library artist's tracks matching the specified track name or substring. This command is invoked by "roon -l artracks -a artist [-T track] [-x exartist] [-X extrack]".

COMMAND LINE OPTIONS

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

TRACK : Provide a track name, in quotes if it contains spaces, or a case-sensitive substring. All Roon library track names matching the provided track name or containing the substring will be listed.

EXARTIST : Provide an artist exclusion string, in quotes if it contains spaces. No Roon library artist names including the provided artist exclusion string will be searched

EXTRACK : Provide a track exclusion string, in quotes if it contains spaces. No Roon library track names including the provided track exclusion string will be listed

EXAMPLES

list_artist_track Beatles Yesterday : Will list the tracks titles containing the string "Yesterday" by the artists whose name contains "Beatles"

list_artist_track Beatles Love foo "Love version" : Will list the tracks titles containing the string "Love" but not the string "Love version" by the artists whose name contains "Beatles" but not "foo"

AUTHORS

Written by Ronald Record github@ronrecord.com

LICENSING

LIST_ARTIST_TRACKS is distributed under an Open Source license. See the file LICENSE in the LIST_ARTIST_TRACKS source distribution for information on terms & conditions for accessing and otherwise using LIST_ARTIST_TRACKS 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_artist_albums(1), list_artists(1), list_composers(1), list_genre_albums(1), list_genre_artists(1), list_genres(1), list_playlists(1), list_radio(1), list_tags(1), list_zones(1), play_album(1), play_artist(1), play_artist_album(1), play_artist_track(1), play_composer(1), play_genre(1), play_genre_album(1), play_genre_artist(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_artist_tracks.py, can be invoked directly as:

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

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

usage: list_artist_tracks.py [-h] [-t TRACK] [-a ARTIST] [-X EXTRACK]
                             [-x EXARTIST] [-z ZONE]

optional arguments:
  -h, --help            show this help message and exit
  -t TRACK, --track TRACK
                        track search term
  -a ARTIST, --artist ARTIST
                        artist search term
  -X EXTRACK, --extrack EXTRACK
                        track exclude search term
  -x EXARTIST, --exartist EXARTIST
                        artist exclude search term
  -z ZONE, --zone ZONE  zone selection