Tinyflux – A browser extension for Miniflux

Tinyflux is a lightweight browser extension for Miniflux, offering a clean reading experience directly in your browser.

✨ Features

• Intuitive Interface: Simple and easy to navigate.
• Unread Count Badge: View unread items directly from the extension icon.
• Cross-Browser Support: Compatible with Chrome, Firefox, Edge, and other modern browsers.
• In-Browser Reading: Read full articles without opening new tabs or windows.
• Optional Notifications: Stay updated with notifications for new items.
• Optional Sidebar Integration: Access your feeds in a dedicated sidebar for better multitasking.
• Multi-Language Support: Currently available in English and Spanish.
• Dark and Light Modes: Toggle between themes based on your preference.
• Bookmarks: Save articles to read later.
• Quick Actions: Mark items as read with one click.

🧩 Requirements

To use Tinyflux, you need a running Miniflux instance. You can either:

• Use a public instance, like Miniflux Cloud.
• Self-host using the official Miniflux Docker image.

Click here to see how to run Miniflux with 🐳 Docker Compose

Create a compose.yaml file:

services:
  db:
    restart: unless-stopped
    image: postgres:17
    environment:
      - POSTGRES_USER=miniflux
      - POSTGRES_PASSWORD=miniflux
      - POSTGRES_DB=miniflux
    volumes:
      - db:/var/lib/postgresql/data

  miniflux:
    restart: unless-stopped
    image: miniflux/miniflux:latest
    environment:
      - DATABASE_URL=postgres://miniflux:miniflux@db/miniflux?sslmode=disable
      - RUN_MIGRATIONS=1
      - CREATE_ADMIN=1
      - ADMIN_USERNAME=admin
      - ADMIN_PASSWORD=password
    ports:
      - "8080:8080"
    depends_on:
      - db

volumes:
  db:

ℹ️ Note: Replace ADMIN_USERNAME and ADMIN_PASSWORD with secure credentials.

Run the following command to start a Miniflux instance locally

docker compose up -d

See the Miniflux installation guide for more details.

🔑 Generating an API Token

Tinyflux requires a Miniflux API token. You can generate one in your Miniflux account settings:

🚀 Getting Started

1. Install the extension:

   • Firefox Add-on
   • Chrome Web Store

2. Configure Tinyflux:

   • Enter your Miniflux API endpoint and token.
   • Click "Test Connection" to verify your setup.
   • Save your configuration.

3. Start Reading:

   • Browse and read your feeds directly within the extension.

🛠️ Installing from Source

Ideal for developers or advanced users:

1. Clone the Repository:

   git clone https://github.com/jlsalvador/tinyflux.git
   cd tinyflux

2. Install Dependencies:

   npm ci

3. Build the Project:

   npm run build

4. Load the extension in your browser:

   • Firefox:

     1. Visit about:debugging.
     2. Click "This Firefox".
     3. Select "Load Temporary Add-on…".
     4. Choose the dist/tinyflux.version.xpi file.

   • Chromium-based browsers (Chrome, Edge, etc.):

     1. Open chrome://extensions.
     2. Enable Developer mode.
     3. Click "Load unpacked".
     4. Select the dist/chromium directory.

🤝 Contributing

Contributions are welcome! Open issues, submit pull requests, or suggest features to help improve Tinyflux.

📄 License

This project is licensed under the Apache 2.0 License.