For the impatient:

Unpack the archive, switch to the folder ./winki-X.X.X/winki (X.X.X should be replaced
with the current version number) and issue:

- for installation (this is the preferred method)
		./install

- for uninstallation
		./uninstall

- start the program (from the GUI):
	Applications -> Multimedia -> Winki the Ripper

- start the program (command line):
	winki


WARNING: The documentation below is a bit old and may not be accurate.
	

Content:
1. Requirements
2. Upgrade from previous version
3. Installation using setup.py (you should have installed distutils)
4. Installation without using setup.py
5. Uninstallation


1. Requirements

In order to run Winki the Ripper you need to have installed:
- python interpreter (version >= 2.3) (http://www.python.org)
- python-gtk
- python-gnome
- python-gnome2-extras (systray integration)
- python-glade
- python-distutils (debian: since version 1.5.2 distutils is included in python-dev)
  You will need this package if you want to use the setup.py installation
  script.
- mencoder		(http://www.mplayerhq.hu)
- mplayer		(http://www.mplayerhq.hu)
- lsdvd			(http://sourceforge.net/projects/acidrip/)
- dvdauthor		
- paldump		
- mplex			
- lindex		
- title		
- spumux		
- spuunmux		

- lame			(http://lame.sourceforge.net/)
- oggenc		(http://directory.fsf.org/audio/ogg/OggEnc.html)
- ffmpeg		
- mp2enc		

- mkvtoolnix	(http://www.bunkus.org/videotools/mkvtoolnix/)

- vcdimager		(http://www.gnu.org/software/vcdimager/vcdimager.html)
- libdvdcss		(if you want support for encrypted DVD's)

If you find dependencies that I've missed, please report them to me:
welko at web dot de.

2. Upgrade from previous version

	Issue either:
		./install

		or

		python setup.py install --force


3. Installation using setup.py (you should have installed distutils)

	- unpack the archive
		gzip -d winki-X.X.X.tar.gz
		tar xvf winki-X.X.X.tar

		or

		tar xvzf winki-X.X.X.tar

	- change to the package folder, become root and run the installer script

		cd winki-X.X.X/winki
		su
		./install
		
		or:

		cd winki-X.X.X
		su
		./setup.py install --record installed.files

	This will copy the python modules to a sub-folder called "winki" in
	your site-packages folder. On my machine this is
	/usr/lib/python2.3/site-packages/winki. Some data files (images, glade
	UI files and documentation files) will be copied to subfolders of
	/opt/winki. Please note that the path /opt/winki is now hard coded into
	the program (druid.py, file.py, alert.py, page_rip.py and the glade
	file). If you want to change it, you have to edit these files.

	- start the program issuing as normal user:
		WinkiRip

	or create a shortcut for this command.


4. Installation without using setup.py (may be obsoleted)

	- unpack the archive
		gzip -d winki-X.X.X.tar.gz
		tar xvf winki-X.X.X.tar

		or

		tar xvzf winki-X.X.X.tar

	- change to the package folder
		cd winki-X.X.X/winki

	- become root and copy the files to their destinations
		su
		mkdir /usr/lib/python2.x/site-packages/winki
		cp *py /usr/lib/python2.x/site-packages/winki
		mkdir /opt/winki /opt/winki/doc
		cp -R glade /opt/winki
		cp -R pixmaps /opt/winki
		cp -R po /opt/winki
		cp AUTHORS INSTALL README TODO GPL /opt/winki/doc
		cp example/winkirc /etc	(note: this _is_ important!)
		cp desktop/winki.desktop /usr/share/applicaitions
		mkdir /usr/share/gnome/help/winki
		cp -R help/* /usr/share/gnome/help/winki
		mkdir /usr/share/omf/winki
		cp omf/winki-C.omf /usr/share/omf/winki
		chmod 755 WinkiRip
		cp WinkiRip /usr/bin

	After doing this, you will have (almost) the same installation as if you
	installed the package using setup.py.


5. Uninstallation

	For uninstalling Winki The Ripper switch to the unpacked tarball folder
	and issue:

	./uninstall

	as root. Note that this script uses the file "../installed.files" which is
	created on installation time if you installed Winki with the install
	script. If you haven't installed it that way - you have to remove it's
	files manually.  These include:

	/opt/winki
	/usr/lib/pythonX.X/site-packages/winki
	/usr/bin/WinkiRip
	/etc/winkirc
	/usr/share/omf/winki
	/usr/share/gnome/help/winki
	/usr/share/pixmaps/winki.png
	/usr/share/applications/winki.desktop
	~/.winkirc
