Satoshi WP

Calibre WP

Calibre WP is a WordPress plugin developed by SatoshiWP, currently in closed beta. This article provides a comprehensive overview of the features in Calibre WP 7.x.

I. Bridging Two Worlds

For anyone serious about knowledge work, books remain one of the most essential sources of insight. Chances are you’ve already accumulated hundreds — if not thousands — of eBooks in Calibre: technical manuals, academic texts, literary classics, industry reports. They sit on your self-hosted Calibre-Web server, neatly organized into carefully curated categories. And yet, between those books and your WordPress knowledge platform, there’s an invisible wall.

Calibre-Web, as the web interface for the world’s most popular open-source eBook management tool, offers robust library management — browsing, searching, downloading, user management, you name it. But it’s designed as a library manager, not a content publishing platform. Its interface is built for administration, not presentation. Its styling can’t be deeply customized, and it sits completely apart from your WordPress site in terms of both visuals and interaction. More critically, sharing your Calibre-Web login link means exposing your server address and port — a non-starter from a security standpoint.

WordPress, as the world’s most popular content management system, excels at publishing and presenting content. Its plugin ecosystem and flexible theming make it adaptable to virtually any content display need. What it lacks, however, is any native capability for eBook management or online reading.

💡 Calibre WP was built to bridge this gap. Using the OPDS (Open Publication Distribution System) protocol — an open standard designed specifically for eBook catalogs — it connects to your Calibre-Web server and seamlessly embeds your entire library into WordPress. Visitors can browse covers, search titles, and read EPUBs online, while your Calibre-Web server address stays hidden behind the WordPress proxy layer. Going further, integration with TriliumAI Chat turns AI into your personal “book review editor” and “reading companion” — whenever a new book appears in your library, AI can automatically draft a write-up and save it to Trilium Notes; while reading, you can highlight any passage, ask AI a question, and have the conversation automatically archived as a knowledge base note.

This isn’t just a book display tool. It’s a complete bridge connecting library management, online reading, AI assistance, and knowledge capture, adding unique value to your site and creating a genuine 1 + 1 > 2 synergy.

II. Core Philosophy & Architecture Overview

Calibre WP is built on a simple principle: “Protocol-first, secure proxy, native experience” — fetch data through open standard protocols, enforce security through the WordPress proxy layer, and deliver a first-class user experience through native frontend rendering.

📡 OPDS: The “Universal Language” of eBooks

OPDS is a catalog standard based on the Atom XML format, designed specifically for eBook publishing and distribution. Think of it as “RSS for eBooks” — just as RSS lets blog content be consumed by any feed reader, OPDS lets eBook catalogs be accessed by any compatible client. Calibre-Web natively supports OPDS, serving a standardized catalog feed at its /opds endpoint.

The beauty of OPDS lies in its openness. Whether your backend is Calibre-Web, Calibre Server, or any other system that supports OPDS, as long as it provides a standards-compliant OPDS feed, Calibre WP can connect to it. The plugin is bound to a protocol, not a product.

🏗️ 7.x Architecture: A “Less Is More” Rewrite

Calibre WP 7.0 marks the most significant architectural overhaul since the plugin’s inception. Earlier versions (≤4.x) relied on a PHP-based HTTP reverse proxy that piped the entire Calibre-Web interface through WordPress. Every page turn, every resource request had to pass through PHP for request forwarding and response rewriting. When Calibre-Web updated its internal URL structure, the proxy layer could break; every new frontend feature meant wrestling with cross-origin restrictions and CSP issues introduced by the proxy.

Version 7.0 made a fundamental decision: strip out the reverse proxy entirely, demoting Calibre-Web from a “proxied frontend” to a “pure data source.” Communication between WordPress and Calibre-Web was reduced to three clearly defined data flows:

  1. OPDS Metadata: Book listings and details fetched via the OPDS protocol (structured XML, highly cacheable)
  2. Cover Images: Retrieved through a lightweight image proxy and cached locally
  3. EPUB Files: Downloaded in full and cached locally
Old Architecture (≤4.x)                     New Architecture (≥7.0)

