MIM v1.0 (MIM Isn't mtv)

University of Oregon
Hoang Tran
htran@darkwing.uoregon.edu

Description: 
	
	View mpeg-1 audio and video multicast rtp streams.
		
	Writing an mpeg video/audio decoder library is beyond the scope of this
	project. Given more time and more programmers, it certainly is a 
	possibility. This is just a hack for unix systems to be able to recieve
	content that is pumped out by Cisco's IPTV Server.

Requirements:

	mtvp 
		this is a very good and fast command line mpeg player. 
		The mtvp binary is freely available for private noncommercial 
		use from :
		http://www.mpegtv.com/

	mpg123
		this is a free mpeg layer 1,2,3 audio player for unix os's.
		check it out at: http://www.mpg123.de/

	mtvp and mpg123 need to be in your PATH or else in the same directory 
	as this mim binary.
		
Installation:
	
	Untar the package. Precompiled binaries for solaris and linux are 
	available in the binary directory. To compile, copy the 
	Makefile.platform for your specific platform to Makefile.
	
	Check the Makefile for sanity in the context of your environment.	

	Type "make mim" to compile the command line program.
	Type "make xmim" to compile the gtk-interfaced program. 
	
Running:
	
	MIM
	
	Currently this is a command line program.
	
	mim [-v video_address video_port] [-a audio_address audio_port] 	
	
	mim -v 239.192.0.2 49534 -a 239.192.0.2 2348	-z
	
	XMIM 
	
	Requires the gtk/glib libraries installed. This comes with a simple GUI
	which integrates an sap listener. Point and click.
		

Notes ::
	
	The current version uses timestamp info on the two streams to attempt to 
	synchronize audio and video. As you an imagine this is not entirely 
	accurate, but it's good enough so far.
	
	SHOULD compile on solaris and linux
	digital unix is being worked on.	

TODO ::
	
	Better synchronization of audio/video
	
	Integrate into SDP listener so that we don't need all the command line 
	options.
		
	
	
	











