From 6e75da10f3ef1e22abbb5f5609180d0da8b0d0f0 Mon Sep 17 00:00:00 2001 From: Antoni Sawicki Date: Tue, 4 Jun 2019 02:20:43 -0700 Subject: [PATCH] readme update --- README.md | 47 ++++++++++++++++++++++++++--------------------- 1 file changed, 26 insertions(+), 21 deletions(-) diff --git a/README.md b/README.md index 8a6a41b..0ed4675 100644 --- a/README.md +++ b/README.md @@ -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 Floyd–Steinberg 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. \ No newline at end of file +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/