
           AV viewer
	   
	   (C) Vladimir Dergachev 2001-2004
	   
	  
   A viewer for TV capable cards.
   
          * Xv support
	  
   Requirements: TV input capable card with Xv support
		 Tcl/Tk 8.4.x or later
		 libzvbi from http://zapping.sf.net/
		 ffmpeg-0.4.6 from http://ffmpeg.sf.net/
		 LIRC (optional) from http://www.lirc.org/
		  
	
*** NOTES ***

       * right-clicking in the video window will bring up a menu
       
       * People with newer cards with SPDIF - if your sound is distorted
         try muting/unmuting various channels (like CD).
	 LET ME KNOW (volodya@mindspring.com) if this helps.       

       * If you are working off ffmpeg CVS it is a good idea to run
         
	 make clean; cvs update -d; make 

	 in ffmpeg directory before installing newer version of avview. 
	 Since CVS might turn out to be screwed up I recommend making a 
	 tarball of ffmpeg tree right after make clean - it is not that 
	 big and you would be able to untar it and continue as before if 
	 anything breaks.
	 
       * Do you want to use AVview remote bindings before AVview is launched ?
         put the following line in your .xinitrc or .xsession file:

	 xmodmap /usr/local/share/AVview/avview.modmap

         You might need to replace /usr/local/ with whatever location 
	 you installed AVview in.       	 


       * at the moment closed captioning will only work with km from CVS
         and only with Radeon cards.

*** KEYBOARD BINDINGS ***

	*** Pressed anywhere in AVview ***
	
	Control-F                toggle fullscreen
	Keypad + or -            switch favorite channels
	Control-Keypad + or -    increas/decreases channel number
	Control-i                switch between tuner/composite/svideo
	Keypad *                 toggle mute
	Arrow Up/Down            switch on-screen controls
	Arrow Left/Right         adjust on-screen control
	Control-q or Escape      exit AVview

	*** Pressed in main window (with TV display) ***
	
	1-9,0			 input channel number
	1-9,0, single letters	 input channel name
	' (apostrophe)		 begin entering channel name (required
				 for all-digit channel names)
	Enter, Return		 switch to keyed in channel
	Delete			 erase keyed in channel name and show 
				 current channel
	BackSpace		 erase last entered letter
	
	Left-click		 rotate among on-screen controls
	Right-click		 bring up popup menu
	MouseWheel		 adjust on-screen control
	
*** LIRC CONFIGURATION ***

       * LIRC (Linux Infrared Remote Control) commands are defined in
	 file ~/.lircrc. Each entry in the file consist of at least
	 button, prog and config fields. Button names can be found
	 from /etc/lircd/lircd.conf or from graphical utility like KDE
	 LIRC server. prog field has to be set to 'avview' (without
	 the apostrophes). The following commands are valid config
	 field values:

	 fullscreen		 toggle fullscreen mode
	 next_channel val     	 switch between favourite channels.
				 val is the number of channels to 
				 skip, can be negative
	 mute			 toggle mute
	 exit			 exit AVview
	 volume val		 change volume by amount val
	 next_control val	 switch on-screen control. val is the
				 number of controls to skip, can be
				 negative
	 change_control val	 change the value of on-screen control
				 by amount val
	 next_encoding		 change xv port encoding (PAL, NTSC, ...)
	 remote_power_off	 exit or toggle screensaver
	 channel val		 select channel val. val is channel
				 name (e.g. E5)
	 channel_number val	 select channel number val

	 See <http://www.lirc.org/html/configure.html> for further
	 description of the file format and instructions on setting up
	 LIRC. File lircrc.example contains a config file template
	 that you can edit and append to ~/.lircrc (you may need to
	 change the button names).
