Web Rendering Proxy: Use vintage, historical, legacy browsers on modern web
Go to file
2020-10-26 02:15:29 -07:00
.gitignore gitignore update 2020-04-23 03:26:56 -07:00
Dockerfile makefile update 2019-08-04 09:01:55 -07:00
go.mod add halfgone to go modules 2020-09-29 11:39:42 -07:00
go.sum add halfgone to go modules 2020-09-29 11:39:42 -07:00
LICENSE Create LICENSE 2019-03-27 13:29:02 -07:00
Makefile add arm64 linux target 2019-11-14 00:52:25 -08:00
README.md readme update 2020-10-26 02:15:29 -07:00
wrp.go remove else to improve readability 2020-10-26 01:49:03 -07:00
wrp.png img update 2019-07-14 22:51:57 -07:00

WRP - Web Rendering Proxy

A browser-in-browser "proxy" server that allows to use historical / vintage web browsers on the modern web. It works by rendering a web page in to a GIF or PNG image with clickable imagemap.

Internet Explorer 1.5 doing Gmail

Usage

  1. Download a WRP binary and run it on a machine that will become your WRP gateway/server. This machine should be pretty modern, high spec and Google Chrome / Chromium Browser is required to be preinstalled.
  2. Point your legacy browser to http://address:port of WRP server. Do not set or use it as a "proxy server".
  3. Type a search string or a http/https URL and click Go.
  4. Adjust your screen width/height/scale/#colors to fit in your old browser.
  5. Scroll web page by clicking on the in-image scroll bar.
  6. Do not use client browser history-back, instead use Bk button in the app.
  7. To send keystrokes, fill K input box and press Go. There also are buttons for backspace, enter and arrow keys.
  8. You can set height H to 0 to render pages in to a single tall image without the vertical scrollbar and use client scrolling. However this should not be used with old and low spec clients. Such tall images will be very large and take long time to process, especially for GIFs.
  9. Prefer PNG over GIF if your browser supports it. PNG is much faster, whereas GIF requires a lot of additional processing on both client and server.

Docker

$ docker run -d -p 80:8080 tenox7/wrp

Google Cloud Run

$ gcloud run deploy --platform managed --image=gcr.io/tenox7/wrp:latest --memory=2Gi --args='-t=png','-g=1280x0x256'

Or from Gcloud Console. Use gcr.io/tenox7/wrp:latest as container image URL.

Note that unfortunately GCR forces https. Your browser support of encryption protocols and certification authorities will vary.

Azure Container Instances

$ az container create --resource-group wrp --name wrp --image gcr.io/tenox7/wrp:latest --cpu 1 --memory 2 --ports 80 --protocol tcp --os-type Linux --ip-address Public --command-line '/wrp -l :80 -t png -g 1280x0x256'

Or from the Azure Console. Use gcr.io/tenox7/wrp:latest or tenox7/wrp:latest for image name.

Fortunately ACI allows port 80 without encryption.

Flags

-l  listen address:port (default :8080)
-t  image type gif or png (default git) 
-g  image geometry, WxHxC, height can be 0 for unlimited (default 1152x600x256)
-h  headless mode, hide browser window on the server (default true)
-d  chromedp debug logging (default false)
-n  do not free maps and gif images after use (default false)

Minimal Requirements

  • Server/Gateway requires modern hardware and operating system that is supported by Go language and Chrome/Chromium Browser, which must be installed.
  • Client Browser needs to support HTML FORMs and ISMAP. Typically Mosaic 2.0 would be minimum version for forms. However ISMAP was supported since 0.6B, so if you manually enter url using ?url=..., you can use the earlier version.

Troubleshooting

I can't get it to run

This program does not have a GUI and is run from the command line. You may need to enable executable bit on Unix systems, for example:

$ cd ~/Downloads
$ chmod +x wrp-amd64-macos
$ ./wrp-amd64-macos -t png

History

  • Version 1.0 (2014) started as a cgi-bin script, adaptation of webkit2png.py and pcidade.py, blog post.
  • Version 2.0 became a stand alone http-proxy server, supporting both Linux and MacOS, another post.
  • In 2016 thanks to EFF/Certbot the whole internet migrated to HTTPS/SSL/TLS and WRP largely stopped working. Python code became unmaintainable and there was no easy way to make it work on Windows, even under WSL.
  • Version 3.0 (2019) has been rewritten in Go using Chromedp as browser-in-browser instead of http-proxy. The initial version was less than 100 lines of code.
  • Version 4.0 has been completely refactored to use mouse clicks via imagemap instead parsing a href nodes.
  • Version 4.1 added sending keystrokes in to input boxes. You can now login to Gmail. Also now runs as a Docker container and on Cloud Run/Azure Containers.
  • Version 4.5 introduces rendering whole pages in to a single tall image with client scrolling.

Credits

  • Uses chromedp, thanks to mvdan for dealing with my issues
  • Uses go-quantize, thanks to ericpauley for developing the missing go quantizer
  • Thanks to Jason Stevens of Fun With Virtualization for graciously hosting my rumblings
  • Thanks to claunia for help with the Python/Webkit version in the past
  • Historical Python/Webkit versions and prior art can be seen in wrp-old repo

License: Apache 2.0
Copyright (c) 2013-2018 Antoni Sawicki
Copyright (c) 2019-2020 Google LLC