Skip to content
pierow2kPublic

About

Capture text/QR Codes/Barcodes/Colors from screen snippets - fork of the original Viz by alienator88

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

VizCE

status: Maintained Codacy Badge commits ahead release version
logo
Download · Commits

Extract text from images, videos, QR codes, barcodes and colors with a simple snip mechanism.

Table of Contents

About this fork

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

Differences from upstream

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.

Differences to be aware of

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

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.

Missing Icons Example

Viz vs. VizCE Menu on macOS 27.png

Features

  • 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 example printf '%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

Preview

VizCE Menu Screenshot

Text Extraction Demo

demo-ocr.mp4

QR/Barcode Extraction Demo

demo-barcode.mp4

Color Picker Demo

demo-color.mp4

History View

VizCE History Screenshot

Requirements

  • macOS 14.0 or later.

Getting VizCE

Releases

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.

Building locally

Refer to BUILDING.md

License

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

About

Capture text/QR Codes/Barcodes/Colors from screen snippets - fork of the original Viz by alienator88

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Used by

Contributors

Languages