Privoxy Files

# File        :  README
#
# Purpose     :  Overall instructions and credits for this module.
#
# Copyright   :  Written by and Copyright (C) 2001-2012 the
#                Privoxy team. http://www.privoxy.org/
#
#                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 2 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.
#
#                The GNU General Public License should be included with
#                this file.  If not, you can view it at
#                http://www.gnu.org/copyleft/gpl.html
#                or write to the Free Software Foundation, Inc.,
#                51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
#                USA
#
# Modification : If you modify this file please consider whether your 
#                changes ought to be passed back to the iOSPackgeBuilder
#                module.
#


INTRODUCTION

The aim of this module is to provide a framework for generating a zip file installation package for Privoxy that supports iOS, for provision to a Cydia repository such that it can be deployed to iOS devices.


Please refer to "iOS Package Builder HOWTO.txt" for full instructions.


SUPPORTED PLATFORMS

Theoretically this framework can create a zip file supporting any iOS version. Packages have so far been created with support for a minimum version of iOS 4.3 and tested on the following platforms:

- iPhone 3GS running iOS 6.1


INSTALLATION

Privoxy can only be installed and run on a jailbroken iDevice.

- Copy the zip file into the root directory on the iDevice. This can be achieved in many ways; I used the NetATalk Cydia package that installs the AFP file protocol on the iDevice which allows one to connect to it as a shared drive in Finder.
- unzip org.ijbswa.privoxy.zip
- change into the newly-created DEBIAN subfolder
- chmod the scripts to make them executable
- run ./preinstall
- run ./postinstall
- In Settings->WiFi->[your network name]->HTTP Proxy enter 127.0.0.1 for the server and 8118 for the port

From now on, all HTTP communications whilst on the WiFi network will pass via Privoxy's filtering.


GPL LICENSING LIABILITY

The binary distributions in this project were cross-compiled from Apple Macintosh OS X 10.6 to ARM using standard gcc 4.0.1 (see below), available as part of the freely available Xcode development environment. It is assumed that the same version of gcc obtained via an open source route would build an equivalent binary, hence the toolchain source is _not_ included in this project.

$ gcc --version
i686-apple-darwin10-gcc-4.0.1 (GCC) 4.0.1 (Apple Inc. build 5494)
Copyright (C) 2005 Free Software Foundation, Inc.
This is free software; see the source for copying conditions.  There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.


ATTRIBUTION

This module is based on the previous work done by Mark Miller (macsetup module) and David Schmidt & John Daniels (osxsetup module), to whom I am indebted. Thanks also to Fabian Keil for occasional technical and significant licensing guidance, and to Andrew Jones for testing.


Ian Silvester October 2013