My Lists
Documentation & User Guides

How to Use My Lists Addon

The complete guide to turning MDBList, Trakt, TMDB, and Simkl lists into dynamic Stremio, Wako, and Nuvio catalogs, building 24/7 Channels and Storylines & Universes, importing lists from other trackers, and syncing across your devices.

1

1. Quick Start

Get catalog rows running on Stremio, Wako, Nuvio, or any other app built on the Stremio addon protocol, with zero registration.

The fastest way to get started is to use the hosted instance directly at mylistsaddon.com — no deployment, nothing to set up. The site’s public lists work without an account; a free account adds custom lists, channels and your own watch history.

1

Open mylistsaddon.com

Visit mylistsaddon.com in any browser, on desktop or mobile.

2

Add Your Favorite Shelves

Under the Catalogs tab, click + New Catalog to paste any MDBList, Trakt, TMDB, or Simkl URL, or browse the Discover tab for one-tap shelves (Netflix, Disney+, Prime Video, genres, and more).

3

Generate Your Install Link

Click Generate Install Link on the Catalogs tab. Open the resulting link, or paste it into Stremio, Wako, Nuvio, or your app's "Install addon from URL" field, and confirm. You're done!

How it works: Your entire configuration is encoded into your install link. When you add or reorder catalogs later, click Update Link on the Catalogs tab and reinstall to push the changes.
2

2. Discover Tab

Browse everything available without typing a single URL.

The default landing tab. Filter pills across the top narrow the shelves shown: All, Movies, Shows, Popular Lists, Curated, Hidden Gems, Kids, Holidays, Genres.

What's here:

Each shelf has + Movies / + Shows buttons to add just that half of a chart, or + Add all at the top of a section to add every shelf in it at once. Click See All › to preview a shelf's full contents first.

3

3. Catalogs Tab

Where you add, arrange, and finalize what appears on your home screen.

Three submenus: My Catalogs, Quick Add, and Bulk Add.

My Catalogs — Live Preview & Editor

Shows every catalog row you've added, in the order it will display.

MDBList

No Key Required

Paste any public list URL like mdblist.com/lists/username/list-name. Connect an account or API key under Settings to unlock your personal Watchlist and private lists.

Trakt.tv

OAuth & Public

Add public lists (trakt.tv/users/username/lists/list-slug) or connect your account to sync your Watchlist and History.

TheMovieDB (TMDB)

Lists & Charts

Add public lists (themoviedb.org/list/12345), or browse automated genre, network, and streaming-provider charts.

Simkl

Anime & Trending

One-tap trending charts for Movies, Shows, and Anime. Connect an account to import personal lists and watch history.

Adding a catalog by URL (the "+ New Catalog" modal):

  1. Click + New Catalog.
  2. Enter a Catalog name — this becomes the row title on your home screen.
  3. Paste a list URL from MDBList, Trakt, TMDB, or Simkl.
  4. Optional: click + Add another link to combine multiple list URLs into one blended row.
  5. Choose the content type: Movies or Shows.
  6. Click Add.

Quick Add & Bulk Add

Quick Add is a one-tap shortcut to official charts without leaving this tab. Bulk Add lets you paste multiple list URLs at once, one per line, and click Add All Lines as Catalogs — each line is auto-detected and added as its own row.

Combined Rows: Add multiple links to a single "+ New Catalog" entry to merge several lists into one unified catalog row.
4

4. Lists Tab

Your personal, account-connected, and hand-built lists, separate from the catalog rows themselves.

Three submenus: My Lists, Liked, and Import.

My Lists

Building a Custom List from Scratch:

  1. Click + New List and choose Destination: Custom List.
  2. Give it a Name and optional Description.
  3. Choose Content Type: Movies, Shows, or Mixed, and Visibility: Public or Private.
  4. Click Create, then use Search/Discover/Charts to tap + on any title to add it to the list.
  5. Reorder by dragging or typing a position number; remove with the ✕ button.
  6. Click Save. You can now add this list to your Catalogs like any other.

