Byakugan Scan v1.0.4

Byakugan Scan v1.0.4

Added

• Custom-Tinted Interactive Screen Selection Overlay (SelectionOverlayController) (#6):
  • Replaced macOS's uncustomizable grey system selection rectangle with a native 60/120Hz AppKit fullscreen overlay across all displays (SelectionOverlayWindow & SelectionOverlayView).
  • Live-renders the user's selected ThemeAccent color (glowing 2px border, 4 corner Byakugan reticle brackets, subtle 14% inner tint fill, dashed crosshair guides, and live W × H pixel dimension pill) and respects the user's overlayOpacity screen dimming setting.
  • Captures selected regions directly into RAM pasteboard via /usr/sbin/screencapture -c -x -R<x,y,w,h> with zero disk I/O.
• Interactive Selection Box Preview in Settings:
  • Added a live visual preview canvas and a one-click Test Capture Overlay button inside Settings > Appearance.

Fixed

• Settings Window Layout & Appearance Swatch Overflow:
  • Fixed horizontal clipping of the sidebar and right edge in Settings > Appearance by redesigning the theme swatches to use a responsive 5-column flexible layout with compact labels, removing redundant outer padding on grouped forms, and expanding default Settings window dimensions to 680 × 540.
• Theme Accent Propagation Across UI:
  • Connected AppSettings.shared.themeAccent live to FloatingHUDView, MenuBarPopoverView, and SettingsView tinting.
• CI Concurrency & Check Completion:
  • Updated GitHub Actions ci.yml concurrency grouping so push and pull_request test checks never cancel each other mid-run during branch promotions.

---

---

📦 Direct Downloads

• 🍎 Latest Universal DMG: ByakuganScan.dmg
• 🏷️ Versioned DMG: ByakuganScan-v1.0.4.dmg

Requires macOS 14.0 Sonoma or later on Apple Silicon / Intel.

Byakugan Scan v1.0.3

Byakugan Scan v1.0.3

Added

• Transient Minimal HUD / Floating Toast (FloatingHUDController) (#3):
  • Non-intrusive, frosted-glass floating pill (NSPanel with .borderless, .nonactivatingPanel across all virtual desktops and full-screen spaces).
  • Displays word and character counts for text captures, barcode previews, and context-aware one-click action buttons (Open for URLs, Email for email addresses).
  • Configurable FeedbackStyle preference (Floating HUD Pill, System Notification, Both HUD & Notification, or Silent / Off).
• Selection Sound Variations & Configurable Audio Effects (SoundEffect) (#4):
  • Added selectable audio profiles in Settings > General: Classic Glass, Subtle Click, Camera Shutter, Haptic Pop, and Mute / Silent.
  • Added an interactive preview speaker button inside Settings to test sound effects live.
• Menu Bar Icon Activity State & Live Scanning Animation (#5):
  • Reactive Combine observer in AppDelegate bound to ScanCoordinator.shared.$isScanning.
  • Dynamically transitions the menu bar icon to an active scanning reticle (viewfinder.circle.fill) during capture/OCR, flashes a completion reticle (checkmark.circle.fill) for 450ms upon success, and restores the default eye icon with zero disk I/O.
• Customizable Selection Box Tint & Theme Accents (ThemeAccent) (#6):
  • Added a dedicated Appearance tab in Settings featuring curated color swatches: Byakugan Chakra (Lotus Pink), Neon Cyan, Electric Purple, Terminal Emerald, and System Accent, alongside an adjustable capture overlay dimming opacity slider.
• Cinematic 60 FPS Demo Video Generator:
  • Added scripts/generate_cinematic_demo.swift producing a 1080p @ 60 FPS native macOS demo video with procedural lo-fi audio and synchronized Foley sound effects.
• Automated Test Suite Expansion:
  • Added unit test suites covering SoundEffect, FeedbackStyle, ThemeAccent, and FloatingHUDItem word/character formatting.

---

---

📦 Direct Downloads

• 🍎 Latest Universal DMG: ByakuganScan.dmg
• 🏷️ Versioned DMG: ByakuganScan-v1.0.3.dmg

Requires macOS 14.0 Sonoma or later on Apple Silicon / Intel.

Byakugan Scan v1.0.2

Byakugan Scan v1.0.2

Added

• Deep Links & macOS Shortcuts Integration (byakugan://): Registered custom URL scheme and route handler (URLRouteService) enabling programmatic triggers from Raycast, Alfred, Stream Deck, BetterTouchTool, terminal scripts, and macOS Shortcuts:
  • byakugan://scan?mode=text — Starts instant interactive text OCR capture.
  • byakugan://scan?mode=qr — Starts instant QR code capture.
  • byakugan://scan?mode=barcode — Starts commercial barcode recognition.
  • byakugan://scan?mode=last — Re-scans the most recent rectangular region.
  • byakugan://settings — Opens the Settings preferences window.
  • byakugan://history — Opens recent scan history popover.
• Native macOS App Intents: Provided Swift AppIntent definitions (CaptureTextIntent, ScanQRCodeIntent, ScanBarcodeIntent, CaptureLastSelectionIntent, OpenSettingsIntent) and AppShortcutsProvider for native integration with macOS Shortcuts.app and Spotlight search.
• Official Homebrew Cask Distribution: Added official Homebrew Cask formula (Casks/byakugan-scan.rb) and official tap support (halcyon-past/tap/byakugan-scan), enabling seamless installation and upgrades via brew install --cask halcyon-past/tap/byakugan-scan.
• Interactive Web Installer Tabs: Added a dual-tab installation card to the marketing website hero section featuring one-click copyable Homebrew commands, direct DMG downloads, SHA-256 checksum copying, and file size badges.

Changed

• Conflict-Free Default Shortcuts: Changed default QR code scan shortcut to ⌘⇧6 and barcode scan shortcut to ⌘⇧7 to eliminate hotkey collisions with native macOS system screenshot shortcuts (⌘⇧3, ⌘⇧4, ⌘⇧5).
• 3D Follower Eyeball Trajectory: Recalibrated 3D Three.js Byakugan eyeball follower coordinates and ambient lighting stages for improved visual hierarchy across desktop and mobile devices.

Fixed

• Xcode Target Compilation: Regenerated ByakuganScan.xcodeproj via xcodegen to ensure UpdateService.swift, URLRouteService.swift, and related components are properly included in the build target.

Security

• Hardened GitHub Actions Token Permissions: Added explicit least-privilege permissions blocks (contents: read / contents: write) across all CI/CD workflow manifests.
• Dependency Vulnerability Remediation: Upgraded Next.js to 15.2.3 and refreshed website packages to eliminate all reported Dependabot security vulnerabilities.

---

---

📦 Direct Downloads

• 🍎 Latest Universal DMG: ByakuganScan.dmg
• 🏷️ Versioned DMG: ByakuganScan-v1.0.2.dmg

Requires macOS 14.0 Sonoma or later on Apple Silicon / Intel.

Byakugan Scan v1.0.1

Byakugan Scan v1.0.1

Announcement:
🚀 Byakugan Scan v1.0.1 introduces our Native Zero-Dependency In-Place Auto-Updater! Update seamlessly directly from Settings > About with one click, without needing to mount or drag a DMG installer.

Added

• Native Zero-Dependency In-Place Auto-Updater: Seamless in-app version checker in the About settings tab that queries the GitHub Releases API and executes an atomic in-place binary swap and restart without requiring users to download or drag a DMG.
• Automatic Background Update Checks on Launch: Configurable user preference in General settings to silently check for new releases when Byakugan Scan launches.
• Interactive Update Notification Banner: Dynamic notification badge in the menu bar popover and About settings directing users to update with a single click.
• ZIP Release Artifacts: Added compressed ByakuganScan.zip release packages alongside universal DMGs for instantaneous in-place extraction via native macOS ditto.
• Automated Test Suite Expansion: Added automated unit tests covering semantic version comparison, numeric chunk sorting, GitHub release asset discovery, and update lifecycle states (21 passing tests).

---

---

📦 Direct Downloads

• 🍎 Latest Universal DMG: ByakuganScan.dmg
• 🏷️ Versioned DMG: ByakuganScan-v1.0.1.dmg

Requires macOS 14.0 Sonoma or later on Apple Silicon / Intel.

Byakugan Scan v1.0.0

Byakugan Scan v1.0.0

Announcement:
🎉 Welcome to the official launch of Byakugan Scan (v1.0.0) — the all-seeing, high-performance macOS screen intelligence utility! Engineered natively with Swift 6 and Apple Vision to snatch unselectable text in sub-100ms and decode 13+ barcode & QR formats with 100% on-device privacy. Enjoy friction-free captures directly from your menu bar!

🎉 Initial Release

The official 1.0.0 release of Byakugan Scan — a high-performance, lightweight, fully on-device macOS utility for instant OCR, QR code scanning, and barcode recognition.

Added

Core Performance & Capture Pipeline

• Instant In-Memory Screen Capture: Direct RAM capture via /usr/sbin/screencapture -c -s -x eliminating disk I/O and Spotlight metadata (mdwrite) indexing delays.
• Hardware-Accelerated Vision OCR: Native VNRecognizeTextRequest Revision 3 running directly on the Apple Silicon Neural Engine (ANE) with sub-90ms recognition speed.
• Background Pre-Warming: Vision and CoreML neural models pre-warm automatically on launch to eliminate cold-start latency on the first scan.
• Re-scan Last Selection: Instantly re-process the most recent rectangular region (⌘⌥S) without re-dragging.
• TCC Screen Recording Stability: Persistent ad-hoc Designated Requirement (designated => identifier "cloud.aritro.byakugan-scan") ensuring macOS Privacy permissions stay valid across updates.

Scanning Modes & Formats

• Text OCR: Instant text extraction across 30+ BCP-47 language models with automatic whitespace trimming and line-break controls.
• QR Code Detection: High-speed QR code decoding with optional automatic URL opening.
• Universal Barcode Detection: Full support for Aztec, Code 128, Code 39, Code 93, Data Matrix, EAN-8, EAN-13, ITF-14, PDF417, UPC-E, Micro QR, and Micro PDF417.

Advanced Productivity Controls

• Additive Clipboard Mode: Seamlessly accumulate successive screen captures onto the clipboard separated by newlines.
• Text-to-Speech Engine: Built-in AVSpeechSynthesizer narration with customizable speech rate (90–300 WPM).
• In-Flight Capture Modifiers: Dedicated shortcuts for text capture with line breaks (⌘⇧2 / ⌘L), single-line capture (⌘H), and text-to-speech capture (⌘S).
• Auto-Open URLs: Automatically detects and opens captured web links in the default browser.

Menu Bar Utility & User Interface

• Menu Bar Companion: Lightweight accessory app (LSUIElement = true) living in the status bar with custom Light/Dark mode template icons.
• Quick-Access Popover: Recent scans, instant action buttons, and segmented view switcher.
• Floating Settings Window: Dedicated NSWindow with floating window-level focus (⌘,) featuring General, Shortcuts, OCR, Clipboard, Appearance, and About preferences.
• Local Scan History: Searchable, favorite-toggleable history list persisted locally in ~/Library/Application Support/ByakuganScan/history.json.

Privacy, Security & Offline Guarantee

• 100% On-Device: Zero cloud dependencies, zero external network requests (com.apple.security.network.client: false).
• Zero Telemetry: No analytics, user tracking, or crash-reporting daemons.
• Privacy Policy & Terms: Full in-app and web-published legal policies.

Engineering & CI/CD

• Branch Strategy: Tri-branch architecture (main, uat, dev) protected by GitHub branch rules and code owner review.
• Branch Naming Policy: Enforced feature/<base>/<feature-name> and hotfix/<feature-name> conventions with fork PR exemptions.
• Automated CI Quality Gate: GitHub Actions workflows running on Apple Silicon (macos-14) validating 14 unit test suites and Next.js website production builds.

---

Links

• Repository: https://github.com/halcyon-past/byakugan-scan
• Website: https://byakugan-scan.aritro.cloud
• Support: https://byakugan-scan.aritro.cloud/support

---

📦 Direct Downloads

• 🍎 Latest Universal DMG: ByakuganScan.dmg
• 🏷️ Versioned DMG: ByakuganScan-v1.0.0.dmg

Requires macOS 14.0 Sonoma or later on Apple Silicon / Intel.