pkg content skeleton/Applications/Privoxy/readme.rtfd/TXT.rtf

   1 {\rtf1\ansi\ansicpg1252\cocoartf1038\cocoasubrtf360
   2 {\fonttbl\f0\fswiss\fcharset0 Helvetica;\f1\fswiss\fcharset0 ArialMT;\f2\fnil\fcharset0 LucidaGrande;
   3 \f3\fmodern\fcharset0 CourierNewPSMT;}
   4 {\colortbl;\red255\green255\blue255;\red255\green19\blue25;\red126\green0\blue20;\red126\green0\blue20;
   5 \red10\green0\blue139;}
   6 \margl1440\margr1440\vieww21240\viewh13460\viewkind0
   7 \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
   8
   9 \f0\b\fs34 \cf2 \
  10 You must make the following change in order to start using Privoxy!
  11 \b0\fs24 \cf0 \
  12 \
  13 \
  14
  15 \b\fs26 Setting up your web browser(s) to use Privoxy
  16 \b0\fs24 \
  17 \
  18 In order for Privoxy to filter web content for you, it must be set up as a proxy for your web browser. To do this for most web browsers (Safari, Chrome, Camino - see later in this readme for other browsers) go into your System Preferences.. Network.. preference pane. If the padlock at the bottom-left of the window is locked, you'll need to click it and enter your password to makes changes, then click 'Advanced' and click on the Proxies tab. In both the Web Proxy (HTTP)
  19 \b and
  20 \b0  Secure Web Proxy (HTTPS) entries, add the value 127.0.0.1 in the Web Proxy Server box and 8118 in the box to it's right (see screenshot below). Click 'OK' and then 'Apply' and you're all set!\
  21 \
  22 \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural\pardirnatural
  23 \cf0 {{\NeXTGraphic Screen shot 2012-01-30 at 1.12.07 PM.png \width13300 \height10400
  24 }¬}\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural\pardirnatural
  25 \cf0 \
  26 \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
  27 \cf0 \
  28 \
  29 Firefox and Opera have their proxy server settings within the application, for Firefox you'll find the settings at:\
  30 \
  31 Firefox > Preferences > Network > Settings > Manual Proxy Configuration\
  32 \
  33 and for Opera at:\
  34 \
  35 Opera > Preferences > Advanced > Network > Proxy Servers\
  36 \
  37 All done! To test that you've set things up correctly please follow the instructions in the next section.\
  38 \
  39 \
  40 \
  41 \pard\pardeftab720\sa240\ql\qnatural
  42
  43 \f1\b\fs36 \cf3 Checking that Privoxy is working for you
  44 \f0\b0\fs24 \cf0 \
  45 \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
  46 \cf0 Simply point your web browser here:\
  47 \
  48 \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
  49 {\field{\*\fldinst{HYPERLINK "http://config.privoxy.org/"}}{\fldrslt \cf0 http://config.privoxy.org/}}\
  50 \
  51 If you see a page like the following screenshot then all is well and Privoxy is filtering web content for you.
  52 \b\fs26 \
  53 \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural\pardirnatural
  54
  55 \b0\fs24 \cf0 {{\NeXTGraphic Screen shot 2012-01-30 at 1.23.15 PM.png \width25300 \height12660
  56 }¬}\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural\pardirnatural
  57 \cf0 \
  58 \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
  59 \cf0 \
  60 \
  61 \
  62
  63 \b\fs26 \
  64 \pard\pardeftab720\sa240\ql\qnatural
  65
  66 \f1\fs36 \cf3 Known Problems
  67 \f0\fs26 \cf0 \
  68 \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
  69
  70 \b0\fs24 \cf0 The OS X 'Mavericks' & 'Yosemite' releases have a bug that causes an intermittent problem for Privoxy that a simple upgrade install will not cure. If you have a persistent problem with Privoxy not starting (in your web browser you get a "Cannot connect to proxy server" error) then the best advice is to completely uninstall Privoxy (using the guide in the readme file at /Applications/Privoxy) then reinstall from scratch. Please ensure you take a copy of your config file and filters if you have made any customisations you do not want to lose.\
  71 \
  72 For the technically minded, the bug is that the _privoxy user & group cannot be reliably read from directory services at system startup time (there are suggestions that usernames with leading underscore are no longer properly supported), causing Privoxy to fail to load. Details can be found in these discussion threads:\
  73 \
  74 https://sourceforge.net/p/ijbswa/support-requests/1601/\
  75 https://sourceforge.net/p/ijbswa/support-requests/1599/\
  76 https://sourceforge.net/p/ijbswa/bugs/882/
  77 \b\fs26 \
  78 \
  79 \
  80 \
  81 \pard\pardeftab720\sa240\ql\qnatural
  82
  83 \f1\fs36 \cf4 Is there a particular feature from our TODO list you'd like to see implemented sooner rather than later? Would you like to donate in general?\
  84 \pard\pardeftab720\sa240\ql\qnatural
  85
  86 \b0\fs24 \cf0 Donations are welcome, and you are free to discuss with us what your donation should be used for. Our {\field{\*\fldinst{HYPERLINK "http://ijbswa.cvs.sourceforge.net/viewvc/ijbswa/current/TODO"}}{\fldrslt \cf5 TODO list}} is rather long and being able to pay one (or more) developers to work on Privoxy would make a huge difference, even if it was only for a couple of weeks. Donations may also be used for Privoxy-related travel expenses (for example to attend conferences), for hardware used for Privoxy development and for hosting expenses etc.\
  87 Privoxy is an associated project of {\field{\*\fldinst{HYPERLINK "http://www.spi-inc.org/"}}{\fldrslt \cf5 Software in the Public Interest (SPI)}}, which allows us to receive tax-deductible donations in the United States. If you want to donate through SPI, please use {\field{\*\fldinst{HYPERLINK "http://www.spi-inc.org/donations"}}{\fldrslt \cf5 SPI's donation page}} to see what the options are.\
  88 You can also donate to Privoxy using a bank account managed by {\field{\*\fldinst{HYPERLINK "https://www.zwiebelfreunde.de/"}}{\fldrslt \cf5 Zwiebelfreunde e.V.}}:\
  89 \'a0Name\'a0on\'a0Account:\'a0Zwiebelfreunde\'a0e.V.
  90 \f2 \uc0\u8232
  91 \f1 \'a0IBAN:\'a0DE95430609671126825604
  92 \f2 \uc0\u8232
  93 \f1 \'a0BIC:\'a0GENODEM1GLS
  94 \f2 \uc0\u8232
  95 \f1 \'a0Bank:\'a0GLS\'a0Bank\
  96 Donations made through Zwiebelfreunde e.V. are tax-deductible in Germany and other countries that recognize German charitable clubs. Feel free to use the Subject field to provide a name to be credited and a list of TODO list items you are interested in the most. For example: Max Mustermann: #16, #1, #14.\
  97 If you have any questions regarding donations please mail to either the public user mailing list or, if it's a private matter, to {\field{\*\fldinst{HYPERLINK "mailto:fk@fabiankeil.de"}}{\fldrslt \cf5 Fabian Keil}} (Privoxy's SPI liason) directly.\
  98 \pard\pardeftab720\ql\qnatural
  99 \cf0 \
 100 \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 101
 102 \f0\b\fs26 \cf0 \
 103 \pard\pardeftab720\sa240\ql\qnatural
 104
 105 \f1\fs36 \cf3 Configuring Privoxy
 106 \f0\b0\fs24 \cf0 \
 107 \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 108 \cf0 You can access your Privoxy installation configuration at:\
 109 \
 110 \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 111 {\field{\*\fldinst{HYPERLINK "http://config.privoxy.org/"}}{\fldrslt \cf0 http://config.privoxy.org/}}\
 112 \
 113 Note that to make configuration changes here you first have to manually enable this feature. This is done by setting parameter enable-edit-actions to the value 1 in {\field{\*\fldinst{HYPERLINK "file:///usr/local/etc/privoxy/config"}}{\fldrslt Privoxy's config file}}, which you'll need to edit as an administrator in order to save your changes. Full documentation for Privoxy can be found here:\
 114 \
 115 \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 116 {\field{\*\fldinst{HYPERLINK "file:///usr/local/share/doc/privoxy/"}}{\fldrslt \cf0 file:///usr/local/share/doc/privoxy/}}  (a good place to start is index.html or README)\
 117 \
 118 \
 119 \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 120
 121 \b\fs26 \cf0 \
 122 \pard\pardeftab720\sa240\ql\qnatural
 123
 124 \f1\fs36 \cf3 Merging in an existing configuration
 125 \f0\b0\fs24 \cf0 \
 126 \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 127 \cf0 If you already had Privoxy installed prior to this installation, then your configuration is unchanged. It is possible however that the configuration files supplied with this new installation contain new options that your existing configuration files do not. If you wish to manually merge your settings into the new files you will find them all at /usr/local/etc/privoxy/\
 128 \
 129 \
 130 \
 131 \pard\pardeftab720\sa240\ql\qnatural
 132
 133 \f1\b\fs36 \cf3 Starting and stopping Privoxy
 134 \f0\fs26 \cf0 \
 135 \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 136
 137 \b0\fs24 \cf0 Privoxy can be started and stopped using the two scripts in /Applications/Privoxy named startPrivoxy.sh and stopPrivoxy.sh. They must be run as sudo from an account that has administrative rights. To do this, open a Terminal window then enter the following commands:\
 138 \
 139 \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 140
 141 \f3 \cf0 cd /Applications/Privoxy\
 142 sudo ./startPrivoxy.sh\
 143 \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 144
 145 \f0 \cf0 \
 146 <or>
 147 \b \
 148 \
 149 \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 150
 151 \f3\b0 \cf0 sudo ./stopPrivoxy.sh\
 152 \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 153
 154 \f0\b \cf0 \
 155 \
 156 \
 157 \pard\pardeftab720\sa240\ql\qnatural
 158
 159 \f1\fs36 \cf3 Uninstalling Privoxy
 160 \f0\b0\fs24 \cf0 \
 161 \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 162 \cf0 To remove Privoxy once it has been installed, first of all reconfigure your web browser(s) not to use Privoxy as a proxy (see the top of this file for details). Once you're happy that you're not using Privoxy any more you can run its uninstall script.\
 163 \
 164 To do this, open a Terminal window then enter the following commands:\
 165 \
 166 \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 167
 168 \f3 \cf0 cd /Applications/Privoxy\
 169 sudo ./uninstall.command\
 170 \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 171
 172 \f0 \cf0 \
 173 You will be prompted for your password, since the script requires super-user privileges to run. If your account is not an administrator account, then the script won't work; you'll need to log in using an administrator account and try again. If you have already dragged the Privoxy application folder to the trash, use the 'Put Back' feature to restore it or else recreate the Privoxy folder in your Applications folder, drag the uninstall.command file from the trash to that folder and proceed as above.\
 174 \
 175 \
 176 \
 177 \pard\pardeftab720\sa240\ql\qnatural
 178
 179 \f1\b\fs36 \cf3 Thanks
 180 \f0\b0\fs24 \cf0 \
 181 \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 182 \cf0 This installer is based on previous work done by Mark Miller, David Schmidt and John Daniels, to whom I am indebted. Thanks also to Fabian Keil for occasional technical and significant licensing guidance, and to Andrew Jones, Andreas Rutkauskas, Julien Joubert, Lizik Grelier and Steven Kolins for testing.\
 183 \
 184 \
 185 \
 186 \pard\pardeftab720\sa240\ql\qnatural
 187
 188 \f1\b\fs36 \cf3 Copyright and licensing
 189 \f0\b0\fs24 \cf0 \
 190 \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 191 \cf0 All files that comprise this installation of Privoxy are written by and Copyright (C) 2001-2012 the Privoxy team. http://www.privoxy.org/\
 192 \
 193 \pard\pardeftab720\ql\qnatural
 194 \cf0 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.\
 195 \
 196 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. \'a0See the GNU General Public License for more details.\
 197 \
 198 The GNU General Public License should be included with this file. \'a0If 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\
 199 }