📖 Plugin Overview
Trakt Lists is a plugin designed to fetch and manage Trakt TV lists.
- Version: 0.2.7
- Features: Retrieve public and personal Trakt lists, recommendations, and watchlists
- Purpose: Manage movie and TV show collections and discover recommended content
🎯 Key Features
1. Browse Public Lists
- Explore popular lists on Trakt
- View trending lists
- Access genre-based lists (Sci-Fi, Horror, Comedy, etc.)
2. Personal List Management
- View your own Trakt lists
- Access private lists (requires authentication)
- Add external lists to the plugin
3. Watchlist Management
- View your watch history
- Access “To Watch,” “Watching,” and “Completed” lists
- Support for list merging
4. Recommendation System
- Receive personalized recommendations based on your viewing history
- Discover movies and shows that match your preferences
5. Search Functionality
- Search Trakt lists by keyword
- Quickly find specific content lists
6. RPDB Integration (Optional)
- Integrates with Rating Poster Database (RPDB)
- Displays enhanced poster rating information
- Improves visual presentation
⚙️ Configuration Guide
Basic Settings
| Setting | Description | Default |
|---|---|---|
| Trakt Prefix | Add "Trakt - " prefix to list names | Enabled |
| Popular | Enable popular lists | Enabled |
| Trending | Enable trending lists | Enabled |
| WatchList | Watchlist management | Configurable |
| Merged | Merge watchlists | Optional |
| Recommendations | Enable recommendations | Disabled |
| Search | Enable search feature | Enabled |
📚 Step-by-Step Instructions
Step 1: Log in to Trakt.tv
1.1 Click the Login Button
On the plugin settings page, click “Login to Trakt.tv”.
1.2 Complete OAuth Authentication
You will be redirected to the Trakt OAuth page:
- Client ID:
18bde7dcd858c86f9593addf9f66528f8c1443ec1bef9ecee501d1c5177ce281 - Redirect URL:
https://2ecbbd610840-trakt.baby-beamup.club - Purpose: Enables access to private lists, watchlists, and recommendations.
1.3 Authorize Access
- Log in with your Trakt account
- Click “Authorize”
- Grant permission to access your lists and watch history
1.4 Authentication Complete
After successful authorization, you will be redirected back to the plugin configuration page.
Step 2: Add Lists
You can add lists in several ways:
Method 1: Browse Popular Lists
- Click “Browse popular lists”
- Select lists of interest
- Add them to the plugin
Method 2: Browse Trending Lists
- Click “Browse trending lists”
- View current trending lists
- Add them
Method 3: Browse Personal Lists (Login Required)
- Click “Browse personal lists”
- Select from your Trakt lists
- Add desired lists
Method 4: Search for Lists
- Enter keywords in the search box
- Click “Search”
- Review results
- Add your chosen list
Search Examples:
- “science fiction”
- “horror”
- “best movies 2024”
Method 5: Paste List URL
- Copy the Trakt list URL
- Paste it into “Paste list URL”
- Click “Add list”
Example URLs:
https://trakt.tv/users/username/lists/list-name
https://trakt.tv/lists/trending/sci-fi
https://trakt.tv/shows/star-trek/lists/watched
Note: Private lists require login authentication.
Step 3: Configure RPDB API Key (Optional)
3.1 Obtain API Key
Visit: https://ratingposterdb.com/api-key/ Register or log in and create an API key.
3.2 Enter API Key
- Paste the key into “Paste RPDB API Key (optional)”
- Click “Validate key”
3.3 Confirmation
A success message will appear if validation passes.
Step 4: Configure List Settings
Trakt Prefix
Enable or disable the “Trakt - ” prefix.
Popular Lists
Enable or disable popular lists.
Trending Lists
Enable or disable trending lists.
WatchList Settings
- Merge mode: On/Off
- Sorting: By added date, rating, views, etc.
- Order: Ascending / Descending
Recommendations
Enable personalized recommendations.
Search
Enable or disable list search functionality.
Step 5: Manage Added Lists
Added lists appear under “Trakt lists”.
View Lists
Each list card displays:
- List name
- Description
- Number of items (movies/shows)
Delete Lists
Each list card includes a remove/delete button.
🎨 Tips & Best Practices
Create Custom Lists
- Create lists on Trakt.tv
- Add them via URL in the plugin
- Configure sorting and display options
Keep Lists Updated
- Lists update periodically
- Some may require manual refresh
- Logged-in users get the latest data
Improve Search Results
- English keywords typically work best
- Try multiple keyword combinations
- Supports fuzzy matching
Optimize Recommendations
- Enable Recommendations
- Mark favorite content consistently
- Adjust settings periodically
RPDB Recommendation
- Highly recommended for English-language users
- Enhances posters with detailed ratings and metadata
- Improves visual experience
🔧 Advanced Configuration
Watchlist Sorting Options
Sorting methods:
- Date Added
- Rating
- Views
- Popularity
- Alphabetical
Sorting order:
- Ascending (A → Z / Low → High)
- Descending (Z → A / High → Low)
📱 Supported List Types
Movie Lists
- Popular movies
- Award-winning films
- Genre-based movies
- Era-based collections
TV Show Lists
- Popular series
- Indie shows
- Genre series
- Ongoing series
Combined Lists
- Sci-Fi movies & shows
- 2024 releases
- Must-watch classics
❓ Frequently Asked Questions
Q1: I can’t see my private lists after logging in. A: Ensure you authorized the app in your Trakt account settings.
Q2: Search can’t find a specific list. A: Try English keywords or verify the list URL.
Q3: How do I remove a list? A: Click the delete button on the list card.
Q4: What does the RPDB API Key do? A: It provides enhanced poster ratings and metadata.
Q5: Do lists update automatically? A: Yes, periodically. Some may require manual refresh.
Q6: Can I add lists from multiple users? A: Yes, as long as you have the correct URL and access permissions.
📞 Support
- Author: dexter21767
- GitHub: https://github.com/dexter21767
- Version: 0.2.7
🎓 Conclusion
The Trakt Lists plugin is a powerful content management tool, ideal for:
- 🎬 Movie enthusiasts
- 📺 TV series fans
- ✍️ Content creators
With proper configuration and usage, it helps you build a comprehensive and personalized movie and TV database.