Miniflux WP is an all-in-one WordPress plugin built for Miniflux RSS reader users. It bridges the gap between your self-hosted RSS reader and your WordPress site, transforming RSS content from a “read-and-forget” stream into raw material that can be showcased, subscribed to, and deeply processed by AI.
Picture this: every day you skim through hundreds of RSS articles in Miniflux, but never have the time to truly digest them all. Now, all you need is a single task configured in your WordPress dashboard — and every Monday at 8 AM, AI automatically pulls the past week’s articles from Miniflux, generates a well-structured topic briefing, and saves it to your Trilium knowledge base. All before you’ve even opened your eyes.
Meanwhile, your WordPress homepage is presenting the latest RSS content from Miniflux in beautifully organized category tabs for your visitors to browse. And when you stumble upon a YouTube channel or Twitter account worth following, just paste the link into the quick-subscribe panel on the front end — Miniflux picks up a new subscription instantly.
Three capabilities. One plugin. Done.
🏗️ The Big Picture: Three Modules, One Entry Point
Miniflux WP is composed of three functional modules, all managed within a single plugin and sharing one unified Miniflux connection configuration:
┌──────────────────────────────────────────────────────────┐
│ WordPress Site │
│ │
│ ┌──────────────────┐ ┌──────────────┐ ┌───────────┐ │
│ │ 📰 RSS Digests │ │ 📺 Content │ │ ⚡ Quick │ │
│ │ │ │ Display │ │ Subscribe │ │
│ │ 🤖 AI Summaries │ │ 🧱 Gutenberg │ │ 🔗 Smart │ │
│ │ ⏰ Scheduled Runs │ │ 📋 Shortcodes │ │ Detect │ │
│ │ 📝 Save to │ │ 🎨 4 Layouts │ │ 📺 YouTube │ │
│ │ Trilium │ │ 🔄 Auto- │ │ 🐦 Twitter │ │
│ │ 📊 Multi-task │ │ Refresh │ │ 📡 Generic │ │
│ │ Management │ │ │ │ RSS │ │
│ └──────────────────┘ └──────────────┘ └───────────┘ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌──────────────────────────────────────────────────┐ │
│ │ 📡 Miniflux RSS Reader (Unified Conn.) │ │
│ │ ┌─────────────────────────────────────────┐ │ │
│ │ │ Trilium AI Chat · Trilium WP · Trilium │ │ │
│ │ │ Notes Knowledge Base (Storage) │ │ │
│ │ └─────────────────────────────────────────┘ │ │
│ └──────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────┘RSS Digests is the core engine — it periodically pulls articles from Miniflux, hands them to AI for structured briefing generation, and archives the results in Trilium Notes. Content Display is the front-end window — it renders RSS content for visitors using Gutenberg blocks and shortcodes across multiple layout options. Quick Subscribe is the productivity tool — it provides a front-end interface for adding RSS feeds to Miniflux with one click, with smart detection for YouTube, Twitter, and more.
The three modules work independently or in concert — you can use Content Display alone to build an RSS aggregation page, or wire all three together into a complete information pipeline: Subscribe → Read → Summarize → Archive.
📰 RSS Digests — Let AI Read Everything So You Don’t Have To
The RSS Digest module is the core engine of Miniflux WP. It tackles a classic dilemma of the information age: you’ve subscribed to more sources than you could ever keep up with.
⏰ Set It and Forget It
Each digest task is a fully automated pipeline — from pulling articles to generating briefings to archiving — with zero manual intervention required:
📡 Pull from Miniflux ──► 🔍 Filter & Select ──► 🤖 AI Generates Digest ──► 📝 Save to Trilium Notes
│ │ │ │
By time range By feed/unread Auto-fill placeholders Auto-naming
By max count Flexible selection Multi-language support Auto-tagging
Choose your AI modelYou can schedule tasks to run every morning, every Monday, or the 1st of every month at a specified time. The system checks for due tasks every 15 minutes via WordPress native Cron, with transaction locking to prevent duplicate execution.
📋 Multiple Tasks, Each With Its Own Mission
You can create multiple independent digest tasks, each with its own configuration, schedule, and execution history. This means you can tailor digest strategies to different domains of interest:
- 📰 Tech Weekly — Automatically pulls from tech-related feeds every Monday, generates a briefing in Chinese
- 📖 English News Daily — Pulls from English-language feeds every morning, generates summaries in English
- 🔬 Research Monthly — Pulls from academic feeds on the 1st of each month, generates in-depth analysis reports
- 🎯 Ad-Hoc Deep Dive — Manually triggered, for one-off deep dives into topic-specific feeds
Each task runs, counts, and tracks independently. From the dashboard or front end, you can instantly see which tasks succeeded, how many articles were processed, and how long it took.
🤖 AI Configuration: Fine-Grained Control
The heart of digest generation is the AI layer — and you have full control over its behavior:
- 🧠 Choose Your Model — Each task can use a different AI model. Bring out the heavy hitters for deep analysis, use lighter models for routine briefings — balance cost and quality however you see fit
- 📝 Fully Customizable Prompts — A battle-tested default prompt template is included, but you can rewrite it entirely. Use the
{articles}placeholder to mark where articles get injected; everything else — the AI’s role, output format, and focus areas — is yours to define - 🌐 Multi-Language Output — Supports Chinese and English output, with language directives automatically injected before AI processing
- 🔌 Reuse Your Existing AI Infrastructure — Hooks directly into the AI services already configured in the Trilium AI Chat plugin (Google Gemini, OpenAI/POE, Ollama, etc.) — no need to set up API keys again
🔄 Smart Nitter Link Replacement
If you subscribe to Twitter/X content via a Nitter instance, the digest generator will automatically restore Nitter links back to their original x.com URLs. It intelligently matches subdomains — configure xcancel.com, and rss.xcancel.com, www.xcancel.com, and other variants will all be correctly detected and replaced.
📝 Save to Trilium Notes: Knowledge That Accumulates Itself
Generated briefings are automatically converted to HTML and saved as child notes under a designated directory in Trilium Notes. Note titles support template variables — Week {week}, {year} RSS Briefing auto-fills to something like “Week 11, 2026 RSS Briefing.” You can also attach custom labels for easy retrieval and organization.
Each briefing automatically includes generation metadata at the bottom: task name, date range, and generation timestamp — so you can always trace where a briefing came from.
📺 Content Display — Bring Your RSS Content to Life on WordPress
The Content Display module gives your Miniflux subscriptions a second life on your WordPress site. Whether you’re building an internal news aggregation page for your team or offering curated reading lists for your blog readers, it handles it all.
🧱 Gutenberg Block: Visual Configuration, WYSIWYG
Search for “Miniflux RSS” in the WordPress editor to add an RSS display block. A rich inspector panel lets you configure everything without writing a single line of code:
- 📋 Feed Selection — Browse by category, check the feeds you want to display, or select “All” to include everything
- 🔍 Content Filtering — Set time range (1/3/7/14/30 days), max items, or show unread only
- 🎨 Display Styles — List, grid, or card layout, with customizable 2–4 columns in grid mode
- 📂 Grouping — Group by category or by source for clear hierarchy
- 🔄 Auto-Refresh — Set refresh intervals (30 seconds to 1 hour); new entries appear with a smooth fade-in animation
The editor shows a live preview of the 5 most recent items; the full display renders on the published page. Pair it with WordPress’s wide/full-width alignment for seamless integration with any page layout.
📋 Shortcodes: Flexible Full-Category Display
When you need to display content from all categories in Miniflux, shortcodes offer more flexibility:
[miniflux_feeds] — Default tabbed layout
[miniflux_feeds layout="accordion"] — Accordion (collapsible) layout
[miniflux_feeds layout="grid" columns="3"] — Three-column grid layout
[miniflux_feeds category="Tech,Design" layout="tabs"] — Filter by categoryFour layout modes, each with its own strengths:
- 📑 Tabs — Categories as top-level tabs, click to switch — ideal for many categories
- 🪗 Accordion — Categories expand/collapse in layers, saves space — great for mobile
- 📊 Grid — Categories as card grids, high visual impact — perfect for wide screens
- 📃 List — Clean, compact list mode — maximum information density
Every layout comes with polished interactions: staggered fade-in animations on entry, a modal popup on article click that loads the full original content with attachments and estimated reading time — all smooth and natural.
🌓 Native Dark Mode
All display components are driven by CSS variables powering a full light/dark theme system. They follow the system preference automatically and respond to your WordPress theme’s dark mode settings — no matter what device or theme your visitors use, the RSS display blends right in.
⚡ Built-In Smart Caching
Front-end display uses the WordPress Transient API to cache Miniflux API responses. The default cache period is 300 seconds, adjustable from the unified settings page. Identical requests never hit the Miniflux API twice — protecting your reader’s performance while speeding up page loads.
⚡ Quick Subscribe — See Something Good? Subscribe in a Second
The Quick Subscribe module solves an everyday pain point: you spot a great feed while browsing, but to add it you’d have to open the Miniflux backend, navigate to the subscription page, paste the URL, pick a category… by the time you’re done, the impulse is gone.
Now, just drop a [trd_quick_subscribe] shortcode on any WordPress page, and you get a clean, efficient subscription panel.
🔗 Smart Link Detection
Paste a URL and the plugin automatically identifies its type and converts it for optimal subscription:
- 📺 YouTube Channels/Playlists — Automatically extracts the channel ID and converts it to an RSS feed URL. Supports
youtube.com/channel/,youtube.com/@handle,youtube.com/playlist, and other formats - 🐦 Twitter/X Accounts — Automatically converts to an RSS feed URL via your configured Nitter instance. Paste
x.com/usernameand the plugin generatesnitter-instance/username/rss - 📡 Standard RSS/Atom Links — Used directly with automatic format validation
📦 Batch Subscribe
Paste one URL per line in the input field and click once to add them all. The system processes each link sequentially, automatically skips duplicates (feeds already subscribed in Miniflux), and provides clear status feedback for every link.
📂 Category Management
When subscribing, pick a category from the dropdown populated with your existing Miniflux categories — new feeds are automatically filed into the right folder. The category list is fetched in real time from the Miniflux API, always in sync with your reader.
🎛️ Unified Admin Dashboard
All three modules share a clean, well-organized management interface, presented under a dedicated 📡 Miniflux WP top-level menu in the WordPress sidebar:
| Tab | Function |
|---|---|
| 📋 Task Management | View, create, edit, duplicate, delete, and manually run digest tasks. Toggle switches for enabling/disabling — one-click operation |
| ⚙️ Global Settings | Miniflux connection config (shared across all modules), Nitter domain, RSS cache duration, digest task defaults |
| 📊 Execution History | Last 50 task execution records, including status, duration, articles processed, and note ID |
| 📝 Shortcodes | Complete documentation for all 6 shortcodes with parameter descriptions and usage examples — one-click copy |
You can also bypass the WordPress admin entirely and manage everything from the front end — the [trd_dashboard] shortcode provides a fully functional management panel with Task Management, Global Settings, and Execution History tabs. Especially handy for users who prefer staying out of the WordPress backend.
📊 Feature Overview
| Capability | Details |
|---|---|
| 📡 Miniflux Connection | Unified configuration shared across all modules, one-click connection test |
| 📰 Digest Generation | Multi-task, multiple scheduling strategies, custom AI prompts, multi-language output |
| 🤖 AI Integration | Leverages Trilium AI Chat’s multi-model support (Gemini / OpenAI / Ollama) |
| 📝 Trilium Storage | Auto-converts to HTML, title template variables, custom labels, generation metadata |
| ⏰ Scheduled Execution | Manual / daily / weekly / monthly, 15-minute granularity checks, transaction locking to prevent duplicates |
| 🧱 Gutenberg Block | Visual configuration, list/grid/card layouts, grouped display, auto-refresh |
| 📋 Display Shortcodes | Tabs / accordion / grid / list — four layouts with category filtering |
| 🔍 Content Preview | Modal popup with full original content, attachment display, reading time estimate |
| ⚡ Quick Subscribe | Smart detection for YouTube / Twitter / generic RSS, batch add, duplicate checking |
| 🔄 Nitter Replacement | Configure once globally, applied automatically in both digest and subscribe modules |
| 💾 Smart Caching | Transient API caching with configurable duration, protects Miniflux performance |
| 🌓 Dark Mode | CSS variable-driven, auto-switches based on system preference |
| 📱 Responsive Design | Both admin and front-end fully adapted for mobile |
| 🔐 Permission Control | Admin operations require manage_options capability; content display is public |
🚀 Getting Started
📋 Prerequisites
- ✅ WordPress 5.8 or higher
- ✅ PHP 7.4 or higher
- ✅ A running Miniflux instance (with API enabled and an API key created)
If you plan to use the digest generation feature:
- ✅ Trilium AI Chat plugin (provides AI model access)
- ✅ Trilium WP plugin (provides Trilium Notes API connection)
- ✅ A running Trilium Notes instance
📥 Three-Step Setup
1️⃣ Upload & Activate — Upload miniflux-wp.zip in the WordPress admin and activate the plugin. The 📡 Miniflux WP menu appears in the sidebar.
2️⃣ Configure Connection — Go to the Global Settings tab, enter your Miniflux API URL and API Key, and hit “Test Connection” to confirm everything’s working.
3️⃣ Start Using —
- Want to display RSS content? Add a Miniflux RSS block in the editor, or insert
[miniflux_feeds]on any page - Want AI-generated briefings? Head to the Task Management tab and create your first digest task
- Want quick subscriptions? Drop
[trd_quick_subscribe]on any page
📋 Shortcode Quick Reference
| Shortcode | Purpose | Visibility |
|---|---|---|
[miniflux_feeds] / [mrb_feeds] | Front-end RSS content display | All users |
[trd_dashboard] | Full management panel (tasks + settings + history) | Admins |
[trd_task_list] | Task list only | Admins |
[trd_execution_history] | Execution history only | Admins |
[trd_quick_subscribe] | Quick subscribe panel | Admins |
🗺️ Design Philosophy & Roadmap
🧩 Why Merge Three Into One?
Miniflux WP started life as three separate WordPress plugins, each serving a distinct role around the Miniflux RSS reader. But as the features evolved, the overlap between them kept growing — shared Miniflux connection configs, interdependent function calls, scattered admin interfaces.
The merge wasn’t a simple copy-paste job. We went back to first principles, re-examined the dependency topology of all three plugins, and restructured them into a modular architecture within a single unified codebase. Each module retains its internal logic and independence while sharing connection configuration, the admin interface, and common infrastructure. The result: one plugin for the user, three well-scoped modules under the hood.
🔮 What’s Next
The consolidation of Miniflux WP is just the beginning. Here’s what we’re planning to roll out incrementally:
🔗 Unified Miniflux Client — Currently, the digest and display modules each maintain their own Miniflux API client. The next step is merging them into a single client class that combines the display module’s caching with the digest module’s flexible querying.
📊 Richer Analytics — Leveraging Miniflux’s reading data to provide feed activity analysis, reading trend statistics, unread backlog alerts, and visual dashboards.
🔄 Two-Way Sync — The current data flow is one-directional (Miniflux → WordPress). In the future, we’ll explore syncing WordPress-side actions (mark as read, star, annotate) back to Miniflux.
🧠 Deeper AI Integration — Beyond generating digests, AI could recommend new feeds worth following based on your reading history, detect filter bubbles, and automatically optimize your subscription list.
🧑💻 About Us
Miniflux WP is developed and maintained by SatoshiWP, released under the GPL v2+ open-source license. It’s part of the Trilium AI ecosystem, working alongside Trilium AI Chat, Trilium WP, and other plugins to build a complete pipeline from information intake to knowledge retention.
We believe self-hosting shouldn’t mean compromising on experience. Miniflux is one of the best self-hosted RSS readers out there — and Miniflux WP’s mission is to unlock its full potential within the WordPress ecosystem.
📡 Miniflux WP — Your RSS subscriptions shouldn’t just be another overflowing inbox. Let AI do the reading, let WordPress handle the presentation, and let automation take care of the archiving. From information overload to accumulated knowledge — one plugin, fully covered.