Fusion Setup Guide

01

Start Here

This guide keeps the first setup intentionally simple. Fusion with AIOStreams is enough for a strong initial build. If you already have sources addons or AIOStreams configured, you can skip directly to the Player, Starter Kit, Ratings and Extras sections.

First timeStart with AIOStreams Already set upSkip to Player

Keep the stack minimal

Use→Fusion + AIOStreams with TorBox

This guide does not include AIOMetadata as part of the default setup. It is fully supported, but Fusion already covers a lot of the same ground with its built-in features and tends to feel faster and lighter across catalogues, metadata and search. If you self-host AIOMetadata, that gap gets smaller.

Debrid support

TorBox is the recommended debrid provider for this guide, but it is not the only option. Other debrid services supported by AIOStreams, along with other debrid-focused sources addons, are fully supported in Fusion too.

02

AIOStreams

For an awesome Fusion setup, this is the addon to start with. Use the official AIOStreams guide to get it set up cleanly.

First things first

Sign upTorBox.app

TorBox is the recommended debrid provider. Go to TorBox.app and sign up for the Essential plan ($33/year).

Open the official docs

Opendocs.aiostreams.viren070.me

AIOStreams is the recommended sources addon. Use the official AIOStreams documentation to configure the addon and generate the install URL you want to use in Fusion.

Recommended instance

I also recommend nhyyeb's nightly instance at aiostreams-nightly.fortheweak.cloud. He's both an admin in AIOStreams and a Founding Contributor of Fusion.

Install AIOStreams

InstallSettings›Addons

Once the docs give you the final AIOStreams URL, paste it into Fusion and you're off.

03

Player

Fusion gives you two playback options worth your time here: the built-in player for the native experience, and Infuse if you want the more premium Apple-device route.

Default 01

Internal player

Good enough for mobile and most everyday viewing inside Fusion. This is the easiest place for most people to start.

Best forQuick setup with no extra app

TradeoffMisses some premium codecs

Best on Apple devices 02

Infuse

The premium route if Dolby Vision P5 support and broader audio codec support matter to you on Apple hardware.

Best forHigher-end playback quality

TradeoffPaid app

You do not need Infuse on day one. Start with the internal player and only switch if you run into format limits.

Difusion

Fusion's internal player is built from the ground up by the Fusion developer with the goal of getting as close to Infuse as possible. It is built on FFmpeg and AVFoundation, is being worked on actively, and the latest TestFlight builds have already fixed most of the issues people still bring up. It is a genuinely solid choice.

04

Starter Kit

The Fusion Starter Kit is the easiest way to import homescreen layouts, widgets, collections, icon packs, and other resources.

Fusion Starter Kit

Openitsrenoria.github.io/fusion-starter-kit

Browse for homescreen setups, widgets, collections, icon packs, and other community-built Fusion resources.

Import widgets Most common

The fastest way to add rows to the home screen.

Import it Settings› Widgets› Scroll to bottom› Import› URL

Pick a widget from the Starter Kit, click Copy JSON URL, choose Widget, decide whether you want sources included or want to assign them yourself later, then paste it into Fusion.

Import collections Almost identical

Collections follow nearly the same idea as widgets.

Import it Settings› Widgets› Add New› Collections Row› Continue› Import Collections

Pick a widget from the Starter Kit, click Copy JSON URL, choose Collection, decide whether you want sources included or want to assign them yourself later, then paste it into Fusion.

Import full setups Fastest reset

Best when you want Fusion to feel complete in one move.

Import it Settings› Widgets› Scroll to bottom› Import› URL

Pick a full setup in the Starter Kit, click Copy JSON URL, select Full Setup, then paste it into Fusion.

Import BYO setups Build your own

Use JSON paste when you want a custom widget bundle.

Import it Settings› Widgets› Scroll to bottom› Import› Paste JSON

Choose BYO in the Starter Kit, click Build JSON, select the widgets you want, click Copy JSON, choose whether you want sources included, copy and paste the JSON string into Fusion.

Widgets and collections

In practice, widgets and collections are essentially the same besides the import flow.

05

Ratings Icons

Fusion can show community rating labels on the hero, media details and on posters. To make that work cleanly, connect PMDB first, then import an icon pack and map it to your labels.

0

Create your PMDB setup

Sign up for PMDB and create an API key under Settings › API.

1

Connect PMDB

Go to Settings › Accounts › PublicMetaDB and paste your API key.

