AIOMetadata
Community guides

COMMUNITY GUIDE

Collections

Build folders and rows from your catalogs, then export the layout to your app.

Find a fix ↗
Downloads

Quick start

  1. Prepare a source. In Catalogs, make sure the movie or show catalog you want is enabled. Save your AIO configuration.
  2. Open Collections. Choose Nuvio or Fusion at the top.
  3. Create a layout. Preview a Featured layout and import the parts you want, or create a collection with a folder and a catalog source.
  4. Check and save. Confirm that every folder has its intended sources, resolve any save issues, then save.
  5. Use it in your app. Export for your chosen app and import the file or supported link there. Saving in AIO alone does not update the app.

Choose your starting point

A ready-made layout to customize

Best place to startUse a featured layout

What you will buildImport one section, then adjust its folders and sources.

A small collection of your own

Best place to startBuild your own collection

What you will buildMovie Night with two folders, each connected to a movie catalog.

Titles displayed directly in Fusion

Best place to startCreate a normal catalog row

What you will buildA Trending Tonight row without a folder to open first.

A folder based on a provider collection or public list

Best place to startFind a provider source

What you will buildAttach a TMDB/TheTVDB collection or an MDBList list from the picker.

If this is your first layout, finish one small example and open it in your app before importing a large pack.

1. What are you building?

Illustration: Movie Night contains two folders, each with a catalog source. Save the design, export it, then import it into Nuvio or Fusion.

The builder arranges catalogs into a layout. The catalogs supply the movies and shows; the layout controls how people browse them.

TermWhat it meansExample
Catalog / sourceA list that supplies titles.TMDB Popular — Movie
FolderA tile that opens one or more catalog sources.Popular Movies
CollectionA named group of folders.Movie Night
RowA direct catalog row for Fusion, rather than a collection of folder tiles.Trending Tonight
JSONThe file format used to move the layout into an app or another builder. You do not need to write it yourself.Downloaded collection or widget file
ManifestThe addon description that tells the builder which catalogs and options are available.Your saved AIO addon configuration

A small first collection could be:

  • Movie Night — the collection.
  • Popular Movies — a folder using the TMDB Popular movie catalog.
  • Top Rated Movies — a second folder using the TMDB Top Rated movie catalog.

A folder's cover is artwork for that folder, not the posters for every movie inside it.

2. Open the builder and choose your app

  1. Open your AIOMetadata configuration and log into your saved setup.
  2. Open Catalogs.
  3. Click Collections to open Collections & Widgets.
  4. Choose Nuvio or Fusion at the top, depending on where you will use the layout.

Use Build to edit a layout, Featured to browse ready-made examples, and Export & share when you are ready to use or share it.

FeatureNuvioFusion
Collections with folder tilesSupportedSupported
Classic catalog rowsOmitted from exportSupported
Nuvio presentation and artwork settingsUsed by NuvioIgnored by Fusion
Nested foldersTheir catalogs are flattened into the parent folder on exportTheir catalogs are flattened into the parent folder on export

Nested folders are labeled “Jellyfin only.” The builder says Jellyfin clients can open them as folders within folders. This guide concentrates on the Nuvio and Fusion export workflow.

Featured layouts provide ready-made folders, sources and artwork. You can preview them before importing anything.

Featured collection gallery

Examples available when this guide was written:

Featured layoutWhat to expect
Starter KitAwards, decades, directors, genres and streaming services.
Ninja StreamsTrending titles, services, genres, decades, runtime, studios and networks. Includes classic rows.
Callandt95Trending/watchlist rows, services, movie genres and film franchises.
SnoakPopular titles, discovery, service top tens, genres and decades.
TVGenieDaily picks, movie/show categories, decades and networks.
Unified Media ExperienceA larger selection of services, genres, people, studios, awards and lists.

Some featured layouts use adapted sources. Read their description: an original Trakt list may have been replaced with an MDBList counterpart or another available source. Provider access and required keys still matter.

See what a complete layout looks like

TVGenie Movie Categories: a ready-made layout in the featured preview

Read this example from the outside in: Movie Categories is the collection; Daily Picks, Latest Movies and Trending Movies are folder tiles. The images identify the folders. The catalog sources attached to each folder determine the titles that open inside it.

This is the builder's preview of a complete featured design, before import. Use it as a visual reference; the final app can arrange the same layout differently.

