1
0
mirror of https://github.com/tenox7/wrp.git synced 2025-01-09 15:31:11 +00:00

54 lines
3.2 KiB
Markdown
Raw Normal View History

# WRP - Web Rendering Proxy
2019-05-31 18:28:48 -07:00
2019-07-17 13:54:54 -07:00
A HTTP proxy server that allows to use historical and obsolete web browsers on the modern web. It works by rendering the web page in to a GIF image with ISMAP.
2019-01-07 17:04:07 -08:00
2019-06-04 02:20:43 -07:00
## Current Status
2019-05-30 02:04:25 -07:00
2019-07-17 00:49:36 -07:00
* This is a new version using GoLang/[ChromeDP](https://github.com/chromedp/chromedp). Python/Webkit being now deprecated.
2019-07-14 01:40:17 -07:00
* Beta versiom, but fully supported an maintained.
2019-07-12 14:28:26 -07:00
* Works as browser-in-browser. A real http proxy mode is being investigated. Check [issue #35](https://github.com/tenox7/wrp/issues/35) for updates.
2019-07-17 13:54:54 -07:00
* As of 4.1 supports clicking on non-link elements (eg. cookie warnings, dropdown menus, etc.) and sending keystrokes. Yes, you can login and use Gmail.
2019-05-27 16:37:19 -07:00
2019-06-05 01:42:17 -07:00
## Usage
2019-07-12 02:04:35 -07:00
1. [Download a WRP binary](https://github.com/tenox7/wrp/releases/) and run it on a machine that will become your WRP server.
2019-06-20 10:20:41 -07:00
2. Point your legacy browser to `http://address:port` of WRP server. Do not set or use it as a "Proxy Server" (yet).
2019-07-17 00:52:59 -07:00
3. Type a search string or a http/https URL and click Go.
2019-06-06 01:35:23 -07:00
4. Adjust your screen width/height/scale/#colors to fit in your old browser.
2019-07-12 02:04:35 -07:00
5. Scroll web page by clicking on the in-image scroll bar.
2019-07-17 00:49:36 -07:00
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.
2019-06-05 01:42:17 -07:00
2019-07-12 02:20:56 -07:00
![Internet Explorer 1.5 doing Gmail](wrp.png)
2019-06-04 02:20:43 -07:00
## Flags
```
-l listen address:port, default :8080
-h headed mode, display browser window
-d chromedp debug logging
```
2019-07-17 00:49:36 -07:00
## Minimal Requirements
WRP Server / Gateway should run on a modern hardware/os that supports memory hungry Chrome.
2019-07-17 01:01:18 -07:00
WRP Client / Browser needs to support forms and ISMAP. Typically Mosaic 2.0 would be minimum version for forms, although ISMAP was supported since 0.6B so you could manually enter url using `?url=...`.
2019-07-17 00:49:36 -07:00
2019-07-13 01:23:34 -07:00
## History
2019-07-13 01:25:35 -07:00
* In 2014, version 1.0 started as a cgi-bin script, adaptation of `webkit2png.py` and `pcidade.py`, [blog post](https://virtuallyfun.com/2014/03/03/surfing-modern-web-with-ancient-browsers/).
* Later in 2014, version 2.0 became a stand alone http-proxy server, also support for both Linux/MacOS, [another post](https://virtuallyfun.com/wordpress/2014/03/11/web-rendering-proxy-update//).
2019-07-13 01:23:34 -07:00
* 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.
2019-07-16 23:47:37 -07:00
* 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.
2019-06-06 16:46:40 -07:00
## Credits
2019-06-10 15:14:17 -07:00
* Uses [chromedp](https://github.com/chromedp), thanks to [mvdan](https://github.com/mvdan) for dealing with my issues
2019-06-18 14:46:19 -07:00
* Uses [go-quantize](https://github.com/ericpauley/go-quantize), thanks to [ericpauley](https://github.com/ericpauley) for developing the missing go quantizer
2019-06-10 15:14:17 -07:00
* Thanks to Jason Stevens of [Fun With Virtualization](https://virtuallyfun.com/) for graciously hosting my rumblings
2019-07-14 01:40:17 -07:00
* Thanks to [claunia](https://github.com/claunia/) for help with the Python/Webkit version in the past
2019-06-18 14:48:39 -07:00
## Legal Stuff
2019-06-18 14:49:32 -07:00
License: Apache 2.0
Copyright (c) 2013-2018 Antoni Sawicki
2019-06-18 14:48:39 -07:00
Copyright (c) 2019 Google LLC