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.