Browser ←→ WordPress(PHP Proxy) ←→ CW      Browser ←→ WordPress ←→ CW (OPDS only)
  │                                           │
  ├─ Page turn → PHP forward → CW render      ├─ First visit → Download EPUB → Local cache
  ├─ Each asset → PHP rewrite URL → CW        ├─ Subsequent pages → Pure frontend (zero server overhead)
  ├─ Session state → File JSON → PHP restore   ├─ Reading progress → user_meta / Cookie
  └─ TTS → Cross-iframe extraction → Edge TTS └─ Bookmarks → user_meta + EPUB CFI

The impact is dramatic: online reading went from “every action requires a server round-trip” to “fully offline once the EPUB is downloaded.” Server load shifted from linear growth to near-constant.

📌 Three-Layer Separation of Concerns

The refactored plugin follows a clean three-layer architecture:

LayerResponsibilityCore Module
Data Fetching LayerSends HTTP requests to Calibre-Web, retrieves OPDS XML dataCalibreOPDSClient
Business Logic LayerCoordinates data fetching, cache management, image proxying, file downloadsCalibreOPDSQuery (Singleton)
Presentation LayerFrontend bookshelf display, admin dashboard, online EPUB readingCalibreOPDSShortcodes, CalibreAdmin, CalibreFoliateReader

Beyond the core three layers, two important cross-ecosystem integration modules exist: the AI Article Generator (bridging the library, AI capabilities, and knowledge capture across three independent systems) and the In-Reader AI Assistant (embedded in the Foliate.js reader, connecting reading with reflection). The key design principle: all integration modules are optional — if TriliumAI Chat isn’t installed, AI features are silently disabled, and core library functionality remains completely unaffected.

III. Immersive Online Reading

One of Calibre WP’s most compelling features is its built-in online EPUB reader. It’s powered by Foliate.js — a high-quality open-source web reading engine (sharing its lineage with GNOME Books) that parses and renders EPUB files directly in the browser, with zero server involvement for page turns and resource loading.

📖 Why Foliate.js

FeatureFoliate.jsepub.js
RenderingShadow DOM isolationiframe embedding
Style IsolationPerfect isolation, immune to theme interferenceRequires additional handling
PaginationNative pagination, smooth page turnsPrimarily scroll-based
Bundle Size~150KB~200KB
MaintenanceActively developedRelatively stable

Foliate.js’s Shadow DOM architecture is an especially good fit for WordPress — no matter how complex your theme, the reader’s internal styles remain pristine. Pure client-side rendering, Web Components, native ES Modules, and the ability to bundle everything inside the plugin with zero external dependencies make it the ideal choice.

🔗 Clean URL Routing

The plugin registers native WordPress Rewrite Rules, creating clean URL endpoints for the reader:

/calibre-reader/{book_id}/

Compared to the old architecture’s proxy paths like admin-ajax.php?action=calibre_proxy&session=xxx&path=..., these URLs are not only easier to share and remember — they can be bookmarked, shared, and require no server-side session state. The entire session-restoration subsystem from the old version is gone.

📚 EPUB Fetching & Caching

CalibreFoliateEpubHandler manages EPUB retrieval from Calibre-Web with local caching, designed to handle URL variations across different versions and configurations:

  • Multi-path fallback strategy: Prefers the OPDS-provided path, then progressively falls back to alternative URL formats for maximum compatibility
  • EPUB signature verification: After each download, the first two bytes of the response body are checked for PK (the ZIP magic number), distinguishing a real EPUB file from a login redirect page
  • Caching policy: Valid EPUB files are cached locally for 30 days, served with full HTTP cache headers (Cache-Control, ETag) and Range request support

🔖 Bookmarks & Reading Progress

