=================
httpripper Manual
=================

About
=====
HTTP Ripper is a generic ripper for the web
It is free software licensed under the terms of the GNU General Public License 3
or later.

Generic Installation
====================
To install use you need to have the following libraries installed:
* Python 2.5
* PyGTK >= 2.10
Normally these libraries are already installed on your system.

To install httpripper execute: ``python setup.py install`` as superuser (root). If you are using a gnome based system like ubuntu you can just doubleclick ``install.sh`` and select run.

Usage
=====
Start HTTPRipper. It will display the hostname/port it's running on.
Configure your browser to use it as proxy. Hit the record button ;)
For information on how to use httpripper please visit the website.

Recommendations
===============
Tired of manually switching proxies? Use use a proxyswitcher
like (http://foxyproxy.mozdev.org/). 

Hacking
=======
If you want to hack on httpripper just clone my git repository::
    http://github.com/jwagner/httpripper

And don't forget to init the submodules (needs git 1.5.3 or newer!)

$ git submodule init
$ git submodule update

If you have any questions or a patch just drop me a mail.

License
=======
Copyright (C) 2008-2010 Jonas Wagner

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.


Bugreports / Questions
======================
If you encounter any bugs in httpproxy or have suggestions or just want to
thank me - I would like to hear about it!

Contact
=======
You can reach my by e-mail: veers at gmx dot ch