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