A minimal WebKit based browser
Switch branches/tags
Nothing to show
Clone or download
Pull request Compare This branch is 5 commits ahead, 5 commits behind pschultz:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


This is a minimal WebKit based browser in fullscreen. It's intended use is to display a single web resource non-interactively, while being highly portable, especially to the arm11 architecture (used for the Raspberry Pi), and supporting Javascript and HTML5 Websockets for dynamic content updates. Peter Schultz wrote the original version. See the changes under changelog.


apt-get install libwebkit-dev
# OR: yum install webkitgtk-devel

gcc -o browser browser.c $(pkg-config --libs --cflags gtk+-2.0 webkit-1.0)


No special steps are required for installation. Just execute browser. This program was designed to be started via inittab on boot like this:

1:2345:respawn:/usr/bin/startx -e /usr/bin/browser tty1 </dev/tty1 >/dev/tty1 2>&1



This will launch the browser in fullscreen mode and load the resource fromDEFAULT_URL hardwired in the source. DEFAULT_URL can be anything that WebKit supports, including file://-URLs for local webpages and documents.

The following keybinding exists:

  • F5 for reloading the current page It's also implemented as a signal handler:
  • HUP for reload


  • hardwired size(int HEIGHT and int WIDTH)
  • hardwired URL (gchar* DEFAULT_URL), no commandline argument
  • hardwired position (GTK_WIN_POS_CENTER_ALWAYS)
  • no toggle fullscreen with F11, thus removed unmaximize() and USR1
  • deleted Makefile, only one command(see above)


Flattr this git repo