Win32 Installation

Home  : Home >

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.

The 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 Configuration options#Specifying_media_repositoriesset 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:

A path of /my/path translates to c:\cygwin\my\path (assuming that Cygwin was installed to C:\Cygwin)

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

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

Note 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"