Stremio Shufflist is a powerful add-on that breathes life into your Stremio library. Instead of static lists, Shufflist lets you create Dynamic Catalogs that automatically rotate through your favorite content sources (lists). Whether you want a "Movie of the Night" catalog that picks a random genre every day, or a "Sitcom Shuffle" that rotates through your Plex TV sitcom collections, Shufflist handles it all.
- 🧩 Dynamic Catalogs: Define catalogs in Stremio that act as placeholders. These placeholder catalogs automatically update to display different content based on your configuration.
- 🔄 Smart Rotation: Catalogs automatically rotate through a pool of lists you define (e.g., switch between "Trending Sci-Fi" and "80s Action" every 24 hours).
- 📋 List Shuffling: Enable "Shuffle" on specific lists to randomize the item order every time they appear. Perfect for "Random Episode" style viewing.
- 🖥️ Web Management UI: Detailed, mobile-responsive web interface to add list sources, configure catalogs, filter lists, and manage your library.
- ⭐ RPDB Integration: Automatically fetch premium posters with ratings from Rating Poster Database (RPDB) for all your items.
- ⚡ Seamless Updates: Most content updates happen instantly. New lists appear in your existing catalogs without needing to reinstall the addon in Stremio.
Note: You will need to reinstall the addon if you add/remove a catalog or change a catalog's name or media type. This is a Stremio limitation.
- 📅 Automated Scheduling: Content refreshes automatically in the background based on your preferred interval (in hours).
- 🚫 Group Exclusivity: Assign lists to a 'Group' (e.g. 'Action', 'Comedy'). Shufflist ensures that only one list from a group is active at a time across all your catalogs, preventing duplicate genres or themes.
Mix and match content from your favorite platforms:
- Trakt: Trending, Popular, Watched, Collected, Recommendations, and custom User Lists.
- MDBList: Import any list from MDBList.
- IMDB: Built-in support for Official Top 250 Movies & TV Shows.
- Plex: Connect your Plex server to use your Plex Collections as source lists.
You need the following API keys depending on the services you wish to use:
- Node.js 18+ (if running locally)
| Variable | Description | Required? |
|---|---|---|
TRAKT_CLIENT_ID |
Your Trakt API Client ID. Create an app at trakt.tv/oauth/applications. | Yes (for Trakt) |
MDBLIST_KEY |
Your MDBList API Key. Get it from MDBList.com/preferences. | Yes (for MDBList) |
RPDB_KEY |
Your RPDB API Key. Get it from ratingposterdb.com. | Yes (for Posters) |
PLEX_URL |
Your Plex Server URL (e.g., http://192.168.1.10:32400). |
Yes (for Plex) |
PLEX_TOKEN |
Your Plex Authentication Token. Guide to find X-Plex-Token. | Yes (for Plex) |
PLEX_SERVER_NAME |
The friendly name of your Plex server. | Yes (for Plex) |
PLEX_USERNAME |
Your Plex Username (used for internal auth). | Yes (for Plex) |
PLEX_PASSWORD |
Your Plex Password (used for internal auth). | Yes (for Plex) |
| Variable | Description | Default |
|---|---|---|
PORT |
The port the server listens on. | 7000 |
Run the container directly:
docker run -d \
--name=stremio-shufflist \
-e TRAKT_CLIENT_ID=your_trakt_id \
-e MDBLIST_KEY=your_MDBList_key \
-e RPDB_KEY=your_rpdb_key \
-e PLEX_URL=http://your-plex-ip:32400 \
-e PLEX_TOKEN=your_token \
-e PLEX_SERVER_NAME="YourServerName" \
-e PLEX_USERNAME="YourUsername" \
-e PLEX_PASSWORD="YourPassword" \
-v /path/to/config:/app/config \
-p 7000:7000 \
profesaurus/stremio-shufflist:latestCreate a docker-compose.yml file:
version: '3.8'
services:
stremio-shufflist:
image: profesaurus/stremio-shufflist:latest
container_name: stremio-shufflist
restart: unless-stopped
environment:
- TRAKT_CLIENT_ID=your_trakt_id_here
- MDBLIST_KEY=your_MDBList_key_here
- RPDB_KEY=your_rpdb_key
- PLEX_URL=http://your-plex-ip:32400
- PLEX_TOKEN=your_plex_token
- PLEX_SERVER_NAME=Tower
- PLEX_USERNAME=myplexuser
- PLEX_PASSWORD=secret
volumes:
- ./config:/app/config
ports:
- "7000:7000"Run with:
docker-compose up -dTo install on Unraid, use the "Add Container" feature in the Docker tab.
- Name: Stremio Shufflist
- Repository:
(profesaurus/stremio-shufflist, or build locally) - Network Type: Bridge
- WebUI:
http://[IP]:[PORT:7000]/web-config - Port Mapping:
- Container Port:
7000 - Host Port:
7000
- Container Port:
- Path Mapping:
- Container Path:
/app/config - Host Path:
/mnt/user/appdata/stremio-shufflist
- Container Path:
- Variables: Add variables for
TRAKT_CLIENT_ID,MDBLIST_KEY, etc. as "Variables".
- Clone the repository.
- Install dependencies:
npm install
- Create a
.envfile in the root directory with your keys (seePrerequisites). - Build and Start:
npm run build npm start
- Access the Web UI at
http://localhost:7000/web-configorhttps://your-domain-name/web-configif using a reverse proxy setup.
- Open the Web Dashboard: Navigate to
http://localhost:7000/web-configorhttps://your-domain-name/web-configif using a reverse proxy setup. - Add Lists:
- Click "Add Lists" in the top right.
- Select a source (e.g., Trakt User List, Default Trakt List, or Plex Collection).
- Configure the list options (filters, limits).
- Create a Catalog:
- Click "+ New Catalog" in the left sidebar.
- Give it a name (e.g., "weekend Binge").
- Click the Gear Icon (⚙️) on the new catalog slot.
- Select which of your added lists should feed into this catalog.
- Install in Stremio:
- Click the "Install" button in the header.
- Click "Stremio" to install directly to Stremio on your device.
- Click "Stremio Web" to install to Stremio Web.
- Click "Copy URL" to install in the addon section of Stremio using the url.
Note: Your addon instance must be accessible to the internet if you want to use the addon in Stremio outside your local network.
MIT