The plugin implements a complete bookmark management system based on EPUB CFI (Canonical Fragment Identifier):

  • 📌 Bookmarks: Users can place bookmarks at any position, recording the CFI location, chapter title, selected text snippet (truncated to 200 characters), reading percentage, and user notes. Bookmarks are deduplicated by CFI and sorted by reading percentage
  • 📌 Reading Progress: Uses a dual-storage strategy — logged-in users are stored in WordPress user_meta (synced across devices), anonymous users fall back to Cookie storage. The next time you open the same book, you’re automatically returned to where you left off
  • 📌 Migration Path: The code already includes “storage migration hooks,” paving the way for future migration of bookmarks from WordPress user meta to Trilium Notes — at which point your reading annotations will live alongside your knowledge base notes

🎛️ Reader Features at a Glance

  • ✅ Two reading modes: paginated (click or swipe) and continuous scroll
  • ✅ Auto-parsed EPUB table of contents with quick navigation
  • ✅ Adjustable font size, line height, margins, and typeface to suit your preferences
  • ✅ Automatic light/dark mode switching based on system settings
  • ✅ Edge TTS high-quality text-to-speech (details in the next section)
  • ✅ AI reading assistant (details in the AI section)

IV. Intelligent Text-to-Speech

Calibre WP’s TTS feature doesn’t rely on the browser’s built-in Web Speech API (which varies wildly in quality and offers limited CJK support). Instead, it leverages a standalone Edge TTS plugin that taps into Microsoft Edge’s neural speech synthesis service for high-quality text-to-speech.

🔊 “Server-Side Generation, Client-Side Playback”

User clicks "Read Aloud" → Reader extracts current paragraph text
      ↓
Frontend sends text to WordPress backend
      ↓
WordPress calls the Edge TTS service's API endpoint
      ↓
Edge TTS returns MP3 audio data
      ↓
WordPress caches the audio file and serves it to the browser
      ↓
Browser plays audio while highlighting the current paragraph

Speech synthesis happens server-side using Microsoft Edge’s professional-grade neural voice models — far more natural and fluent than any browser’s built-in synthesis engine. Generated audio is cached locally in WordPress — the same text is never synthesized twice, dramatically reducing API call frequency.

🎙️ Rich Voice Selection

Edge TTS offers a wide range of high-quality neural voices, including warm and lively female voices, deep and professional male voices, and more. Each voice supports multiple emotional styles — general, cheerful, sad, serious, gentle, lyrical, and others. Speech rate and pitch are fully adjustable.

🎵 Smart Reading Experience

The reader’s TTS module is a carefully engineered playback system:

  • 🏷️ Paragraph-level smart extraction — Automatically identifies readable paragraphs within the EPUB content (headings, body text, list items, blockquotes, etc.), skipping navigation bars, sidebars, and other non-content areas. Extra-long paragraphs are automatically split at sentence boundaries
  • 🏷️ Visual sync highlighting — The paragraph currently being read aloud is highlighted with a prominent visual style and auto-scrolled into the viewport
  • 🏷️ Intelligent prefetching — While the current paragraph plays, the next two paragraphs are preloaded in the background, ensuring seamless transitions
  • 🏷️ Cross-chapter continuous playback — When all paragraphs in a chapter are finished, the system automatically advances to the next chapter
  • 🏷️ Tap-to-read — Click any paragraph on the page to start reading aloud from that point
  • 🏷️ Variable speed playback — Supports 1.0×, 1.25×, 1.5×, 2.0×, and 2.5× speed, with your preference remembered
  • 🏷️ Position memory — Your read-aloud position is saved; the next time you open the same book, you can resume from where you stopped

🎧 Why Edge TTS instead of native browser speech? The Web Speech API’s quality varies by browser and OS, CJK voice options are extremely limited, and available voice lists differ across platforms. Edge TTS’s neural voices deliver consistent, high-quality results on every platform — especially important for CJK-heavy knowledge content.

V. AI-Powered: From Book Reviews to Reading Companion

Calibre WP’s AI capabilities span two dimensions: automated content production (the Article Generator) and interactive reading assistance (the In-Reader AI Assistant). These features are powered through integration with the TriliumAI Chat plugin, representing the most direct intersection between Calibre WP and the SatoshiWP AI ecosystem.

🤖 AI Article Generator

When new books are detected in the library, the plugin automatically invokes AI to draft a write-up and saves it to the Trilium Notes knowledge system.

