This is the readme file for fmcontrol.py The script fmcontrol is something which I put together one evening to save me from having to remember frequencies and volumes when using the fm program from fmtools by Ben Pfaff. It also meant that I didn't have to change settings in my infra-red handset control script if I wanted to make alterations. The script does not support any of fm's command line options with the exception of volume because I do not use them but feel free to modify it. All that it does is to tune in to a station specified by name at the frequency and volume specified in $HOME/.fmrc and $HOME/.radiostations or the volume given on the command line. LICENSE AND DISCLAIMER ********************** I have now put this under the GPL, having made a decision that I would GPL everything I write to cover my back. You should find a copy of the GPL in the file license.txt included in the fmcontrol package. INSTALLATION ************ Simply put the file fmcontrol wherever you want it, and check that its ownership and file permissions suit you. Then put the dot.radiostations file in your home directory and change its name to .radiostations (that can be changed if you wish). Then check and alter if necessary the three variables at the top of fmcontrol. They should be self explanatory. Then enter the radio stations to which you wish to tune in $HOME/.radiostations as described in the top of that file and shown by example in dot.radiostations.sample which is a copy of the file on my system. The volume adjustment field sets the change in volume from the default (either from .fmrc or the top of fmcontrol if there is no .fmrc), it must be an integer between 0 and 100. This feature is an attempt to get round the problem of different stations transmitting at different volumes and so causing pain when the station is changed. The first letter on each config line must be the start of the station name. USAGE ***** fmcontrol may be used by typing: fmcontrol OR fmcontrol <station name> OR fmcontrol <station name> <volume> Try it and see what it does.