/* * Copyright (C) 2005 by Enrico Chiaretti - enrico.chiaretti@gmail.comThis 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA */ *******************************************This is the README for the JVTV applicationUpdate: 2005-10-09, v0.6The primary goal of tihs project is to provide a VERY SIMPLE tv controller, allowing you to select a channel by its name.Now, it has got basic tv recorder functions.version 0.6 (beta) provides: * (optional) allows the user to enter a description for each tv station (in the channel list file). Backward compatibility is guaranteed. * recording setting dialog: you can tune the recording quality and enter a recording duration (in minutes). * the 'run mplayer' button is under testing, still. I am thinking of removing it from the user interface. The user can anyway run his favourite player by the 'watchtv.sh' script. Remember that, if you're watching tv, you're locking the video device and you won't be able to record. You can anyway perform a 'time shift' by starting recording and playing the video file while it is being saved.version 0.4 (beta) provides: * default channels, for my home TV. you can EDIT the station list any time, with a text editor * capability of switching station with one click * capability of running gmplayer (my favourite Linux Media Player) to watch TV, and capability of closing it. * capability of START RECORDING / STOP RECORDING current station: PAL format, requires MPEG2 hardware codec 	(i.e.: any Hauppauge PVR series card) requirements: * IVTV module loaded and property configured. * java 2 runtime environment properly installed (JRE 1.4.x or later is recommended) - - - - - - - - - - Installation:just docd binsu(root password)./setup.sh A script called jvtv.sh shall be created and placed into /usr/local/bin, so you can run it any time.If you're using KDE, you may even want to create a desktop and / or menu icon.You will find also a script named watchtv.sh which can be used to run mplayer. Feel free to edit it, as you may need different settings or player.I suggest you to run JVTV as normal user (not root).The first time you run it, you'll find a $HOME/.jvtv/jvtv_channels.txt file.You can edit it to watch your favourite tv stations.Here is an example:E, Rai1, 183750;36, VCR, 591250;the first is the station number. The second is a user description. The third is the station frequency.Please, remember the frequency is optional. IF you do not know it, you may just miss it. Example:E, Rai1, ;36, VCR, ;This way you won't be able to perform a fine tuning of the stations, but that could be enough for many users.- - - - - - - - - -Configuration:Java:You'll need j2SDK in order to configure both the channel list and the path-related settings (as far). Remember to place the java binary folder into your path variable. To do so, please edit your $HOME/.bash_profile or /etc/.profile. Otherwise, you can just edit the jvtv.sh script replacing	java TvControlwith	/usr/local/j2sdk-1.4_07/jre/bin/java TvControlor with any other folder where you installed java in.       IVTV:You must properly configure the IVTV module: set default format (PAL/NTSC), table (pal-italy or any other), device (ie: tuner0), width (720), height (576). To do so, you can use the ptune.pl or ptune-ui.pl script provided with IVTV.Please, refer on IVTV resources on the web (http://ivtv.sourceforge.net), as I am not related in any manner with the IVTV developers.Paths:the script "setup.sh" should set up everything, as long if you run it with root privileges. If you can not obtain the root privileges or are willing to run jvtv from a user directory, please remember to place two required script in your `path`.scripts are ptune.pl and record-v4l2.pl. You shall find them into IVTV directory. Please, add that directory to your `path` or create a link to each of them.- - - - - - - - - - - - -Advanced configuration (for developers only):Anyone who can understand a little the java language can edit and configure JVTV.One basic tune you may want to perform is to change the default player (gmplayer for me): to do so, please edit TvActions.java, search for the string "gmplayer" and change it with whatever media player you like.Then compile the sources and place back the new binaries into the ./bin directory.To do so, you'll need a j2sdk. I'm using 1.4 but I think JVTV can compile even on other releases.- - - - - - - - - - - - -SUPPORT:you can visit http://sourceforge.net/projects/jvtv and leave a message in the forum.