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.
COMMUNITY GUIDE
Build folders and rows from your catalogs, then export the layout to your app.
Best place to startUse a featured layout
What you will buildImport one section, then adjust its folders and sources.
Best place to startBuild your own collection
What you will buildMovie Night with two folders, each connected to a movie catalog.
Best place to startCreate a normal catalog row
What you will buildA Trending Tonight row without a folder to open first.
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.
The builder arranges catalogs into a layout. The catalogs supply the movies and shows; the layout controls how people browse them.
| Term | What it means | Example |
|---|---|---|
| Catalog / source | A list that supplies titles. | TMDB Popular — Movie |
| Folder | A tile that opens one or more catalog sources. | Popular Movies |
| Collection | A named group of folders. | Movie Night |
| Row | A direct catalog row for Fusion, rather than a collection of folder tiles. | Trending Tonight |
| JSON | The 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 |
| Manifest | The addon description that tells the builder which catalogs and options are available. | Your saved AIO addon configuration |
A small first collection could be:
A folder's cover is artwork for that folder, not the posters for every movie inside it.
Use Build to edit a layout, Featured to browse ready-made examples, and Export & share when you are ready to use or share it.
| Feature | Nuvio | Fusion |
|---|---|---|
| Collections with folder tiles | Supported | Supported |
| Classic catalog rows | Omitted from export | Supported |
| Nuvio presentation and artwork settings | Used by Nuvio | Ignored by Fusion |
| Nested folders | Their catalogs are flattened into the parent folder on export | Their 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.
Examples available when this guide was written:
| Featured layout | What to expect |
|---|---|
| Starter Kit | Awards, decades, directors, genres and streaming services. |
| Ninja Streams | Trending titles, services, genres, decades, runtime, studios and networks. Includes classic rows. |
| Callandt95 | Trending/watchlist rows, services, movie genres and film franchises. |
| Snoak | Popular titles, discovery, service top tens, genres and decades. |
| TVGenie | Daily picks, movie/show categories, decades and networks. |
| Unified Media Experience | A 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.
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.
The selection checkbox controls what gets imported. Selecting an entry to preview it is a separate action.
| Import choice | What it does |
|---|---|
| Merge | Combines matching IDs and skips catalogs you already have. |
| Add as new | Keeps both copies rather than merging them. |
| Overwrite | Discards 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.
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.
Movie Night.Popular Movies.A new collection is not yet in your list until you click Add collection. Discard abandons that new entry.
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.
Select Movie Night, click Add folder, and repeat the process:
| Folder title | Catalog source | Suggested tile shape |
|---|---|---|
| Popular Movies | TMDB Popular — movie | Wide |
| Top Rated Movies | TMDB Top Rated — movie | Wide |
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.
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.
The Lord of the Rings when looking for a film collection. This is a search example, not a guarantee of a particular result.| Source tab | Choose it for | Check before adding |
|---|---|---|
| Your catalogs | Reusing an enabled catalog you already configured. | Correct movie/series type and filters. |
| TMDB | Finding a TMDB collection. | The intended franchise or collection, rather than assuming every title search is a collection. |
| TheTVDB | Finding a collection available through TheTVDB's picker. | The result's contents and supported media type. |
| MDBList | Searching 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.
Before exporting, select Movie Night and confirm this structure in the editor:
| Collection | Folder tile | Attached source | Expected result when opened |
|---|---|---|---|
| Movie Night | Popular Movies | TMDB Popular — movie | Popular movie titles. |
| Movie Night | Top Rated Movies | TMDB Top Rated — movie | Top-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.
| Setting | What it changes |
|---|---|
| Folder title | The name of the tile. |
| Tile shape | Poster is tall, Wide is landscape, Square is square. Fusion calls this Layout. |
| Cover image URL | The artwork displayed on the folder tile. Use an image address your viewing device can reach. |
| Hide title on the folder | Hides the text label on that folder. Useful when the artwork already contains the name. |
| Sources / Add catalog | The catalogs opened by the folder. More than one can be attached. |
| Folders inside | Adds nested folders for Jellyfin; Nuvio/Fusion exports flatten their catalogs into the parent. |
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.
Think about the part of the layout you are decorating before choosing an image.
| Artwork field | Belongs to | Intended use |
|---|---|---|
| Cover image URL | Folder | The tile you select to open that folder. For example, a Popular Movies cover identifies that folder. |
| Backdrop image URL | Collection, under Nuvio presentation | Background artwork for the whole collection. |
| Hero backdrop URL | Folder, under Nuvio artwork | Artwork for the folder's hero presentation in a supporting app. |
| Title logo URL | Folder, under Nuvio artwork | A graphic title/logo for the folder's presentation. |
| Focus GIF URL / Play focus GIF | Folder, under Nuvio artwork | Optional animated artwork when supported by the app. |
| Hero video URL | Folder, under Nuvio artwork | Optional 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.
These collection controls are grouped under Nuvio presentation. Fusion ignores them.
| Setting | Purpose |
|---|---|
| Backdrop image URL | A background image for the collection. |
| Folder view mode | Choose Tabbed grid, Rows, or Follow layout. |
| Pin to top | Requests that the collection be pinned at the top in Nuvio. |
| Focus glow | Turns the focus glow on or off. |
| Show “All” tab | Controls 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.
Use a Row when you want a catalog displayed directly, instead of a tile that opens a folder.
Trending Tonight.| Row setting | Meaning |
|---|---|
| Items shown | The item count requested for the row. |
| Cache TTL (seconds) | The row's cache duration setting. For example, 1800 seconds is 30 minutes. |
| Aspect ratio | Poster, Wide or Square cards. |
| Card size | The card-size preference for the row. |
| Numbered ranking | Adds 1, 2, 3… to the cards. |
| Hide title | Hides the row heading. |
| Provider badges / Rating badges | Controls 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.
There are two separate jobs: save the design in AIO, then import it into the viewing app.
| Action | What it does | What to do next |
|---|---|---|
| Add collection / Add row | Adds the new entry to the builder design. | Review the entry, then save the configuration. |
| Apply only | Applies 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. |
| Save | Stores the configuration on the server. | Export for the app you use. |
| Download | Downloads the selected export as a JSON file. | Import that file into the target app. |
| Import in Nuvio or Fusion | Loads the exported layout in that app. | Open a folder or row to check the contents. |
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.
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.
Start with the symptom below. When testing, change one thing at a time and check the same folder again.
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.
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.
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