Installation Guide (Windows & macOS)

Windows Installation

1. Download the latest Windows installer from the Download Page.
2. Run the installer and follow the setup wizard. Upgrading over an existing installation automatically preserves your license (v2sub.lic) and configuration (data/config.toml).
3. Launch V2sub from the desktop shortcut and open Config → Model Config to download a Whisper model.

---

macOS Installation & Gatekeeper Troubleshooting

1. Open v2sub-2.0.2-mac-arm64.dmg and drag v2sub.app into your Applications folder.
2. If macOS displays "v2sub is damaged and can't be opened" or "unidentified developer", open Terminal and run:

sudo spctl --master-disable
sudo xattr -rd com.apple.quarantine /Applications/v2sub.app

3. Enter your Mac login password when prompted (characters will not be echoed on screen) and press Enter. Then launch V2sub normally.