Orynivo Server

Orynivo Server

Orynivo Server is a headless ASP.NET Core service for Windows, Linux, and macOS. It scans local directories and exposes authenticated catalog, artwork, playlist, search, waveform, lyrics-cache, and audio-streaming endpoints.

Basic configuration

Edit the Orynivo section in appsettings.json:

{
  "Orynivo": {
    "ApiKey": "replace-with-a-random-key",
    "LibraryPaths": ["/music"],
    "ScanOnStartup": true,
    "ServerName": "Music Server"
  }
}

The default address is http://0.0.0.0:5280. Every endpoint except /api/health requires the API key.

Linux service

DEB and RPM packages install under /usr/lib/orynivo-server, use /etc/orynivo-server/appsettings.json, and run as the dedicated orynivo-server system user. Persistent data is stored under /var/lib/orynivo-server.

Desktop connection

Open Settings → Library → Orynivo Server, enter the server URL and API key, and test the connection. Remote directories and scans can be managed from the same dialog.

Remote rows are merged into the shared library views. Credentials remain in client configuration and credential-bearing stream URLs must never be stored in playlists, the playback queue, logs, or model-visible tool output.

Updates

Remote server updates are opt-in and use signed, hash-verified DEB/RPM bundles. See Updates-and-Releases.