Editing Privoxy

[http://www.privoxy.org/ Privoxy] is a web proxy.  This means that it is a program which runs on your tablet through which all http/https traffic is routed.  It can be utilized to filter advertisements, popups, and other annoying web content.  It can also be used to access remote proxies that require specific user-agent information or other custom http headers.  For more information, see the [http://www.privoxy.org/faq/index.html Privoxy FAQ] and the [http://www.privoxy.org/user-manual/index.html Privoxy User Manual].  

[http://www.privoxy.org/ Privoxy] is a web proxy.  This means that it is a program which runs on your tablet through which all http/https traffic is routed.  It can be utilized to filter advertisements, popups, and other annoying web content.  It can also be used to access remote proxies that require specific user-agent information or other custom http headers.  For more information, see the [http://www.privoxy.org/faq/index.html Privoxy FAQ] and the [http://www.privoxy.org/user-manual/index.html Privoxy User Manual].  

== Installation ==

== Installation ==

Next you must configure your network connection to utilize privoxy as a "proxy".  On a typical desktop system, each ''application'' has its own proxy settings.  On the NIT, each ''connection'' has its own proxy settings.  This is unfortunate for two reasons.  First, every time you connect to a new wireless access point (at your local coffee shop for example) and you want to use privoxy, you must enter the proxy configuration for that connection.  Second, certain built-in applications (namely the Media Player) have issues with privoxy.   

Next you must configure your network connection to utilize privoxy as a "proxy".  On a typical desktop system, each ''application'' has its own proxy settings.  On the NIT, each ''connection'' has its own proxy settings.  This is unfortunate for two reasons.  First, every time you connect to a new wireless access point (at your local coffee shop for example) and you want to use privoxy, you must enter the proxy configuration for that connection.  Second, certain built-in applications (namely the Media Player) have issues with privoxy.   

These instructions assume that you already have an entry for your network connection and you simply want to add privoxy to it.  (You could just as easily adapt these instructions to a new connection.)  Open the "Connectivity" Control Panel and click the "Connections" button to view your list of configured connections.  Select the desired connection and click the "Edit" button.  Note that you cannot edit a connected entry, which means if you want to add privoxy to your current connection, you must first disconnect.  Once you are in the "Connection setup" dialog, click "Next" several times until you get to the "Complete" dialog.   

These instructions assume that you already have an entry for your network connection and you simply want to add privoxy to it.  (You could just as easily adapt these instructions to a new connection.)  Open the "Connectivity" Control Panel and click the "Connections" button to view your list of configured connections.  Select the desired connection and click the "Edit" button.  Note that you cannot edit a connected entry, which means if you want to add privoxy to your current connection, you must first disconnect.  Once you are in the "Connection setup" dialog, click "Next" several times until you get to the "Complete" dialog.   

Now click the "Advanced" button.  In the "Advanced settings" dialog, make sure you are on the "Proxies" tab.  Check the "Use proxy" checkbox and enter proxy address <code>127.0.0.1</code> and port <code>8118</code> for both <tt>http</tt> and <tt>https</tt> as shown in the next image.

Now click the "Advanced" button.  In the "Advanced settings" dialog, make sure you are on the "Proxies" tab.  Check the "Use proxy" checkbox and enter proxy address <code>127.0.0.1</code> and port <code>8118</code> for both <tt>http</tt> and <tt>https</tt> as shown in the next image.

Click the "OK" button, and then the "Finish" button to save the settings.  Click "Done"/"OK" buttons to get out of the Connectivity Control Panel.  Now connect to the newly configured connection.

Click the "OK" button, and then the "Finish" button to save the settings.  Click "Done"/"OK" buttons to get out of the Connectivity Control Panel.  Now connect to the newly configured connection.

Configuration of privoxy is accomplished through the web interface.  To configure privoxy, open a web browser and enter <code>p.p</code> into the address textbox.  <code>http://p.p</code> is a shortcut for the "real" configuration page <code>http://config.privoxy.org/</code>.  You should see the main privoxy page showing the main Privoxy Menu.

Configuration of privoxy is accomplished through the web interface.  To configure privoxy, open a web browser and enter <code>p.p</code> into the address textbox.  <code>http://p.p</code> is a shortcut for the "real" configuration page <code>http://config.privoxy.org/</code>.  You should see the main privoxy page showing the main Privoxy Menu.

Click the first link in the Privoxy Menu labeled "View &amp; change the current configuration".  This will take you to the web-based configuration screen.  Note that you will find all of the configuration files in the <code>/etc/privoxy</code> directory and you can edit these text files "by hand" if you prefer not to use the web-based interface.

Click the first link in the Privoxy Menu labeled "View &amp; change the current configuration".  This will take you to the web-based configuration screen.  Note that you will find all of the configuration files in the <code>/etc/privoxy</code> directory and you can edit these text files "by hand" if you prefer not to use the web-based interface.

By clicking on the "Edit" buttons, you can fine tune each of the configuration files.  The most important file in this list is the <tt>global.action</tt> file.  Click on the "Edit" button next to <code>/etc/privoxy/global.action</code> to change the protection level to one of [http://www.privoxy.org/user-manual/actions-file.html#AEN2194 three pre-defined levels].  (Note to desktop privoxy users: you may be used to setting the protection level in the <code>default.action</code> file.  For the maemo version, this was changed to allow for easy updates to the <code>default.action</code> file.)   

By clicking on the "Edit" buttons, you can fine tune each of the configuration files.  The most important file in this list is the <tt>global.action</tt> file.  Click on the "Edit" button next to <code>/etc/privoxy/global.action</code> to change the protection level to one of [http://www.privoxy.org/user-manual/actions-file.html#AEN2194 three pre-defined levels].  (Note to desktop privoxy users: you may be used to setting the protection level in the <code>default.action</code> file.  For the maemo version, this was changed to allow for easy updates to the <code>default.action</code> file.)   

For the maemo version, the default protection level is set to "Medium".  If you find this to be too aggressive you can set it to "Cautious" which will block fewer advertisements and give lower privacy protection.

For the maemo version, the default protection level is set to "Medium".  If you find this to be too aggressive you can set it to "Cautious" which will block fewer advertisements and give lower privacy protection.

Once you have privoxy configured to your liking, you may find there are times that you need to temporarily disable privoxy to access a particular website.  Fortunately, privoxy provides several [http://en.wikipedia.org/wiki/Bookmarklet bookmarklets] for showing the current status and for quickly enabling/disabling privoxy filtering.  Go back to the main privoxy page (http://p.p) and click on the link labeled "Toggle Privoxy on or off".  On the new page, scroll about half way down until you see the following.

Once you have privoxy configured to your liking, you may find there are times that you need to temporarily disable privoxy to access a particular website.  Fortunately, privoxy provides several [http://en.wikipedia.org/wiki/Bookmarklet bookmarklets] for showing the current status and for quickly enabling/disabling privoxy filtering.  Go back to the main privoxy page (http://p.p) and click on the link labeled "Toggle Privoxy on or off".  On the new page, scroll about half way down until you see the following.

Click and hold on the link labeled "Privoxy – View Status".  In the new popup box, select "Add link to Bookmarks...".  This will allow you to see the current status of privoxy and quickly enable/disable it.  When you select this new bookmark, a new web browser window will open that looks like the following.

Click and hold on the link labeled "Privoxy – View Status".  In the new popup box, select "Add link to Bookmarks...".  This will allow you to see the current status of privoxy and quickly enable/disable it.  When you select this new bookmark, a new web browser window will open that looks like the following.

Even though you disable privoxy via the web interface, the actual daemon process is still running in the background.  Privoxy is simply allowing all content to pass through unfiltered.  If you want to ''completely'' disable privoxy, you must do so through a Terminal as <code>root</code>.

Even though you disable privoxy via the web interface, the actual daemon process is still running in the background.  Privoxy is simply allowing all content to pass through unfiltered.  If you want to ''completely'' disable privoxy, you must do so through a Terminal as <code>root</code>.

Since you must configure privoxy on a connection-by-connection basis, all applications that use the http/https protocol will be filtered by privoxy.  For the most part, this is not a problem.  However, there are certain situations where you do not want privoxy to touch the http stream at all.  Here are several occasions where this is true.

Since you must configure privoxy on a connection-by-connection basis, all applications that use the http/https protocol will be filtered by privoxy.  For the most part, this is not a problem.  However, there are certain situations where you do not want privoxy to touch the http stream at all.  Here are several occasions where this is true.

# If your wireless access point redirects initial traffic to a login page on a non-standard port, you may find that you cannot get a connection.

# If your wireless access point redirects initial traffic to a login page on a non-standard port, you may find that you cannot get a connection.

# The Wayfinder Map application cannot download maps via a connection with Privoxy.

# The Wayfinder Map application cannot download maps via a connection with Privoxy.

* An additional action file from [http://www.neilvandyke.org/privoxy-rules/ Neil Van Dyke] provides additional online privacy.  This file is regularly maintained so you are free to download the latest version to replace the current one in <code>/etc/privoxy</code>.

* An additional action file from [http://www.neilvandyke.org/privoxy-rules/ Neil Van Dyke] provides additional online privacy.  This file is regularly maintained so you are free to download the latest version to replace the current one in <code>/etc/privoxy</code>.

* No documentation is provided on the tablet to minimize installation size.  All documentation is available [http://www.privoxy.org online].

* No documentation is provided on the tablet to minimize installation size.  All documentation is available [http://www.privoxy.org online].

* Logging has been disabled.

* Logging has been disabled.

Once you have a working scratchbox development environment, you can [http://repository.maemo.org/extras/pool/gregale/free/source/p/privoxy/ download the maemo source for privoxy] and untar it to your scratchbox home directory.  Then it is simply a matter of changing to the newly extracted privoxy directory and building the code.

Once you have a working scratchbox development environment, you can [http://repository.maemo.org/extras/pool/gregale/free/source/p/privoxy/ download the maemo source for privoxy] and untar it to your scratchbox home directory.  Then it is simply a matter of changing to the newly extracted privoxy directory and building the code.

This will build a new binary package (in the directory above the current one).  If you want to do any customizations for the build, you will need to go into the <code>debian</code> directory and change the files you find there.

This will build a new binary package (in the directory above the current one).  If you want to do any customizations for the build, you will need to go into the <code>debian</code> directory and change the files you find there.

==USB connectivity==

==USB connectivity==