Win32 Installation

Installing kissdx on Windows

To get kissdx running on Windows, you must first install Cygwin, to provide a Linux-like environment for kissdx to run in. You must also install the packages that kissdx depends on: libdvdread, libjpeg and libiconv.

Install Cygwin

Go to http://www.cygwin.com/ and install Cygwin from there. The Cygwin environment and the minimal base packages from the Cygwin distribution will be installed.

Configure Cygwin

A development environment must be set up in Cygwin in order to get libdvdread installed. Go to http://www.cygwin.com/ and download and run the setup.exe program from there. Go through the setup wizard until you get to the Select packages screen.

Open the Devel category in the list. Select to install the following packages by clicking in the New column.

NOTE: If the New column says Keep, the package is already installed and you do not have to install it again.

   autoconf
   autoconf2.5
   automake
   automake1.10
   gcc
   gcc-core
   libtoo0l1.5
   make 

Click Next and follow the setup wizard to the end.

Install libdvdread

Go to http://www.dtek.chalmers.se/groups/dvd/downloads.shtml and download libdvdread-0.9.7.tar.gz (or newer).

Save it to your Cygwin home directory, e.g. C:\cygwin\home\your-user-name

• Start a Cygwin shell window

• Type these commands in sequence:

  tar xfz libdvdread-0.9.7.tar.gz 
  cd libdvdread-0.9.7 
  ./configure 
  make 
  make install 

Watch out for errors at the end of each step.

The ./configure step will take a long time.

Install libiconv and libjpeg

Pre-built libraries of libiconv and libjpeg are available with Cygwin, so the installing these is simpler than for libdvdread. The procedure is the same as for configuring Cygwin (above):

Go to http://www.cygwin.com/ and download and run the setup.exe program from there. Go through the setup wizard until you get to the Select packages screen.

Open the Libs category in the list. Find the libiconv package and select the latest version for installation by clicking in the New column. Do the same for the libjpeg package.

NOTE: If the New column says Keep, the library is already installed and you do not have to install it again.

Click Next and follow the setup wizard to the end.

Install kissdx

The kissdx distribution includes a pre-built kissdx.exe binary for Cygwin. This file and a configuration file is what you need to copy onto your computer to have kissdx installed.

• Go to http://kissdx.vidartysse.net/#Download and download the zip archive.

• Unpack the downloaded archive into a temporary location.

• Copy kissdx\bin-Windows-Cygwin\kissdx.exe from the unpacked archive into a permanent location, typically to C:\cygwin\bin\kissdx.exe.

• Copy kissdx\kissdx.conf from the unpacked archive into a permanent location, typically to C:\cygwin\etc\kissdx.conf.

• Create a batch file called kissdx.cmd on your desktop for starting kissdx directly and have it run invisibly in the background. Double-clicking the batch file icon on your desktop will start kissdx.

   @echo off
   C:
   chdir C:\cygwin\bin
   bash --login -i -c "/bin/kissdx.exe -d"

• Optional: Add a shortcut to this batch file in the Startup folder under All Programs in your Start menu if you want kissdx to start automatically every time you log in to Windows.

• TIP: If you are starting kissdx with the -d option like above, and it doesn't start running, then check in Windows' Event Viewer (Application section) for messages from Cygwin or kissdx.

You have now installed kissdx with a default configuration.

Special advice for pre-V0.14 usersThe only way to stop an invisible pre-0.14 kissdx is to kill the kissdx process in Task Manager (right-click the kissdx process and select "End Process"). As of 0.14, kissdx can be stopped with a management command.

Configure kissdx

One last step remains: Configure your kissdx installation by editing the C:\cygwin\etc\kissdx.conf file.

   At the very least, you must set audiopath, videopath and picturepath to point at your media files.
   You should also tell kissdx where to save its persistent data. 

See the configuration manual for all the possibilities.

Please note these important features of Cygwin when specifying paths:

Special advice for Cygwin usersA path of /my/path translates to c:\cygwin\my\path (assuming that Cygwin was installed to C:\Cygwin)

Special advice for Cygwin usersA path of /cygdrive/c/path translates to c:\path – allowing access to any directory on the C: drive. Same for other drives.

New in v0.14Version 0.14 and later supports Windows filename syntax, e.g. you can specify c:\path in the configuration file.

Special advice for pre-V0.14 usersNote that versions of kissdx prior to 0.14 can not properly use a kissdx.conf that has DOS/Windows-style line termination, so Notepad is probably a bad idea. Use e.g. nano in a Cygwin prompt, or use a Windows editor that supports Unix line termination. NEW: Even better, use the new kissdx configurator by Jan Vaessen. Retrieved from "http://www.famille-kahn.com/kissdxmanual/Kissdx_user_manual:Win32_Installation"