Example: import only TVGenie's Movie Categories

  1. Find TVGenie in Featured, then click Preview.
  2. Click the entry names to inspect the different parts of the layout.
  3. To keep only one part, click None, then tick Import Movie Categories.
  4. Check that the button says Import 1 of 3, then click it.
  5. Review the import summary and choose how to combine it with your current draft.
Only Movie Categories selected for import

The selection checkbox controls what gets imported. Selecting an entry to preview it is a separate action.

Import choiceWhat it does
MergeCombines matching IDs and skips catalogs you already have.
Add as newKeeps both copies rather than merging them.
OverwriteDiscards the existing builder design in favor of the imported one. Check carefully before choosing this.

The summary may say catalogs are rebuildable. That means the file includes definitions for catalogs missing from your setup. The builder adds the needed ones when you apply/save. If you remove parts of the design first, only the remaining referenced catalogs need to be added.

Start with one section. Large featured packs can add many catalogs; you do not need to import the whole pack.

4. Understand the editor

The collection editor with a featured movie layout
  • Left: your collections and folders. Select an item to edit it. Use drag handles to change their order.
  • Middle: settings for the selected collection, folder or row.
  • Right: a live preview of the layout.
  • Design / Preview: switch between editing and inspecting the selected entry.
  • Status and issue indicator: show whether you have a draft and whether anything needs attention before saving.

The preview is approximate. It shows your artwork, shapes, titles and order, but spacing and card sizes can differ in the actual app. It is not a playback test.

The screenshots show “1 issue to fix” because the demonstration draft has no provider keys. In your setup, expand the issue indicator to read the actual reason.

5. Build your own collection

A. Create the collection and first folder

  1. Open Build and click Collection. In an empty builder you may also see New collection.
  2. Set Title to Movie Night.
  3. Click Add folder.
  4. Set Folder title to Popular Movies.
  5. Choose a tile shape: Poster, Wide or Square.
Creating Movie Night with a Popular Movies folder · Focused view; click for full screenshot.
2 Name the collection.3 Add a folder.4 Give the folder its title.

A new collection is not yet in your list until you click Add collection. Discard abandons that new entry.

B. Give the folder a source

  1. Click Add catalog in the folder's Sources section.
  2. In Your catalogs, find TMDB Popular with type movie.
  3. Tick it, then click Add 1.
  4. Check that it appears under Sources.
  5. Click Add collection when the new collection is ready.
Selecting the TMDB Popular movie catalog · Focused view; click for full screenshot.
2 Find the movie catalog in Your catalogs.3 Tick the source, then choose Add 1.

The picker lets you search, filter by media type and select several catalogs at once.

You can also use the provider tabs shown above. See Find a source directly from a provider for the steps.

Choose the correct media type: TMDB Popular — movie and TMDB Popular — series are different catalogs.

C. Add a second folder

Select Movie Night, click Add folder, and repeat the process:

Folder titleCatalog sourceSuggested tile shape
Popular MoviesTMDB Popular — movieWide
Top Rated MoviesTMDB Top Rated — movieWide

This is an example layout, not a required naming scheme. You can use your own lists instead.

An empty folder can still export, but it opens empty. Add at least one source if you want it to show titles.

D. Find a source directly from a provider

The Add catalogs picker pictured above has four tabs: Your catalogs, MDBList, TheTVDB and TMDB. Your catalogs reuses sources already in your configuration; the provider tabs let you find additional sources without leaving the builder.

  1. Select the folder that should receive the source, then click Add catalog.
  2. Choose TMDB or TheTVDB to find collections, or MDBList to search for lists.
  3. Enter a specific name. For example, try The Lord of the Rings when looking for a film collection. This is a search example, not a guarantee of a particular result.
  4. Inspect the results and select the collection or list you actually want. Check its media type and any available description; similarly named lists can have different contents.
  5. Add the selection, then confirm that it appears in the folder's Sources.
  6. Review any catalog additions or required provider access shown by the builder. Save the layout, export it, and import it into your app.
Source tabChoose it forCheck before adding
Your catalogsReusing an enabled catalog you already configured.Correct movie/series type and filters.
TMDBFinding a TMDB collection.The intended franchise or collection, rather than assuming every title search is a collection.
TheTVDBFinding a collection available through TheTVDB's picker.The result's contents and supported media type.
MDBListSearching for a list that matches your theme.List identity, contents and any required provider access.

