<p>
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/usememos/.github/refs/heads/main/assets/brand/lockup-on-dark.svg">
<img src="https://raw.githubusercontent.com/usememos/.github/refs/heads/main/assets/brand/lockup.svg" alt="Memos" width="180">
</picture>
</p>
# Memos Web Clipper
Save pages, selections, and images to your memos from Chrome or Firefox, as Markdown with a link to the source.
## Install
- [Chrome Web Store](https://chromewebstore.google.com/detail/memos-web-clipper/nebaoebnljalfegiidibihhkebeiklbl)
- [Firefox Add-ons](https://addons.mozilla.org/en-US/firefox/addon/memos-web-clipper/)
### Manual installation
Versioned packages and checksums are available from [GitHub Releases](https://github.com/usememos/web-clipper/releases). Store installation is recommended for automatic updates.
For Chromium-based browsers:
1. Download and extract `memos-web-clipper-chromium-v<version>.zip`.
2. Open the browser’s extensions page, such as `chrome://extensions` or `edge://extensions`.
3. Enable **Developer mode**, choose **Load unpacked**, and select the extracted directory.
Firefox stable releases require Mozilla-signed extensions, so install from Firefox Add-ons for permanent use. To test a GitHub release temporarily:
1. Download and extract `memos-web-clipper-firefox-v<version>.zip`.
2. Open `about:debugging#/runtime/this-firefox`.
3. Choose **Load Temporary Add-on** and select the extracted `manifest.json`.
To verify a download on Linux, run `sha256sum --ignore-missing -c SHA256SUMS` in the directory containing the downloaded package. Do not rely on manually installed packages receiving browser-store-managed updates; check GitHub Releases for new versions.
## Features
- Capture a page’s main content as Markdown, with its title, URL, and readable description.
- Convert selected text, links, lists, code, and tables to Markdown.
- Upload selected images as Memos attachments.
- Review and edit every clip before saving.
- Save as Private, Protected, or Public.
- Choose a space and optionally limit visibility to its members on Memos 0.31 or later. The popup remembers your last successful space and visibility for each connection.
- Customize the clip format with a local template.
- Quick-save selected text or images from the context menu.
- Browse and search clips saved locally from the popup.
- See when a page was saved before, with the option to save it again.
The default template quotes the captured content with `> {{content}}` and adds a link back to the source. Use `{{content}}` without the `> ` prefix to preserve the original Markdown without adding a quote. A quoted placeholder must be on its own line; its prefix applies to every line of content. Empty fields are removed automatically.
## What gets captured
Selecting text before you clip captures exactly that selection, along with any images in it. The template controls whether the content is quoted.
With nothing selected, the clipper extracts the page’s main content — the article body, without navigation, sidebars, or footers — and converts it to Markdown, preserving headings, lists, code blocks, and tables. Images in an extracted article are left out rather than linked, so a clip never depends on someone else’s server staying up; select an image, or the region containing it, to save it as an attachment.
Pages with no article to extract, such as dashboards, search results, and feeds, fall back to the page’s own summary and link. The popup says which of these happened, and every clip is editable before you save it.
## How to use
1. Open the extension settings and choose a connection method:
- **usememos.com (Recommended):** sign in, then connect an instance. Your connection information is available after signing in on another device.
- **Direct connection:** enter your Memos instance URL and a personal access token. No usememos.com account is required, and the connection stays in this browser.
2. Open the extension on a page.
3. Review the captured content, choose its visibility and optional space from the same menu, and save.
Open **Saved clips** from the popup or extension settings to review previous saves and reopen either the source page or its memo.
For a direct connection, create a PAT in your Memos user settings at `/setting#access-token`. The clipper tests the instance URL, supported Memos version, and token before saving the connection. The saved token is never displayed again in the extension UI.
You can also right-click selected text or an image and choose **Save selection to Memos**. Context-menu saves are always private.
Browser-owned pages, such as extension stores and internal browser URLs, may block page capture. The clipper falls back to the page title and URL when available.
## Local history
Successful saves made from the popup are recorded in the extension’s local browser storage. A record includes the source page, captured selection, final memo content, visibility, destination, memo link, and save time. This lets the popup recognize a previously saved page without querying Memos.
History stays in the current browser profile and is not synced through usememos.com. Context-menu quick saves are not added to this history.
## Browser support
- Chromium-based browsers that support Chrome extensions, including Google Chrome, Microsoft Edge, Brave, and Arc
- Mozilla Firefox 142 or later
- Memos 0.26.0 or later, including calendar-versioned releases such as 26.10
## Brand assets
Logo and wordmark usage follows the [Memos brand guidance](https://github.com/usememos/.github/blob/main/BRAND.md). Local sources and regeneration instructions are in [assets/brand/README.md](assets/brand/README.md).