Desktop

Install or build the native Pelagica desktop app for macOS, Windows, and Linux.

Pelagica is also available as a native desktop app for macOS, Windows, and Linux, built with Wails v3.

Installing

Download the latest build for your platform from the Releases page.

  • macOS: Available as a .dmg installer or a zipped .app bundle. The .dmg installer is notarized by Apple, so it should open without warnings.
  • Windows: Not signed with an Authenticode certificate, so SmartScreen will flag it.
  • Linux: Available as a .deb package, a .pkg.tar.zst package or an .AppImage.

NOTE

Once installed, the desktop app connects to a Jellyfin server the same way the web app does — it doesn’t need a self-hosted Pelagica instance.

Homebrew (macOS)

On Apple Silicon, Pelagica can also be installed and kept up to date through the Homebrew tap:

brew tap PelagicaApp/pelagica
brew trust PelagicaApp/pelagica
brew install --cask pelagica

Later updates are just brew upgrade --cask pelagica.

Building it yourself

If you’d rather build the desktop app from source, clone the repository as described in Development Setup, then build with Task:

task desktop:build

This produces a desktop/bin/pelagica binary.

Packaging an installer

PlatformCommandOutput
macOStask desktop:package:macosdesktop/bin/Pelagica.app
task desktop:installer:macosdesktop/bin/Pelagica.dmg
Windowstask desktop:package:windowsdesktop/bin/pelagica.exe
task desktop:installer:windowsdesktop/bin/Pelagica-amd64-installer.exe
Linuxtask desktop:package:linuxdesktop/bin/pelagica
task desktop:installer:linux:debdesktop/bin/pelagica.deb
task desktop:installer:linux:pkgdesktop/bin/pelagica.pkg.tar.zst
task desktop:installer:linux:appimagedesktop/bin/pelagica-x86_64.AppImage

A few platform-specific tools are needed on top of the usual development prerequisites:

  • macOS: create-dmg for the .dmg (brew install create-dmg).
  • Windows: NSIS for the installer (winget install NSIS.NSIS, or choco install nsis). The Microsoft Edge WebView2 bootstrapper is downloaded automatically on first build.
  • Linux: A C compiler and the GTK4 + WebKitGTK 6.0 dev headers, since the Linux build uses cgo (Ubuntu/Debian: apt install build-essential pkg-config libgtk-4-dev libwebkitgtk-6.0-dev). The AppImage build additionally downloads linuxdeploy on first run.

None of the produced installers are code-signed or notarized.

See the desktop README in the repository for more detail on the build setup.