Search shoutcast.com radio stations
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
shoutcast_search
.gitignore
AUTHORS
LICENSE
Makefile
README
config.mk
documentation.md
setup.py
shoutcast-search
shoutcast-search.1

README

shoutcast-search 0.4.1
========================
shoutcast-search searches shoutcast.com for radio stations based on
criteria given on the command line. The application can for example
be used to automatically start a random radio station at startup or
as an improved and handy search tool for radio stations.

See documentation.md for a complete description.

Example
-------
The following starts my day: launch vlc with a random station playing
Chill with reasonable technical (128+ kbps) and musical (some
listeners) quality.

    $ shoutcast-search -n 1 -g chill -l ">50" -b ">127" -r | xargs vlc 

    
Requirements
------------
* python 3


Installation
------------
python 3 or higher is required to run the application. You can simply
copy the program to any directory and invoke it by

    $ python shoutcast-search

On *nix, you can install it using make. Edit config.mk to configure make.
Next, as root:

    # make install

    
Running shoutcast-search
------------------------
Using the python interpreter manually:

    $ python shoutcast-search

or after installation on *nix:

    $ shoutcast-search

For more information on usage see the man page shoutcast-search(1) or:

    $ [python ] shoutcast-search --help

    
Changes
-------
0.4.1 (2010-11-04):
    migration from python2 to python 3

0.3.1 (2009-04-15):
    minor adjustmets in setup.py to make PyPI accept package

0.3 (2009-04-15):
    --list-genres option
    -f FORMAT, --format=FORMAT option
    created shoutcast_search.py module
    
0.2 (2009-04-12):
     --sorted option
     exit code 4 when no stations found
     documentation.md (in markdown format)
     minor corrections in e.g. man page 

0.1 (2009-04-08):
     First release. Packaged as application, even though the source code
     is fairly prepared to be used as a python module.

     
License
-------
    Copyright (c) 2009-2010 by the Authors.

    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
    MERCHANTABILITY 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.