dumbaspl/windscribe-ephemeral-port-torrent repository overview

⁠windscribe-ephemeral-port-torrent⁠

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

⁠Features

• 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⁠

⁠Setup

⁠Getting authHash

⁠What? Why?

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.

⁠How?

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

Configuration is done using environment variables

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

⁠Running

⁠Using docker (and docker compose in this example)

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>

⁠Native

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

⁠AI disclaimer

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.

⁠License

MIT⁠

⁠Contributing

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.