Skip to content

Web clipper

The web clipper is a browser extension for Chrome, Edge and Firefox. Right-click a picture, some selected text, a link or the page itself, choose Clip to Kunoru, pick a canvas and it’s there.

  • Pictures are copied into Kunoru, so they keep working after the other site changes or removes them.
  • Text becomes a sticky note, with the page it came from underneath.
  • Links and pages become link cards.

Clips collect in a Clipped column on the canvas, newest at the bottom. If there’s no Clipped column yet, or the column would grow into something below it, a new one starts to the right of everything else, so a clip never lands on top of your work. Rename or move the column whenever you like; a new one starts when there isn’t one called Clipped.

If someone has the canvas open, the clip appears for them straight away.

The extension is built from Apps/Clipper in the Kunoru repository:

Terminal window
cd Apps/Clipper
bun run build

Then load Apps/Clipper/dist:

  • Chrome or Edge: open chrome://extensions (or edge://extensions), turn on Developer mode, choose Load unpacked and pick the dist folder.
  • Firefox (128 or newer): open about:debugging#/runtime/this-firefox, choose Load Temporary Add-on and pick dist/manifest.json.
  1. In Kunoru, open Settings → API & apps and create a personal access token with the docs:write permission. Limit it to one studio if you only clip into that one.
  2. Open the extension’s settings (the gear in its popup), enter your Kunoru address and paste the token.
  3. Choose Save. Your browser asks to let the clipper reach that address; allow it. The settings page then says how many canvases you can clip to.

The token stays in this browser only and is never synced. To disconnect, revoke the token in Kunoru.

  • Right-click anything and choose Clip to Kunoru. The popup shows what you’re clipping; pick the studio, project and canvas, then Clip. The canvas you used last is picked again next time.
  • Click the toolbar button to clip the page you’re on as a link.
  • After a clip, the canvas name in the popup opens it in a new tab.

Only canvases you can edit are listed. Archived canvases, templates and the canvases on cards aren’t.

  • Pictures can be up to 20 MB, in PNG, JPEG, GIF, WebP or AVIF. Kunoru downloads them itself, only from public web addresses.
  • Each token can send 60 clips a minute.
  • Pictures count towards your studio’s storage like any other canvas upload.

The extension uses two endpoints, both with Authorization: Bearer bp_pat_… and the docs:write permission:

  • GET /api/clip/targets lists { studios: [{ slug, name, projects: [{ key, name, canvases: [{ id, title }] }] }] }.
  • POST /api/clip takes { studio, canvasId, kind, imageUrl?, text?, url?, title?, pageUrl? }, where kind is image, text or page, and answers { canvasId, canvasTitle, itemId, canvasUrl }.

Errors use the same { "error": { "status", "message" } } shape as the REST API.