wrp/README.md

# WRP - Web Rendering Proxy
A HTTP proxy server that renders the web page in to a GIF/PNG/JPEG image associated with clickable imagemap of the original web links. It allows to use historical and obsolete web browsers on the modern web. It's still a work in progress but it's quite stable and usable for casual web browsing.

Version 2.0 brings support for PythonMagick (ImageMagick Library) that allows to optimize and reduce image size or covert to greyscale or bitmap for these cool computers without color displays.

# Current Status
* SSL/TLS stripping is delegated to `sslstrip`[1], which you need to install into your PATH first
* I'm also looking for moving away from WebKit, QT and Python
* Stay tuned

## 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.

## Installation
* macOS - should just work
* Linux/FreeBSD install `python-pyqt5.qtwebkit`

## Configuration
Edit wrp.py, scroll past Copyright nonsense 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/

[1]: https://moxie.org/software/sslstrip/
small copyright update and formatting fixes 2018-06-23 07:17:39 +00:00			`# WRP - Web Rendering Proxy`
allow to run on freebsd 2018-06-23 07:40:27 +00:00			`A HTTP proxy server that renders the web page in to a GIF/PNG/JPEG image associated with clickable imagemap of the original web links. It allows to use historical and obsolete web browsers on the modern web. It's still a work in progress but it's quite stable and usable for casual web browsing.`

			`Version 2.0 brings support for PythonMagick (ImageMagick Library) that allows to optimize and reduce image size or covert to greyscale or bitmap for these cool computers without color displays.`
small copyright update and formatting fixes 2018-06-23 07:17:39 +00:00
Status update in readme 2018-12-12 01:19:05 +00:00			`# Current Status`
support https:// sites by stripping with sslstrip if this project wasn't perverse enough, the web-rendering-proxy now requires another proxy as its dependency. 2018-12-28 13:16:01 +00:00			* SSL/TLS stripping is delegated to `sslstrip`[1], which you need to install into your PATH first
Status update in readme 2018-12-12 01:19:05 +00:00			`* I'm also looking for moving away from WebKit, QT and Python`
			`* Stay tuned`

small copyright update and formatting fixes 2018-06-23 07:17:39 +00:00			`## OS Support`
allow to run on freebsd 2018-06-23 07:40:27 +00:00			`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.`
small copyright update and formatting fixes 2018-06-23 07:17:39 +00:00
readme update 2018-06-23 07:44:42 +00:00			`## Installation`
allow to run on freebsd 2018-06-23 07:40:27 +00:00			`* macOS - should just work`
			* Linux/FreeBSD install `python-pyqt5.qtwebkit`
small copyright update and formatting fixes 2018-06-23 07:17:39 +00:00
readme update 2018-06-23 07:21:52 +00:00			`## Configuration`
			`Edit wrp.py, scroll past Copyright nonsense to find config parameters`

readme update 2018-06-23 07:44:42 +00:00			`## 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.`

small copyright update and formatting fixes 2018-06-23 07:17:39 +00:00			`## 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/`
support https:// sites by stripping with sslstrip if this project wasn't perverse enough, the web-rendering-proxy now requires another proxy as its dependency. 2018-12-28 13:16:01 +00:00
			`[1]: https://moxie.org/software/sslstrip/`