Samba (SMB v2/v3) - media provider configuration

Symfonium can connect to your Samba (SMB v2/v3) servers and play, cast and offline cache your music from it. (Requires at least Version 6.0)

This provider is currently in experimental state until more users have confirmed that it works with all the many different Samba servers.

Tags are parsed with Symfonium custom tag parser.
Tags are cached but extracting them will take some time and network ressources, it is recommended to add your provider when connected to wifi.

Add provider

The wizard support many ways to enter your provider information to be able to connect and will try to figure out the proper parameters.

  1. Ip or hostname

You should enter the name or the ip of the Samba server.
So if you access the media usually via \Server\Share\Folder you enter Server in that field.
Netbios names are supported.

  1. Share name

You should enter the name of the share that you want to access
So if you access the media usually via \Server\Share\Folder you enter Share in that field.

  1. Subdirectory

If your music data is in a subfolder you should enter it here to avoid scanning unrelated files.

So if you access the media usually via \Server\Share\Folder you enter **Folder ** in that field.


If you have problems configuring your provider press the Enable button in the support card, then try again to add your host.

After Symfonium shows the error message, press the send button to open your email client with attached logs and write a message so that I can help you.

All settings

Note: Please note that Symfonium’s tag parser caches tags to expedite future syncs. If you update your song tags and the app does not detect them, you can force a new sync by clearing the tag cache in the provider settings.

To access all available settings for a provider, you need to edit the provider after it has been added. (Settings / Manage media providers Settings - Manage media providers)

Wifi only

To prevent Symfonium from accessing the server when not connected to WiFi, please enable this option.

Scrape additional artists metadata

Try to download artists images and biography from online sources.

Automatic image cache

Enabling this option will cache all media images locally on your device after each sync. However, it can also use up storage space on your device and potentially drain your battery faster if you have a large library with many images. It’s recommended to use this option if you have enough storage space available on your device and don’t mind the potential battery drain. If you have limited storage or battery life, it may be better to disable this option.

Automatic media offline cache

Enabling this option will cache media files from selected libraries for offline usage after sync, allowing you to play your music even when you are not connected to the internet. However, this may consume a lot of storage and battery usage, so it is important to consider this before enabling this option.

Prefer song thumbnail

Will use each songs thumbnail in list instead of the album ones. Useful for compilations if each songs have a different image. Will require more storage cache and slower syncs.

Tag ratings as user ratings

Ratings imported from media tags are normally considered as scraped ratings, enable this option to consider them user ratings.

Split album by:

You can select how Symfonium split the albums. Each selected option must be equals for songs to be part of the same album.

Filter short tracks

You can select the minimum duration for a song to help filtering unwanted media.

Exclude folders

You can exclude sub folders from the sync to remove unwanted data.

Custom parser details

See [Wiki] Symfonium custom tag parser for all the documentation about Symfonium custom tag parser.


• SMB v1 is not supported as deemed insecure by many. Most servers support SMB v2 at least.
• Chromecast and UPnP do not support SMB so Symfonium will proxy the media when casting, using more battery and network.

1 Like