# snow-shot (mg-chao/snow-shot)

> This repository hosts the source code for two desktop apps: Snow Shot, a screenshot and OCR tool with screen recording, and Snow Image Viewer, a separate image-viewing app bundled in the same repo.

- GitHub: https://github.com/mg-chao/snow-shot
- GitHub.Locker page: https://github.locker/mg-chao/snow-shot
- Stars: 7.2K
- Language: C++
- Last push: 2026-11-18

## Questions and answers

Written by GitHub.Locker from the README and the repository; check the README below for details.

**Are Snow Shot and Snow Image Viewer one app or two separate apps?**

They are two distinct desktop applications (plus shared engine/crate code) kept in one source repository, each installed and licensed on its own.

**How do I install Snow Shot?**

On Windows, download the installer from the Snow Shot releases page, or install the offline x64 package via the WinGet community repository. On macOS, it will be installable through Homebrew once the first stable release ships.

**Do I need Apple Silicon for the macOS build?**

Yes, the Homebrew install is limited to Apple Silicon Macs running macOS 15 or later.

**Is the macOS version ready to install today?**

Not yet in a stable form — Homebrew install opens up only after the first stable Homebrew release is published, and the current Windows WinGet package still ships beta builds.

**Can OCR work without an internet connection?**

Yes, the Windows package is offline and bundles the default OCR resources in, so text recognition doesn't require downloading anything extra.

**Does installing it touch system permissions?**

On macOS, installation reuses Snow Shot's own local code-signing identity and can prompt for Keychain access and macOS privacy permissions (e.g. screen recording).

**What can Snow Shot actually do?**

Going by its GitHub topics, Snow Shot combines screenshot capture, screen recording, and OCR text extraction in a single Windows/macOS tool.

**What is Snow Image Viewer for?**

It's the companion image-viewing app in the same repo, licensed separately under GPLv3 and built on the shared Snow engine/UI crates.

**Is there a Linux build?**

Not Stated In README — only Windows (installer/WinGet) and macOS (Homebrew) install instructions are documented.


---

## README (checked against GitHub 2026-11-18)

Source: https://github.com/mg-chao/snow-shot/blob/main/README.md

<div align="center">
  <a href="https://snowshot.top">
    <img src="docs/imgs/app-icon.png" width="112" height="112" alt="Snow Shot logo">
  </a>

  <h1>Snow Shot</h1>

  <p><strong>Capture. Annotate. Keep creating.</strong></p>
  <p>A free, open-source screenshot and screen recording tool for Windows and macOS.</p>

  <p>
    <a href="https://github.com/mg-chao/snow-shot/releases"><img src="https://img.shields.io/github/v/release/mg-chao/snow-shot?style=flat-square&amp;color=9254DE&amp;logo=github&amp;label=release" alt="Latest release"></a>
    <a href="https://github.com/mg-chao/snow-shot/releases"><img src="https://img.shields.io/github/downloads/mg-chao/snow-shot/total?style=flat-square&amp;color=1677FF&amp;label=downloads" alt="Total GitHub release downloads"></a>
    <a href="https://github.com/mg-chao/snow-shot/stargazers"><img src="https://img.shields.io/github/stars/mg-chao/snow-shot?style=flat-square&amp;color=B88718&amp;label=stars" alt="GitHub stars"></a>
    <a href="https://github.com/mg-chao/snow-shot/commits"><img src="https://img.shields.io/github/last-commit/mg-chao/snow-shot?style=flat-square&amp;color=389E8D&amp;label=last%20commit" alt="Latest commit"></a>
    <a href="snow_shot/COPYRIGHT"><img src="https://img.shields.io/badge/license-GPL--3.0--or--later-81B950?style=flat-square" alt="GPL-3.0-or-later license"></a>
  </p>

  <p>
    <a href="#download"><img src="https://img.shields.io/badge/Windows-x64%20%7C%20ARM64-0078D4?style=flat-square" alt="Windows x64 and ARM64"></a>
    <a href="#download"><img src="https://img.shields.io/badge/macOS-15%2B-64748B?style=flat-square&amp;logo=apple&amp;logoColor=white" alt="macOS 15 and later"></a>
    <a href="docs/development.md"><img src="https://img.shields.io/badge/C%2B%2B-00599C?style=flat-square&amp;logo=cplusplus&amp;logoColor=white" alt="Built with C++"></a>
    <a href="docs/development.md"><img src="https://img.shields.io/badge/Qt-2E8B57?style=flat-square&amp;logo=qt&amp;logoColor=white" alt="Built with Qt"></a>
    <a href="docs/development.md"><img src="https://img.shields.io/badge/Rust-A65332?style=flat-square&amp;logo=rust&amp;logoColor=white" alt="Built with Rust"></a>
  </p>

  <p>
    <a href="https://snowshot.top"><strong>Website</strong></a> ·
    <a href="https://github.com/mg-chao/snow-shot/releases"><strong>Download</strong></a> ·
    <a href="https://github.com/mg-chao/snow-shot/issues">Report a bug</a> ·
    English · <a href="README.zh-CN.md">简体中文</a>
  </p>
</div>

<br>

<p align="center">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="docs/images/readme/showcase-dark.svg">
    <img src="docs/images/readme/showcase.svg" width="100%" alt="An illustration of Snow Shot's tools: select a region, annotate an image, pin a reference, extract text, and record the screen.">
  </picture>
</p>

<p align="center"><sub>A little capture. A clearer idea. An illustrated look at the Snow Shot toolkit.</sub></p>

## ✨ Features

