From a6df4cbec48f04b5655585ae99d503ca1e87e5ea Mon Sep 17 00:00:00 2001 From: Antoni Sawicki Date: Sat, 1 Jun 2019 01:26:18 -0700 Subject: [PATCH] readme update --- README.md | 5 ++--- pywebkit/README.md | 29 +++++++++++++++++++++++++++++ 2 files changed, 31 insertions(+), 3 deletions(-) create mode 100644 pywebkit/README.md diff --git a/README.md b/README.md index 9393f82..1156540 100644 --- a/README.md +++ b/README.md @@ -19,7 +19,6 @@ A HTTP proxy server that allows to use historical and obsolete web browsers on t ## Todo * ISMAP - underway -* net/url: invalid control character in URL on Windows * configurable color palete and quantization * real http proxy support * option to encode as png/jpeg @@ -27,6 +26,6 @@ A HTTP proxy server that allows to use historical and obsolete web browsers on t * better http server shutdown * chromedp logging, timeout, non-headless flags -## Python version +## Old Python version -Check [master branch](https://github.com/tenox7/wrp/tree/master) for "stable" Python-Webkit version. \ No newline at end of file +Check [pywebkit/](/pywebkit) folder for the old Python-Webkit version. \ No newline at end of file diff --git a/pywebkit/README.md b/pywebkit/README.md new file mode 100644 index 0000000..0384ad4 --- /dev/null +++ b/pywebkit/README.md @@ -0,0 +1,29 @@ +# 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/PNG/JPEG image associated with clickable imagemap of original web links. + + +# Current Status +* This is a WebKit / Python version of WRP. +* No longer maintained / supported. +* You should be using GoLang/CDP version instead. +* It mostly works for casual browsing but it's not very stable. +* Secure aka https/SSL/TLS websites might work with use of [sslstrip](https://moxie.org/software/sslstrip/) cheat (enabled by default). + + +## OS Support +WRP works on macOS (Mac OS X), Linux and FreeBSD. On macOS it uses Cocoa Webkit, on Linux/FreeBSD QT Webkit, for which needs PyQT4 or PyQT5. It does not work on Windows. Use Go/CDP version for that. + +## Installation +* macOS - should just work +* Linux/FreeBSD install `python-pyqt5.qtwebkit` and `sslstrip` +* For PythonMagick (Imagemagick library) install `python-pythonmagick` + +## Configuration +Edit wrp.py, scroll past Copyright section to find config parameters + +## Usage +Configure your web browser to use HTTP proxy at IP address and port where WRP is running. If using browsers prior to HTML 3.2, ISMAP option may need to be enabled. Check configuration. + +## 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/