ProxyToggle
February 12, 2025
Matt Hammond
ProxyToggle - One-Click SOCKS Proxy & SSH Tunnel for macOS
- ๐ Need a simple way to toggle a SOCKS proxy and secure your connection?
- ๐ ProxyToggle makes it effortlessโjust one click from your macOS menu bar.
Whether youโre working remotely, bypassing network restrictions, or securing your browsing, ProxyToggle handles everything for you.
โก Why Use ProxyToggle?
- ๐ฅ๏ธ Menu Bar Integration โ No need to run terminal commandsโjust click the menu bar icon.
- ๐ One-Click Control โ Instantly enable/disable your SOCKS proxy & SSH tunnel.
- ๐ Automatic Process Management โ Detects & manages SSH processes, so you donโt have to.
- ๐ Persistent SSH Tunnel โ Keeps your connection stable and auto-kills outdated sessions.
- ๐ No More Manual Commands โ Forget typing ssh -D 8181 apollo every time.
๐ฅ How to Get ProxyToggle
- ๐พ Visit the project on Github
๐ง How to Install ProxyToggle (For Developers)
If you want to build ProxyToggle from source, hereโs how:
1๏ธโฃ Install Dependencies
Make sure you have Python 3.12+ installed. Then run:
pip install -r requirements.txt
2๏ธโฃ Build the App
Run:
pyinstaller --noconsole --onefile --windowed --name=ProxyToggle --icon=ProxyToggle.icns --add-data "ProxyToggle.icns:." proxy_toggle.py
The app will be available in the dist/ folder.
3๏ธโฃ Move to Applications Folder
mv dist/ProxyToggle.app /Applications/
๐ How to Use ProxyToggle
๐น Start ProxyToggle
You can manually start ProxyToggle from Terminal:
/Applications/ProxyToggle.app/Contents/MacOS/ProxyToggle &
Or, to keep it running even after closing Terminal:
nohup /Applications/ProxyToggle.app/Contents/MacOS/ProxyToggle > /dev/null 2>&1 &
๐น Toggle Proxy
Click the menu bar icon to enable/disable the SOCKS proxy instantly.
๐น Auto-Launch at Login
1. Open System Settings โ General โ Login Items.
2. Click + and select ProxyToggle.app.
๐ Built With
โข ๐ Python 3.12
โข ๐ฅ Rumps (macOS Menu Bar Framework)
โข ๐ฆ PyInstaller (App Packaging)
๐ Future Features
- ๐ก Status indicators for SSH connection
- ๐ก Auto-detect network changes & re-enable proxy
- ๐ก Customizable proxy & SSH settings
- ๐ก Launch at startup & integrate with macOS plist
๐ License
ProxyToggle is open-source under the MIT License.