Skip to content

AIoMetadata Setup

Prefer to watch instead of read? See the video walkthrough — it covers this whole flow end-to-end.

Import the pre-built configuration, add your API keys, then install the generated addon URL in Nuvio. The config enables 160 catalogs for streaming services, franchises, anime, ratings lists, and more. It also includes:

  • MCU, DC, and Star Wars chronological order catalogs
  • Full anime support via MyAnimeList and AniList
  • AI-powered search using Gemini
  • Live ratings from MDBList

Step 1 — Get your API keys

Before importing, grab the main keys you'll need. Open each guide in a new tab:

Key Guide Required?
TMDB Get TMDB key → Yes
MDBList Get MDBList key → Yes
Gemini Get Gemini key → Yes, unless you disable AI search
TVDB Get TVDB key → Optional

The imported config also includes fields for RPDB and Trakt. RPDB is already set to the free token. Trakt is optional unless you plan to connect Trakt lists.

TVDB is optional

Some public AIoMetadata instances already provide TVDB access. If yours does, you can leave the TVDB field blank.

Step 2 — Download the config

Download aiometadata-config.json →

Save as .json

If your browser still opens the file in a new tab, right-click the button and choose Save Link As. Make sure the file saves as aiometadata-config.json — not .txt. The import will fail if the extension is wrong.

Step 3 — Import into AIoMetadata

Choose one of the public AIoMetadata instances below. If one is slow or down, use another one, but try to stick with the same instance after you save because your configuration is stored there.

Instance Link
ElfHosted Open AIoMetadata →
Viren Open AIoMetadata →
Midnight Open AIoMetadata →
Fortheweak Open AIoMetadata →
Forthewizards Open AIoMetadata →

Which one should I use?

Start with ElfHosted if you want the most recognizable host. If it feels slow, pick Midnight or Fortheweak. The setup steps are the same either way.

  1. Go to the Configuration tab
  2. Scroll down to Import & Export and click Import Configuration
  3. Select the aiometadata-config.json file you just downloaded

Import Configuration button

The 160 catalogs and all settings will load automatically.

Step 4 — Add your API keys

The imported config ships with placeholder keys. You'll replace each one in the configure page. All API keys live on the Integrations tab — open that tab first, then work down it section by section.

Save as you go

The page does not auto-save. Each time you paste a key, scroll to the bottom and click Save Configuration before moving on, so you don't lose progress if the tab refreshes.

TMDB (required)

  • Tab: Integrations
  • Section: TMDB Settings (near the top)
  • Field: TMDB API Key
  • What to paste: the 32-character v3 key from Get TMDB key → (looks like a1b2c3d4...).
  • This drives posters, backdrops, plot summaries, cast, and the bulk of metadata. Without it, most catalogs will be empty.

MDBList (required)

  • Tab: Integrations
  • Section: MDBList Settings
  • Field: MDBList API Key
  • What to paste: the key from your MDBList account page — see Get MDBList key →.
  • Powers IMDb / Rotten Tomatoes / Metacritic / Letterboxd rating badges and any MDBList catalogs in the bundle.
  • Tab: Integrations
  • Section: AI Search (sometimes labeled Gemini / AI Settings)
  • Field: Gemini API Key — paste the AIza… key from Get Gemini key →.
  • If you don't want AI search: toggle Enable AI Search off in the same section instead of pasting a key. The rest of the config still works fine.

TVDB (optional)

  • Tab: Integrations
  • Section: TVDB Settings
  • Field: TVDB API Key
  • What to paste: the v4 key from Get TVDB key →, or leave it blank.
  • Many public AIoMetadata instances already include shared TVDB access — if catalogs work without your own key, you don't need to add one.

RPDB (leave the default)

  • Tab: Integrations
  • Section: RPDB Settings
  • Field: RPDB API Key
  • What to paste: nothing — leave the pre-filled value t0-free-rpdb in place. That's the shared free token. Only replace it if you have your own paid RPDB key.

Trakt (optional)

  • Tab: Integrations
  • Section: Trakt Settings
  • Field: Trakt Client ID (and sometimes Client Secret)
  • What to paste: nothing, unless you plan to connect Trakt lists or watchlists. The bundled config does not depend on Trakt by default.

Only paste — don't change other fields

Stick to pasting keys into the fields above. Don't toggle other options in the Integrations tab unless you know what they do — many of them change which catalogs the bundle expects to find.

Step 5 — Save and install

  1. Click Save Configuration (or Save & Install)
  2. Save the UUID and password AIoMetadata gives you
  3. Copy the generated addon URL
  4. Add it on the Nuvio website: nuvioapp.space/account → Addons
  5. Paste the URL and install it on the profile you use for collections

Do not lose the UUID and password

Your AIoMetadata configuration is stored on the public instance you chose. The UUID and password are what let you reopen or move that setup later.