New book added to Calibre-Web
      ↓ Cache refresh detects new title
Plugin compares current catalog against processed book list
      ↓ Unprocessed book found
Calls TriliumAI Chat's AI interface
      ↓ Using preset prompt template + book metadata
AI generates a write-up
      ↓
Saved to Trilium Notes

Three AI backends to choose from:

AI ProviderCharacteristicsBest For
Ollama (Local Models)Zero cost, privacy-safeRoutine book summaries, batch generation
Google GeminiHigh quality, web search supportIn-depth book analysis
OpenAI-Compatible APIFlexible, Poe API compatibleHigh-quality creative reviews

Prompts support variable placeholders (e.g. {{title}}, {{author}}), and administrators can customize templates in the dashboard. Batch generation uses sequential processing with throttle delays to avoid API rate limits, accompanied by a progress bar and real-time log output on the frontend. A processed-books list guarantees idempotency — each book triggers article generation exactly once.

📖 In-Reader AI Assistant

This is an interactive AI module embedded directly in the Foliate.js reader, seamlessly linking the acts of reading and thinking:

  • 🏷️ Highlight text — Select any passage in the book and an “Ask AI” button instantly appears near the selection
  • 🏷️ Quick actions — Clicking the button opens a side panel with preset prompts (“Explain this passage”, “Summarize the key points”, “Analyze in depth”), plus a field for custom questions
  • 🏷️ AI conversation — Your question, along with the selected text, is sent to TriliumAI Chat for processing. The AI response streams back in real time, rendered as Markdown
  • 🏷️ Auto-archiving — Every AI Q&A during a reading session is automatically saved to Trilium Notes, becoming a searchable, linkable permanent record

💡 The real value here is that it breaks down the traditional divide between “reading” and “knowledge management.” In the past, insights and questions that surfaced while reading would linger in your head or scatter across sticky notes. Now AI answers your questions on the spot, and the conversation is automatically captured in your knowledge base — the act of reading itself builds your knowledge library.

In terms of AI design philosophy, Calibre WP follows a “don’t reinvent the wheel” approach — the reader focuses on reading-context prompt construction (assembling the book title, selected passage, and user question into meaningful context), while all AI calls, conversation management, and note-saving are delegated to TriliumAI Chat.

VI. Multi-Layer Intelligent Caching

The plugin’s caching strategy is the backbone of its performance optimization. It implements a clearly delineated multi-tier cache system that strikes a careful balance between speed and data freshness.

⚡ Four-Tier Cache Architecture

Request arrives
  ↓
Tier 1: PHP Runtime Memory Cache (instant return for repeated calls within the same page load)
  ↓ miss
Tier 2: WordPress Transients Cache (database-level cache, 12-hour TTL)
  ↓ miss
Tier 3: PHP File Cache (local serialized data files, safety net for Transients)
  ↓ miss
Tier 4: Live OPDS API Call (fetches latest data from Calibre-Web)
  ↓ on success, writes back to all cache tiers

Each tier addresses a different concern: Runtime cache prevents redundant requests when multiple shortcodes appear on the same page. Transients cache provides cross-request data persistence. File cache ensures that if Transients are unexpectedly flushed by an object cache plugin, an API call isn’t immediately triggered. The live API is the last resort, invoked only when all tiers miss.

In addition, there’s a separate image cache (cover images cached locally for 30 days, 500MB cap, LRU eviction) and EPUB cache (reader EPUB files cached locally for 30 days), ensuring blazing-fast load times even for large libraries with hundreds of books.

🔍 Fingerprint Detection: Lightweight Change Discovery

Scheduled cache refreshes use a fingerprint detection mechanism: instead of pulling the full catalog, only the first page of the OPDS feed is requested, extracting the total book count and the first book’s ID to compute an MD5 fingerprint. A refresh is triggered only if the fingerprint changes; otherwise it’s skipped. This reduces the every-12-hours automatic check from “fetching metadata for hundreds of books” to “a single lightweight HTTP request.”

🔄 Three Refresh Modes

