Skip to main content

Installation

Download the latest installer from Serpent Releases.

Requirements​

  • macOS: Apple Silicon (arm64) or Intel (x64), macOS 11 or newer
  • Windows: 64-bit Windows 10 or Windows 11
  • The app uses about 500 MB; library data needs additional space

Use Serpent Releases for the current Windows installer and version notes.

macOS​

  1. Download the matching Serpent-darwin-arm64-<version>-package.dmg (or Intel build).
  2. Open the DMG and drag Serpent to Applications.

Unsigned development builds may trigger Gatekeeper. Verify the source, then right-click the app, choose Open, and confirm. If it is still blocked, clear quarantine from Terminal:

xattr -cr /Applications/Serpent.app

To uninstall, move the app to the Trash. Libraries live where you created them and are not removed with the app.

Windows​

  1. Download the Windows installer package Serpent-win-x86-64-<version>-setup.zip (extract and run the setup wizard), or download the portable build Serpent-win-x86-64-<version>-portable.zip (extract and run directly from any local directory).
  2. Run the installer and follow the wizard to choose install path, language, and shortcut preferences.

Unsigned development builds may trigger SmartScreen. Verify the source, then choose More info → Run anyway. Uninstall from Settings → Apps; the uninstaller will cleanly remove application files.

Browser extension​

Download the browser extension (Chrome / Edge / Firefox) from the extension releases. Installation and usage: see Browser extension.

Upgrading​

Replace the macOS app with the new DMG, or run the new Windows installer over the existing install. Libraries and user configuration live outside the application install directory and normally remain; back up a library before upgrading. Follow the release notes for migrations and platform-specific caveats.