snow-shot README

The project's README from github.com/mg-chao/snow-shot. As one markdown file: README.md.

Snow Shot logo

Snow Shot

Capture. Annotate. Keep creating.

A free, open-source screenshot and screen recording tool for Windows and macOS.

Latest release Total GitHub release downloads GitHub stars Latest commit GPL-3.0-or-later license

Windows x64 and ARM64 macOS 15 and later Built with C++ Built with Qt Built with Rust

Website · Download · Report a bug · English · 简体中文


An illustration of Snow Shot's tools: select a region, annotate an image, pin a reference, extract text, and record the screen.

A little capture. A clearer idea. An illustrated look at the Snow Shot toolkit.

✨ Features

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.

📦 Download

WinGet Scoop Homebrew

Get Snow Shot from GitHub 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.
Windows · WinGet
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.

Windows · Scoop

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

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.

macOS · Homebrew
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.

Snow Shot or Snow Shot Mini?

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.

🚀 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 or the macOS guide.

🛠 Development

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

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

The development guide covers platform setup, build commands, focused validation, and the OCR submodule. See also the macOS and Windows ARM64 guides.

🤝 Contributing

Found a bug? Open an issue 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 and AGENTS.md before making changes.

LINUX DO community

📄 License

Snow Shot is licensed under GPL-3.0-or-later. Components and bundled dependencies retain their respective licenses; see the repository license scope and third-party notices.

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

Searching Database…

What is this?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.
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.
Creator
mg-chao
Size
127.2 MB
Stars
7.2K
Age
1y
Commits · 90 Days