Configuration
Streaming & Previews
Media preview generation and HLS streaming.
Swush generates previews and HLS streams for supported media types.
Preview generation
- Video and GIF previews generate a static PNG
- Preview jobs run asynchronously
- Previews are used throughout the vault UI
HLS streaming
HLS assets are generated for video/audio when enabled. Playback uses:
/hls/{slug}/Segments are stored alongside the playlist and served on demand.
Quality
Streaming quality respects user preferences. If media transcode is disabled, streaming uses original quality where possible.
Dependencies
- Ensure FFmpeg is installed on the server
- Allow enough disk for generated segments
Troubleshooting
- If
/hls/{slug}/returns 404, the stream is not ready yet - Confirm the background job runner is active