Skip to content
Back to search

OpenScreenShot

OpenScreenShot is a privacy-first, free, open-source screenshot extension -- zero data leaves your device, no account needed, no telemetry, no third-party services.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/pghqdev--openscreenshot/badge.svg)](/listings/pghqdev--openscreenshot)

HTML

<a href="/listings/pghqdev--openscreenshot"><img src="/api/listings/pghqdev--openscreenshot/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 290 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. <img src="media/brand-mark.svg" alt="" width="88" height="88" />
  3. # OpenScreenShot
  4. **The whole page. One click. Yours to keep.**
  5. Open-source full-page screenshot extension for Chrome and Firefox. Capture, annotate, blur,
  6. export as PNG, JPEG, WebP, or PDF, and record a tab. Everything runs on your device. No account.
  7. [![CI](https://github.com/PGHQdev/OpenScreenShot/actions/workflows/ci.yml/badge.svg)](https://github.com/PGHQdev/OpenScreenShot/actions/workflows/ci.yml) [![Chrome release](https://github.com/PGHQdev/OpenScreenShot/actions/workflows/release.yml/badge.svg)](https://github.com/PGHQdev/OpenScreenShot/actions/workflows/release.yml) [![Firefox release](https://github.com/PGHQdev/OpenScreenShot/actions/workflows/release-firefox.yml/badge.svg)](https://github.com/PGHQdev/OpenScreenShot/actions/workflows/release-firefox.yml) [![MCP publish](https://github.com/PGHQdev/OpenScreenShot/actions/workflows/publish-mcp.yml/badge.svg)](https://github.com/PGHQdev/OpenScreenShot/actions/workflows/publish-mcp.yml)
  8. [![License](https://img.shields.io/badge/license-MIT-1B1A17)](./LICENSE) [![Chrome Web Store](https://img.shields.io/chrome-web-store/v/hdabbojjccojlapnfjpdppcpfcnhgmdp?label=Chrome&color=4285F4)](https://chromewebstore.google.com/detail/hdabbojjccojlapnfjpdppcpfcnhgmdp) [![Firefox Add-ons](https://img.shields.io/amo/v/openscreenshot?label=Firefox&color=FF7139)](https://addons.mozilla.org/firefox/addon/openscreenshot/)
  9. <br />
  10. <table>
  11. <tr>
  12. <td align="center" width="280">
  13. <a href="https://chromewebstore.google.com/detail/hdabbojjccojlapnfjpdppcpfcnhgmdp">
  14. <img src="site/public/assets/brands/chrome.svg" alt="Chrome" width="24" height="24" />
  15. <img src="site/public/assets/brands/edge.svg" alt="Edge" width="24" height="24" />
  16. <img src="site/public/assets/brands/brave.svg" alt="Brave" width="24" height="24" />
  17. <img src="site/public/assets/brands/arc.png" alt="Arc" width="24" height="24" />
  18. <img src="site/public/assets/brands/chromium.svg" alt="Chromium" width="24" height="24" /><br />
  19. <strong>Add to Chrome</strong>
  20. </a><br />
  21. <sub>Chrome · Edge · Brave · Arc · Chromium</sub>
  22. </td>
  23. <td align="center" width="280">
  24. <a href="https://addons.mozilla.org/firefox/addon/openscreenshot/">
  25. <img src="site/public/assets/brands/firefox.svg" alt="Firefox" width="24" height="24" /><br />
  26. <strong>Add to Firefox</strong>
  27. </a><br />
  28. <sub>Firefox for desktop · 140+</sub>
  29. </td>
  30. </tr>
  31. <tr>
  32. <td align="center" width="280">
  33. <a href="#mcp">
  34. <img src="site/public/assets/brands/claude.svg" alt="Claude" width="24" height="24" />
  35. <img src="site/public/assets/brands/chatgpt.svg" alt="ChatGPT" width="24" height="24" />
  36. <picture>
  37. <source media="(prefers-color-scheme: dark)" srcset="site/public/assets/brands/grok-dark.svg" />
  38. <img src="site/public/assets/brands/grok.svg" alt="Grok" width="24" height="24" />
  39. </picture>
  40. <img src="site/public/assets/brands/muse.svg" alt="Muse" width="24" height="24" /><br />
  41. <strong>MCP</strong>
  42. </a><br />
  43. <sub>Local server · client setup required</sub>
  44. </td>
  45. <td align="center" width="280">
  46. <a href="#cli">
  47. <img src="site/public/assets/brands/terminal.svg" alt="Terminal" width="24" height="24" /><br />
  48. <strong>CLI</strong>
  49. </a><br />
  50. <sub>Terminal · scripts · CI/CD</sub>
  51. </td>
  52. </tr>
  53. </table>
  54. [Website](https://openscreenshot.app) · [Docs](https://openscreenshot.app/docs/) · [Roadmap](./ROADMAP.md) · [Report a bug](https://github.com/PGHQdev/OpenScreenShot/issues)
  55. <a href="https://index.dodopayments.com/openscreenshot?utm_source=index&utm_medium=badge&utm_campaign=embed&utm_content=tool-openscreenshot" target="_blank"><img src="media/dodo-index-badge.svg" width="250" height="50" alt="OpenScreenShot badge" loading="lazy" /></a>
  56. <br />
  57. <img src="media/hero.jpg" alt="The OpenScreenShot popup open over a web page in Chrome, and beside it the full-page PNG of that page, from the header to the footer" width="860" />
  58. <sub>Chrome preview. Screenshot capture and editing are also available in Firefox.</sub>
  59. </div>
  60. Capture the whole web page, crop it, mark it up, blur what is private, and save it as an
  61. image or a PDF. Every step runs in your browser: nothing is uploaded, and there is no account.
  62. ## Capture → edit → share
  63. - **One click, whole page** — the toolbar icon captures the entire scrolling page,
  64. even behind sticky headers and inside nested scrollers (a settings toggle restores
  65. the mode picker)
  66. - **Visible area, region, and element capture** from the popup, the right-click menu,
  67. or keyboard shortcuts, with an optional 3, 5, or 10 second delay
  68. - **Annotate** with arrows, shapes, text, numbered steps, spotlight, highlighter, and crop,
  69. with full undo
  70. - **Blur or redact secrets** before you share: soft blur, mosaic, or an opaque fill
  71. - **Record the tab in Chrome** with auto-zoom at your clicks, mic and webcam, and trim. Pick
  72. the part of the tab to record and check your camera first; the controls stay out of the video
  73. - **Export** as PNG, JPEG, WebP, or multi-page PDF, or copy straight to the clipboard
  74. - **Script it** from a terminal, CI, or an AI agent with the [CLI and MCP server](#cli--mcp)
  75. The full tour, every shortcut, and the settings reference live in the
  76. [docs](https://openscreenshot.app/docs/).
  77. ### Guides
  78. - [How to take a full-page screenshot in Chrome](https://openscreenshot.app/blog/full-page-screenshot-chrome/),
  79. and the same for [Edge, Firefox, Safari, Brave, Opera, Vivaldi, and Arc](https://openscreenshot.app/full-page-screenshot/)
  80. - [Save a screenshot as a PDF](https://openscreenshot.app/blog/save-screenshot-as-pdf/) ·
  81. [Redact a screenshot](https://openscreenshot.app/blog/redact-screenshot/)
  82. - [Screenshots from the command line](https://openscreenshot.app/blog/screenshot-cli/) ·
  83. [A local screenshot MCP server](https://openscreenshot.app/blog/screenshot-mcp-server/) ·
  84. [Screenshots in CI](https://openscreenshot.app/blog/screenshots-for-ci/)
  85. - [Full-page screenshot extensions compared](https://openscreenshot.app/blog/full-page-screenshot-extensions/) ·
  86. [Alternatives to GoFullPage, FireShot, Awesome Screenshot, and more](https://openscreenshot.app/alternatives/)
  87. ## Install
  88. | | Chrome & Chromium | Firefox |
  89. | -------------------------------------------- | --------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
  90. | Install | [Chrome Web Store](https://chromewebstore.google.com/detail/hdabbojjccojlapnfjpdppcpfcnhgmdp) | [Firefox Add-ons](https://addons.mozilla.org/firefox/addon/openscreenshot/) |
  91. | Full-page, visible, region & element capture | ✓ | ✓ |
  92. | Annotations, redaction & local history | ✓ | ✓ |
  93. | Image, PDF & clipboard export | ✓ | ✓ |
  94. | Screen recording | Chrome | Not available |
  95. Firefox requires **desktop version 140 or later**. The Chrome extension also works in
  96. Edge, Brave, Arc, and other Chromium browsers. Screen-wide color picking and floating
  97. capture windows appear only when the browser supports them.
  98. ### Your first screenshot
  99. 1. **Install** from your browser’s store and pin the extension to the toolbar.
  100. 2. **Click the icon** to capture the whole page. Right-click for visible-area and region capture.
  101. 3. **Edit and share** — annotate, redact, copy, or save an image or PDF.
  102. Prefer a capture menu on every click? Turn off **Express mode** in settings.
  103. For alternatives and a sourced feature comparison, see [How it compares](https://openscreenshot.app/compare/).
  104. ### Element capture
  105. Choose **Capture element** from the page or extension right-click menu, or from
  106. the popup when Express mode is off. Hover over a card, image, chart, or table to
  107. highlight it. Use ↑ / ↓ to select a larger or smaller area, or ← / → to move
  108. between elements without a mouse. Click or press Enter to capture; Esc cancels.
  109. The capture follows your existing Editor, Clipboard, or Download setting. The
  110. element must be fully visible: scroll it into view, or use the **Capture full
  111. page** fallback offered for clipped elements. Content inside an iframe is
  112. captured as part of the iframe's visible rectangle. No new permissions are needed.
  113. ## Private by design
  114. `host_permissions` is empty: `activeTab` grants access on your click, and the extension
  115. does not have standing access to every website. Captures, recordings, and edits stay
  116. in local browser storage until you export or delete them. Chrome can optionally request
  117. broader access for recording across sites; Firefox does not request recording permissions. Full policy: [PRIVACY.md](./PRIVACY.md).
  118. <details>
  119. <summary><b>Every permission, line by line</b></summary>
  120. <br />
  121. | Permission | Why |
  122. | ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
  123. | `activeTab` | Access the current tab — only when you click the extension, use a shortcut, or pick a capture from the right-click menu |
  124. | `scripting` | Inject on-demand page functions for scroll-and-stitch, region selection, the quick-mode clipboard write, and the recording's click tracker |
  125. | `storage` (+ `unlimitedStorage`) | Settings, the last region rect, editing drafts, a parked Record click, and stashing large full-page PNGs and recording chunks for the editor |
  126. | `downloads` | Save exports, quick-mode captures, and recording exports to your Downloads folder |
  127. | `contextMenus` | Add one capture submenu to the page right-click menu |
  128. | `clipboardWrite` | Copy a screenshot from the editor or from quick mode; it never reads the clipboard |
  129. | `offscreen` (Chrome) | Run the recording engine in a hidden document — `MediaRecorder` and the IndexedDB writes need a page context a service worker doesn't have |
  130. | `tabCapture` (Chrome, optional) | Requested once, at your first recording; every recording after that starts in one click |
  131. | `<all_urls>` (Chrome, optional host) | Only if you turn on "Record across sites" — keeps click tracking alive when a recording navigates to a new origin |
  132. </details>
  133. ## Development
  134. TypeScript (strict) + Preact, bundled by Vite + [@crxjs/vite-plugin](https://github.com/crxjs/crxjs).
  135. One runtime dependency (Preact); unit tests with Vitest. Node.js 22.19+ and pnpm 10.33.0.
  136. ```bash
  137. pnpm install --frozen-lockfile
  138. pnpm run icons
  139. ```
  140. | | Chrome | Firefox |
  141. | ------------ | ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------- |
  142. | Develop | `pnpm run dev` | `pnpm run dev:firefox` |
  143. | Build | `pnpm run build` | `pnpm run build:firefox` |
  144. | Package | `pnpm run package` | `pnpm run package:firefox` |
  145. | Load locally | `chrome://extensions` → **Developer mode** → **Load unpacked** → `dist/` | `about:debugging` → **This Firefox** → **Load Temporary Add-on** → `dist-firefox/manifest.json` |
  146. ```bash
  147. pnpm typecheck
  148. pnpm lint
  149. pnpm test
  150. pnpm format:check
  151. pnpm lint:firefox # validate dist-firefox/ after building
  152. ```
  153. The [Firefox release guide](release/firefox/README.md) covers reviewer source archives,
  154. verification, and automated Mozilla submissions. Tagged releases have separate Chrome
  155. and Firefox workflows; store review determines when each update becomes available.
  156. For the website, use `pnpm site:dev`; a push to `main` deploys it. See
  157. [CONTRIBUTING.md](./CONTRIBUTING.md) for the contribution workflow.
  158. <details>
  159. <summary><b>Project structure</b></summary>
  160. <br />
  161. ```
  162. openscreenshot/
  163. ├── manifest.json # MV3 manifest (crxjs entry)
  164. ├── public/ # icons + i18n messages
  165. ├── src/
  166. │ ├── background/ # service worker (capture + recording coordinator)
  167. │ ├── content/ # on-demand capture funcs (scroll, region, recording click tracker)
  168. │ ├── control/ # recording control tab: area, camera preview, Start/Stop (Preact)
  169. │ ├── editor/ # annotation editor + export (Preact, own tab)
  170. │ ├── offscreen/ # recording engine: MediaRecorder + IndexedDB chunks
  171. │ ├── popup/ # popup UI (Preact)
  172. │ ├── recorder/ # recording editor: timeline, zoom, trim, export (Preact, own tab)
  173. │ └── shared/ # design tokens, messaging, storage, types, utils
  174. ├── mcp/ # optional local CLI + MCP server
  175. ├── site/ # Astro website + localized content
  176. ├── site-dist/ # generated site build, served by site-worker.js
  177. ├── tests/unit/ # unit tests (Vitest)
  178. └── scripts/ # icon + screenshot pipelines
  179. ```
  180. </details>
  181. ## CLI & MCP
  182. [![npm](https://img.shields.io/npm/v/openscreenshot?label=openscreenshot&color=E8503A)](https://www.npmjs.com/package/openscreenshot) [![npm downloads](https://img.shields.io/npm/dt/openscreenshot?label=downloads&color=1B1A17)](https://www.npmjs.com/package/openscreenshot)
  183. [![openscreenshot MCP server – quality and maintenance score on Glama](https://glama.ai/mcp/servers/PGHQdev/OpenScreenShot/badges/card.svg)](https://glama.ai/mcp/servers/PGHQdev/OpenScreenShot)
  184. `openscreenshot` (npm) is a separate, optional tool that drives the Chrome already on your
  185. machine. It is local by default and needs no account. Node.js 22.12 or newer and Chrome,
  186. Chromium, or Edge are required. The [package README](./mcp/README.md) has every option.
  187. Optional: `openscreenshot auth login`, then `--cloud` on the CLI or `cloud: true` on the MCP
  188. tool, renders the page on [OpenScreenShot Cloud](https://cloud.openscreenshot.app), a hosted
  189. screenshot API with a free plan. In Cloud mode, the URL and the options go to Cloud.
  190. ### CLI
  191. ```bash
  192. npx openscreenshot shot https://example.com --out shot.png --full
  193. ```
  194. Cover secrets before the pixels are written: `--redact "<css selector>"`,
  195. `--redact-pattern email,phone,secret`, and `--redact-rect x,y,w,h` put black boxes over
  196. their targets, and the capture fails rather than writes an image if a target moves.
  197. ### MCP
  198. Add this server entry to your MCP client’s configuration, then call `capture_screenshot`
  199. with `{ "url": "https://example.com", "fullPage": true }`:
  200. ```json
  201. {
  202. "mcpServers": {
  203. "openscreenshot": { "command": "npx", "args": ["-y", "openscreenshot"] }
  204. }
  205. }
  206. ```
  207. Claude Code: `claude mcp add openscreenshot -- npx -y openscreenshot`.
  208. The server runs locally over **stdio**. Your client must support launching a local MCP
  209. process. For clients that accept only remote MCP URLs, OpenScreenShot Cloud serves
  210. `https://cloud.openscreenshot.app/mcp` (Streamable HTTP, `Authorization: Bearer <api-key>`). The tool returns
  211. the PNG to the client, which may send it to a hosted model: use the `redact` input for data
  212. that must not leave the device.
  213. Built for the terminal-heavy parts of the job:
  214. - **DevOps** — snapshot dashboards, status pages, and admin UIs straight into incident
  215. reports, runbooks, and postmortems, from cron or a chat command
  216. - **CI/CD** — capture pages in your pipeline for docs, release notes, and visual diffs
  217. on every deploy: one command, no hosted service needed
  218. ## Contributing
  219. Desktop and web apps are also in progress. Follow their development on the
  220. [roadmap](./ROADMAP.md).
  221. See [CONTRIBUTING.md](./CONTRIBUTING.md) and the [roadmap](./ROADMAP.md). If
  222. OpenScreenShot is useful to you, you can [buy me a coffee](https://ko-fi.com/pghqdev).
  223. ## License
  224. [MIT](./LICENSE) © OpenScreenShot @PGHQdev

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.