Automatically create ephemeral ports in Windscribe and update your torrent client to use the new port

• Automatically (re)create ephemeral port forwards in Windscribe
• Automatically update your torrent client to use the new port
• Support for multiple torrent clients:
  • Deluge
  • qBittorrent
  • Transmission
  • Feel free to request or contribute more
• Automatically update port forwarding in Gluetun

A while ago Windscribe added Cloudflare CAPTCHA, and their own CAPTCHA to the login endpoint, so we can no longer log in using the normal credentials reliably. Normal web sessions expire, but the session in the Windscribe app doesn't. Turns out that at some point, they decided to merge the APIs, and now the same token that's used in the app also works on the web. This means that you only need to extract it once, and as long as you don't log out of the desktop app, it will keep working.

Download the official app and log in

There is a (vibe coded) Python script available here that will extract it for you (Tested on Linux/Windows)

For manual extraction, the value you're looking for is named authHash and is located inside of the wsnetSettings key in:

• Linux: $XDG_CONFIG_HOME/Windscribe/Windscribe2.conf
• Windows: HKCU\Software\Windscribe\Windscribe2
• Mac: I have no idea, and neither does the slop generator it seems, feel free to contribute.

DON'T LOG OUT! It will invalidate the session. If you want to log out without invalidating it, remove the configuration files listed above instead.

Configuration is done using environment variables

At least one torrent client or gluetun is required to be configured.

services:
  windscribe-ephemeral-port-torrent:
    image: dumbaspl/windscribe-ephemeral-port-torrent:latest
    restart: unless-stopped
    environment:
      WINDSCRIBE_AUTH_HASH: <authHash>
      # DELUGE_URL: http://deluge:8112
      # DELUGE_PASSWORD: <password>
      # QBITTORRENT_URL: http://qbittorrent:8080
      # QBITTORRENT_API_KEY: <apiKey>
      # TRANSMISSION_URL: http://transmission:9091
      # TRANSMISSION_USERNAME: <username>
      # TRANSMISSION_PASSWORD: <password>
      # GLUETUN_URL: http://gluetun:8000
      # GLUETUN_API_KEY: <apiKey>
      # GLUETUN_RESTART: true

make a .env file with the necessary configuration

go build -o windscribe-ephemeral-port-torrent
./windscribe-ephemeral-port-torrent

Make yourself a systemd service or something

Previous versions of this project were fully handwritten by me, this is an AI-assisted rewrite of the original codebase in GO with support for more torrent clients.

All code has been reviewed and tested by me.

MIT

With pet projects, I prefer to write things myself. No guarantees that I won't abandon your PR for 2 years and then re-write it. Debugging, testing, and feedback always welcome.