ZiiX.TV looks up every title in TMDB (The Movie Database) or TheTVDB and fetches its posters, backdrop, description and more.
What is fetched
- Title, original title, year, description, rating, running time and genres.
- Poster and backdrop, the title’s logo and a YouTube trailer.
- Up to 20 cast members, directors (creators for series), studio or network.
- Age rating, used for age limits per user.
- Release date and tagline.
- The film’s collection, so all Bond films can be shown together.
- For series: each episode’s name, description, air date and picture.
Pictures are stored on your server, in the config folder.
TMDB or TheTVDB
Each library has its own source, chosen when you add it and changeable later:
- TMDB is usually best for films, and the only source with ratings.
- TheTVDB is often best for series: episode names and the order of seasons as broadcast.
Changing the source looks up every title in the library again. What you have watched is kept.
Language
ZIIX_METADATA_LANGUAGE in .env sets the language for titles and descriptions for the whole server, for example en-US, da-DK, de-DE, fr-FR or es-ES. When a description does not exist in that language, the English one is used. Age ratings follow the country in the code, with the US rating as fallback.
Through ZiiX.TV, or with your own keys
You need no keys of your own. Without them, your server fetches metadata through ZiiX.TV’s metadata service at metadata.ziix.tv, using its license. The pictures themselves come straight from TMDB and TheTVDB.
- During the trial, confirm your email address under Settings → Server to use the metadata service. There is one trial per email address.
- With a license, it just works.
If you would rather talk to TMDB or TheTVDB directly, set your own keys in .env and restart:
# Free from themoviedb.org: Settings → API
ZIIX_TMDB_API_KEY=your-key
# From thetvdb.com: Dashboard → API Keys
ZIIX_TVDB_API_KEY=your-key
# Only for a key bought as a subscriber
ZIIX_TVDB_PIN=your-pin
The two sources are separate: you can use your own TMDB key and ZiiX.TV for TheTVDB, or the other way round. Settings → Server shows where metadata comes from.
How matching works
ZiiX.TV searches for the title and year read from the file name, and scores each result: the same title, the same year and the same numbers (“Part 2”, “Alien 3”) count most. The best result is chosen. If nothing is found with the year, it searches again without it.
A title that is not found is marked unmatched and is not looked up again on every scan. Look up unmatched titles again under Settings → Server tries them all once more, for example after renaming files. The filter Unmatched in a library lists them.
Matched titles keep their details; new seasons of a series get their episode details as they appear.
Fixing a wrong match
- Open the title and choose Fix match.
- ZiiX.TV searches for the current title straight away, and shows the file or folder the title was made from. Change the search or add a year if needed.
- Pick the right result. The details, pictures and episodes are fetched again; what you have watched is kept.