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.
Install
Section titled “Install”The extension is built from Apps/Clipper in the Kunoru repository:
cd Apps/Clipperbun run buildThen load Apps/Clipper/dist:
- Chrome or Edge: open
chrome://extensions(oredge://extensions), turn on Developer mode, choose Load unpacked and pick thedistfolder. - Firefox (128 or newer): open
about:debugging#/runtime/this-firefox, choose Load Temporary Add-on and pickdist/manifest.json.
Connect it
Section titled “Connect it”- 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.
- Open the extension’s settings (the gear in its popup), enter your Kunoru address and paste the token.
- 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.
Clipping
Section titled “Clipping”- 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.
Limits
Section titled “Limits”- 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.
For developers
Section titled “For developers”The extension uses two endpoints, both with Authorization: Bearer bp_pat_… and the docs:write permission:
GET /api/clip/targetslists{ studios: [{ slug, name, projects: [{ key, name, canvases: [{ id, title }] }] }] }.POST /api/cliptakes{ studio, canvasId, kind, imageUrl?, text?, url?, title?, pageUrl? }, wherekindisimage,textorpage, and answers{ canvasId, canvasTitle, itemId, canvasUrl }.
Errors use the same { "error": { "status", "message" } } shape as the REST API.