ModeMechanismBest For
Auto RefreshWP-Cron runs twice daily; fingerprint comparison, skipped if unchangedDay-to-day operations
Manual RefreshOne-click from the admin dashboard; Transient lock prevents concurrent runsAfter bulk imports
External CronKey-protected HTTP endpoint, compatible with system crontabEnvironments requiring high reliability

🖼️ Cover Image Proxy

While the reverse proxy was removed, cover images still need to pass through WordPress — this is the only “proxy” function retained in 7.x, and it’s orders of magnitude simpler than the old full-site reverse proxy. The proxy layer integrates local caching and HTTP ETag support. For books without covers, it provides multi-level fallbacks: a preset placeholder image is preferred; if unavailable, the GD library dynamically generates a placeholder displaying the book title’s first letter — ensuring the frontend never shows broken image icons.

VII. User-Centered Interface Design

Calibre WP follows the principle of “clean, intuitive, responsive” in its interface design — making complex features easy to understand and use while minimizing cognitive load.

📚 Flexible Library Display

A simple shortcode [calibre_books] embeds the full library display and search interface into any WordPress page or post. The plugin offers a rich set of parameters:

ParameterDescriptionDefault
typeDisplay mode: new (latest additions) / search (search results)new
querySearch keywordempty
show_title / show_authorWhether to display title / authortrue
show_formatWhether to display available format badgestrue
show_descriptionWhether to display book descriptiontrue
show_download / show_readWhether to display download / read online buttonstrue
show_searchWhether to display the search bartrue
placeholderSearch bar placeholder textSearch books...

🎯 For example: [calibre_books type="search" query="Python" show_search="false"] creates a Python-themed bookshelf; [calibre_books show_download="false"] creates a browse-only preview mode.

🔍 Smart Search & Pagination

Search is executed asynchronously via AJAX — no page reloads, with results dynamically replacing the current display. Pagination uses an “ellipsis” algorithm — when the total page count is high, only the first, last, and nearby pages are shown, with ellipses in between.

⚡ Hybrid Rendering Strategy

To ensure fast loading for large libraries, the shortcode implements a hybrid rendering strategy:

  • 📌 First 10 books: Server-side rendered in PHP, visible on initial load
  • 📌 Remaining books: Serialized as JSON in the page, rendered client-side by JavaScript using DocumentFragment in batches (10 books per batch, scheduled via setTimeout) to avoid blocking the main thread
  • 📌 CSS Containment: The book list container uses contain: content, isolating repaint boundaries

🌓 Automatic Light/Dark Mode

The plugin intelligently adapts to light and dark modes based on the user’s system settings. In dark mode, the interface shifts to a color scheme optimized for nighttime reading, reducing screen glare. Whether you’re quickly browsing on a phone or leisurely reading on a tablet or desktop, Calibre WP delivers a perfectly adapted visual experience.

📥 Secure Download Proxy

All book file downloads pass through the WordPress proxy layer: the Calibre-Web server address is completely hidden from users; files are streamed in 8KB chunks so even large files don’t exhaust memory; a HEAD preflight verifies file size (100MB cap) before download; filenames are automatically extracted and sanitized via sanitize_file_name() to prevent path traversal attacks.

VIII. Comprehensive Admin Dashboard

Calibre WP’s backend has grown from a simple settings page into four dedicated admin pages, each with a clear purpose:

PageFunction
📊 Main PageInteractive book search and shortcode generator
⚙️ OPDS SettingsConnection configuration, connection testing, feature documentation
🗂️ Cache ManagementCache status dashboard, manual refresh, external Cron setup, statistics table, operation logs
❓ Help PageShortcode usage, cache overview, reader guide, troubleshooting

The Cache Management page uses a responsive CSS Grid two-column layout, grouping related cards side by side based on information relevance. All AJAX operations are protected by WordPress Nonce verification, and administrative actions require manage_options capability.

IX. Security by Design

