Install App

All releases are available on GitHub: latest stable · all releases including pre-releases.

Android

Android

Via Obtainium (Recommended)

Obtainium lets you install and auto-update Prizrak-Box directly from GitHub Releases.

1. Install Obtainium.
2. Open the Obtainium link for Prizrak-Box — it will pre-fill all settings automatically.
3. Tap Add and then Install.

Manual APK

1. Go to the latest stable release or all releases (including pre-releases).
2. Download the APK matching your device architecture:
   • universal — works on all devices
   • arm64-v8a — 64-bit ARM (most modern phones)
   • armeabi-v7a — 32-bit ARM (older devices)
   • x86_64 — 64-bit x86 (emulators)
3. Enable Install from unknown sources in your device settings.
4. Open the downloaded APK to install.

Note

The APK includes a built-in update checker — it will notify you when a new release is available directly from GitHub.

Windows

Windows

1. Go to the latest stable release or all releases (including pre-releases).
2. Download the .msi installer (e.g. windows-amd64-wails.msi, also shown as the Setup x64 download button).
3. Run the installer — administrator confirmation will be required.
4. Launch Prizrak-Box from the Start menu or desktop shortcut.
5. Adding a provider configuration: click Add in the profiles menu and enter your subscription URL. One-click automatic configuration from your provider’s portal is also supported.

Note

Windows Defender may show a SmartScreen warning on first launch. Click More info → Run anyway.

macOS

macOS

1. Go to the latest stable release or all releases (including pre-releases).
2. Download the .dmg file for your Mac:
   • macos-arm64-wails.dmg — Apple Silicon
   • macos-amd64-wails.dmg — Intel
3. Open the .dmg and drag Prizrak-Box to your Applications folder.
4. On first launch macOS will ask you to confirm opening — click Open.
5. Adding a provider configuration: click Add in the profiles menu and enter your subscription URL. One-click automatic configuration from your provider’s portal is also supported.

Caution

macOS requires granting Network Extension permissions for the TUN mode to work. Follow the system prompt after first launch.

Linux

Linux

1. Go to the latest stable release or all releases (including pre-releases).
2. Download the package for your architecture and distribution:
   • amd64 (x86_64): linux-amd64.deb or linux-amd64.rpm
   • arm64: linux-arm64.deb or linux-arm64.rpm
3. Install the downloaded package:
   • For .deb (Debian/Ubuntu and derivatives):

     sudo dpkg -i linux-amd64.deb

   • For .rpm (Fedora/openSUSE and derivatives):

     sudo rpm -i linux-amd64.rpm

4. Launch Prizrak-Box from your application list.
5. Adding a provider configuration: click Add in the profiles menu and enter your subscription URL. One-click automatic configuration from your provider’s portal is also supported.

AUR

Arch Linux users can install from the AUR:

yay -S prizrak-box-bin

iOS

iOS

The iOS version is in testing. The TestFlight link for testing is available in the developer’s Telegram channel. An App Store release will follow.