shoutcast-search-0.1
shoutcast-search - search shoutcast.com radio stations
SYNOPSIS
shoutcast-search [OPTION]... [CRITERIUM]... [FILTER]... [KEYWORD]...
DESCRIPTION
shoutcast-search searches the shoutcast.com radio stations. CRITERIA
are used to search for station names, genres or currently played songs.
FILTERS can be used to limit searches, for example by number of current
listeners. Finally, KEYWORDS are used to search freely among station
names, genres and current songs. All parameters must match for stations
to be listed. When no CRITERIA or KEYWORDS are supplied, shoutcast-
search returns the current "Top 500" stations.
shoutcast-search uses an API provided by shoutcast.com that may only be
used for non-commercial purposes. See the URL in SEE ALSO for API docu‐
mentation and rules.
OPTIONS
--version
Show program's version number and exit.
-h, --help
Show program's help message and exit.
-n LIMIT, --limit=LIMIT
Set maximum number of stations to be listed.
-r, --random
Sort stations randomly instead of by number of listeners
-v, --verbose
Verbose output, useful for getting search right.
CRITERIA
Used to create detailed searches, for example to search for stations
with specific names or artists being played. You can supply multiple
CRITERIA of the same type, for example
$ shoutcast-search -g Rock -g Pop
to find stations with both "Rock" and "Pop" in the genre. This is dif‐
ferent from
$ shoutcast-search -g "Rock Pop"
where the program searches for the exact string "Rock Pop".
-g GENRE, --genre=GENRE
Search for stations with the word/phrase GENRE in their listed
genre.
in the form [=><]N where N is a positive integer. ">128" means more
than 128, "=128" means exactly 128 and "<128" means less than 128. "="
is assumed if no operator is given, i.e. "128" is identical to "=128".
Note: you probably need to enclose the expression in quotes, depending
on your shell.
-b BITRATE, --bitrate=BITRATE
Filter stations matching with the bitrate in kbps matching the
BITRATE expression (see above for format).
-l LISTENERS, --listeners=LISTENERS
Filter stations with the number of current listeners matching
the LISTENERS expression (see above for format).
-t CODEC, --type=CODEC
Filter stations based on the codec required. Available options
are "mpeg" for MP3 or "aacp" for aacPlus.
KEYWORDS
In addition to CRITERIA, you can provide KEYWORDS when you don't care
where a word or phrase appear. KEYWORDS are matched against station
names, genres and current songs. Separate KEYWORDS with spaces, enclose
multiple word KEYWORDS in quotes, for example:
$ shoutcast-search "Depeche Mode" somebody
EXAMPLES
Normal output is one URL per line pointing to a matching shoutcast
stream. This can be used to start music players with the applicable
stations or to create playlists. For example, start mplayer with the
most popular stream currently playing a Depeche Mode song:
$ shoutcast-search -n 1 -s "Depeche Mode" | xargs mplayer
shoutcast-search can also be used in --verbose mode. This is useful to
verify that you have provided the parameters correctly. Verbose mode
also prints more information for each station, needed for manual
searches. For example, searching for two random stations playing ambi‐
ent music:
$ shoutcast-search --verbose --limit=2 --random --genre=ambient
prints
Search summary
------------------------------
Keywords:
Genres: ambient
Playing:
Stations:
Bitrate:
Listeners:
2 station(s) found.
The information for each station is listed below. Copy/paste or type
the URL into your shoutcast-enabled music player to play the stream.
<station name> [<bitrate> <MIME type>]
<URL>
<genre>, <nr> listeners
Now playing: <current track>
EXIT STATUS
0 Successful
1 Network error
2 Argument error
3 Other error
AUTHOR
Written by Henrik Hallberg (halhen@k2h.se)
REPORTING BUGS
Please report bugs to halhen@k2h.se
SEE ALSO
http://forums.winamp.com/showthread.php?threadid=295638
http://www.shoutcast.com
LICENSE
Copyright (c) 2009 by Henrik Hallberg (halhen@k2h.se)
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of MER‐
CHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General
Public License for more details.
You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
shoutcast-search-0.1 SHOUTCAST-SEARCH(1)
Man(1) output converted with
man2html