Desktop runtime
The CaptchaLa desktop runtime is the set of native libraries for Windows, macOS and Linux that the desktop SDKs are built on. Current version: 1.2.0.
You don't integrate the runtime directly. Use one of these SDKs; they bundle or fetch the matching runtime for you:
- Electron SDK (
@captcha-la/electron): the npm package contains the runtime for every supported target. - Flutter SDK (
captchala): on Windows and Linux the plugin downloads the runtime at build time and checks it against pinned SHA-256 hashes.
Native macOS apps use the iOS / macOS SDK.
Need direct integration?
If neither Electron nor Flutter fits your app, contact us.
Platforms
| Platform | Architectures | Captcha window |
|---|---|---|
| Windows 10 1809+ and Windows Server | x64, arm64, x86 | Native window (Microsoft Edge WebView2 Runtime) |
| Linux, glibc 2.17+ | x64, arm64 | Native window: GTK 3 and WebKitGTK 4.1 (Ubuntu 22.04+, Debian 12+ or equivalent) |
| macOS 11+ | arm64, x64 | Used by the Electron SDK |
Since 1.2.0 the runtime also loads on Windows Server, including Server Core and terminal servers, without installing any extra Windows feature.
On Linux systems older than Ubuntu 22.04 / Debian 12 the native captcha window is not available; the Electron SDK shows the captcha in its own window there.
Download and verification
The libraries are published on the versioned package CDN with checksums, for security reviews or to mirror them inside your network:
- Base URL:
https://pkg.captcha-pkg.net/desktop/1.2.0/(mirror:https://pkg.captcha-cdn.net/desktop/1.2.0/) SHA256SUMSlists every file with its SHA-256; one folder per target:linux-x64,linux-arm64,win32-x64,win32-arm64,win32-ia32,darwin-arm64,darwin-x64
# Linux (use "shasum -a 256 -c -" on macOS)
BASE=https://pkg.captcha-pkg.net/desktop/1.2.0
TARGET=linux-x64
mkdir -p vendor/captchala/1.2.0 && cd vendor/captchala/1.2.0
curl -fsSLO "$BASE/SHA256SUMS"
for f in $(grep " $TARGET/" SHA256SUMS | awk '{print $2}'); do
mkdir -p "$(dirname "$f")" && curl -fsSL -o "$f" "$BASE/$f"
done
grep " $TARGET/" SHA256SUMS | sha256sum -c - # every line must say OKOn Windows, compare Get-FileHash <file> -Algorithm SHA256 with the line in SHA256SUMS. To build a Flutter desktop app from a mirror, point CAPTCHALA_LOCAL_PREBUILDS at the folder (see Flutter: native libraries).
Requirements
- Windows: Windows 10 1809+ or Windows Server; Microsoft Edge WebView2 Runtime for the captcha window.
- Linux: glibc 2.17+ and libcurl; GTK 3 and WebKitGTK 4.1 (
webkit2gtk-4.1) for the captcha window. - macOS: macOS 11+.
Server-side validation
Whichever SDK you use, send the pass token to your backend and validate it with POST https://verify.captcha.la/v1/validate. See the API Reference.