Liked

Tap the heart (♥) icon on any list anywhere in the app to save it here for quick access later.

Import: The Import submenu lets you clone any MDBList, Trakt, or TMDB list URL directly into a Custom List, with an option to keep it synced to the source. See Importing below for the full walkthrough, including bulk file imports from other trackers.
5

5. Channels Tab

Turn any set of shows into a continuous 24/7-style catalog row, like flipping on a real network.

Four submenus: My Channels, Storylines & Universes, Quick Add, and Import.

My Channels

Lists everything you've built. + Create Channel opens the channel builder. Below that, Merge Saved Channels into One Catalog lets you select multiple saved channels with checkboxes, name the merge, and click Merge into catalog to combine them into a single row.

Building a Channel from Scratch:

  1. Click + Create Channel.
  2. Use the Shows / Movies toggle to set what you're searching for.
  3. Search a title and add picks — for shows, an episode picker lets you choose specific seasons/episodes.
  4. Drag a pick, or type a new position, to reorder Picks in this channel. Where a pick sits in this list is the order it plays in.
  5. Use the Play order dropdown to arrange them all at once — Air date (oldest or newest first, from each episode's TMDB air date and each movie's release date, with anything undated last), Show, then season & episode, Title A–Z, or Shuffle now. Each one reorders the list right there, so what you see is what plays.
  6. A sort stays selected and is re-applied whenever you add more picks, so a channel keeps its order as it grows. Move a pick by hand and the dropdown goes back to As listed — your order is kept from then on.
  7. Shuffle daily is the one option that is not a one-off: the channel reshuffles itself every 24 hours, and the order in the list is ignored while it is selected.
  8. Choose a Channel Poster from an added show's artwork, or use the default channel poster.
  9. Name the channel and click Save.

Quick Add Popular Networks

One-click channels for major broadcast/cable networks — ABC, NBC, CBS, FOX, The CW, HBO, AMC, FX, Comedy Central, Nickelodeon, Cartoon Network, Adult Swim, Disney Channel, Discovery, History, HGTV, Food Network, TLC, MTV, Syfy, TBS, TNT, USA Network, BBC One, A&E, Hallmark Channel, Ion Television, MeTV, and more — each with automatic daily episode rotation.

Import channel from a link

Paste any MDBList, Trakt, or TMDB show list URL, give it a channel name, and click Import channel. Every episode of every show on that list becomes the channel automatically.

6

6. Storylines, Sagas & Universes

Found inside the Channels tab — complete franchise viewing orders, pre-built for you.

A curated library of movie trilogies and sagas (3+ films) and TV-to-movie/crossover universes in canon chronological watch order, so you don't have to research the "correct" order yourself.

Filter categories: All Sagas, Movie Sagas (3+ Films), TV Universes & Bridges, Sci-Fi & Fantasy, Action & Crime, Animation & Anime.

Coverage includes large connected universes such as the Arrowverse, Grey's Anatomy/Station 19, the Law & Order franchise, the FBI franchise, the One Chicago shows, the Cobra Kai/Miyagi-verse, and Downton Abbey, tracked at episode-accurate granularity.

Two ways to use a saga: Add it directly to your Catalogs as a normal ordered row, or launch it as a continuous 24/7 channel with one click, using the same engine described above.
8

8. Importing Lists & Data From Other Sites

Two kinds of import: a single list by URL, and bulk files from other trackers.

Importing a single list by URL

Available in the Lists tab → Import submenu (clones into a Custom List), Channels tab → Import submenu (clones into a Channel, shows only), or directly via Catalogs tab → + New Catalog.

  1. Copy the list's URL from MDBList (mdblist.com/lists/username/list-name), Trakt (trakt.tv/users/username/lists/list-slug), or TMDB (themoviedb.org/list/12345).
  2. Paste it into the Import box and give it a name, or let it auto-detect one.
  3. Optional: check "Keep custom list synced with external link" so your copy periodically refreshes to match the source.
  4. Click Import list (or Import channel).

