Extract text from images, videos, QR codes, barcodes and colors with a simple snip mechanism.
VizCE (Community Edition) is an independently maintained fork of Viz.
The original project is currently on indefinite hold for feature development, pull-request reviews, and new releases. VizCE continues development of the application, preserving its core functionality while addressing bugs, improving reliability and usability, and maintaining compatibility with modern versions of macOS.
VizCE is neither affiliated with nor maintained by the original Viz author.
Details
VizCE builds upon the original application with a growing number of improvements:
- Bug fixes and reliability. Fixes for issues affecting screen capture, webcam operation, text recognition, previews, application settings, and history management.
- Interface and usability. Improvements to window layouts, keyboard accessibility, error handling, and responsiveness.
- Performance and stability. Improved handling of background operations, camera sessions, text processing, and history storage.
- Modernization and maintainability. Updated Swift and SwiftUI code, reorganized project structure, and additional regression tests to support ongoing development.
- Independent identity. Renamed to VizCE, with a distinct application icon, bundle identifier, and build configuration.
VizCE retains the core functionality of the original application, with a few important differences:
- Code signing and installation. VizCE releases are ad-hoc signed rather than signed with an Apple Developer ID certificate and are not notarized. Consequently, macOS Gatekeeper may prevent downloaded releases from opening normally. Users can build VizCE from source or use a utility such as Sentinel to manage macOS quarantine restrictions.
- iCloud synchronization is not supported. The original iCloud configuration was tied to the upstream developer's Apple account. VizCE maintains history locally.
- Existing application data is not migrated. VizCE uses its own application identity and history storage, separate from the original Viz installation.
For a detailed record of changes, see the Changelog.
Code quality is monitored using Codacy and SwiftLint. Vendored third-party source code is excluded from quality analysis because it is maintained separately from the project's own source.
- Very quick extraction process (Can set fidelity between fast and accurate as per the Apple Vision framework)
- Can extract text based on all languages or select your language in settings for quicker/accurate captures
- Copies to clipboard automatically, ready to paste
- Post-processing option to execute shell commands when capture is
taken. Pass captured text as a whole argument using
[ocr],"[ocr]", or'[ocr]'(for example,say [ocr]; echo [ocr] > capture.txt). Captured text is passed as data. Templates using placeholders support ordinary commands, pipelines, separators, and redirections. Embedded placeholders, substitutions, heredocs, compound statements, and braced parameter expressions are unsupported; move those operations into a separate script that accepts the text as an argument. Templates without placeholders run unchanged. - Post-processing also exposes captured text as
VIZCE_OCR_TEXT, for exampleprintf '%s' "$VIZCE_OCR_TEXT". No legacy environment-variable alias is supplied. - Customizable hotkeys for the main app functions
- Shows copied text in a floating window, which can be set to auto-hide as well after a custom wait period
- Enable or disable line breaks in the extracted text
- Append multiple text snippets to the clipboard by enabling Append option in Settings, otherwise it only holds one snippet at a time
- Saves captures in History and persists app restarts
- History is stored locally; this fork does not synchronize history with iCloud
- Launch at login option
- Custom auto-updater that pulls latest release notes and binaries from GitHub Releases
demo-ocr.mp4
demo-barcode.mp4
demo-color.mp4
- macOS 14.0 or later.
Pre-compiled, always up-to-date versions are available from the releases page.
Code signing and installation. VizCE releases are ad-hoc signed rather than signed with an Apple Developer ID certificate and are not notarized. Consequently, macOS Gatekeeper may prevent downloaded releases from opening normally. Use a utility such as Sentinel to manage macOS quarantine restrictions.
Refer to BUILDING.md
The original project's license notice and attribution are retained below.
Important
Viz is licensed under Apache 2.0 with Commons Clause. This means that you can do anything you'd like with the source, modify it, contribute to it, etc., but the license explicitly prohibits any form of monetization for Viz or any modified versions of it. See full license HERE


