clone your own copy | download snapshot



This browser is meant to be used with the project html2print available here: http://osp.kitchen/tools/html2print/. The aim is to lay out printed documents within a web browser. We built our own webkit browser in order to have a faster browser and good typography (weirdly, the bearings and kernings can be weird in certain webkit browsers).

For Ubuntu user, before compilation

sudo apt install qt5-default libqt5webkit5-dev ruby-dev qtpositioning5-dev
sudo apt install libqt5sensors5-dev libxcomposite-dev libglib2.0-dev libxrender-dev


Download the zip file and decompress it (or git clone it), then go into the directory

cd tools.ospkit


cd src

Launch the app

From the WebkitApp directory:


Available shortcuts

  • Ctrl + P: Print to file
  • Ctrl + Shift + P: Print dialog (allows output page resizing)
  • Ctrl + R: Reload

Using our patched version of QTWebkit

See https://github.com/annulen/webkit/wiki

sudo apt-get install build-essential perl python ruby flex gperf bison qtbase5-private-dev

cmake ninja-build libfontconfig1-dev libicu-dev libsqlite3-dev

cmake zlib1g-dev libpng12-dev libjpeg-dev libxslt1-dev libxml2-dev libhyphen-dev

cd ../..

Git clone our version of webkit with specifying only the last version with '--depth 1' (if not, it's heavy, around 6,3GB as it is 3 millions of files!)

git clone -b ospkit --depth 1 --single-branch https://github.com/aleray/webkit.git

Compile. It is a heavy operation, fans will work on you computer...

cd webkit


Tools/Scripts/build-webkit --qt --release --no-web-audio --no-video

cd WebKitBuild/qt/Release

sudo ninja install

Run OSPKit with this newly-built code

 cd ..


Is it working? If not, send us feedback on miam@osp.kitchen (we will try to help if possible). If yes, a blank window is still not really exciting :) but we are preparing a boilerplate to start really to use it!

Snapshots | iceberg

Inside this repository



Alex Leraydiscovered

— Basic QTBrowser prototype we made with François.

It seems to work like a charm except for printing: the scale of the
document isn't right; too small.

Sunday, 17th April 2016 - 11:56


Stéphanie Vilayphioublabbed out

— - Added comments to François and Alex's code.
- Removed zoom + and zoom - as it makes visual errors when using the
browser zoom.
- Added Ctrl+R for Reload.
- Added Ctrl + O for Print dialog (to be changed).

Thursday, 28th April 2016 - 23:39


Stéphanie Vilayphiouclaimed

— Added a Makefile and a README for others to test out.

Sunday, 1st May 2016 - 21:52


Stéphanie Vilayphiouclaimed

— Changed shortcut for Print Dialog, it is now set on Ctrl + Shift + P.

Thursday, 5th May 2016 - 16:21


Stéphanie Vilayphioutattled

— some iceberg pictures to prove that this is working!

Thursday, 5th May 2016 - 16:26



— installation for ubuntu users

Friday, 6th May 2016 - 17:44


Alex Leraylet loose

— Welcome to OSPKit!

Monday, 27th June 2016 - 14:04


Alex Lerayexposed

— Instruction to use the latest version of webkit with OSPKit

Wednesday, 20th July 2016 - 16:17


Alex Lerayconfessed

— Extra info for QTWebkit installation

Tuesday, 9th August 2016 - 22:56


Alex Leraysaid

— An first move toward headless ospkit

Tuesday, 10th January 2017 - 17:21


Alex Lerayargued

— Update README to test the gitlab webhook

Tuesday, 10th January 2017 - 17:30


Alex Leraytalked

— Licence AGPL

Monday, 23rd January 2017 - 22:08



— in QTWebkit installation don't forget to install cmake

Wednesday, 11th January 2017 - 12:28



— Update README.md

Wednesday, 11th January 2017 - 15:22



— change link to webkit repo to clone

Saturday, 14th January 2017 - 20:30


Alex Leraysaid

— Merge branch 'master' of gitlab.constantvzw.org:osp/tools.ospkit

Monday, 23rd January 2017 - 22:09



— Update README.md

Monday, 13th February 2017 - 13:17



— Update README.md

Monday, 13th February 2017 - 13:29



— Update README.md

Friday, 24th March 2017 - 11:44



— updated README

Tuesday, 23rd May 2017 - 13:48



— Update README.md during a session to test it with new users

Thursday, 6th July 2017 - 10:29



— Update README.md

Thursday, 6th July 2017 - 10:34



— Update README.md

Thursday, 6th July 2017 - 10:35



— Update README.md

Thursday, 6th July 2017 - 10:36



— Update README.md

Thursday, 6th July 2017 - 10:44


pierrehlet the cat out of the bag

— Update README.md

Thursday, 6th July 2017 - 10:46


pierrehspilled the beans

— Update README.md

Thursday, 6th July 2017 - 13:15



— Update README.md

Thursday, 6th July 2017 - 15:28



— Update README.md

Thursday, 6th July 2017 - 16:48



— Update README.md

Thursday, 6th July 2017 - 17:17


pierrehblabbed out

— Update README.md

Thursday, 6th July 2017 - 17:18



— Update README.md

Friday, 7th July 2017 - 09:27