Web Rendering Proxy: Use vintage, historical, legacy browsers on modern web
Go to file
Antoni Sawicki e2223af833 makefile update 2019-08-04 09:01:55 -07: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 Create LICENSE 2019-03-27 13:29:02 -07:00
Makefile makefile update 2019-08-04 09:01:55 -07:00
README.md Update README.md 2019-08-04 01:16:07 -07:00
make.ps1 better ps make script 2019-07-29 23:59:32 -07:00
wrp.go fix content type for shutdown 2019-08-04 00:39:21 -07:00
wrp.png img update 2019-07-14 22:51:57 -07:00

README.md

WRP - Web Rendering Proxy

A HTTP proxy server that allows to use historical / vintage web browsers on the modern web. It works by rendering a web page in to GIF image with ISMAP.

Internet Explorer 1.5 doing Gmail

Current Status

  • This is a new version using GoLang/ChromeDP (Python/Webkit is now deprecated).
  • Fully supported an maintained.
  • Works as browser-in-browser. A real http proxy mode is being investigated. Check issue #35 for updates.
  • Supports clicking on non-link elements (eg. cookie warnings, dropdown menus, etc.) and sending keystrokes. Yes, you can login to 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 "Proxy Server" (yet).
  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 WRP button.
  7. To send keystrokes fill K input box and press Go. There also are buttons for backspace, enter and arrow keys.

Docker

docker run -d -p 8080:8080 --name wrp --restart unless-stopped tenox7/wrp

Flags

-l  listen address:port, default :8080
-h  headed mode, display browser window
-d  chromedp debug logging

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 ealier 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.

Credits

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