2

Enable community ratings

Open Settings › Metadata › Community Ratings and toggle it on.

3

Enable and sort ratings

Enable the ratings you want shown and sort them as per your preference.

4

Import an icon pack

Go to Settings › Icon Packs and add Icon Pack from URL. The Starter Kit includes icon pack links for this.

5

Assign icons to labels

Tap each rating label and choose the icon you want attached to it.

*

Optional: show them on posters

Back in Settings › Metadata › Community Ratings, make sure Show on Posters is enabled if you want it.

PMDB

PMDB is also worth knowing about beyond ratings: it is an actively updated alternative to Trakt, built by the Fusion developer, and fully integrated into Fusion and the internal player. It recently got scrobbling, and already includes lists, continue watching, up next, history, skips, highlights, calendar, favorites, discover stats, and more still to come. Head over to Extras for a nice surprise if you're considering switching to it.

06

Extras

Once the main setup works, these are some upgrades that will make Fusion feel even more polished.

Apple TV settings

If you own one→Yuhasebe Guide

Openqooode.github.io/yuh-guide

This guide is a must-have for device-level Apple TV settings, made by none other than yuhasebe.

Trailer previews

Use→Trailerio

Install Trailerio in Fusion as an addon so the app can show trailer previews.

Choose trailer language

Use URL trailerio.cc/manifest.json

Enable trailer previews

Open Settings › Video Player and turn Autoplay Previews on. The exact wording can vary slightly by version, but it stays in the video player settings.

Poster overlays

Use→BetterPosters

Openbtttr.cc

Use BetterPosters for clean overlays and extra visual styling in your posters, if you like the preview.

Example of BetterPosters poster overlays in Fusion

Example BetterPosters overlays in Fusion. Click the image to open the full-size version.

Trakt to PMDB migration

Use→Migration Utility

Open github.com/yodaluca23/Trakt-To-PMDB-Migration

If you want to move from Trakt to PMDB, this utility migrates your watchlist, custom lists, watch history, and resume points.

SyncMeta

Use→PMDB Sync Tool

Opensyncmeta.febsho.me

SyncMeta automatically syncs your watchlists and lists from SIMKL, Trakt, AniList, and MDBList into PublicMetaDB. It also supports history import for Trakt and SIMKL, plus resume progress for Trakt.

Migrating from Omni

Use→Fusion Widget Manager

Opennobnobz.github.io/fusion-widget-manager

If you are coming from Omni, this is the cleanest way to move over. Fusion Widget Manager can convert Omni snapshots into Fusion widgets, merge them into existing setups, and export them back into Fusion without manually wrestling with JSON. Even outside Omni migration, it is a genuinely useful browser-based editor for building, merging, and maintaining larger widget setups.

07

FAQ

The questions people usually run into right after the starter setup: what Fusion actually is, how tracking behaves, which metadata defaults make sense, and which settings are easiest to miss.

What This Covers

This section complements the main guide instead of repeating it. It focuses on app behavior, account choices, metadata, collections, and the small settings that make Fusion feel right once the first install is already done.

General Tracking Metadata Collections Playback

Foundation

General

What Fusion is, what it supports, and what it does not do for you out of the box.

01

What is Fusion?

Fusion is a media companion app for Apple platforms. It brings discovery, organization, watch tracking, collections, and home-screen customization into one interface, with optional third-party extensions if you want to add your own sources.

Which devices does Fusion support?

Fusion supports iPhone, iPad, Mac, and Apple TV. Support is currently limited to iOS/iPadOS, macOS, and tvOS 26+.

Does Fusion include or host any content?

No. Fusion does not provide, host, stream, or distribute media content. It is a media browser and organizer. Any extensions or content sources are added by the user, and Fusion assumes those sources are legal and user-controlled.

Are addons built into Fusion?

No. Addons are user-configured URLs that you add yourself in Settings > Addons. Fusion does not bundle or control what those endpoints provide.

Mapping

Metadata and Anime

The defaults that usually work best, plus the anime-specific gotchas behind Fusion's warnings.

02

Which metadata source should I use?

The best default depends on the type of media:

Movies: TMDB is usually the best primary source.
Series: TMDB or TVDB both work well, depending on which structure you prefer.
Anime: TVDB is the safest default for episode and season structure.

If you want more control, Fusion also lets you set field-specific overrides for things like hero images, episode backgrounds, synopsis, and structure.

