Skip to content
Back to search

Desktop-App

Public mirror of the Windscribe VPN desktop client for Windows, Mac and Linux

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Windscribe/Desktop-App with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Windscribe/Desktop-App'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/windscribe--desktop-app/badge.svg)](/listings/windscribe--desktop-app)

HTML

<a href="/listings/windscribe--desktop-app"><img src="/api/listings/windscribe--desktop-app/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

- You will have to go to `Manage App Execution Aliases` in System Settings and disable app installer for `python.exe` and `python3.exe`

  python3 -m pip install -r tools/requirements.txt

In case of `pyyaml` [building issue on Windows](https://github.com/yaml/pyyaml/issues/724#issuecomment-1638636728), execute the following and then re-execute the above python step:

pip install setuptools wheel
pip install "cython<3.0.0" && pip install --no-build-isolation pyyaml==6.0

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 233 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Windscribe Desktop Application
  2. ![Windscribe splash image](/windscribe_banner.jpg)
  3. The Windscribe VPN desktop application hides your physical location, blocks ads and trackers, and keeps you safe online. Features available in the application are:
  4. - Offers 6 different protocols to choose from, along with over 20 different connection ports:
  5. - WireGuard® - Now with [Post-Quantum Encryption](https://windscribe.com/blog/post-quantum-vpn/)
  6. - OpenVPN UDP/TCP
  7. - IKEv2
  8. - Stealth
  9. - WSTunnel
  10. - Proactive firewall eliminates the chance of any kind of leak.
  11. - Network and per-app split tunneling.
  12. - Appear as a brand new user, every time you connect using MAC address spoofing.
  13. - Network rules allowing you to connect or disconnect automatically.
  14. - Custom config support for importing any VPN config into Windscribe.
  15. - Create a secure HTTP or SOCKS5 proxy server on your computer, allowing any device on your network to use this proxy server in order to make requests over the VPN tunnel.
  16. - Content filtering with our integrated DNS-based blocker (R.O.B.E.R.T.) for ads, trackers, malware, and custom domains.
  17. - Custom DNS support for using any 3rd party DNS server, including our sister product [ctrld](https://github.com/Control-D-Inc/ctrld).
  18. - CLI support on all platforms, including a pure CLI environment for Linux.
  19. - No per-device or simultaneous connection restrictions. Use one account across all your personal systems.
  20. ## OS Support
  21. - Windows 10/11 amd64 (minimum build 17763)
  22. - Windows 11 arm64
  23. - Windows Server 2022 amd64
  24. - macOS 14.4+ (amd64, arm64)
  25. - Ubuntu 22.04+ (amd64, arm64)
  26. - Fedora 36+ (amd64, arm64)
  27. - openSUSE Leap 15.6 amd64
  28. - Arch amd64 (with a minimum glibc version of 2.35)
  29. - Immutable distros (e.g. Fedora Silverblue 40, openSUSE Aeon/MicroOS)
  30. ## Windows Build Process
  31. ### Prerequisites
  32. - Windows 10/11 x86_64, or Windows 11 arm64. On arm64 hardware the build is native and targets arm64. Pass `--arm64` only to cross-compile an arm64 target from x86_64 hardware.
  33. - Install [git](https://git-scm.com/downloads). When installing Git, you can stick with all the default options presented to you by the installer.
  34. - Clone the repository.
  35. - Install Visual Studio Community Edition 2022.
  36. - Install Python 3 via either the Microsoft Store or from [here](https://www.python.org/downloads/). Minimum tested version is 3.6.8.
  37. - Install CMake v3.28.x or newer from [here](https://cmake.org/download/). The project will build with older versions of CMake, but you may encounter some warnings.
  38. - Install Ninja v1.10.2 from [here](https://github.com/ninja-build/ninja/releases)
  39. - Install Windows 11 SDK (10.0.22000) from [here](https://go.microsoft.com/fwlink/?linkid=2173743). Newer versions may work as well.
  40. - Clone the [ws-vcpkg-registry](https://github.com/Windscribe/ws-vcpkg-registry) and run its installation script to set up vcpkg. Then set the `VCPKG_ROOT` environment variable to the path you chose:
  41. ```
  42. git clone https://github.com/Windscribe/ws-vcpkg-registry.git
  43. ws-vcpkg-registry\install-vcpkg\vcpkg_install.bat C:\path\to\vcpkg
  44. ```
  45. - Verify the following entries are in your System `PATH` environment variable. If they are not, add them to the System `PATH` environment variable and reboot.
  46. - `C:\Program Files\Git\cmd`
  47. - `C:\[folder containing ninja.exe]`
  48. - `C:\[folder containing cmake.exe]`
  49. - Verify that `python3` is available in your System `PATH` environment variable.
  50. - If you installed Python from the Microsoft Store, enable the `python3.exe` execution alias in System Settings `Manage App Execution Aliases`.
  51. - If you installed Python from python.org, you can `mklink /path/to/your/python3.exe /path/to/your/python.exe`
  52. ### Install build script dependencies
  53. - You will have to go to `Manage App Execution Aliases` in System Settings and disable app installer for `python.exe` and `python3.exe`
  54. ```python
  55. python3 -m pip install -r tools/requirements.txt
  56. ```
  57. In case of `pyyaml` [building issue on Windows](https://github.com/yaml/pyyaml/issues/724#issuecomment-1638636728), execute the following and then re-execute the above python step:
  58. ```python
  59. pip install setuptools wheel
  60. pip install "cython<3.0.0" && pip install --no-build-isolation pyyaml==6.0
  61. ```
  62. ### Install signing certificate (optional)
  63. - Copy your PFX code signing file to `installer/windows/signing/code_signing.pfx`.
  64. - Edit (create) `tools/notarize.yml` and add the following line:
  65. ```
  66. windows-signing-cert-password: password-for-code-signing-pfx
  67. ```
  68. - Edit `client/common/utils/executable_signature/executable_signature_defs.h` and set the `WINDOWS_CERT_SUBJECT_NAME` entry to match your certficate's name of signer field.
  69. ### Build libraries
  70. Go to subfolder `tools/deps` and run the following scripts in order. Append `--arm64` to the command to build a library for Windows arm64. Libraries will be placed in `build-libs[-arm64]`.
  71. ```
  72. install_openvpn_dco
  73. install_wintun
  74. ```
  75. ### Build the Windscribe 2.0 app
  76. Go to subfolder `tools` and run `build_all --dev-mode`. Assuming all goes well with the build, the installer will be placed in `build-exe`. The `--dev-mode` flag disables run-time signature verification and relaxes the security checks, which is what you want for local development and debugging. Omitting `--dev-mode` produces a build that performs run-time signature verification on its executables; that build must be code-signed with `--sign-app` (and `--sign-installer` / `--sign-bootstrap` as needed), using the certificate from the [Install signing certificate](#install-signing-certificate-optional) section above, otherwise it will reject its own unsigned executables at run time. On x86_64 hardware, append `--arm64` to cross-compile for Windows arm64. On arm64 hardware that is the default, and the compiler, linker, and vcpkg host tools are the native arm64 tools.
  77. See `build_all --help` for other build options.
  78. ### Logs
  79. - Client app, OpenVPN log, location pings and installer helper: `C:/Users/<user_name>/AppData/Local/Windscribe/Windscribe2`
  80. - Service: `<Windscribe_installation_path>/windscribeservice.log`
  81. - Installer: `C:/ProgramData/Windscribe/installer.log` (previous attempt in `installer.log.1`)
  82. - Uninstaller: `C:/ProgramData/Windscribe/uninstaller.log` (previous run in `uninstaller.log.1`)
  83. - `<Windscribe_installation_path>` defaults to `C:/Program Files/Windscribe`
  84. ## macOS Build Process
  85. ### Prerequisites
  86. - macOS Sonoma (14.4) or newer.
  87. - Install Xcode 15 or newer.
  88. - You must agree to the Xcode license (`sudo xcodebuild -license`)
  89. - You may need to run `xcodebuild -runFirstLaunch` or the Xcode GUI once if CMake complains that it can't find the compiler when building using the Xcode generator.
  90. - Note: these downloads will require you to first login to your Apple account.
  91. - https://xcodereleases.com
  92. - Install brew (brew.sh)
  93. ```bash
  94. /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  95. ```
  96. - Install git. This step is optional, as git is bundled with Xcode.
  97. ```bash
  98. brew install git
  99. ```
  100. - Install Auto-Tools:
  101. ```bash
  102. brew install libtool
  103. brew install automake
  104. ```
  105. - Install Python 3:
  106. - Minimum tested version is Python 3.6.8. 3.12.0 seems to have some issues with the python deps, so 3.11.6 is the latest recommended version. You may do this however you like, however `pyenv` is recommended:
  107. ```bash
  108. brew install pyenv
  109. echo 'if command -v pyenv 1>/dev/null 2>&1; then eval "$(pyenv init --path)"; fi"' >> ~/.zshrc
  110. pyenv install 3.11.6
  111. pyenv global 3.11.6
  112. ```
  113. - Install CMake v3.28.x or newer from [here](https://cmake.org/download/) and make sure that the cmake executable is in the path and available for execution. The project will build with older versions of CMake, but you may encounter some warnings.
  114. - Clone the [ws-vcpkg-registry](https://github.com/Windscribe/ws-vcpkg-registry) and run its installation script to set up vcpkg. Then set the `VCPKG_ROOT` environment variable to the path you chose:
  115. ```bash
  116. git clone https://github.com/Windscribe/ws-vcpkg-registry.git
  117. ./ws-vcpkg-registry/install-vcpkg/vcpkg_install.sh /path/to/vcpkg
  118. ```
  119. - Clone the repository.
  120. - Install python deps:
  121. ```python
  122. python3 -m pip install -r tools/requirements.txt
  123. ```
  124. ### Install signing certificate (required)
  125. - Install your Developer ID Application signing certificate from your Apple Developer account in Keychain Access.
  126. - Edit `client/common/utils/executable_signature/executable_signature_defs.h` and set the `MACOS_CERT_TEAM_ID` entry to match your Developer ID Application signing certificate's team ID.
  127. ### Build the Windscribe 2.0 app
  128. Go to subfolder `tools` and run `build_all --dev-mode`. Assuming all goes well with the build, the installer will be placed in `build-exe`.
  129. See `build_all --help` for other build options.
  130. ### Platform Notes:
  131. - If you make any changes to the helper source code `src/helper/macos`, you must increase the `CFBundleVersion` in `src/helper/macos/helper-info.plist`. The installer only updates the helper if this bundle version number has changed.
  132. - The IKEv2 protocol will only function in builds produced by Windscribe. Its implementation on macOS utilizes the NEVPNManager API, which requires the 'Personal VPN' entitlement (`com.apple.developer.networking.vpn.api`) and an embedded provisioning profile file. If you wish to enable IKEv2 functionality, you will have to create an embedded provisioning file in your Apple Developer account and use it in the client project (Search for `embedded.provisionprofile` in `client/CMakeLists.txt` for details on where to place the embedded provisioning profile).
  133. ### Logs
  134. - Client app and location pings: `/Users/<user_name>/Library/Application Support/Windscribe/Windscribe2`
  135. - Installer: `/Users/<user_name>/Library/Application Support/Windscribe/Windscribe/log_installer.txt`
  136. - Helper: `/Library/Logs/com.windscribe.helper.macos/helper_log.txt`
  137. - OpenVPN: `/etc/windscribe/openvpn.log`
  138. ## Linux Build Process
  139. ### Build with Docker
  140. The repository contains Dockerfile to simplify building process. Skip all the other sections of this manual if you decide to use Docker.
  141. - Generate builder image:
  142. ```bash
  143. sudo docker build -t ws-builder .
  144. ```
  145. - Install vcpkg via [ws-vcpkg-registry](https://github.com/Windscribe/ws-vcpkg-registry):
  146. ```bash
  147. sudo docker run --rm -v .:/w ws-builder /bin/bash -c "git clone https://github.com/Windscribe/ws-vcpkg-registry.git /tmp/ws-vcpkg-registry && /tmp/ws-vcpkg-registry/install-vcpkg/vcpkg_install.sh /w/vcpkg"
  148. ```
  149. - Build the application:
  150. ```bash
  151. sudo docker run --rm -v .:/w ws-builder /bin/bash -c "export VCPKG_ROOT=/w/vcpkg && cd /w/tools/ && ./build_all --dev-mode"
  152. ```
  153. ### Prerequisites
  154. Build process tested on Ubuntu 22.04/24.04.
  155. - Install build requirements:
  156. ```bash
  157. sudo apt-get update
  158. sudo apt-get install build-essential git curl patchelf libpam0g-dev software-properties-common libgl1-mesa-dev fakeroot python3-pip zip unzip libnl-genl-3-dev pkg-config libcap-ng-dev libnftables-dev wget autoconf libtool libfontconfig1-dev libfreetype6-dev libx11-dev libx11-xcb-dev libxext-dev libxfixes-dev libxi-dev libxrender-dev libxcb1-dev libxcb-cursor-dev libxcb-glx0-dev libxcb-keysyms1-dev libxcb-image0-dev libxcb-shm0-dev libxcb-icccm4-dev libxcb-sync-dev libxcb-xfixes0-dev libxcb-shape0-dev libxcb-randr0-dev libxcb-render-util0-dev libxcb-util-dev libxcb-xinerama0-dev libxcb-xkb-dev libxkbcommon-dev libxkbcommon-x11-dev libwayland-dev libacl1-dev
  159. # install CMake 3.28.x or newer. Issues were encountered with cmake 4.x building some of the dependencies via vcpkg (e.g. lzo). We recommend rolling back to the latest cmake 3.x stable if you encounter build issues.
  160. # Make sure that the cmake executable is in the path and available for execution.
  161. sudo snap install cmake --classic
  162. ```
  163. - Clone the [ws-vcpkg-registry](https://github.com/Windscribe/ws-vcpkg-registry) and run its installation script to set up vcpkg. Then set the `VCPKG_ROOT` environment variable to the path you chose:
  164. ```bash
  165. git clone https://github.com/Windscribe/ws-vcpkg-registry.git
  166. ./ws-vcpkg-registry/install-vcpkg/vcpkg_install.sh /path/to/vcpkg
  167. ```
  168. - Clone the repository.
  169. - Install Python (if necessary) and Python deps. You may want to use a virtual environment for Python (e.g. with pyenv), but this is up to you (and possibly your distribution). We recommend 3.11 or later.
  170. ```python
  171. python3 -m pip install -r tools/requirements.txt
  172. ```
  173. ### Build the Windscribe 2.0 app
  174. Go to subfolder `tools` and run `build_all --dev-mode`. Assuming all goes well with the build, the installer will be placed in `build-exe`.
  175. See `build_all --help` for other build options.
  176. The application installs to `/opt/windscribe`.
  177. ### Logs
  178. - Client app and location pings: `~/.local/share/Windscribe/Windscribe2`
  179. - Helper: `/var/log/windscribe/helper_log.txt`
  180. - OpenVPN: `/var/run/windscribe/openvpn.log`
  181. ## Contributing
  182. Please see our [Contributing Guidelines](https://github.com/Windscribe/Desktop-App/blob/master/CONTRIBUTING.md)
  183. ## License
  184. The Windscribe Desktop Client app [License](https://github.com/Windscribe/Desktop-App/blob/master/LICENSE)
  185. “WireGuard” is a registered trademark of Jason A. Donenfeld. [Open Source Software Attributions](https://windscribe.com/terms/oss/)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.