Skip to content

Web clipper ​

The Aurora Web Clipper is a browser extension that saves pages and selections into Aurora.

What It Captures ​

The current clipper supports:

  • Clip page: creates a Bookmark page, sends it to Inbox, and stores the source URL.
  • Clip selection: creates a Page with the selected content quoted in the body, sends it to Inbox, and stores the source URL.

Selection clipping preserves basic formatting such as bold text, links, and lists. Relative links are saved against the original page URL.

Where Clips Go ​

Clips land in Inbox so you can process them later:

  • tag them
  • move them into a space or folder
  • convert a capture into a task when appropriate
  • link them into existing notes

See Inbox & capture for the triage flow.

Install ​

The clipper runs in Chrome, Edge, Brave and other Chromium browsers. It has its own version number and is released separately from the Aurora apps.

  1. Download the latest ZIP from the Aurora download page, or from the public releases page.
  2. Unzip it into a folder you will keep. The browser loads the clipper from that folder, so do not move or delete it later.
  3. Open chrome://extensions (in Edge, edge://extensions).
  4. Turn on Developer mode.
  5. Choose Load unpacked and pick the unzipped folder: the one that holds manifest.json.
  6. Optional: pin Aurora Web Clipper from the browser's Extensions menu so it stays in the toolbar.

Connect to Aurora ​

  1. Click the clipper in the toolbar.
  2. Open Connection settings. Keep the API URL https://api.aurora.ink unless you use a self-hosted server, then ask its administrator for the URL.
  3. In Aurora, open Settings → Workspace, copy the Workspace ID, and paste it into the clipper.
  4. Sign in the way you sign in to Aurora:
    • with your Aurora email and password, or
    • with Continue with Google, GitHub, Apple or Microsoft. A window opens for that service. When you finish there, it closes and the clipper is signed in. The clipper never sees your password for that service.
  5. If your account uses two-step sign-in, enter your authenticator code or ask for an email code. Apple, and Microsoft when it reports two-step sign-in, already count, so the clipper may skip this step.

The clipper keeps you signed in, so you do not have to paste a token.

Sometimes the clipper cannot finish a sign-in with a service on its own. It says why and offers the next step:

  • There is no Aurora account for this email yet: create your account in Aurora first, then sign in here.
  • This account is not linked to your Aurora account yet: choose Email me a link, open the link in the email, then sign in again.
  • Confirm your email first: open the Aurora email in your inbox, then try again.

Update ​

  1. Download and unzip the new release.
  2. Copy its files over the folder the clipper already loads from.
  3. On chrome://extensions, choose Reload on the Aurora Web Clipper card.

This keeps you signed in. If you instead remove the clipper and load the new folder, sign in and pair again.

The first update with Google, GitHub, Apple and Microsoft sign-in is different. It gives the clipper a fixed identity, so the browser treats it as a new extension one time. Sign in again and, for encrypted workspaces, pair again. The old browser entry under Authorized clippers is no longer used, and you can revoke it. Later updates keep you signed in as before.

Remove ​

Choose Sign out or Disconnect in the clipper, then remove it on chrome://extensions. Clips already in Aurora stay where they are. To stop an encrypted pairing from Aurora's side, see E2EE workspaces.

E2EE workspaces ​

To clip into an encrypted workspace, choose Enable encrypted capture in the clipper. In a trusted Aurora browser session with the workspace unlocked, Aurora asks you to allow the clipper and shows a code to compare with the one in the clipper. The clipper never asks for your recovery phrase. After pairing it can only add encrypted clips; it cannot read your workspace, and your full sign-in is removed from the extension.

Captures are encrypted in the extension before they are uploaded. AuroraCloud cannot read them, and the clipper works even when no Aurora page or desktop app is open. The clip appears in your Inbox the next time you unlock the workspace on a trusted device. If an upload fails, the extension can retry it without keeping an unencrypted copy of the clip.

To stop a browser from clipping, revoke it under Settings → Workspace → Encryption → Authorized clippers (visible while the workspace is unlocked). A revoked or expired browser stops clipping and the popup asks you to pair again.

Encrypted capture is turned on by AuroraCloud and may not be available everywhere during the beta. If pairing is not offered or does not complete, it is not available for your workspace yet.

Do not paste an MCP access token (one that starts with aur_mcp_) into the clipper. Those tokens are for MCP clients; the clipper uses a normal Aurora sign-in.

Troubleshooting ​

  • The clipper will not load: unzip the file first, turn on Developer mode, and pick the folder that holds manifest.json.
  • Sign-in fails: check the API URL in Connection settings. Sign in with your Aurora email and password, not an MCP token.
  • No Continue with Google, GitHub, Apple or Microsoft buttons: the server does not offer that sign-in for the clipper. Use your email and password, or ask the server's administrator.
  • The sign-in window closed and nothing happened: the sign-in was cancelled. Choose the button again.
  • Pairing fails: codes expire after a few minutes. Cancel, start again, and approve it in an Aurora tab where the workspace is unlocked.
  • Clip selection does nothing: highlight the text before you open the clipper.
  • Nothing happens on some pages: browser settings pages, extension pages and web stores block extensions. Try a normal https:// page.

Scope ​

The clipper is for AuroraCloud workspaces. Browser-only and Local folders workspaces do not expose a server API that a browser extension can safely write to from outside the app.

The clipper's source code is on GitHub.

Aurora is in public beta and free while beta.