Skip to content
Open the app

Chrome extension

The Ensō Reading extension adds a side panel to Chrome (or any Chromium browser: Edge, Brave…) that saves the current tab to a reading list, together with a complete offline copy of the page. Saved pages appear in the Reading app on every device within a sync cycle (about 15 seconds); the desktop app also downloads the offline copy so you can read it without a connection.

It needs Chrome 116 or newer.

The extension is not on the Chrome Web Store yet, so it installs “unpacked”:

  1. Get the extension folder:
    • From the web: download the extension zip from the downloads page (https://ensoapp.io/download/) and extract it.
    • From the desktop app: in Reading, click Browser extension. The app places its bundled copy in a folder, opens that folder in your file manager, and shows the steps below with the folder path and a Copy path button.
  2. Open chrome://extensions and switch on Developer mode (top right).
  3. Click Load unpacked and select the folder — or simply drag the folder onto the chrome://extensions page.
  4. Pin the Ensō button to the toolbar.

Optionally, open the extension’s Options page to check the Server URL. The default, https://app.ensoapp.io, is right for everyone.

Click the Ensō toolbar button to open the side panel and sign in with your Ensō email and password. You stay signed in until you click Sign out in the panel or go 90 days without opening it.

  1. Open the article and click the Ensō button; the side panel toggles open.
  2. Under Save to, pick a reading list (it defaults to Inbox and remembers your choice).
  3. Click Save page.

The page and its offline copy appear in the panel’s list and in Reading on every device. If Chrome cannot capture the page, the panel offers Save URL only, which saves the link without an offline copy.

The main button follows the page’s state in your reading lists:

If the current page is… The button reads And it…
Not saved Save page Captures it and adds it to the chosen list
Saved, unread Mark as Read Completes it in place — no duplicate
Saved and read Read ✓ — Save again Captures a fresh copy and puts it back as unread

Completing a page removes its offline copy (the link is kept), which is why Save again captures the page anew.

The panel shows the selected list: unread pages on top, a collapsible Completed (N) section, and — behind Show archived — an Archived (N) section. On each row you can mark it read or unread, archive or unarchive it, or delete it (click twice to confirm). Clicking a title opens the original page in a new tab. Refresh re-fetches the list.

If an upload fails — the server is unreachable, or the connection drops — the save is queued and retried automatically. A N queued pill in the footer shows how many are waiting.

The extension talks only to your Ensō server and sends nothing else anywhere. It asks Chrome for permission to capture the current tab, read its address and title, keep its sign-in and pending uploads, and show the side panel.