A desktop media app for Windows, macOS, and Linux.
Browse, organize, and play media from sources you add.

About

Nuvio Desktop is a media client for browsing metadata, managing collections and watch progress, downloading media, and playing streams from user-installed extensions or user-provided sources.

Installation

Download the latest desktop build from GitHub Releases.

Release packages are provided for supported desktop platforms:

• Windows: MSI installer
• macOS: DMG installer
• Linux: DEB package, when available

Development

git clone https://github.com/NuvioMedia/NuvioDesktop.git
cd NuvioDesktop

Run from source:

./gradlew :composeApp:run

On Windows PowerShell:

.\gradlew.bat :composeApp:run

Build a release package for the current host:

./gradlew :composeApp:packageReleaseDistributionForCurrentOS

Platform-specific packaging:

# Windows
./gradlew :composeApp:packageReleaseMsi --rerun-tasks

# macOS
./scripts/build-macos-release-dmgs.sh --package-only

# Linux
./gradlew :composeApp:packageReleaseDeb

Project Structure

• composeApp/ contains the app code.
• composeApp/src/commonMain/ contains shared UI, features, repositories, and platform-agnostic logic.
• composeApp/src/desktopMain/ contains desktop-specific integrations.
• composeApp/Configuration/DesktopVersion.properties contains the desktop release version and build code.

Versioning

Desktop versions are set in composeApp/Configuration/DesktopVersion.properties.

VERSION_NAME=0.1.1-alpha
VERSION_CODE=1

Use the version helper when changing desktop release versions:

./scripts/set-version.sh --desktop 0.1.2-alpha --desktop-code 2
./scripts/set-version.sh --show

Legal & DMCA

Nuvio functions solely as a client-side interface for browsing metadata and playing media provided by user-installed extensions and/or user-provided sources. It is intended for content the user owns or is otherwise authorized to access.

Nuvio is not affiliated with any third-party extensions, catalogs, sources, or content providers. It does not host, store, or distribute any media content.

For comprehensive legal information, including our full disclaimer, third-party extension policy, and DMCA/Copyright information, please visit our Legal & Disclaimer Page.

Built With

• Kotlin Multiplatform
• Compose Multiplatform
• Kotlin
• Compose Desktop packaging
• Native desktop player integrations

Star History