wrp/README.md

# WRP - Web Rendering Proxy

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. It sends mouse clicks via ISMAP and keystrokes from a text box form input.

## Current Status

* This is a new reimplementation in GoLang/[ChromeDP](https://github.com/chromedp/chromedp). Python/Webkit being now deprecated.
* Beta but fully supported an maintained.
* 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.
* 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 or play web based games from any old browser.

## Usage	

1. [Download a WRP binary](https://github.com/tenox7/wrp/releases/) and run it on a machine that will become your WRP 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. Send keystrokes by filling in K input box and pressing Go. You also have buttons for backspace, enter and arrow keys.

![Internet Explorer 1.5 doing Gmail](wrp.png)

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

## More info and screenshots
* http://virtuallyfun.superglobalmegacorp.com/2014/03/11/web-rendering-proxy-update/
* http://virtuallyfun.superglobalmegacorp.com/2014/03/03/surfing-modern-web-with-ancient-browsers/

## Credits 
* Uses [chromedp](https://github.com/chromedp), thanks to [mvdan](https://github.com/mvdan) for dealing with my issues
* Uses [go-quantize](https://github.com/ericpauley/go-quantize), thanks to [ericpauley](https://github.com/ericpauley) for developing the missing go quantizer
* Thanks to Jason Stevens of [Fun With Virtualization](https://virtuallyfun.com/) for graciously hosting my rumblings

## Legal Stuff
License: Apache 2.0  
Copyright (c) 2013-2018 Antoni Sawicki  
Copyright (c) 2019 Google LLC
small copyright update and formatting fixes 2018-06-23 07:17:39 +00:00			`# WRP - Web Rendering Proxy`
readme fix 2019-06-01 01:28:48 +00:00
readme update 2019-07-12 09:04:35 +00: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. It sends mouse clicks via ISMAP and keystrokes from a text box form input.`
readme update 2019-01-08 01:04:07 +00:00
readme update 2019-06-04 09:20:43 +00:00			`## Current Status`
readme fix 2019-05-30 09:04:25 +00:00
Update README.md 2019-07-12 21:28:26 +00:00			`* This is a new reimplementation in GoLang/[ChromeDP](https://github.com/chromedp/chromedp). Python/Webkit being now deprecated.`
readme update 2019-07-12 09:20:56 +00:00			`* Beta but fully supported an maintained.`
Update README.md 2019-07-12 21:28:26 +00: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.`
readme update 2019-07-13 07:45:01 +00: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 or play web based games from any old browser.`
Update README.md 2019-05-27 23:37:19 +00:00
Update README.md 2019-06-05 08:42:17 +00:00			`## Usage`

readme update 2019-07-12 09:04:35 +00:00			`1. [Download a WRP binary](https://github.com/tenox7/wrp/releases/) and run it on a machine that will become your WRP server.`
Update README.md 2019-06-20 17:20:41 +00:00			2. Point your legacy browser to `http://address:port` of WRP server. Do not set or use it as a "Proxy Server" (yet).
Update README.md 2019-07-12 21:28:26 +00:00			`3. Type a search string or a http/https URL and click GO.`
Update README.md 2019-06-06 08:35:23 +00:00			`4. Adjust your screen width/height/scale/#colors to fit in your old browser.`
readme update 2019-07-12 09:04:35 +00:00			`5. Scroll web page by clicking on the in-image scroll bar.`
readme update 2019-07-13 07:45:01 +00:00			`6. Send keystrokes by filling in K input box and pressing Go. You also have buttons for backspace, enter and arrow keys.`
Update README.md 2019-06-05 08:42:17 +00:00
readme update 2019-07-12 09:20:56 +00:00			`![Internet Explorer 1.5 doing Gmail](wrp.png)`
readme update 2019-06-04 09:20:43 +00:00
			`## Flags`
			```
			`-l listen address:port, default :8080`
			`-h headed mode, display browser window`
			`-d chromedp debug logging`
			```

			`## More info and screenshots`
			`* http://virtuallyfun.superglobalmegacorp.com/2014/03/11/web-rendering-proxy-update/`
			`* http://virtuallyfun.superglobalmegacorp.com/2014/03/03/surfing-modern-web-with-ancient-browsers/`
Update README.md 2019-06-06 23:46:40 +00:00
			`## Credits`
Update README.md 2019-06-10 22:14:17 +00:00			`* Uses [chromedp](https://github.com/chromedp), thanks to [mvdan](https://github.com/mvdan) for dealing with my issues`
Update README.md 2019-06-18 21:46:19 +00:00			`* Uses [go-quantize](https://github.com/ericpauley/go-quantize), thanks to [ericpauley](https://github.com/ericpauley) for developing the missing go quantizer`
Update README.md 2019-06-10 22:14:17 +00:00			`* Thanks to Jason Stevens of [Fun With Virtualization](https://virtuallyfun.com/) for graciously hosting my rumblings`
Update README.md 2019-06-18 21:48:39 +00:00
			`## Legal Stuff`
Update README.md 2019-06-18 21:49:32 +00:00			`License: Apache 2.0`
			`Copyright (c) 2013-2018 Antoni Sawicki`
Update README.md 2019-06-18 21:48:39 +00:00			`Copyright (c) 2019 Google LLC`