AI media harness for planning, generating, and editing locally
TypeScript
Document the Linux app
Bitti4c1cdd2ecdc0
diff --git a/README.md b/README.mdindex 86a711e..a13e933 100644--- a/README.md+++ b/README.md@@ -45,6 +45,10 @@ Slopus brings an AI assistant, a scene generator, reusable references, a timelinLocal 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 computerWorkers 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.mdindex 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 improvementsdiff --git a/docs/linux.md b/docs/linux.mdnew file mode 100644index 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.mdindex 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 anerror 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 notneed the signing key. Direct installer builds (`npm run tauri -- build`) require