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.

ProxyToggle

โšก 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.