> ## Documentation Index
> Fetch the complete documentation index at: https://core-builds.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Importing a Template

> Step-by-step guide to importing, configuring API keys, and updating templates.

<Frame>
  <img src="https://raw.githubusercontent.com/brevityA/Core-Builds/refs/heads/main/Assets/master_guide_banner.svg" alt="Master Guide" style={{ width: '100%', display: 'block' }} />
</Frame>

## Steps

<Steps>
  <Step title="Pick your template">
    Use [Which Template?](/which-template) or browse the [Template Directory](/template-directory).
  </Step>

  <Step title="Get the import URL">
    The [Template Directory](/template-directory) has **Import on ElfHosted** and **Import on Fortheweak** buttons for each template — click to open the template directly in your AIOStreams instance. Or copy the raw URL block to paste into any host manually.
  </Step>

  <Step title="Load in AIOStreams">
    Open your AIOStreams instance → **About → Get Started → Load Template** → paste the URL → click **Load**.
  </Step>

  <Step title="Enter your API keys">
    Fill in **Services**:

    * **TorBox API key** — [torbox.app/dashboard](https://torbox.app/dashboard) → API Keys
    * **TMDB Access Token** (recommended) — [themoviedb.org/settings/api](https://www.themoviedb.org/settings/api) → Read Access Token
  </Step>

  <Step title="Save and install">
    Click **Save** → copy the manifest URL → install in Stremio or WuPlay.
  </Step>
</Steps>

## API Keys

| Key                  | Where to get it                                     | Required for                        |
| -------------------- | --------------------------------------------------- | ----------------------------------- |
| TorBox API key       | torbox.app → Dashboard → API Keys                   | All TorBox templates                |
| TMDB Access Token    | themoviedb.org → Settings → API → Read Access Token | Better title matching (recommended) |
| NZBGeek API key      | nzbgeek.info → My Profile → API                     | Hybrid templates only               |
| AllDebrid API key    | alldebrid.com → My Account → API                    | AllDebrid templates only            |
| EasyNews credentials | easynews.com                                        | Speed EasyNews templates            |

## Updating a Template

Re-import the same URL. AIOStreams will load the latest version and merge it over your existing config. Your API keys are preserved.

<Tip>
  Already imported? Check AIOStreams for an in-app update notification — it will prompt you to pull the latest version automatically.
</Tip>

## After Importing

<AccordionGroup>
  <Accordion title="Standard TorBox templates">
    MediaFusion and HdHub are enabled by default from v2.9.4. **MediaFusion** adds regional and international content coverage. **HdHub** is a TorBox-native P2P scraper that only returns results when TorBox is your active debrid service. Both are stream-only — neither injects catalog rows into Stremio. To disable either, go to **Addons** and toggle it off.
  </Accordion>

  <Accordion title="Hybrid templates (4K Hybrid, Hybrid, Hybrid Lite)">
    The NZBGeek (Newznab) preset is included but **disabled by default**. NZBGeek flags accounts accessed from multiple IP addresses simultaneously — a pattern that occurs on shared hosting (ElfHosted, fortheweak.cloud) where search and download requests can originate from different IPs.

    **To enable on ElfHosted:** use the [Zyclops proxy](https://zyclops.elfhosted.com) — set the proxy URL in the Newznab addon config so both search and grab route through the same IP. Then enter your NZBGeek API key in **Add-ons → Newznab**.

    **On a private/self-hosted AIOStreams instance:** enable the preset, enter your API key, and ensure the built-in NZB grab proxy is active (`AIOSTREAMS_AUTH` credentials set) so search and grab share the same IP.

    If you want a Usenet indexer with no IP restrictions on shared hosting, [NinjaCentral](https://ninjacentral.co.za) has publicly confirmed AIOStreams public-instance compatibility.
  </Accordion>

  <Accordion title="AllDebrid templates">
    Go to **Add-ons → StremThru AllDebrid** and enter your AllDebrid API key.
  </Accordion>

  <Accordion title="Speed templates">
    These exit after 3 cached results or a timeout. Test with a popular title first (e.g. Breaking Bad S01E01).
  </Accordion>

  <Accordion title="Flash templates">
    Cached-only. If a title isn't in TorBox's cache you'll get no results. Use Speed or Essential as a fallback for new releases.
  </Accordion>
</AccordionGroup>

## Choosing a Host

<CardGroup cols={2}>
  <Card title="elfhosted (paid private)" icon="server" href="https://store.elfhosted.com/product/aiostreams">
    **\$9/month** — dedicated instance, no rate limits, Torrentio enabled. Best for serious daily use.
  </Card>

  <Card title="fortheweak.cloud" icon="users" href="https://aiostreams.fortheweak.cloud">
    **Free** — community-run by nhyyeb, stable and nightly builds. Core Builds verified against their allowlist. Best free option.
  </Card>
</CardGroup>

<Tip>
  Not sure? Start with **fortheweak** (free, no signup) to test your template. Upgrade to elfhosted private if you need Torrentio or want a dedicated instance with no shared load.
</Tip>

|                      | elfhosted private | fortheweak | elfhosted free              | Self-hosted        |
| -------------------- | ----------------- | ---------- | --------------------------- | ------------------ |
| Cost                 | \$9/month         | Free       | Free                        | Free (server cost) |
| Rate limits          | None              | Shared     | Shared + Torrentio disabled | None               |
| Torrentio            | Enabled           | Enabled    | Disabled                    | Enabled            |
| Core Builds verified | ✓                 | ✓          | ✓                           | ✓                  |
| Nightly builds       | —                 | ✓          | —                           | ✓                  |

For the full list of public instances, see the [AIOStreams public instances page](https://docs.aiostreams.viren070.me/getting-started/public-instances/).

### Regex and allowlists

Hosted instances validate inline regex patterns against an allowlist. v2.9.0 templates are verified against both elfhosted and fortheweak allowlists — import errors from regex patterns indicate an outdated template.

|                   | Hosted (elfhosted, fortheweak.cloud) | Self-hosted                  |
| ----------------- | ------------------------------------ | ---------------------------- |
| Inline regex      | Validated against host allowlist     | Works — all patterns allowed |
| Synced regex URLs | Whitelisted URLs only                | All URLs allowed             |

<Info>
  As of v2.9.0, all Core Builds templates are verified against both elfhosted and fortheweak allowlists. If you see a "regex not allowed" error after importing, re-import the latest template version — older templates may contain pattern strings that predate the v2.9.0 allowlist sync.
</Info>

## Stremio vs WuPlay

|              | Stremio               | WuPlay                      |
| ------------ | --------------------- | --------------------------- |
| Platform     | Desktop + mobile      | Web + Chromecast            |
| Installation | Add-on URL in Stremio | Direct stream URL           |
| Best for     | Standard setup        | Casting / TV without an app |