====== khtmld(aemon) ======
===== Announcments =====
  * **Feb. 18, 2009** \\ I have merged the dev branch to master on my git repository. There is a change in the config parser, which allows you to use a special configuration option to indicate wich options should be passed to the KHTML engine. \\ The current release with the tag v0.3.8 can be found by having a look at [[code:gitweb|Gitweb]], a .tar.gz listed under downloads or from the [[http://www.sourceforge.net/projects/khtmld|SourceForge]] project page. I have also updated the configuration example on this page.
  * **Jul. 04, 2008** \\ Added downloads of the experimental branch sock_dev, with the latest version of the source. 
  * **Apr. 11, 2008** \\ I currently have pushed a development version of khtmld into my Git repository, the latest branch is [[http://git.goatpr0n.de/cgi-bin/gitweb.cgi?p=khtmld.git;a=shortlog;h=refs/heads/sock_dev|sock_dev]], but it has not been tested, and may contain syntax problems. If you are brave or impatient you can get this branch und run a test.
  * **Apr. 10, 2008** \\ Here you can inform yourself about the current [[https://wiki.goatpr0n.de/blog/2008/04/09.process.on.khtmld|process on khtmld]].
  * **Oct. 09, 2007** \\ Released version 0.3.5 >> [[https://sourceforge.net/project/showfiles.php?group_id=147327|Download]] \\ After long time I finally managed to eliminate the latest problems of khtmld.


===== What is khtmld =====
khtmld provides an interface to control [[http://khtml2png.sourceforge.net/|khtml2png]], which creates screenshots of websites and runs on headless-server systems with a virtual X server, or a VNC server. The only requirement are some KDE libraries, providing the khtml class. With khtmld you are able to activate khtml2png through php-scripts (e.g. Generating previews of your links).


==== Credits ====
  * Florent Bruneau:
    * setuid feature: http://fruneau.rznc.net (french)

If __you__ have also something to contribute to khtmld(aemon), please do not hesitate to inform me. Simply write an email or submit your patch/source via sourceforge.net tracker.


===== How it works =====
khtmld passes commands to [[http://khtml2png.sourceforge.net/|khtml2png]], to generate your screenshot. The daemon listens on a named pipe (FIFO) to read the information for the next job. There is a simple syntax rule for adding jobs. At first you define the target url and than the target image file on your system, seperated by a //BLANK// (SPACE). You can add multiple jobs at once. Just add them line by line. \\
**Notice:** May be you need to append a '\n' (NEWLINE) to each job. Depending on your scripting/programming language and functions you use.)


==== Examples 1.1 ====
<code>
Command spool syntax:

  [TARGET_URL] [DESTINATION_IMAGE]


Example:

  BASH:

    $ echo "http://www.example.com /tmp/example.png" >/tmp/khtmldspool


  PHP:

    <?php
    $data = "http://www.example.com /tmp/example.png\n";
    $fp = fopen("/tmp/khtmldspool", "w");
    if ($fp) {
      fwrite($fp, $data, strlen($data));
      fclose($fp);
    }
    ?>
</code>


===== .khtmldrc for use with khtml2png 1.x.x =====
<code>
width=1280
height=1024
scaled-width=800
scaled-height=600
flash-delay=5
time=30
display=:0.0

KHTML=disable-js
KHTML=disable-java
</code>
//**Note:** display needs to be set, check your X server config.\\
:0.0 should be your first screen,\\
:1.0 could be a second X server.//


===== .khtmldrc for use with khtml2png 2.5.x or later =====
<code>
width=800
height=600
time=30
display=:0.0

KHTML=disable-js
KHTML=disable-java
</code>
//**Note:** display needs to be set, check your X server config.\\
:0.0 should be your first screen,\\
:1.0 could be a second X\\
\\
khtml2png2 doesn't have parameters like scaled-with do not put them into your .khtmldrc.//


===== Compatibility =====
kthmld has been tested with following [[http://khtml2png.sourceforge.net/|khtml2png]] versions
^ 1.0.3        | **successful** |
^ 2.5.0        | **successful** |
^ 2.6.0        | **successful** |
^ Static_2.5.0 |     not testet |


===== Project Information =====
Latest Version: **0.3.8**\\
Project hosted at Sourceforge.net: **[[http://www.sourceforge.net/projects/khtmld]]**


==== Downloads via SourceForge ====
  * [[http://downloads.sourceforge.net/khtmld/khtmld-0.3.8.tar.gz?use_mirror=|khtmld-0.3.8.tar.gz]]

==== Local Downloads ====
  * {{:projects:khtmld:khtmld-0.3.8.tar.gz|}}

{{tag>linux projects khtmld}}

~~DISCUSSION~~