Rigorous security practices are woven throughout the entire plugin:

  • 🔐 AJAX Endpoints: All protected by WordPress Nonce verification; admin endpoints require manage_options capability
  • 🔐 EPUB Endpoints: Use book-level Nonces (calibre_foliate_epub_{book_id}) to prevent unauthorized access
  • 🔐 Cache Directories: Each directory contains index.php and .htaccess to prevent directory listing
  • 🔐 External Cron: Protected by a 32-character random key, regeneratable at any time
  • 🔐 Manual Refresh: Transient lock (5-minute timeout) prevents concurrent execution
  • 🔐 Download Proxy: HEAD preflight verifies file size (100MB cap), 8KB chunked streaming
  • 🔐 Filename Handling: sanitize_file_name() prevents path traversal attacks

X. Position in the SatoshiWP Plugin Ecosystem

Calibre WP isn’t an isolated plugin — it’s an integral part of SatoshiWP’s sovereign personal knowledge infrastructure. When used alongside the Trilium family of plugins, a complete knowledge workflow emerges:

You manage your eBooks in Calibre
      ↓
Calibre WP publishes the library on your WordPress site
      ↓
Foliate.js reader lets you read in the browser
      ↓ (Future: bookmark migration to Trilium Notes)
Annotations and notes from reading are captured in the knowledge base
      ↓
AI Article Generator drafts write-ups for new books
      ↓
Write-ups are saved to Trilium Notes
      ↓
TriliumAI Chat's context features let AI "remember" what you've read
      ↓
A complete cycle: Read → Annotate → Knowledge Capture → AI Enhancement

Each component is independent yet collaborative:

ComponentRelationshipFunction
Calibre WP (Core)StandaloneLibrary display, online reading, cache management
TriliumAI ChatOptional integrationAI article generation + in-reader AI assistant
Trilium NotesOptional integrationArticle storage + AI Q&A archiving + future bookmark migration
Edge TTSOptional integrationHigh-quality neural text-to-speech
Trilium WPEcosystem synergyKnowledge base display, forming a complete “knowledge + books” content platform alongside the library

Calibre WP works perfectly on its own — even without any Trilium plugins or Edge TTS, the core features — library display, search, online reading, and cache management — are fully functional. AI article generation, the in-reader AI assistant, and Edge TTS are “nice-to-haves” that showcase the power of the SatoshiWP ecosystem, but they’re not prerequisites.

XI. Real-World Use Cases

Calibre WP’s flexibility makes it well-suited for a wide range of knowledge-sharing and reading scenarios.

📚 Personal Reading Site

Build a beautiful personal reading platform to showcase your collection, read online, and let AI write your book reviews. Combined with WordPress’s blogging capabilities, you can create monthly or quarterly reading roundups linked to your eBook library, forming a complete reading-log system. With Calibre WP, your Calibre library transforms from a private management tool into a vibrant reading portal.

🎓 Educational & Research Resource Hub

Teachers and educators can create course-specific eBook resource centers — consolidating textbooks, reference materials, and supplementary reading in one place where students can easily find and download what they need. The online reader lets students start reading without installing any client software. For research teams, create topic-specific bookshelves using different search parameters on different pages: [calibre_books type="search" query="machine learning"].

👥 Team & Community Shared Library

Leverage WordPress’s user role system for permission tiers — all visitors can browse the catalog, but only logged-in users can download and read online. Combine with a membership plugin (such as BuddyBoss or MemberPress) to offer “premium members only” access to the full library. With AI article generation enabled, every new book automatically gets a write-up, creating a complete “library + reviews” content ecosystem.

🌱 The Reading Layer of Your Digital Garden

When Calibre WP and Trilium WP work together — Trilium WP provides structured knowledge display, Calibre WP provides the eBook library and online reading — your WordPress site evolves from a plain blog into a full-fledged “digital garden.” Visitors can explore your knowledge notes and browse your bookshelf, reading recommended titles online. AI conversations and annotations made during reading flow back into the Trilium Notes knowledge base, creating a virtuous cycle of knowledge.

XII. The Evolving Calibre Ecosystem

The Calibre ecosystem itself is evolving rapidly. Within SatoshiWP’s open-source research community, members have been following and discussing two noteworthy emerging projects:

🔧 Calibre-Web Automated (CWA)