No useful results? Try the full name rather than an abbreviation, check provider access, and confirm you chose the right tab. If you already have a supported list URL, Quick Add is another route.

E. Check the finished Movie Night example

Before exporting, select Movie Night and confirm this structure in the editor:

CollectionFolder tileAttached sourceExpected result when opened
Movie NightPopular MoviesTMDB Popular — moviePopular movie titles.
Movie NightTop Rated MoviesTMDB Top Rated — movieTop-rated movie titles.

You should have one collection containing two folders, with one source under each. The preview should show two folder tiles; opening those folders in the app should show their respective titles. Folder artwork is optional for this first check.

Use the complete featured preview above to understand the visual structure. The Movie Night table is the expected result of the manual exercise, not a screenshot from a tested client import.

6. Customize folders and collections

Folder settings

Folder name, tile shape and cover controls
SettingWhat it changes
Folder titleThe name of the tile.
Tile shapePoster is tall, Wide is landscape, Square is square. Fusion calls this Layout.
Cover image URLThe artwork displayed on the folder tile. Use an image address your viewing device can reach.
Hide title on the folderHides the text label on that folder. Useful when the artwork already contains the name.
Sources / Add catalogThe catalogs opened by the folder. More than one can be attached.
Folders insideAdds nested folders for Jellyfin; Nuvio/Fusion exports flatten their catalogs into the parent.
Folder sources and the Jellyfin-only nesting option

The catalog source supplies the contents; these controls arrange how it is attached to the folder. Use the source arrows or drag handles to change source order. Its actions menu includes Rename catalog and Remove from folder.

Which artwork goes where?

Think about the part of the layout you are decorating before choosing an image.

Artwork fieldBelongs toIntended use
Cover image URLFolderThe tile you select to open that folder. For example, a Popular Movies cover identifies that folder.
Backdrop image URLCollection, under Nuvio presentationBackground artwork for the whole collection.
Hero backdrop URLFolder, under Nuvio artworkArtwork for the folder's hero presentation in a supporting app.
Title logo URLFolder, under Nuvio artworkA graphic title/logo for the folder's presentation.
Focus GIF URL / Play focus GIFFolder, under Nuvio artworkOptional animated artwork when supported by the app.
Hero video URLFolder, under Nuvio artworkOptional video for the hero presentation when supported.

Example: Movie Night can have a collection backdrop, while Popular Movies and Top Rated Movies each have their own covers. Those covers do not replace the posters of the movies inside the folders.

The featured preview shows labeled folder covers such as Daily Picks and Latest Movies. Use the folder settings screenshot to locate the cover control. Start with covers; add optional Nuvio artwork after the basic layout works. Fusion ignores Nuvio-specific presentation settings.

Nuvio presentation

These collection controls are grouped under Nuvio presentation. Fusion ignores them.

SettingPurpose
Backdrop image URLA background image for the collection.
Folder view modeChoose Tabbed grid, Rows, or Follow layout.
Pin to topRequests that the collection be pinned at the top in Nuvio.
Focus glowTurns the focus glow on or off.
Show “All” tabControls whether the collection includes an All tab.

Show Nuvio artwork opens optional folder artwork fields: Cover emoji, Focus GIF URL, Hero backdrop URL, Hero video URL, Title logo URL, and Play focus GIF. Leave them blank if you only want a simple tile. Their actual appearance depends on the app.

The collection-level Hide title control is labeled Fusion only. It is separate from hiding a folder's title.

7. Fusion example: a normal catalog row

Use a Row when you want a catalog displayed directly, instead of a tile that opens a folder.

  1. Select Fusion, then click Row.
  2. Name it Trending Tonight.
  3. Click Pick catalog and choose your trending movie catalog.
  4. Adjust Items shown, aspect ratio and card size.
  5. Optionally enable numbered rankings or change badges.
  6. Click Add row.
A new Fusion row and its approximate preview
Row settingMeaning
Items shownThe item count requested for the row.
Cache TTL (seconds)The row's cache duration setting. For example, 1800 seconds is 30 minutes.
Aspect ratioPoster, Wide or Square cards.
Card sizeThe card-size preference for the row.
Numbered rankingAdds 1, 2, 3… to the cards.
Hide titleHides the row heading.
Provider badges / Rating badgesControls those badges in the row.

