How to Use My Lists Addon

The fastest way to get started is to use the hosted instance directly at mylistsaddon.com — no account, no deployment, nothing to set up.

Prefer to run your own dedicated copy instead of the shared hosted instance? See Self-Hosting below.

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:

• Combined Charts — Popular, Trending, Streaming Top 10, and Streaming (All Services), blending multiple sources into one row.
• TMDB Charts — New Releases, Trending, Popular, Top Rated, Now Playing, Upcoming.
• Trakt Charts — Trending, Popular, Most Played, Most Watched, Most Collected, Most Favorited, Most Anticipated, and Box Office.
• MDBList Official — Popular, US Daily Streaming Charts, Streaming Charts (Extended), IMDb MovieMeter.
• Simkl Anime & Trending — Trending Today/Week/Month, plus Anime Trending.
• Streaming Top 10 & Streaming Catalogs — per-service rows for Netflix, Disney+, HBO Max, Hulu, Prime Video, Apple TV+, Paramount+, Peacock, Discovery+.
• Hidden Gems, Kids, Holidays, Genres — curated thematic and seasonal shelves.
• Popular Community Lists and Curated For You — the latter personalized from your watch history.

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.

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.

• + New Catalog — opens the Add Catalog modal to add a list by URL (see below).
• Edit — toggle edit mode to drag-reorder, rename, or remove rows.
• Refresh Preview — re-renders the live preview.
• Filter by name and by group using the controls above the list.
• Daily Randomizer — two toggles: shuffle catalog row order every 24 hours, or shuffle items within each catalog every 24 hours.
• Generate Install Link — produces your install URL, ready for Stremio, Wako, Nuvio, or any other app built on the Stremio addon protocol.

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.

Three submenus: My Lists, Liked, and Import.

My Lists

• Your Custom Lists — hand-built lists. + New List starts one from scratch.
• Your MDBList Lists — once you Connect MDBList, your Lists, Watchlist, and Watch History appear here.
• Your Trakt Lists — via Connect Trakt (OAuth, no password shared with the addon).
• Your TMDB Lists — via Connect TMDB, pulls your Lists, Watchlist, and Favorites.
• Your Simkl Lists — via Connect Simkl, pulls your Lists, Watchlist, and History.

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.

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

My Channels

Lists everything you've built. + New 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 + New 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. Reorder or remove picks in Picks in this channel. Shuffle picks now randomizes the order once; the Randomize play order checkbox re-shuffles automatically every 24 hours.
5. Choose a Channel Poster from an added show's artwork, or use the default channel poster.
6. 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.

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.

1. Type a title or list name into the search box.
2. Filter by type using the Movies / Shows / Lists pills.
3. Refine with Genre, Year, and Rating dropdowns.
4. Click Reset to clear filters.

Results show a + Add button on each poster to add it directly to a Custom List or the channel/catalog builder you launched Search from.

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.

Four submenus: Account & Sync, External Accounts & API Keys, Presets & Backup, Feedback and Support.

Account & Sync

• Watchlist Preferences — controls how watched titles are handled in your Watchlist.
• Hidden Lists — hide specific lists from My Lists, Airing Next, and Simkl Airing Next without un-tracking them; they keep updating and can be un-hidden anytime.
• Region — sets your country for streaming-availability catalogs (Netflix, Disney+, etc.), Stream Releases, and content ratings.
• Trending & Popular Catalogs — toggle "Hide items with no digital release" to skip still-in-theaters movies from Trending/Popular rows. Requires Save/Update to take effect.
• Watch History — clear/reset all recorded history.
• Auto-Track & Media Server Scrobbling — automatically records watched movies/episodes from your streaming apps and home media servers (Plex, Jellyfin, Emby) into Watch History and Continue Watching.

External Accounts & API Keys

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:

• TMDB key: themoviedb.org/settings/api
• Trakt Client ID: trakt.tv/oauth/applications
• MDBList key: mdblist.com/preferences
• Simkl Client ID: simkl.com/settings/developer/

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 and 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.

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.

• Save preset — names and stores your current configuration.
• Upload preset file — restores a previously downloaded preset.

Backup & Restore

• Export current — downloads your full setup as JSON.
• Import JSON → Upload file — restores from a downloaded backup.
• Import from Install/Configure Link — paste an existing install link (yours or shared with you) and click Import link to pull in that whole configuration.

Export Lists & History

Pulls your data out to portable formats for other apps:

• Watch History — all watched movies, shows, and episodes with timestamps, as CSV (Trakt/Simkl), CSV (Letterboxd), or Universal CSV.
• All Custom Lists & Watchlist — every list plus watchlist and continue-watching items, as Export All (CSV) or Full Library (JSON).

Prefer a dedicated instance instead of the shared hosted one at mylistsaddon.com? The full source is open on GitHub at github.com/Br0ck25/My-Lists — deploy it to your own free Cloudflare account and it's entirely yours from then on.