Chrome to Miro

A Chrome extension for researchers: capture highlights and cropped screenshots while browsing, and send them straight to a Miro board.

What it does

• Highlight → Sticky note: Select text on a page and press Cmd+Shift+2 to create a sticky note on your Miro board that includes the quote + source URL.
• Cropped screenshot → Image: Press Cmd+Shift+1 and drag-select an area of the page to capture; the cropped image is uploaded to your Miro board with the source URL attached where supported.
• Auto organization: Each session creates (or reuses) a new frame on the board and places items in a grid:
  • Row = website/domain
  • Columns = each captured item from that website (in capture order)

Install

1. Open Chrome → chrome://extensions/
2. Enable Developer mode
3. Click Load unpacked → select chrome-miro/extension

Setup Miro OAuth

Follow OAUTH_SETUP.md.

Usage

1. Open the extension popup
2. Login to Miro
3. Select a board
4. Click Start New Session
5. Use the shortcuts while browsing:
   • Cmd+Shift+2: capture highlighted text
   • Cmd+Shift+1: capture a cropped screenshot

Notes on shortcuts

• Chrome commands don’t support every punctuation key in manifest.json (for example backslash/pipe). If you want custom shortcuts like Cmd+Shift+| or Cmd+Shift+,, set them manually at chrome://extensions/shortcuts.

Repo structure

chrome-miro/
└── extension/
    ├── background.js   # service worker (Miro API + layout + commands)
    ├── content.js      # area selection overlay + cropping helper
    ├── manifest.json   # permissions + commands
    ├── popup.html/css/js
    ├── schema.js / storage.js
    └── icons/

Troubleshooting

• Commands don’t fire: ensure you started a session in the popup, and check chrome://extensions/shortcuts.
• Login fails: confirm your Miro app’s redirect URI matches the one shown in the popup, and that you set miroClientSecret in chrome.storage.local.