Configuration

Media Sources

The media widget's browser spans every source you've connected: Home Assistant media, your Plex servers, and SMB network storage (NAS). You pick something to play from one place — where it ends up depends on the source.

Open the browser from a media widget and you get a tab for each source — Music, Home, Plex, and NAS. Plex and NAS are set up once in Settings → Media; after that they appear in the browser ready to play.

Home Assistant media

The Home tab browses Home Assistant's own media tree — the same media_source browser the Home Assistant app shows. Flux starts at the root and lets you tap into folders; playable items show a play button.

What it shows — whatever Home Assistant exposes as a media source: your Local Media folder, TTS, camera clips, and any media integrations you've added.
NAS mounted in Home Assistant — if your NAS is mounted inside Home Assistant (for example as a media directory), it appears here as part of the Home Assistant tree, not under the separate NAS tab.

Two ways to reach a NAS A share mounted into Home Assistant shows up under Home and plays on your speakers. The same files reached directly over SMB show up under NAS and play on this device. Same files, different path, different destination.

Plex

Plex uses the documented plex.tv sign-in — no account password is ever entered in Flux. Set it up in Settings → Media → Plex:

Tap Sign in to Plex. Flux requests a short 4-character code from plex.tv.
Enter that code at plex.tv/link (or tap Authorize in Plex, which opens Plex with the code already filled in). Flux polls until you authorize, then stores only the access token in your Keychain.
Flux discovers the servers on your account. Pick one (Flux prefers a local connection when available).
Browse the server's libraries — Music, Movies, TV — down through artists, albums, shows, and seasons to individual tracks, movies, and episodes.
Tap a playable item to play it. Flux builds a direct stream URL (your token appended) and hands it to the widget's speakers.

Where Plex playback goes From a media widget's browser, Plex plays on the widget's selected speakers — Flux passes the stream URL to media_player.play_media (content type music for audio, video for movies/episodes/shows/seasons). The standalone browser in Settings plays Plex in a built-in player on this device.

NAS (SMB)

Flux talks to SMB file servers directly. Set one up in Settings → Media → Network Storage:

Discover servers on your network. Flux browses Bonjour for SMB, AFP, and NFS file-sharing services and lists what it finds. Tap one to pre-fill its address.
Or add manually: enter the host or IP, the SMB port (default 445), the share/volume name, and a username and password. (Leave the credentials empty for a guest / public share.)
The password is stored in your Keychain, synced across your devices — never in plain settings. Only the non-secret connection info is saved.
Browse: pick a saved server, then a share, then drill through folders. Flux marks audio and video files as playable.
Tap a media file to play it.

SMB only for browsing Discovery finds SMB, AFP, and NFS boxes, but Flux reads files over SMB. Use the SMB share for browsing and playback.

Where it plays

The destination depends on the source — this is the part worth remembering:

Source	Plays on	How
Home Assistant media	The widget's selected speakers	`media_player.play_media` with the media's content id.
Plex	The widget's selected speakers	Plex stream URL → `media_player.play_media`.
NAS (SMB)	This device	Flux downloads the file to a temp location and plays it locally (AVPlayer). A speaker can't read SMB.

Notes

The speaker has to reach the Plex stream URL. Flux hands the chosen server connection's URL to the speaker, so that speaker must be able to reach your Plex server on the network. A local-only Plex address won't work for a speaker that lives elsewhere.
SMB can't go to a speaker. NAS files always play on this device — there's no way to send an SMB path to a media_player. If you want a NAS file on your speakers, mount the share inside Home Assistant and play it from the Home tab instead.
NAS playback is a whole-file download. Flux fetches the file to a temp location before playing — fine for audio; large video is a later streaming refinement.