Skip to content

AI media harness for planning, generating, and editing locally

TypeScript

Document the Linux app

Bitti4c1cdd2ecdc0
diff --git a/README.md b/README.md
index 86a711e..a13e933 100644
--- a/README.md
+++ b/README.md
@@ -45,6 +45,10 @@ Slopus brings an AI assistant, a scene generator, reusable references, a timelin
Local video generation requires separately installed model weights and GPU support. In **Settings → Generator**, configure a generator's model paths and check that its status reads **Ready**. Configure OpenRouter or a local model endpoint in **Settings → Agents** to make it available in the assistant's agent list.
+### Linux
+
+Slopus runs on x86_64 Linux. Install `Slopus-<version>-linux-x64.deb` (Debian, Ubuntu) or `Slopus-<version>-linux-x64.rpm` (Fedora, openSUSE), or make `Slopus-<version>-linux-x64.AppImage` executable and run it; the AppImage updates itself. The app needs WebKitGTK 2.42 or later for video decoding, export and GPU effects. Local generation has the same requirements as the Linux worker below. See [docs/linux.md](docs/linux.md).
+
### Generating on another computer
Workers run on Windows or Linux. On a computer with a capable GPU on the same network, unpack the worker package and start it:
diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 11ccf63..81874db 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -15,6 +15,7 @@ This alpha update adds DMAD LoRA support, resumable model downloads, and improve
- Downloadable DMAD 4-Step LoRA for MiniMax H3, with its re-noising sampling recipe applied automatically. Its fixed four-step schedule overrides step counts and turns off MotionCache.
- Sound references: add an MP3, M4A, WAV, FLAC or Ogg file to a reference, choose a 2 to 15 second range, and cite it in a shot as `<Audio N>`, for example as a voice timbre. Sound references need a Ref2VA generator and an image or video reference in the same scene, and also work on LAN workers.
- Bundled release notes appear once per app version.
+- Slopus for Linux (x86_64): install the .deb or .rpm package, or run the AppImage, which updates itself. Local generation on Linux needs an NVIDIA GPU with CUDA 13.
- LAN workers: run the Slopus worker package on another Windows or Linux computer and pick it in the new **Settings → Workers** tab to generate there. Slopus finds workers on the local network automatically, or by address. Workers download generator weights from their download links themselves and use CUDA when available, with a Vulkan fallback; local-only files are sent from this computer, and finished videos, images and latents are saved in your project as usual.
## Fixes and improvements
diff --git a/docs/linux.md b/docs/linux.md
new file mode 100644
index 0000000..8ab2113
--- /dev/null
+++ b/docs/linux.md
@@ -0,0 +1,71 @@
+# Linux desktop app
+
+Slopus builds for x86_64 Linux from the same sources as the Windows app. The
+Rust side was already portable (the LAN worker runs on Linux); what differs is
+the webview, where the runtime is installed, and the packaging.
+
+## Packages
+
+`release.cmd` and `package.cmd` build the Linux app in WSL after the Windows
+build, through `scripts/package-linux-app.sh`:
+
+| Artifact | Install | Updates |
+| --- | --- | --- |
+| `Slopus-<version>-linux-x64.deb` | `sudo apt install ./Slopus-<version>-linux-x64.deb` | Settings offers the releases page |
+| `Slopus-<version>-linux-x64.rpm` | `sudo dnf install ./Slopus-<version>-linux-x64.rpm` | Settings offers the releases page |
+| `Slopus-<version>-linux-x64.AppImage` | `chmod +x` and run | In-app updater (signed, `linux-x86_64` in `latest.json`) |
+
+The script reuses the frontend that the Windows build has just written to
+`dist/` (it is platform independent, and WSL usually has no Linux Node.js), and
+runs the Tauri CLI version pinned in `package-lock.json`, installed with cargo
+into `~/.cache/slopus/tauri-cli-<version>` on first use. Cargo builds in
+`~/.cache/slopus/linux-app-target`, on the Linux filesystem.
+
+One-time WSL setup on Ubuntu (Rust as for the Linux worker):
+
+```sh
+sudo apt-get install -y libwebkit2gtk-4.1-dev libgtk-3-dev libayatana-appindicator3-dev \
+ librsvg2-dev libxdo-dev libssl-dev build-essential file patchelf
+```
+
+`release.cmd` passes `TAURI_SIGNING_PRIVATE_KEY` (and its password) into WSL
+through `WSLENV`; a Windows key path is translated with `wslpath`. Without a key,
+`package.cmd` builds the same packages unsigned.
+
+## Runtime layout
+
+Platform resources live in `src-tauri/tauri.windows.conf.json` and
+`src-tauri/tauri.linux.conf.json`, which Tauri merges over `tauri.conf.json`.
+On Linux `libslopfab.so` is installed in Tauri's resource folder,
+`/usr/lib/Slopus/` (inside the AppImage too). `default_dll_path` looks beside the
+executable first, as on Windows and in development builds, and then in
+`../lib/Slopus/`.
+
+Generation has the same requirements as the Linux worker: an NVIDIA GPU with its
+driver and CUDA 13 cuBLAS (`libcublas.so.13`), found in `/usr/local/cuda*` when
+the system linker does not.
+
+## WebKitGTK
+
+Tauri uses WebKitGTK on Linux. Unlike WebView2, it ships WebCodecs and WebGPU
+behind runtime feature flags. `src-tauri/src/linux_webview.rs` turns them on
+(`WebCodecsVideoEnabled`, `WebCodecsAudioEnabled`, `WebCodecsAV1Enabled`,
+`WebGPUEnabled`) with GPU compositing and WebGL, and reloads the page once so
+the first document has them. The feature API needs WebKitGTK 2.42 or later; it is
+looked up at run time, so older versions still start and the diagnostic log
+names the missing features.
+
+WebKitGTK decodes and encodes through GStreamer. The .deb and .rpm depend on the
+base, good and bad plugin sets; `gstreamer1.0-libav` is recommended for H.264
+on systems without a hardware VA-API decoder. The AppImage bundles GStreamer.
+
+## Desktop integration
+
+- The window stays frameless with the in-page title bar. Caption buttons are
+ drawn as SVG, since the Segoe icon fonts exist only on Windows.
+- "Show in Files" selects the item through the `org.freedesktop.FileManager1`
+ D-Bus interface, and falls back to opening the folder with `xdg-open`.
+- The Cut / Copy / Paste / Select all text menu runs WebKit's editing commands
+ instead of replaying keystrokes.
+- Mica, the Windows accent colour and rounded DWM corners are Windows only; the
+ app uses its own palette and an opaque ground.
diff --git a/docs/updater.md b/docs/updater.md
index 9d71db1..fcb018c 100644
--- a/docs/updater.md
+++ b/docs/updater.md
@@ -127,10 +127,11 @@ the first release containing `latest.json` is published, checks will report an
error and leave the current app running.
The manifest generated by `release.cmd` covers the current Windows architecture
-and includes NSIS/MSI-specific targets. When publishing more architectures or
-operating systems, merge their platform entries into one `latest.json` before
-uploading it. Tauri also supports signed macOS and Linux updater artifacts; the
-existing Windows packaging script does not build those.
+with NSIS/MSI-specific targets, and `linux-x86_64` for the signed AppImage built
+in WSL (see [linux.md](linux.md)). The .deb and .rpm are published alongside but
+are not updater targets: those installs open the releases page instead, like
+portable Windows copies. When publishing more architectures or operating
+systems, merge their platform entries into one `latest.json` before uploading it.
`package.cmd` still builds portable binaries without bundling, so it does not
need the signing key. Direct installer builds (`npm run tauri -- build`) require