# OCC - Simple Web Browsing with TLS

My goal was to have a smallnet web browser that could handle
graphics and not choke on TLS like the ancient Iceweasel that ships
with Debian Lenny. I originally tried to compile a more recent
version of Dillo, but ran into errors and gave up. Then I remembered
that the links browser supported graphics, and ended up being able
to compile and link the latest version with libressl and the older
image libraries present on Debian Lenny - I was even able to add
webp support. Here is how I did it.

First, install the tools and development libraries you'll need,
using the following /etc/apt/sources.list:

    deb http://archive.debian.org/debian/ lenny main contrib
    deb http://archive.debian.org/debian-backports lenny-backports main
    deb http://archive.debian.org/debian-backports lenny-backports-sloppy main

And use the following package install commands (note you'll need to
accept the lack of a current archive signing key):

    apt-get install gcc make autoconf automake libtool
    apt-get install libjpeg62-dev libpng12-dev libsvga1-dev libtiff4-dev zlib1g-dev libbz2-dev

You'll have a chicken-and-egg problem with the source versions of
libwebp and libressl, you'll need to download the source tarballs on
a newer box and transfer them over somehow. What I did was to setup
an NFS server on my "modern" workstation so I could easily mount it
from the OCC box and copy files over.

So to continue, download libwebp v1.5.0 from
https://chromium.googlesource.com/webm/libwebp, and install it with
the usual 'configure; make; make install'.

Next, download the following versions of libressl and links:

libressl v2.1.0 (from https://ftp.openbsd.org/pub/OpenBSD/LibreSSL/)
links v2.30 (from http://links.twibright.com/download.php)

Uncompress and install libressl with the usual 'configure; make;
make install', then run 'ldconfig' as root.

For links, remember to add the --enable-graphics flag to the
configure command:

    configure --enable-graphics; make; make install

Links is nice and simple, and this did not take too long at all on
my 2009 HP with its Intel Core 2 Duo. Once done, you can run 'links
-g' and have a smallnet browser [0] that can load sites with
reasonably modern TLS support (on some sites you'll need to accept
and click through the 'invalid cert' warning that links gives you,
but this is a minor irritation). This setup is not perfect, as it
has no javascript support, but I see that as a benefit - I don't
want to browse the user-hostile sites that require javascript to
function anyway.

[0]: gopher://sdf.org/I/users/thinknix/images/occ-links.png