Skip to content

play_artist_track

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

NAME

play_artist_track - Play Roon Library Track by Artist

SYNOPSIS

play_artist_track [ ARTIST ] [ TRACK ] [ EXARTIST ] [ EXTRACK ]

DESCRIPTION

Plays Roon Library artist's track matching the specified track name or substring. This command is invoked by "roon -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 returned and the first one returned will be played.

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 played

EXAMPLES

play_artist_track Beatles Yesterday : Will play the first track returned in a list of all Roon library track names with titles containing the string "Yesterday" by the artists whose name contains "Beatles"

play_artist_track Beatles Love foo "Love version" : Will play the first track returned in a list of all Roon library track names with titles containing the string "Love" but not "Love version" by the artists whose name contains "Beatles" but not "foo"

AUTHORS

Written by Ronald Record [email protected]

LICENSING

PLAY_ARTIST_TRACK is distributed under an Open Source license. See the file LICENSE in the PLAY_ARTIST_TRACK source distribution for information on terms & conditions for accessing and otherwise using PLAY_ARTIST_TRACK 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/play_artist_track.py, can be invoked directly as:

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

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

usage: play_artist_track.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
Clone this wiki locally