Install on Linux

From KiSS DP 558 STAGE2 WiKi
Jump to: navigation, search

Installation from packaged distribution of kissdx

IPKG package for Optware and ARM platforms

  • On Optware platforms

Install kissdx from the Optware package feeds by issuing these commands:

 ipkg update
 ipkg install kissdx

  • On other big-endian linux ARM platforms

Install kissdx directly from this site if you have the ipkg tool:

 ipkg install
  • Configure kissdx

Optware.png Edit kissdx.conf in /opt/etc/

Installation from source distribution of kissdx

For kissdx to be fully functional the GNU Linux sort program must be in the PATH at runtime, and the following libraries must be installed:

  libdvdread  for playing DVD ISOs and VOBs
  libjpeg     for rescaling jpeg images
  libiconv    for character set translation between player and server

To compile kissdx, you will need the development packages for these libraries.

Generic : make, make install

See the latest readme for changes that you may need to do to the Makefile to get it to compile on your system.

  • Download the kissdx archive and unpack the downloaded archive.
  • Check 'Makefile' to be compliant with your platform settings
  • With root access : Compile and install kissdx on your target system :
 make && make install
  • With standard user access : Installation needs to invoke sudo
 sudo make 
 sudo make install
  • Configure properly kissdx

Edit kissdx.conf by default in /etc/

Debian : Installation from source

On linux debian (I tried with stable distribution - but I assume it's the same with testing/unstable/experimental).

Get the prerequisite library according the readme of your kissdx release. Make sure that apt (/etc/apt/sources.list) is shaped correctly and do:

 apt-get install libdvdread-dev libjpeg62-dev

Get kissdx latest source


Customise the Makefile to be compliant to linux debian distribution including liconv. Identify the line and remove "-liconv"

$(CC) -o $@ $(OBJS) -ldvdread -liconv -ljpeg -lm

Launch a standard compilation

make && make install

If the compilation process is successfull you have the kissdx executable in /usr/sbin/kissdx and the corresponding config file to /etc/kissdx.conf

Configure properly kissdx Edit kissdx.conf by default in /etc/

We recommend you, the first time, to launch manually kissdx to ensure that no log warning remains To start manually the console & verbose mode of kissdx :

 /usr/sbin/kissdx -v 
  • To start manually daemon mode of kissdx :
  /usr/sbin/kissdx -d
  • To start automatically kissdx daemon at startup:

Use your favourite editor and create the startup init shell:

  /usr/sbin/kissdx -d -c /etc/kissdx.conf

Save this file to /etc/init.d/kissdx and run :

  chmod 755 /etc/init.d/kissdx && cd /etc/rc2.d/ && ln -s /etc/init.d/kissdx S40kissdx

Finally launch kissdx daemon:

  sh /etc/init.d/kissdx

Check if kissdx is running properly

  ps x|grep kissdx

You should see something like:

  4193 ? S 0:00 /usr/sbin/kissdx -d -c /etc/kissdx.conf

Synology DS-211+ installation

Please look at the following page for further information about Wizd Media Server KissDX Media Server Website

  1. KissDX Media Server will automatically install needeed dependences - if they are not already installed you’ll have to install them.
  2. This will install KissDX v0.13.10a (stable)
ipkg install kissdx

But if you want to install a newest (BETA!!!) version, you can do this with: * Note, can not make this work at this time.

wget ipkg install
ipkg install


First need to change configuration (i must change path on my system to start working- on DS108j) : /opt/etc/kissdx.conf

vi /opt/etc/kissdx.conf

Change path - set your correct path, where you store media files:

# paths for the media files (ending / not needed)
audiopath       =       /volume1/music
videopath       =       /volume1/video
picturepath     =       /volume1/photo

More that 1 mediapath with v0.13

On the Synology use a symlink:

ln -s /volume1/video2/ /volume2/video2

Character sets (Danish character)

ipkg install gconv-modules
# Character sets for conversion between server filenames, this configuration file (content),
# all playlist files (content) and client filenames.
# If a character set is not specified, no conversion will take place involving that entity.
# NOTE:  To get additional character sets on an NSLU2:  ipkg install gconv-modules
server_character_set	= UTF-8
client_character_set	= ISO-8859-1

Picture scaling

# Picture scaling options (Screen width / height in pixels and optional zoom percentage)
# Specify both picturetargetwidth and picturetargetheight to enable picture scaling.
picturetargetwidth		= 720
picturetargetheight		= 576
picturemaxzoompercent	= 30

Check configuration

We can check does it work - to determine if correct path is set (Ctrl+C break)

Reading configuration file '/opt/etc/kissdx.conf'
Starting kissdx...

Manual start (as daemon)

Manual start as daemon (will work until NAS will be restarted)


Auto-start when NAS is power-on

If you want to start this automatically after reboot, need copy one file and restart you NAS

cp /opt/etc/init.d/S83kissdx /usr/syno/etc/rc.d/

Mariusz Litwinczuk - 2008.10.05

Initial version of this step by step settings was posted by Pol Hallen

Synology DS-107+ installation

Marvell 88F5281 (CPU, 500 MHz, ARM9E processor family, ARMv5TEJ architecture)

Following paackge are cross compiled with crosstool :

Installing kissdx on a DS-107+ and cs-407

1. make a directory opt at volume1.

  cd /volume1
  mkdir opt
  chmod 777 opt

2. make a symbolic link /opt to /volume1/opt.

  ln -s /volume1/opt /opt

3. copy kissdx.tar libdvdread.tar libiconv.tar and libjpeg.tar to /opt Kissdx.tar or Kissdx-0.14b1a.tar libcharset.tar Libdvdread.tar Libiconv.tar Libjpeg.tar

4. unpack the tar-files

  tar -xvf kissdx.tar
  tar -xvf libdvdread.tar
  tar -xvf libiconv.tar
  tar -xvf libjpeg.tar
  check if there are files in lib etc and bin.

5. move to /usr/syno/etc.defaults/rc.d/

  mv /opt/ /usr/syno/etc.defaults/rc.d/  

6. add /opt/bin in /etc.defaults/profile to the PATH variable.

  cd /etc.defaults
  vi profile	

7. edit the /opt/etc/kissdx.conf to your settings and try to run kissdx.

  /opt/bin/kissdx -d -c /opt/etc/kissdx.conf

if the command kissdx is in the ps-list then it's running. Try now by rebooting your DS-107+ and see if it will run with the script.

Initial version of this step by step settings was posted by Sivard

QNAP TS201 : Installation from source

Hardware specification SoC 266MHz Ram 128Mb Linux telneted TS201 wiki page on Optware/NLSU2

  processor       : 0
  cpu             : 82xx
  revision        : 1.4 (pvr 8081 1014)
  bogomips        : 175.10
  vendor          : Motorola SPS
  machine         : Sandpoint
  .... Host bridge: Motorola MPC8245 [Unity] (rev 20)....

Technical Datasheet of MPC8245


Configure kissdx

One last step remains: Configure your kissdx installation by editing /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 by setting persistentstoragepath.

See the configuration manual for all the possibilities. Retrieved from ""