ZOYKU火线榜

mg-chao/snow-apps技术文档

mg-chao/snow-apps open-source repository on GitHub

多语言回退提示:当前仓库原作者暂未发布本地化文档,已为您无缝切换至官方英文原版(English),排版及代码实例完整保真。
极速安装
git clone https://github.com/mg-chao/snow-apps.git

Snow Shot — free, open-source screenshot and screen recording

English | 简体中文

Snow Shot app icon

Snow Shot (SnowShot) is a free, open-source screenshot tool for Windows and macOS. Capture and annotate your screen, take scrolling screenshots, extract text with local OCR, pin references above other windows, and record your screen.

免费开源截图工具:支持 Windows 和 macOS,集成截图标注、滚动长截图、离线 OCR 文字识别、贴图与录屏。阅读中文介绍。

Download the latest release · Getting started · User guides · Official website · Report an issue

This is the official Snow Shot repository, maintained by mg-chao. The repository is named Snow Apps because it also contains Snow Image Viewer and shared libraries. The previous mg-chao/snow-shot address redirects here. The official website is snowshot.top.

What you can do with Snow Shot

Task Features Guide
Explain a bug or share a detail Region, window, full-screen and delayed capture; arrows, shapes, text, highlights and blur Capture and annotate
Save a long page or conversation Scrolling capture with a stitched preview Scrolling screenshots
Copy text from an image Local text recognition; table and QR recognition in the full edition Offline OCR
Keep a reference in view Pin screenshots and clipboard content above other windows Pin to screen
Show a sequence of actions Screen recording with configurable audio and cursor presentation Screen recording
Find a previous capture Local screenshot history with search and retention settings History and privacy

Download

Get packages from GitHub Releases. The official download page helps select an architecture and also provides the maintained Gitee mirror.

System Full edition Mini
Windows x64 Online installer, offline installer, portable ZIP Online installer, portable ZIP
Windows ARM64 Native online installer, offline installer, portable ZIP Native online installer, portable ZIP
macOS 15+ · Apple silicon DMG, Homebrew DMG
macOS 15+ · Intel DMG, Homebrew Not available

Choose the full edition for text, table and QR recognition. The Windows offline installer includes the default OCR resources. Choose Mini for a smaller package focused on capture, annotation, pinning and recording; text OCR resources download when needed, and table/QR recognition is omitted. Mini has no offline installer. See package selection and setup.

Windows users can also install from the Microsoft Store.

Install Snow Shot on Windows

Download the installer from Snow Shot releases. Install the offline Windows x64 package from the WinGet community repository with:

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

This package includes published beta versions and the default OCR resources. See WinGet release support for upgrades, removal, and maintainer setup.

Install the portable package with Scoop from the official Extras bucket:

scoop bucket add extras
scoop install extras/snowshot

The Scoop package follows stable releases and includes the default OCR resources. Quit Snow Shot before running scoop update snowshot; use Scoop rather than the app's built-in updater. Settings and history persist across upgrades and ordinary uninstall. See Scoop release support for removal, data locations, and maintainer setup.

Install Snow Shot on macOS

Apple silicon and Intel Macs running macOS 15 or later can install the stable full edition with:

brew update
brew install --cask mg-chao/tap/snow-shot
brew upgrade --cask snow-shot
brew uninstall --cask snow-shot

Installation reuses Snow Shot's local signing identity and may request Keychain access and macOS privacy permissions. See Homebrew installation and migration for existing installations, custom app directories, and recovery.

Your first screenshot

  1. Launch Snow Shot. On macOS, grant screen recording permission when requested.
  2. Press F1, select a region or window, and use the toolbar to annotate it.
  3. Copy, save or pin the result. Ctrl+F1 (Command+F1 on macOS) starts a capture that copies the confirmed selection directly; F3 pins clipboard content.

These are the default shortcuts. If your keyboard uses function keys for media controls, use Fn or assign another binding in Snow Shot's shortcut settings. Existing custom bindings take precedence. Read the step-by-step guide for setup and troubleshooting.

Frequently asked questions

Is Snow Shot free and open source?

Yes. Snow Shot is licensed under GPL-3.0-or-later. The repository contains other components under their own licenses; see the license table below.

Does OCR work offline?

Standard text recognition runs locally once its model resources are installed. For an offline Windows setup, choose the full offline installer. Translation and optional online or AI features have separate network and provider requirements. See offline OCR and the privacy policy.

Does Snow Shot support Linux?

The published desktop packages currently target Windows and macOS. There is no official Linux package. Source availability does not imply Linux runtime support.

Where are the official downloads and source code?

Use this repository's Releases or snowshot.top. Forks and third-party download sites may describe older versions. Report problems against the version and package you actually installed.

Development and repository layout

Snow Apps contains the Snow Shot app (snow_shot/), Snow Image Viewer (snow_image_viewer/), shared Qt/C++ libraries, and Rust components in snow-crates/. See AGENTS.md for build commands and repository rules, Windows ARM64 build support, and macOS build support. User documentation lives in docs/guide/.

Maintain the OCR submodule

snow-crates/crates/simd-paddle-ocr-rs/ is a Git submodule with its own repository, history, branches, and releases. Snow Apps records the exact OCR commit to check out. The submodule is excluded from the Snow Crates Cargo workspace so it retains its own pinned nightly toolchain and lockfile. Run its Cargo commands from the submodule directory.

After cloning Snow Apps, initialize the submodule from the repository root:

git submodule update --init --recursive

For a new clone, git clone --recurse-submodules initializes it automatically. Submodule updates normally check out a detached HEAD. Before editing OCR code, switch to main or a feature branch inside the submodule:

git -C snow-crates/crates/simd-paddle-ocr-rs switch main

Follow the submodule's README and AGENTS.md for its build and validation commands. Commit and push OCR changes to its own repository first, then record the new revision in Snow Apps:

git add snow-crates/crates/simd-paddle-ocr-rs
git commit -m "build(ocr): update simd paddle ocr submodule"

Open Source Licenses

This is a multi-license repository. See LICENSE.md for the repository-level scope rules and third-party material policy.

Project License
ant_design_qt/ Apache License 2.0
snow-crates/ GNU GPL v3.0 or later
snow_draw_engine_qt/ Apache License 2.0
snow_rust_ffi/ GNU GPL v3.0 or later
snow-crates/crates/simd-paddle-ocr-rs/ Apache License 2.0
snow_image/ GNU GPL v3.0 or later
snow_image_viewer/ GNU GPL v3.0 or later
snow_shot/ GNU GPL v3.0 or later

Synchronized and bundled third-party materials retain their upstream licenses. See Ant Design Qt third-party notices and Snow Shot third-party notices.

Contributing / 贡献指南

Only fix PRs will be reviewed. Feature PRs are not accepted directly; please start a community discussion first if you need a specific feature. See the contribution guidelines for details.

仅审查修复问题的 PR,不直接接受新增功能或功能增强的 PR。如有功能需求,请先在社区发起讨论。 详情请阅读贡献指南。

Community

LINUX DO

文档镜像归档自 GitHub 官方源路径 · 访问原项目 GitHub
最后同步快照:2026-11-09