An enhanced automated eBook management system built on top of Calibre-Web, positioned as an “all-in-one solution.” Version 3.1.x introduced Hardcover integration, KOReader sync, Calibre plugin support, and other new features. Built on SQLite, it maintains solid performance even with libraries of 10,000+ titles and offers full Unicode/CJK support. CWA represents the “in-place upgrade” approach to Calibre-Web — adding layers of automation on top of the existing core architecture to make library management more hands-off.

📱 Anx Calibre Manager

A mobile-first modern web application that connects to your existing Calibre Content Server. It provides a multi-role user system, invite-code registration, KOReader sync, smart Kindle delivery, a built-in WebDAV server, and one particularly eye-catching feature — AI conversations with any book in your library. Even more notable, it includes a standards-compliant MCP (Model Context Protocol) server, allowing AI agents or external tools to interact with your library securely via API.

The emergence of these projects confirms a trend: library management is shifting from “humans operating on data” to “AI agents operating on data.” Calibre WP’s current design — OPDS-based data retrieval, AI-generated book reviews, an in-reader AI assistant — is already practicing this very direction.

XIII. Roadmap & Future Vision

While Calibre WP already offers a rich feature set, the continuous evolution of technology and user needs opens up exciting possibilities for the plugin’s future.

🔮 Bookmark Migration to Trilium Notes

Migrating the reader’s bookmarks and annotations from WordPress user meta to Trilium Notes, fully merging reading annotations with knowledge base notes. You’ll be able to search Trilium for “which book and where did I highlight something about ‘quantum computing,’” and AI will be able to cite your reading annotations in conversations.

🔮 Smart Recommendations Based on Reading History

When AI “knows” what you’ve read (through book reviews and reading notes captured in Trilium Notes), it can recommend your next great read based on your preferences and knowledge graph.

🔮 Cross-Book Knowledge Synthesis

Leveraging TriliumAI’s context capabilities, AI can perform synthesis across multiple books. For instance, ask “How do these three AI books differ in their views on consciousness?” and AI can draw from multiple titles in your library to deliver a comparative analysis.

🔮 Smart Chapter Summaries & Reading Companion

After each chapter, AI automatically generates a summary and connects it to your reading history, discovering intellectual threads between books. Beyond Q&A, it proactively asks questions, challenges your assumptions, and runs Feynman-style comprehension checks — a genuine “co-reading” experience.

🔮 Voice-Interactive Reading

Combining Edge TTS’s read-aloud capabilities with the AI assistant — pause the narration, ask a question by voice, hear AI’s response, and resume reading, creating a fully hands-free intelligent reading experience.

XIV. Start Your eBook Library Journey

Calibre WP makes building a professional eBook library simple and elegant. It bridges the full path from library management to online reading, from AI assistance to knowledge capture.

🚀 Three Steps to Get Started

  1. Set up your Calibre-Web server — Make sure OPDS is enabled on your Calibre-Web instance. Verify that you can access http://your-address/opds in a browser and see XML-formatted catalog data.
  2. Install and configure Calibre WP — Install it like any other WordPress plugin. Go to Calibre Books → OPDS Settings, enter your server address and credentials, and hit “Test Connection” to confirm everything works.
  3. Embed the library — Drop the [calibre_books] shortcode into any page or post, and your eBook library appears instantly. Optionally install TriliumAI Chat to unlock AI features, and Edge TTS for text-to-speech.

🌿 In an era of information fragmentation, books remain humanity’s most enduring vehicle for knowledge. Calibre WP, and the broader SatoshiWP technology ecosystem it belongs to, harnesses today’s most powerful tools — open-source software, self-hosting, AI — to safeguard that timeless core. When your AI assistant can browse your entire bookshelf, when your reading notes automatically weave into your knowledge graph, when every new arrival gets an AI-written introduction — technology fades into the background, leaving only a deeper, freer connection between you and your books, your thoughts, your knowledge.

Note: Before using this plugin, please ensure you have the legal right to share the eBooks in question and comply with all applicable copyright laws and regulations. Calibre WP is committed to advancing knowledge dissemination while respecting the rights of creators.