readme update

This commit is contained in:
Antoni Sawicki 2019-06-04 02:20:43 -07:00
parent fb4848d235
commit 6e75da10f3
1 changed files with 26 additions and 21 deletions

View File

@ -2,30 +2,35 @@
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 associated with clickable imagemap of original web links.
**You are looking at a GoLang / CDP branch of WRP.**
## Current Status
**This code is under active development and not fully usable yet.**
## Done so far
* basic browser-in-browser mode
* screenshot and serve image+map via CDP
* gif with FloydSteinberg dithering
* multiple concurent client support
* resolve relative links
* paginated scrolling
* google search on input not starting with ^http
* ISMAP, although for a redirect to work `-i` flag must be specified
otherwise http-equiv refresh will be used and/or link provided
* headed mode and chromedp debug output
* This is a new GoLang/ChdomeDP version.
* It's still lacking some features of the older [pywebkit/](/pywebkit) version (eg real http proxy mode and image manipulation) but it surpases it in terms of stability and usability.
* It's beta quality but I can fix/maintain the code unlike the older version.
## Todo
* configurable color palete and quantization
* real http proxy support
* padded box model coordinates
* better http server shutdown
* Configurable color palete and quantization.
* Real http proxy support via [goproxy](https://github.com/elazarl/goproxy) - if you really need a real proxy for now try [pywebkit/](/pywebkit) version.
* Padded box model coordinates.
* Input boxes support. However today you can cheat by using headed mode and input your data on the WRP server.
## Old Python version
## Usage
Check [pywebkit/](/pywebkit) folder for the old Python-Webkit version.
1. [Download a WRP binary](https://github.com/tenox7/wrp/releases) and run on a server/gateway.
2. Point your legacy browser to the IP address:port of WRP server.
3. Type a search string or a http/https URL and click Go.
4. Adjust your screen width/heigh/scale to fit in your old browser.
5. For very very very old browsers such as Mosaic 2.x and IBM WebExplorer 1.x check the I checkbox to enable ISMAP mode. However this normally should not be needed.
6. Scroll web page by clicking Up/Down. To go to top enter 0 and click Go.
## 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/