Closed Alpha

FluxPlay is currently in Closed Alpha. This documentation is a work in progress and may be incomplete or out of date. Features, UI, and APIs are subject to change without notice. For access inquiries, please contact [email protected].

METADATA

FluxPlay enriches your media with information from 20+ providers including titles, descriptions, artwork, cast information, and ratings.

Metadata Providers

Movies & TV

TMDB

Primary source🔑

IMDb

IDs & ratings

OMDb

RT, Metacritic🔑

MDBList

Aggregated scores

Fanart.tv

Logos, clearart🔑

YouTube

Trailers

Books & Comics

AniList

Manga/Anime

MyAnimeList

Manga fallback🔑

ComicVine

Western comics🔑

Google Books

Literature

Music & Audio

MusicBrainz

Primary source

ListenBrainz

Scrobbling

Last.fm

History & art🔑

Spotify

Modern albums🔑

Deezer

Covers

🔑 = Requires free API key

Provider Routing

FluxPlay Self-Hosted libraries keep the ordered provider chain for each library. When FluxPlay Cloud cache is enabled, Cloud first filters providers through its media-group matrix and then honors the ordered hints supplied by self-hosted.

Library Order

1. Each library keeps its own metadata and image provider order
2. Movies, TV, books, and music can use different chains
3. Local credentials remain the fallback path when Cloud misses

Cloud Matrix

1. Tabs: Movies, TV Shows, Books, Music
2. Sections: Metadata Providers and Image Fetchers
3. Each provider row is enabled or disabled only

Request Flow

1. Cloud cache checks the allowed providers for that media group
2. Cloud tries providers in the order supplied by self-hosted
3. If Cloud is unavailable or misses, self-hosted falls back locally

Configure library order in self-hosted admin settings. Configure Cloud matrix toggles in FluxPlay Cloud under Servers -> Providers.

Images & Artwork

Image Type	Description	Where Displayed
Poster	Primary vertical artwork	Library grids, detail pages
Backdrop	Wide horizontal artwork	Detail page backgrounds
Logo	Transparent title treatment	Overlaid on backdrops
Clearart	Transparent character art	Detail pages (optional)
Thumb	Episode/track thumbnails	Episode lists, now playing
Profile	Cast/crew photos	Cast sections

Ratings Display

TMDB

User votes

Percentage / stars

IMDb

User rating

x.x / 10

Rotten Tomatoes

Critics & Audience

Tomatometer

Metacritic

Critics aggregate

0-100 scale

Local Overrides

Local metadata files always take priority over online providers.

NFO Files

Movies & TV

movie.nfo

tvshow.nfo

[filename].nfo

ComicInfo.xml

Comics & Manga

Inside archive

Sidecar file

OPF Files

Books

content.opf

metadata.opf

Manual Identification

Fixing Wrong Matches

1Navigate to the incorrectly identified item
2Open the item's detail page
3Click the three-dot menu (or right-click)
4Select "Identify" or "Fix Match"
5Search for the correct title
6Select the correct match and click Apply

Metadata Tips

Add the year to filenames for better matching accuracy
Use IMDb IDs in filenames for guaranteed correct matches
Refresh metadata periodically to get updated ratings and cast info
Add Fanart.tv API key for enhanced logos and clearart
Local images (poster.jpg, backdrop.jpg) override provider images