Skip to content


Subversion checkout URL

You can clone with
Download ZIP
C Python
Branch: master

Merge pull request #9 from ashkulz/master

add notes about installation on Windows
latest commit ad3a1d26aa
@mreiferson authored

Python bindings for the fabulous libwkhtmltox using Cython

Special thanks to antialize for creating wkhtmltopdf

For parameters and settings (for users familiar with the command line utility) see:


$ python install

Tested on:

  • Mac OSX 10.6.4 Snow Leopard, Python 2.6.1 (32-bit and 64-bit)
  • CentOS 5.5, Python 2.6.4 (32-bit)
  • Windows 7, Python 2.7.6 (32-bit)

Pre-requisites on all platforms:

  • you need libwkhtmltox.* somewhere in your LD path (/usr/local/lib)
  • you need the directory include/wkhtmltox from wkhtmltopdf somewhere on your include path (/usr/local/include)

OSX Notes

If compiling for OSX (64-bit Python/libwkhtmltox only), until this bug is fixed you need the qt_menu.nib directory from the QT source tree in the same directory as your libwkhtmltox.* library files.

Windows Notes

You will need Visual Studio 2008 (VS2008 Express with SP1 and latest updates from Microsoft Update should work as well). Start a "Visual Studio 2008 Command Prompt" and run the following (assuming that wkhmltopdf is installed in C:\Program Files\wkhtmltopdf:

set INCLUDE=%INCLUDE%C:\Program Files\wkhtmltopdf\include;
set LIB=%LIB%C:\Program Files\wkhtmltopdf\lib;
python bdist_wininst

This would produce an installer in the dist/ folder which you can install. You will need to have C:\Program Files\wkhtmltopdf\bin in the path or copy wkhtmltox.dll along with the extension.


If you want to re-generate C source (or have made changes to the Cython template file, .pyx) you need Cython (tested with 0.13):

$ easy_install cython
Something went wrong with that request. Please try again.