Python bindings for shadowsocks sysproxy utility. This is a Windows-only package.
pip install sysproxy
>>> import sysproxy
>>> sysproxy.off() # Turn proxy settings off.
True
>>> sysproxy.pac('pac_url') # Turn proxy settings on with PAC.
True
>>> sysproxy.set('127.0.0.1:10809', '127.*;10.*;172.16.*') # Turn proxy settings on with server and bypass.
True
>>> sysproxy.daemon_off() # Turn proxy daemon off.
True
>>> sysproxy.daemon_on_() # Turn proxy daemon on. You should launch this function in a Python thread.When sysproxy daemon turned on, it executes a window-less WINAPI event loop that captures WM_QUERYENDSESSION message,
which is sent when Windows is about to shutdown. When the message arrives, the daemon calls off(), which turns proxy
settings off.
As mentioned above, sysproxy.daemon_on_() will block current Python execution, so you should launch it in a Python
thread.
sysproxy works on all reasonable Windows platform with all Python version(Python 3).
Below are tested build in github actions.
| Platform | Python versions |
|---|---|
| Windows x64 | 3.6-3.14 |
| Windows ARM64 | 3.11-3.14 |
Free-threaded Python 3.13 and 3.14 wheels are also built and tested. Each wheel
job runs the daemon lifecycle and interpreter-finalization checks in
sample/sample.py before a tagged release can be published.