winget install --id=FengZeng.Soia -e High-performance cross-platform media player, with HDR/Dolby Vision, WebDAV/DLNA/SMB streaming, dual subtitles, and modern UI.
Soia
š¬ HDR & Dolby Vision Ā· š WebDAV + DLNA + SMB Streaming Ā· š„ Cross-platform
ā¬ļø Download Latest Release Ā· š Report a Bug
> A modern mpv frontend focused on performance and clean design.
Soia is a high-performance video player built on mpv, designed for smooth playback of everything from local Dolby Vision content to remote WebDAV, DLNA, and SMB streams ā all in one fast, elegant, cross-platform experience.
Dolby Vision is not currently supported on Linux
Download from the release page.
On Windows, you can also install it with WinGet:
winget install soia
Or you can build it yourself. Support macOS 13+, Windows, and Linux.
Linux builds have been tested on Ubuntu and Fedora Wayland sessions (X11 is not currently supported).
Q: macOS says "Soia is damaged and can't be opened" or cannot verify it is free of malware.
A: This happens because the app is not yet signed with an Apple Developer ID certificate, so macOS may block it on first launch.
Easy fix (recommended):
If that doesn't work, run:
sudo xattr -r -d com.apple.quarantine /Applications/Soia.app
You can also go to System Settings -> Privacy & Security and click "Open Anyway" (it appears after a blocked launch attempt).
The app is open-source and its code is publicly available for anyone to inspect.
media.db) + JSON state filesPrerequisites
Ensure you have the following installed:
Setup
# Automatically prepares runtime libs
pnpm install
Run
# Launches with auto-injected library paths
pnpm tauri dev
Common release build commands:
pnpm bundle:mac:release
pnpm bundle:linux:release
pnpm bundle:win:release
Space: play/pauseLeft / Right: seek backward/forward (step from settings)I: toggle playback info panelApp data is stored in Tauri's local app data directory and includes:
media.db: default playlist entries, playback history, and local installation/device/sync metadatastate.json: UI state and settings (for example active panel, multiple-playlist metadata, and preferences)network_connections.json: saved network connectionsthumbnails/: captured artwork for Now PlayingSaved network credentials are currently persisted in network_connections.json as plain text. Avoid using sensitive production credentials on shared machines.
glib-2.0 / gdk-3.0 / *.pc not found, install the Ubuntu deps:sudo apt update
sudo apt install -y \
build-essential \
curl \
wget \
file \
libgtk-3-dev \
libayatana-appindicator3-dev \
librsvg2-dev \
pkg-config \
libwebkit2gtk-4.1-dev
Linux runtime note: current bundle targets Ubuntu Wayland sessions only; launching under pure X11 is not supported.
If build fails with Cannot find libmpv, run:
pnpm setup:libs
If pnpm setup:libs fails, confirm release access to:
https://github.com/FengZeng/mpv/releases/tag/v0.41.0-r15MPV_RELEASE_ASSET_URL to a direct asset URL and retry.If Linux/Windows bundle scripts report missing runtime manifest, generate it on the target platform:
pnpm sync:runtime:linux
pnpm sync:runtime:win
mpv + dependencies directory for dev testing, use:pnpm setup:libs /absolute/path/to/mpv-bundle
Soia is an independent project developed and maintained by @FengZeng.
While development is driven independently, issues and feedback are actively reviewed and addressed whenever possible.
If you find Soia useful, consider giving it a ā Star ā it helps the project grow and reach more users.
This project is licensed under the GNU General Public License v3.0 only (GPL-3.0-only).
See LICENSE for the full text.