Bulk file import (CSV/JSON from other trackers)

Go to Settings → External Accounts & API Keys → Import List. Supported source formats: IMDb, Letterboxd, MovieLens, Trakt, Simkl, and TMDB exports, in CSV or JSON. You can select multiple files at once.

  1. Export your ratings/watchlist/history file from the other service (each site has its own "export my data" feature).
  2. Set Source to the matching provider, or leave it on Auto-detect.
  3. Choose Import to which list? — an existing list, or type a New List Name.
  4. Optionally check "Also add watched items to Watch History".
  5. Click Select file(s), choose your export file(s), then click Import.
Have a pile of list links instead? Use Catalogs → Bulk Add to paste one URL per line and add them all as catalogs at once.
9

9. Settings Tab

Connected accounts, region, watch history, and support.

Settings submenus include: Account & Security, Catalog & Display, Tracking & Scrobble, Connected Services, Presets & Backup, and Feedback & Support.

Account & Security

Catalog & Display

Tracking & Scrobble

Connected Services

Connect MDBList, Trakt, TMDB, and Simkl. Each provider offers Connect Account (OAuth/PIN flow — for Trakt, enter a code at trakt.tv/activate, your password is never entered here), Disconnect, Sync Watch History (push watched items back to that provider), and an advanced custom API key/Client ID field:

You only need any of this for private lists, personal watchlists/history, or your own dedicated rate limit — public lists and charts work with zero setup.

Feedback & Support

A built-in chat with the developer — pick a category (Bug Report, Improvement/Feature Request, Idea/Suggestion, General Question), write your message, and send. Use ↻ Refresh to check for a reply.

10

10. Backups, Presets & Data Export

Found under Settings → Presets & Backup.

Presets

Save your entire current setup as a named preset to switch back to later, or download it as a file. Ideal for maintaining a few different "profiles" — e.g. a Kids setup vs. your main one.

Backup & Restore

Export Lists & History

Pulls your data out to portable formats for other apps:

11

11. Frequently Asked Questions

Quick answers to common questions and troubleshooting.

Is My Lists Addon completely free?
Yes, it has no subscription, no ads, and no paid tier. Running it costs the owner real money, though, and the public site will shut down on November 8, 2026 unless donations cover its costs (Ko-fi). You can also run your own copy on Cloudflare (a Workers Paid plan, about $5 a month): see SELF-HOSTING.md.
Do I need to sign up or create an account?
Not to get started. Without an account you can add any of the site’s public lists — charts, curated shelves, community lists, storylines and Explore Channels listings — and install them in Stremio, Wako, Nuvio, or any other app built on the Stremio addon protocol. Install links never expire. Custom lists, building or customizing your own channels, your watchlist, watch history and Airing Next, connecting a Trakt, MDBList, Simkl or TMDB account, and liking or sharing all need a free account. It only takes a username, and it keeps everything in sync across your devices.
Do I need API keys from MDBList, Trakt, TMDB, or Simkl?
Not for public lists. You only need your own personal key for private lists, personal watchlists, or if you want your own dedicated rate limit instead of the shared one.
How do I reorder catalogs on my home screen?
On the Catalogs tab, click Edit in the Live Preview & Editor and drag rows into the order you want, then click Generate Install Link (or Update Link) and reinstall to apply it.
I changed my catalogs but nothing updated on my home screen — why?
Your install link encodes your configuration at the time it was generated. Go to Catalogs and click Update Link, then reinstall using the new link.
What's the difference between a Catalog, a List, and a Channel?
A Catalog is a row on your home screen in Stremio, Wako, Nuvio, or any other app built on the Stremio addon protocol — the end result. A List is a named, editable collection of titles that becomes a catalog row once added. A Channel is a special catalog that plays episodes continuously like a live TV network.