- 📸 **Capture what matters.** Select a region, capture the focused window or current monitor, set a delay, or take a scrolling screenshot.
- ✏️ **Make your point.** Add arrows, shapes, text, numbered steps, highlights, blur, and more. Edit existing images with the same drawing tools.
- 📌 **Keep references close.** Pin images and clipboard content above other windows, then organize and restore your pins.
- 🔎 **Turn pixels into text.** Extract text with local OCR and read QR codes. Optional online services add translation, table recognition, and AI conversion.
- 🎬 **Show how it works.** Record your screen, include system or microphone audio, and export video or GIF, APNG, and WebP animations.
- 🧩 **Finish the picture.** Stitch images, split them into pieces, or sketch on a full-screen canvas.
- 🎨 **Make it yours.** Customize shortcuts, toolbars, themes, and export preferences. Use the interface in English, Simplified Chinese, or Traditional Chinese.
- 🔌 **Connect your workflow.** Enable MCP integration to let a compatible AI client use supported Snow Shot tools.

Core capture, annotation, recording, standard OCR, and QR recognition run on your device.
Translation, advanced recognition, AI conversion, and cloud uploads use the services you choose.
MCP is optional and off by default. See the [privacy policy](docs/snow-shot-privacy-policy.en.md).

<a id="download"></a>

## 📦 Download

[![WinGet](https://img.shields.io/badge/WinGet-0078D4?style=flat-square)](docs/snow-shot-releases.md#winget)
[![Scoop](https://img.shields.io/badge/Scoop-2E8B57?style=flat-square)](docs/snow-shot-releases.md#scoop)
[![Homebrew](https://img.shields.io/badge/Homebrew-B88718?style=flat-square&logo=homebrew&logoColor=white)](docs-macos-build.md#homebrew-installation)

Get Snow Shot from [GitHub Releases](https://github.com/mg-chao/snow-shot/releases).
Choose a package for your operating system and processor.

| Platform | Packages |
| --- | --- |
| **Windows · x64 / ARM64** | Installer or portable ZIP; the full edition's offline installer includes the default OCR resources. |
| **macOS 15+ · Apple Silicon / Intel** | DMG or Homebrew; availability depends on the architectures included in the release. |

<details>
<summary><strong>Windows · WinGet</strong></summary>

```powershell
winget install --exact --id mg-chao.snow-shot --source winget
```

The package includes the default OCR resources and can include published beta versions.
See [WinGet installation and updates](docs/snow-shot-releases.md#winget).

</details>

<details>
<summary><strong>Windows · Scoop</strong></summary>

Install the Windows x64 portable edition from the official Extras bucket:

```powershell
scoop bucket add extras
scoop install extras/snowshot
```

Quit Snow Shot before upgrading with `scoop update snowshot`; use Scoop to manage
updates. Settings and history persist across upgrades and ordinary uninstall.
See [Scoop installation and updates](docs/snow-shot-releases.md#scoop).

</details>

<details>
<summary><strong>macOS · Homebrew</strong></summary>

```sh
brew update
brew install --cask mg-chao/tap/snow-shot
```

To update, quit Snow Shot and run `brew upgrade --cask snow-shot`.
Project-signed releases preserve the same identity across DMG, script, and Homebrew
installation. First installation or migration may require macOS privacy permissions. See [installation and migration](docs-macos-build.md#homebrew-installation).

</details>

<details>
<summary><strong>Snow Shot or Snow Shot Mini?</strong></summary>

**Snow Shot** includes the full toolkit. **Snow Shot Mini** keeps capture, annotation,
pinning, recording, and manual text recognition, with OCR models downloaded on demand.
Mini omits QR, table, Markdown, HTML, LaTeX, translation, Extended Features, and API Configuration.

Mini is available for Windows and Apple Silicon Macs. Its text-recognition toolbar
button is hidden by default, and automatic recognition of pinned content is off.
See [edition details](docs/snow-shot-releases.md#snow-shot-mini-paired-releases).

</details>

## 🚀 Get started

1. **Set your shortcut.** Open Snow Shot and choose a capture action in **Global shortcuts**.
2. **Select and refine.** Capture a region, add annotations, or run text recognition.
3. **Keep it moving.** Copy the result, save it, or pin it beside your work. Use screen recording when a still image is not enough.

On macOS, follow the permission prompts for the features you use.
For installation help and platform notes, visit the [website](https://snowshot.top)
or the [macOS guide](docs-macos-build.md).

## 🛠 Development

Snow Shot is built with **C++ / Qt and Rust**.

```sh
git clone --recurse-submodules https://github.com/mg-chao/snow-shot.git
cd snow-shot
```

The [development guide](docs/development.md) covers platform setup, build commands,
focused validation, and the OCR submodule. See also the [macOS](docs-macos-build.md)
and [Windows ARM64](docs-windows-arm64-build.md) guides.

## 🤝 Contributing

Found a bug? [Open an issue](https://github.com/mg-chao/snow-shot/issues) with your
OS, Snow Shot version, and steps to reproduce it.

Only bug-fix PRs are reviewed. For new features or enhancements, start a community
discussion before submitting a PR. Read [CONTRIBUTING.md](CONTRIBUTING.md) and
[AGENTS.md](AGENTS.md) before making changes.

[![LINUX DO community](https://img.shields.io/badge/LINUX%20DO-Community-1677FF?style=flat-square)](https://linux.do)

## 📄 License

Snow Shot is licensed under [GPL-3.0-or-later](snow_shot/COPYRIGHT).
Components and bundled dependencies retain their respective licenses; see the
[repository license scope](LICENSE.md) and
[third-party notices](snow_shot/THIRD_PARTY_NOTICES.md).

