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
- Linux: 64-bit x86_64 or aarch64 (release asset is an AppImage; newer distros recommended — both architectures use the Ubuntu 22.04 / glibc ≥ 2.35 baseline)
- The app uses about 500 MB; library data needs additional space
Use Serpent Releases for current installers and version notes.
macOS
- Download the matching
Serpent-darwin-arm64-<version>-package.dmg(or Intel build). - 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
- Download the Windows installer package
Serpent-win-x86-64-<version>-setup.zip(extract and run the setup wizard), or download the portable buildSerpent-win-x86-64-<version>-portable.zip(extract and run directly from any local directory). - 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.
Linux
- Download the AppImage that matches the machine:
Serpent-linux-x86-64-<version>.AppImagefor x86_64, orSerpent-linux-arm64-<version>.AppImagefor aarch64. - Make it executable and run:
chmod +x Serpent-linux-x86-64-<version>.AppImage
./Serpent-linux-x86-64-<version>.AppImage
# On aarch64, use Serpent-linux-arm64-<version>.AppImage instead.
Runtime dependencies:
- FUSE (
libfuse2). Without FUSE, add--appimage-extract-and-run. The same requirement applies to x86_64 and aarch64. - The released AppImage ships the same
ffmpeg,ffprobe, andoiiotoolbinaries as macOS and Windows (oiiotoolincludes LibRaw / OCIO). Video previews and professional image formats do not normally need those tools installed on the system.SERPENT_FFMPEG_PATHandSERPENT_OIIO_PATHcan still point at another copy. The aarch64 asset appears on Releases after its media bundle is promoted. - Debian/Ubuntu example:
sudo apt install libfuse2. A source checkout that has not acquired the media bundle still needs systemffmpeg.
Current Linux behavior and limits:
- Windows-style shell: frameless window, in-app main menu (≡), rounded corners when a compositor is present.
- No system tray: closing the window quits the app (unlike Windows, which hides to the notification area).
- Launch at login is not offered yet. See Basics.
- Tested on Debian 13 (X11) and under a nested Wayland compositor; native Wayland sessions still need dedicated acceptance. x86_64 and aarch64 share these limits.
- Set
SERPENT_SOFTWARE_GL=1for software WebGL when no usable GPU / GL driver is available. Force square / rounded corners withSERPENT_LINUX_ROUNDED_CORNERS=0/1.
To uninstall, delete the AppImage. Library directories are separate from the app file and are not removed with it.
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, run the new Windows installer over the existing install, or replace the Linux AppImage with the newer file (keep the old file until you confirm the upgrade). 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.
In-app Help → About → Check for updates on Linux selects Serpent-linux-x86-64-<version>.AppImage or Serpent-linux-arm64-<version>.AppImage for the running architecture; after download and checksum verification, run chmod +x before launching.