code.delx.au - osx-proxyconf/blob - README

   1 ------------
   2 Introduction
   3 ------------
   4
   5 Do you use Mac OSX's multiple network locations feature with different proxies?
   6 This is a great way to conveniently use applications in multiple locations
   7 without having to configure each app separately.
   8
   9 Now you've probably noticed that command line applications do not use the proxy
  10 settings from System Preferences. This includes things like wget, fink, etc
  11 These applications all actually pay attention to the Unix convention of putting
  12 proxies in environment variables, eg
  13 $ export http_proxy="http://www-cache.example.com"
  14
  15 Proxyconf allows you to configure your proxies in System Preferences, and it
  16 takes care of grabbing these values and exporting them as environment
  17 variables. The upshot of this is, your command line apps will use the same
  18 proxy settings as your GUI apps.
  19
  20
  21 ------------
  22 Installation
  23 ------------
  24
  25 Installation is easy. Note the following assumes you've already configured your
  26 proxies in System Preferences. Skip to the last step if you downloaded a
  27 binary version.
  28
  29 Firstly, grab a copy of the code using Mercurial (http://selenic.com/mercurial):
  30 $ cd ~/Downloads/
  31 $ hg clone http://delx.net.au/hg/proxyconf
  32
  33 Next compile it:
  34 $ cd proxyconf
  35 $ make
  36
  37 Now add the following line to your ~/.bashrc (modify as appropriate):
  38 eval $(~/Downloads/proxyconf/proxyconf)
  39
  40
  41 -----------
  42 Limitations
  43 -----------
  44
  45 Note that proxyconf only works if you have System Preferences set to configure
  46 proxies "Manually". For example, proxy.pac files are not supported.
  47
  48 The environment variables are only exported when the shell starts. This means
  49 if you have a terminal open and change location the environment will be
  50 incorrect. This is unavoidable. The workaround is to close and start the
  51 terminal, or to run "exec bash -i"
  52