|
|
@@ -12,12 +12,18 @@ only an up-arrow when the proxy is not active. |
|
|
|
Toggle the on/off state by clicking the icon, quit the application by |
|
|
|
`Ctrl`-clicking the icon. |
|
|
|
|
|
|
|
## Build |
|
|
|
## Prerequisites |
|
|
|
|
|
|
|
* PyObjC: this should be already installed on your Mac, possible after |
|
|
|
installing [XCode][xcode] first; |
|
|
|
* [py2app][py2app] |
|
|
|
|
|
|
|
To build the application, you'll have the Developer tools for Mac OS |
|
|
|
X installed. |
|
|
|
[xcode]: http://itunes.apple.com/us/app/xcode/id448457090?mt=12 |
|
|
|
[py2app]: https://bitbucket.org/ronaldoussoren/py2app |
|
|
|
|
|
|
|
## Build |
|
|
|
|
|
|
|
When you have, you first build the application: |
|
|
|
Build the application from Terminal like so: |
|
|
|
|
|
|
|
python setup.py py2app |
|
|
|
|
|
|
@@ -28,14 +34,35 @@ there, or move it to somewhere more appropriate first. |
|
|
|
|
|
|
|
## Troubleshooting |
|
|
|
|
|
|
|
On Mac OS X Lion, you might get errors running the application. If that |
|
|
|
happens, first try to find out what the reason is. Run this from the same |
|
|
|
directory as `setup.py`: |
|
|
|
If you run into problems, first try to find out what the reason is. Run |
|
|
|
this from the same directory as `setup.py`: |
|
|
|
|
|
|
|
./dist/ToggleProxy.app/Contents/MacOS/ToggleProxy |
|
|
|
|
|
|
|
If you're getting errors about frameworks not being found, you might have |
|
|
|
to install a different version of the `py2app` module. I'm using [this |
|
|
|
one][py2app]. |
|
|
|
This should output any errors to stdout, so you might get a clue as to why |
|
|
|
it's not working. If it warrants an issue-report, you're welcome! |
|
|
|
|
|
|
|
[py2app]: https://bitbucket.org/ronaldoussoren/py2app |
|
|
|
## Author & License |
|
|
|
|
|
|
|
Copyright (C) 2011 by Robert Klep (_robert AT klep DOT name_). |
|
|
|
|
|
|
|
Permission is hereby granted, free of charge, to any person |
|
|
|
obtaining a copy of this software and associated documentation |
|
|
|
files (the "Software"), to deal in the Software without |
|
|
|
restriction, including without limitation the rights to use, |
|
|
|
copy, modify, merge, publish, distribute, sublicense, and/or |
|
|
|
sell copies of the Software, and to permit persons to whom the |
|
|
|
Software is furnished to do so, subject to the following |
|
|
|
conditions: |
|
|
|
|
|
|
|
The above copyright notice and this permission notice shall be |
|
|
|
included in all copies or substantial portions of the Software. |
|
|
|
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, |
|
|
|
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES |
|
|
|
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND |
|
|
|
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT |
|
|
|
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, |
|
|
|
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING |
|
|
|
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR |
|
|
|
OTHER DEALINGS IN THE SOFTWARE. |