VintageRadio Files

This is the README file for VintageRadio 1.0, Copyright (c) 2021 by Rupert
Pupkin.

WHAT IS VINTAGERADIO?
VintageRadio is a graphical player for FM radio devices supported by Video4Linux
(v4l2). It is actually just a GUI front-end for the fm command-line application,
included with fmtools <http://benpfaff.org/fmtools>. VintageRadio is not part of
fmtools, however.

WHAT COOL FEATURES DOES VINTAGERADIO HAVE?
* A vintage 70s-era look, inspired by a number of stereo tuners and receivers
  with the classic silver face. In particular, the Realistic TM-1000 AM/FM
  stereo tuner from Radio Shack was a big influence.
* A rotary tuning dial that actually works.
* Ability to store up to 6 stations as presets.
* Keyboard shortcuts for all application functionality.
* A user configuration file (~/.vintageradiorc) that lets you customize which
  radio device/tuner to use, as well as most of the colors (in case you don't
  like the defaults).

WHAT ARE THE REQUIREMENTS FOR VINTAGERADIO?
* fmtools (tested with 2.0.7)
* Tcl/Tk 8.6 or higher (8.5 or lower will *not* work)
* [incr Tcl/Tk] (tested with 4.1.1)
* Iwidgets (tested with 4.1.1)
* Bwidget (tested with 1.9.7)

HOW DO I INSTALL VINTAGERADIO?
To install VintageRadio the easy way, just run the install.sh script either as
root or by using sudo.

VintageRadio assumes that your Tcl interpreter is /usr/bin/tclsh. You might have
to modify the first line of the vintageradio file to reflect the correct
location (e.g. #!/usr/local/bin/tclsh).

On systems running Fedora 33 or higher, there is an RPM file for VintageRadio.

After installation, just run the command vintageradio.

HOW DO I USE VINTAGERADIO?
The man page (man vintageradio) has all the details, but VintageRadio operates
like you think it would---the button labels and dial are self-explanatory.

IS VINTAGERADIO "FREE" SOFTWARE?
Yes. VintageRadio 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 3 of the License, or
(at your option) any later version.

VintageRadio 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., 675 Mass Ave, Cambridge, MA 02139, USA.

WHERE CAN I GET VINTAGERADIO?
You can get the latest version of VintageRadio at
https://sourceforge.net/projects/vintageradio

WHO WROTE VINTAGERADIO?
VintageRadio's author is Rupert Pupkin, who can be reached via e-mail at
sato_ichi@yahoo.com

HISTORY OF VINTAGERADIO
February 21 2021 - VintageRadio 1.0 released