Web Rendering Proxy: Use vintage, historical, legacy browsers on modern web
Go to file
2019-12-25 03:35:48 -08:00
old added readme to ld 2019-07-16 23:44:27 -07:00
.gitignore added gitignore 2019-07-16 23:31:54 -07:00
Dockerfile makefile update 2019-08-04 09:01:55 -07:00
LICENSE
Makefile add arm64 linux target 2019-11-14 00:52:25 -08:00
README.md readme updates 2019-12-25 03:35:48 -08:00
wrp.go change int64 to float64 for chromedp.MouseClickXY 2019-12-25 03:04:46 -08:00
wrp.png

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.
  2. Point your legacy browser to http://address:port of WRP server. Do not set or use it as a "http 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. Experimentally you can set height H to 0 to render pages in to one tall image without the vertical scrollbar. Note it will be large, slow to process, download and display on client browser.
  9. Generally if the client browser supports PNG you should use it instead of GIF. PNG is much faster, GIF Requires a lot of processing time on both server/client for encoding/decoding, compress/decompress, color palette optimizations and so on.

Docker

docker hub:

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

gcr.io:

docker run -d -p 8080:8080 gcr.io/tenox7/wrp:latest

Flags

-l  listen address:port, default :8080
-t  image type gif (default) or png, when using PNG number of colors is ignored
-g  image geometry, WxHXC, height can be 0 for unlimited, default 1152x600x256
-h  headed mode, display browser window on the server
-d  chromedp debug logging
-n  do not free maps and gif images after use

Minimal Requirements

  • Server Gateway should run on a modern hardware/os that supports memory hungry Chrome.
  • 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.

History

  • In 2014, version 1.0 started as a cgi-bin script, adaptation of webkit2png.py and pcidade.py, blog post.
  • Later in 2014, version 2.0 became a stand alone http-proxy server, also support for both Linux/MacOS, another post.
  • In 2016 the whole internet migrated to HTTPS/SSL/TLS and WRP largely stopped working. Python code became unmaintainable and mostly unportable (especially to Windows, even WSL).
  • In 2019 WRP 3.0 has been rewritten in Golang/Chromedp as browser-in-browser instead of http proxy.
  • Later in 2019, WRP 4.0 has been completely refactored to use mouse clicks instead using a href nodes. Also in 4.1 added sending keystrokes in to input boxes. You can now login to Gmail. Also now runs as a Docker container. Version 4.5 introduces rendering whole pages in to one tall image image.

Credits

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