JIVO INSTALL NOTES - very beta
Andrew Taylor <andy@benow.ca>

Jivo is a java based tv listings management and recording application.  It does a good job
of sifting through hundreds of channels to best get at the good programming.  Among its features
are:
- web presentation for local or remote recording scheduling, people, programmes
  and channel browsing, in-page streaming of recorded video
- sql tv listings management for highly linked and navigable information
- flexible recording backend, including
  - commercial trimming (via comskip.exe)
  - re-encoding to mp4 for space saving
  - re-encoding to flv for web based streaming

REQUIREMENTS
- recent linux (ubuntu, suse, debian, gentoo, etc)k
- a v4l capture card (designed with a Hauppauge PVR 250)
- sun jdk v6+
- apache ant
- firebird sql server v2+, installed and running
- mencoder for commercial trimming and mp4 re-encoding
- wine (for comskip.exe commercial trimming)
- ir transmitter (ie http://iguanaworks.net) and configured lirc for channel changing on external box (optional)
- xmltv, configured with tv_grab_* --configure
 
INSTALLATION
To configure do:
  $ ant setup
  
Do initial run:
  $ bin/web -k

It will prompt you for a sudo password for creating the database, it will only do this once.
Once started you should be able to connect to 
  http://localhost:1413/

On startup it tries to grab a weeks worth of listings if there are no future listings
which it knows of.  It will also automatically schedule (via cron) late-night retrieval
of listings, if not already scheduled.  To tune the scheduled listings grabbing, if required, do
  $ crontab -e

Once it has be validated once it can be auto started via:

Gentoo:
	# cp etc/init.d/jivo.gentoo /etc/init.d/jivo
	# rc-update add jivo default

Ubuntu/Debian:
	$ sudo cp etc/init.d/jivo.debian /etc/init.d/jivo
	$ sudo update-rc.d jivo defaults


Setup crontab (optional).   
	$ sudo crontab -e

  # trim old capture files once a day
  0 4 * * * cd /opt/workspace/tv/; bin/prune_cap

	# reboot at 5am if not recording (optional)
	0 5 * * * cd /opt/workspace/tv/; bin/reboot_if_idle

Test recording
To test recording, you can do a 
  $ bin/rec [CHANNEL] test 1
ie
  $ bin/rec 505 test 1 
  
Which will record a minute from the given channel.  The bin/rec record script is used
for all recording, so modify to suit your setup accordingly.  By default it changes the 
channel using lirc records from svhs input on /dev/video0 to /archive/incoming/cap.   
If you have installed wine, the included comskip.exe program will be used after recording
to detect commercials and mencoder will trim them without loss of fidelity.  (If wine
is not installed, the commercials will not be trimmed) After trimming, the recorded
video will be re-encoded to mp4 and land in the output directory.  


SUPPORT
- drop by benow chat
  - hit 'chat' from http://benow.ca
  - connect with irc client to: irc.benow.ca/6667 #benow
- email me: andy@benow.ca