The screenshot is an unfinished row before its catalog is selected. Fusion drops rows without a catalog. Nuvio omits classic rows entirely.

8. Save, export and use your layout

There are two separate jobs: save the design in AIO, then import it into the viewing app.

ActionWhat it doesWhat to do next
Add collection / Add rowAdds the new entry to the builder design.Review the entry, then save the configuration.
Apply onlyApplies the design to the current configuration without saving it to the server.Save the configuration when you are ready to keep it on the server.
SaveStores the configuration on the server.Export for the app you use.
DownloadDownloads the selected export as a JSON file.Import that file into the target app.
Import in Nuvio or FusionLoads the exported layout in that app.Open a folder or row to check the contents.
  1. Expand any issues to fix and resolve them.
  2. Click Save to store the configuration on the server. Apply only keeps the design in the current configuration without saving it to the server.
  3. Select the correct target: Nuvio or Fusion.
  4. Open Export & share.
  5. For your own app, leave Make a copy for someone else off. Use Download to get the JSON file, or use the import link if your app supports it.
  6. In the target app, open its collection/widget import feature and import the file or supported link.
  7. Check the layout and open a folder to verify that its sources load.

Updating an existing layout

  • Nuvio: editing an imported collection preserves its ID, so re-importing updates the matching collection. Building a new collection creates a new ID and adds another collection.
  • Fusion: importing adds widgets rather than matching existing ones. The builder advises removing the widgets you changed in Fusion, then importing only those replacements. They return at the end, so you may need to reorder them.

Image caching

Serve images through this server makes exported artwork URLs use AIO's image cache. The original addresses in the editor remain unchanged. This may help with slow image hosts, but the viewing device must be able to reach your AIO server.

Export dialog with Make a copy for someone else enabled
  1. Open Export & share.
  2. Turn on Make a copy for someone else.
  3. Download that copy and review it for any private list names or custom image URLs you added.
  4. Share the sanitized file, not your personal addon or import link.
  5. The recipient opens Import JSON in their own AIO builder, then loads the file, pastes its contents or loads its link.
  6. They review the import summary, save their own setup, and export a personal copy for their app.

The sharing switch removes the personal addon link. It does not mean that every custom name or external URL you typed is suitable for public sharing. A share copy is intended to be imported into the recipient's builder first so their own addon link can be filled in.

10. Quick troubleshooting

Start with the symptom below. When testing, change one thing at a time and check the same folder again.

My folder is empty

  1. In the builder, select the folder and check Sources. An empty tile can export successfully.
  2. Confirm the catalog is enabled in Catalogs and has the correct media type.
  3. Check the list/provider itself and any required access or filters. If the source has no titles, adding artwork will not fix it.
  4. Save and re-import if you changed the source or layout.

I saved, but nothing changed in my app

  1. Check whether you clicked Save or only Apply only.
  2. Export for the correct app and import it there again.
  3. In Nuvio, edit the existing collection to preserve its ID. In Fusion, follow the replacement workflow to avoid duplicates.

I cannot save or cannot see a genre option

Expand the issue indicator. Resolve the specific problem it names, such as missing provider keys or capacity. If the builder is using a local draft, save the main configuration so it can read the real manifest. Do not paste somebody else's private manifest link to work around this.

My artwork is blank

Check the cover URL first: it should point to an image the viewing device can reach. A successful browser preview on one device does not prove another device can reach a private server. If using Serve images through this server, check that the app can reach AIO too.

Other problems

New collection is missing from the builder list
Click Add collection after creating it.
Source is wrong or unavailable
Check the folder's Sources and the builder's source indicator. Use your own saved configuration.
Fusion has duplicate widgets
Follow Updating an existing layout and import only the changed replacements.
Nuvio is missing a classic row
Classic rows are Fusion-only. Use a collection with folders for Nuvio.
Preview looks different from the app
The builder preview is approximate. Check the exported layout in the target app.
Images load slowly on repeat visits
See Caching & Warming for image routing, caching and warming checks.

A good first setup: one collection, two folders, one source per folder. Once that works in your app, add more sections or adapt a featured layout.

BEFORE YOU MOVE ON

Check your setup

  • Every folder has the intended sources.
  • The design is saved in AIOMetadata.
  • The exported layout is imported and opens correctly in your app.
Next guideCaching & WarmingPrepare artwork for smoother browsing.