Skip to content

WebDAV: media provider configuration

Requires v6.0+

Connect Symfonium to your WebDAV servers to play, cast, and download music for offline listening.

Open Settings → Manage media providers → Add media provider and choose WebDAV.

Enter the full Server URL, including the protocol, any custom port, and the path containing your media. For example: https://webdav.example.com:5006/Music/.

Enter your Login and Password, review the artwork options, then press Add to connect and scan that location. Basic and Digest authentication are supported.

Use the WebDAV endpoint provided by your server, including its path:

  • Nextcloud: https://example.com/remote.php/dav/files/username/Music/
  • ownCloud: https://example.com/remote.php/dav/webdav/Music/

Replace the hostname, username, and media folder with your own values.

After adding the provider, open it from Settings → Manage media providers and choose Edit. In Folders, press Add folder and enter another path on the same server.

Use the complete WebDAV path, including any endpoint prefix. For example, add /remote.php/dav/files/username/Audiobooks/ for an audiobook folder on Nextcloud, or /Audiobooks/ when that folder is directly under your server’s WebDAV root.

Folders card with no folder selected and an Add folder buttonAdded folder with Music and Audiobook media type choices and a remove button

Choose Music or Audiobook for each folder. Press the × beside a folder to remove it from the selection. Keep at least one folder.

Press Update to save the folder selection. The edit screen also lets you change the IP or hostname, Port, Login, and Password.

If setup fails repeatedly, use the support card to collect logs. Press Enable, then try adding the provider again to reproduce the error.

Support card with an Enable button for debug logging

After the error appears, press Send and follow the prompts to upload the logs with a description of the problem.

Support card with a Send button to submit logs

After adding the provider, open Settings → Manage media providers, select it, and choose Edit. Change its Display name and folders, or review its connection and authentication details. Press Update to save. The provider must be online so Symfonium can test the changes.

Clear tag cache setting in Symfonium

Clear the cached tags if you have changed metadata in your files and a normal sync does not detect the changes. All files will need to be scanned again during the next sync, which takes time and uses network data.

Wi-Fi only setting in Symfonium

Only communicate with this provider when the device is connected to Wi-Fi.

Scrape additional artist metadata setting in Symfonium

Retrieve supplementary artist images and biographies from online sources. When enabled, Clear scraped data lets you remove previously scraped artist data.

Prefer track thumbnail setting in Symfonium

Use each track’s artwork when available instead of the album artwork. This is useful for compilations with different track images, but makes synchronization slower.

Generate missing thumbnails from songs setting in Symfonium

Generate artist and genre images from track artwork when no image is available.

Automatic image cache setting in Symfonium

Cache all media images on your device after each sync. This uses additional storage and battery, especially with large libraries.

Automatic media offline cache setting in Symfonium

Cache media for offline playback after each sync. This can use substantial storage, network data, and battery. See Offline media cache and downloads for the available caching options.

Automatic playlist import setting in Symfonium

Automatically import M3U and PLS files found during synchronization as read-only playlists, ignoring duplicates. See Import and sync media provider playlists for playlist paths and update behavior.

Tag ratings as user ratings setting in Symfonium

Treat ratings imported from file tags as user ratings instead of scraped ratings.

Artist tag as display artist setting in Symfonium

Use the raw Artist tag as the display artist when present instead of building it from the parsed list of artists.

Ignore explicit tags setting in Symfonium

Do not import explicit-content markers from file tags.

Ignore MusicBrainz IDs setting in Symfonium

Ignore MusicBrainz IDs from parsed tags. This can prevent artist or album splits caused by inconsistent IDs.

Prefer Year tag setting in Symfonium

Use the raw Year tag when present instead of extracting the year from full date tags.

Encoding time as date added setting in Symfonium

Use the encoding-time tag as the date added when present, falling back to file dates when it is missing.

Artist/album artist tag separators setting in Symfonium

Press Set to configure the separators used to split artist and album artist values.

Genre tag separators setting in Symfonium

Press Set to configure the separators used to split genre values.

MBID tag separators setting in Symfonium

Press Set to configure the separators used to split MusicBrainz ID values. See Symfonium custom tag parser for supported tags and separator behavior.

Split albums by setting in Symfonium

Choose which fields must match for tracks to belong to the same album, such as Folder, MusicBrainz ID, and Album version.

Scrobble as advertisement setting in Symfonium

Mark media played from this provider as advertisements so compatible scrobbler apps can ignore them.

Exclude tracks shorter than setting in Symfonium

Set a minimum track duration to filter out unwanted short media.

Exclude folders setting in Symfonium

Under Exclude tracks from those folders and their subfolders, press Add folder to exclude paths from synchronization. This removes those folders from the library without deleting files from the provider. When available, you can also restore files previously hidden from Symfonium here.

Clear playback history setting in Symfonium

Clear the playback history associated with this provider.

See Symfonium custom tag parser for supported tags, file formats, separators, and metadata behavior.

Chromecast and UPnP renderers cannot send the authentication headers required by the WebDAV server. Symfonium proxies the media when casting, which uses additional network data and battery on your phone.