Miniflux Companion

Unread badge and optional three-pane reader for your self-hosted Miniflux server.

Miniflux Companion Miniflux Companion is a Chrome and Chromium Manifest V3 extension for self-hosted Miniflux servers. It displays the unread item count in the browser toolbar, opens the standard Miniflux interface, and optionally provides an enhanced three-pane reader. The extension communicates directly with the Miniflux server configured by the user. It does not require an intermediary service, cloud account, or external application backend. Core Features • Unread-count toolbar badge • Configurable refresh interval • Configurable badge colors • Standard Miniflux interface • Configurable landing page • Open a new tab or focus an existing tab • Optional enhanced three-pane reader • Self-hosted Miniflux support Enhanced Reader Features • Three-pane reader layout • Collapsible and resizable panes • Persistent pane widths • Category and feed navigation • Feed and category maintenance • Contextual search • Read and unread controls • Mark visible articles as read • Automatic title-based read filters • Bookmark support • Telegram sharing • Email sharing • Copy article title and link • Keyboard navigation • Light, dark, and system themes • Configurable item limit How It Works The extension periodically queries the configured Miniflux server to update the toolbar badge. When the extension icon is clicked, it opens either the standard Miniflux interface or the enhanced reader, depending on the selected option. It can open a new tab or focus an existing Miniflux tab. The enhanced reader communicates with Miniflux through its API. Changes to reading status, bookmarks, feeds, and categories are written back to the user’s Miniflux account and remain visible in the standard Miniflux interface and other Miniflux clients. Optional automatic-read filters can mark articles as read when their titles contain user-defined words or phrases. Matching is case-insensitive, and the articles remain stored in Miniflux. Privacy Miniflux Companion handles only the information required to connect to and operate with the user-configured Miniflux server. The developer does not receive, collect, sell, or share this information. • Connects only to the configured Miniflux server • Stores the server URL locally • Stores the API token locally • Stores the username and user ID locally • Stores settings and preferences locally • Does not use Chrome Sync • Retrieves feed and article content from Miniflux • May cache layout settings and favicons locally • Shares articles only after user action • No analytics, advertising, or tracking • No telemetry • No remote executable code • No external application service • No developer-operated intermediary server License Miniflux Companion is licensed under the GNU General Public License version 3.0 or, at your option, any later version.