Why does Fusion warn me when I change anime metadata or structure sources?

Because anime numbering can differ between providers. Changing the structure or image source away from the recommended setup can break episode mapping, make season ordering look wrong, or cause watch-status sync to appear incorrect.

Where do anime watched checkmarks come from?

You can choose the source in Settings > Progress > Anime Tracking > Show Watched From. The options are Local, Trakt, AniList, or All Sources. If you watch across multiple devices or apps, All Sources is usually the safest choice.

Accounts and Sync

Tracking

How Fusion stores progress, how to wire Trakt cleanly, and what to check when Continue Watching looks wrong.

03

Should I use Local, Trakt, or AniList progress?

Use Local if you want device-only progress with no external account. Use Trakt if you already track most of your watching there. Use AniList if anime is your main focus and you want anime-first tracking.

How do I connect Trakt?

Open Settings > Accounts > Trakt and choose Connect to Trakt.

On iPhone and Mac, Fusion opens a browser so you can sign in and approve access.
On Apple TV, Fusion gives you a code and verification URL to finish on another device.

Once connected, the Trakt status should show as connected and the Trakt sync options under Settings > Progress > Trakt should become available.

Why is Continue Watching not updating?

Check these in order:

Confirm your storage mode in Settings > Progress.
If you use Trakt, make sure your Trakt account is connected.
In Settings > Progress > Trakt, turn on Scrobble Playback and run Sync Now.
If you use external players, enable Sync After External Playback.
If it is still wrong, switch to Local, test one playback, then switch back and sync again.

How can I tell whether progress was actually saved?

Play something briefly, exit playback normally, then check Home > Continue Watching. If you use Trakt, also open Settings > Progress > Trakt, run Sync Now, and confirm the last sync time updates.

What does Source Switcher do?

Source Switcher changes which progress sources feed Continue Watching and related views. Common setups include All Local, All Trakt, Trakt + AniList, or Anime Local + AniList. It also gives quick access to sync and cache-clear actions.

Where does the watchlist button save items?

That depends on the provider you choose in Settings > Progress. Fusion can use Trakt or PublicMetaDB for the watchlist button. If Trakt is connected, it is the default association. One useful limitation to know: Trakt watchlists have a 100-item cap.

Layout

Home and Customization

Collections, widgets, and the settings people usually discover too late.

04

What are collections in Fusion?

Collections are custom folders on your Home screen. Each collection tile can have its own title, image, tile shape, and one or more content sources. When opened, Fusion shows a grid built from those sources.

What happens if a collection has multiple sources?

If a collection has one source, Fusion opens that source directly. If it has two or more, Fusion merges them into a single combined grid. If it has no sources, the collection will show as not configured.

Can I disable a widget without deleting it?

No. Fusion does not currently have a true disable toggle for widgets. If you want to hide one, you need to delete it and add or import it again later.

What settings do people commonly miss after first setup?

Progress Storage and whether it should be Local or Trakt
Watchlist Button provider
Video Player and per-media-type player selection
Autoplay Next Episode
Remember Last Source
Up Next timing
Subtitle presets, size, colors, and position
Addon timeout settings
iCloud sync
Continue Watching sync and push/pull options

Finish Touches

Playback

The little playback details that matter once the rest of the setup is already in place.

05

How do I customize subtitles?

Go to Settings > Subtitles. From there, you can use built-in presets or adjust subtitle size, position, and colors manually.

Will HDR video look washed out on an SDR Apple TV setup?

No. Fusion relies on Apple's system-level tone mapping on tvOS. If you play HDR content on an SDR display, Apple TV handles the tone mapping rather than leaving the image washed out.

08

Quick Links

Everything important in one table. Install the basics first, then layer on the community resources.

Resource	Use it for	Where to find it
AIOStreams	Recommended addon for a basic Fusion setup.	docs.aiostreams.viren070.me
TorBox	Recommended debrid companion for AIOStreams.	TorBox.app
Starter Kit	Homescreen setups, widgets, collections, icon packs, and more.	itsrenoria.github.io
BetterPosters	Poster overlays and visual polish.	btttr.cc
Trailerio	Trailer previews in the home hero section.	manifest.json
PMDB	Used for the ratings icon flow and also works as a Trakt alternative built by the Fusion developer.	publicmetadb.com
Apple TV settings	Extra Apple TV device tuning if you own one.	Yuhasebe Guide