KartikLabhshetwar/better-shot
41.2
Weak · 15 November 2026
67k
lines of production code
Swift
with TypeScript
5
measurements over time
What this system is
BetterShot is a native macOS application designed for capturing, editing, and sharing screenshots and screen recordings. It provides comprehensive tools for region, window, and scrolling captures, alongside a robust annotation engine and video editor with features like auto-silence detection and cinematic color grading. The system supports persistent history management, self-hosted sharing via Cloudflare R2, and seamless in-app updates, all wrapped in a modern SwiftUI interface.
Features
Add landing page UI component library
The landing page now includes a comprehensive set of reusable UI components, such as accordions, dialogs, alerts, buttons, carousels, and charts, providing a consistent design system for the new site.
bettershot-landing/components/ui · high confidence
Add landing page utility libraries for analytics, content, and sharing
The landing page now includes a set of new utility modules in the lib directory to support its features. This adds analytics tracking for download sources via Umami, a structured blog system with post metadata and date formatting, and a changelog parser that reads version history from a markdown file. It also introduces a downloads module that fetches the latest release information and download counts from GitHub, and a robust sharing system that validates and resolves shared media manifests with security checks against SSRF and local network access. Additional utilities include Open Graph image generation, script loading, and CSS class merging.
bettershot-landing/lib · high confidence
Add product comparison and FAQ sections to the landing page
The home page now includes a new comparison section that contrasts Better Shot with CleanShot X, Loom, and CapCut across features like pricing, offline capability, and specific tools (screenshots, recording, editing), alongside a mobile-responsive card layout. An FAQ section has also been added to address common questions regarding pricing, privacy, system requirements, and installation, reinforcing the product's value proposition as a free, open-source alternative.
bettershot-landing/components/home · high confidence
Adds native editor preview and Remotion motion-preview tooling for landing page media
This change introduces tooling to generate authentic, dark-mode media assets for the landing page. It adds a native macOS preview app (CaptureEditors) and a shell script (capture-editors.sh) that bundle the production editor to display real Recording and Screenshot interfaces for screencapture. It also adds a Node.js script (prepare-demos.mjs) and a sources manifest (sources.json) to process raw recordings into optimized H.264 videos and WebP stills, and a Remotion setup (feature-demos.tsx, index.tsx, render-features.mjs) to render motion previews that frame these actual editor captures with zoom/pan animations. These assets and previews are intended for use on the recording and screenshot pages to showcase real editor interactions rather than fabricated UI.
bettershot-landing/media · high confidence
BetterShot project structure initialized with comprehensive source and resource files
The Xcode project file (project.pbxproj) has been created, registering a complete set of Swift source files and resources for the BetterShot application. This includes core components for screen capture (ScreenCapture, ScrollCaptureController), video recording and editing (RecordingStudioWindow, VideoTrimSelection, Recording3DKeyframeEditor), and annotation tools (AnnoEditor, AnnotationCanvas, various inspector and renderer classes). The project also incorporates resources for onboarding, settings, and UI themes, establishing the foundational build structure for the app's capture, editing, and sharing capabilities.
BetterShot.xcodeproj · high confidence
Initial landing page infrastructure with responsive hooks and global theming
The bettershot-landing area now includes the foundational assets for the new landing page. This adds a \useIsMobile\ hook to detect viewport width (breaking at 768px) for responsive behavior, and a \useToast\ hook to manage toast notifications with a limit of one active toast and a 1,000,000ms removal delay. Additionally, \globals.css\ establishes the global style system using Tailwind CSS and \tw-animate-css\, defining CSS variables for light and dark mode themes, typography (Geist/Geist Mono), and UI components like cards, popovers, and charts.
bettershot-landing/hooks, bettershot-landing/styles · high confidence
Introduce scrolling capture with live preview and auto-scroll
Users can now capture full-length scrolling webpages or documents. The new \ScrollCaptureController\ stitches multiple frames into a single image, while the \ScrollCaptureSessionPresenter\ manages the session UI, including a floating control bar and a \ScrollCapturePreviewPanel\ that shows a live preview of the stitched content as it grows. The system automatically scrolls the target window to capture the content, with options to toggle auto-scrolling and cancel the session.
Sources/Capture · high confidence
Introduce self-hosted R2 sharing with direct links and secure credential storage
Users can now share captures to their own Cloudflare R2 bucket. This change introduces a new R2 credential store that securely saves access keys in the Keychain and manages configuration in UserDefaults, including a migration path for existing installs to enable uploads. It adds a hand-rolled AWS SigV4 signer (R2Uploader) to perform direct uploads without an SDK dependency, and implements image compression and manifest generation to optimize file sizes and provide metadata for the web share page. A new toggle allows users to choose between direct file links and viewer links, with direct links disabled by default for existing users.
Sources/Sharing · high confidence
Introduces HistoryStore for persistent capture management
Adds a new HistoryStore class that persists capture history as a JSON file in Application Support. This component handles importing captures with specific naming conventions, referencing existing files, syncing recordings, and managing metadata like pixel dimensions and beautified export paths. It provides the underlying storage logic for the history feature, including thumbnail source resolution and record matching.
Sources/History · high confidence
Introduces a floating preview overlay with pinned screenshots and deck staging
Adds a new floating preview panel that displays a deck of recent captures (images and videos) with configurable card size, edge margins, and position. Users can pin individual captures to persistent floating windows that support scroll-wheel resizing and hover-to-reveal close buttons. The system uses a staging directory to manage capture files, allowing users to edit, pin, share, or save captures from the overlay before they are permanently stored, with automatic dismissal and save-to-default-location actions.
Sources/Preview · high confidence
Introduces comprehensive settings, background, and capture history models
The application now supports a richer set of user preferences and visual customizations. Users can configure the app's appearance, save directory, and export quality, as well as control the capture overlay's position, size, and auto-dismiss delay. A new background system allows screenshots to be beautified with solid colors, gradients, or bundled macOS wallpapers. Additionally, the capture history now tracks recording metadata (such as microphone and camera settings) and preserves the user-assigned name of each capture to prevent renaming conflicts.
Sources/Models · high confidence
Introduces in-app auto-update, image beautification, and silent-screen recording
Users can now update BetterShot directly from within the app via the new AppUpdater service, which checks GitHub releases, downloads the DMG, and prepares it for installation. The image editor gains a BeautifierRenderer that applies cinematic color grades (exposure, contrast, saturation, split-tone, vignette, grain) and decorative backgrounds (solid, gradient, wallpaper, bundled images) with adjustable padding, aspect ratios, and per-corner radii. Screen recording now includes a SilenceDetector that automatically identifies and removes quiet stretches from the audio track, and the app supports editing images directly from the clipboard via a new ClipboardImage service.
Sources/Services · high confidence
Introduces native SwiftUI menu bar popover, onboarding flow, and Liquid Glass styling
The app now uses a custom SwiftUI-based popover for the menu bar tray instead of the native MenuBarExtra, featuring a redesigned capture grid with Region, Screen, Window, Recording, Scrolling Capture, OCR, and Color Picker actions. A new guided onboarding experience walks users through permissions (Screen, Accessibility, Input Monitoring, Microphone, Camera) and includes interactive demos. The UI adopts a new 'GlassSurface' visual style that uses macOS 26's native glass effects with fallbacks for earlier versions, and includes a reusable escape-key handler and toast notification system for status updates.
Sources/Views · high confidence
Launch of the Better Shot marketing site with blog, changelog, and comparison content
The landing site is now live at bettershot.site, providing a central place for documentation and marketing. The site includes a changelog page that displays versioned release notes, a blog index, and dedicated comparison articles positioning Better Shot as a free alternative to CleanShot X, Loom, and CapCut. Global styles and layout components are established to support these pages.
bettershot-landing/app · high confidence
New annotation engine and capture display logic
This change introduces a complete rewrite of the annotation editor and screenshot capture targeting. A new annotation engine (AnnoEditor, AnnoCanvasLayer, AnnoShapeDrawing) replaces the previous implementation, adding support for complex interactions like arrow binding, rotation, and native text editing overlays, while also introducing 3D camera effects, progressive blur, and custom backgrounds for the preview card. Additionally, a new ActiveDisplayResolver ensures screenshots and previews target the correct display by honoring user pinning preferences and mouse position, and AfterCaptureActions configures post-capture behaviors like auto-saving and uploading.
Sources/BetterShot · high confidence
New build and validation scripts for DMG packaging and symbol checks
The project now includes a suite of automation scripts to support the build and release process. A new \create-dmg.sh\ script automates the creation of the application installer disk image, utilizing a \dmg-background.swift\ script to generate a custom branded background image. Additionally, \check-sf-symbols.py\ validates that all SF Symbols used in the source code are available on the minimum supported macOS version, and \run-checks.sh\ orchestrates these validations alongside Swift source checks. A \generate-cap-3d-reference.py\ script is also added to regenerate 3D scene test fixtures from the upstream Cap renderer.
scripts · high confidence
New interactive share view for screenshots and recordings
The share view component now renders a dedicated interface for viewing shared Better Shot content, supporting both screenshots and video recordings. For screenshots, an image viewer allows zooming (up to 6x) and panning via mouse drag or Ctrl/Cmd+scroll, with a floating toolbar for zoom controls. For videos, a custom player includes a scrubber with hover previews, keyboard shortcuts (space to play/pause, arrows to seek, J/L for 10s seek, M to mute, F for fullscreen), playback speed selection, picture-in-picture, and fullscreen modes. The view also displays metadata (author, dimensions, file size, relative time) and provides download and copy-link actions.
bettershot-landing/components/share · high confidence
New landing page UI components for BetterShot
The landing page now features a suite of new UI components including a download dropdown with Apple Silicon, Intel, and Homebrew options, animated demo galleries with autoplay videos, a feature carousel, and animated statistics counters. The site navigation and footer have been updated to include product links, social proof with GitHub contributor avatars, and badges for UsefulShelf and TryMacApps.
bettershot-landing/components · high confidence
New native macOS settings interface and media gallery
The application now features a redesigned, native macOS Settings window with a sidebar navigation for General, Capture, Overlay, Recording, Shortcuts, and Sharing sections. This update introduces a dedicated Media Gallery for browsing and managing local and cloud captures, and a new Overlay Settings tab that allows users to customize the preview card's layout, position, size, and tool assignments.
Sources/Settings · high confidence
Behavioural changes
BetterShot sandboxing and URL scheme configuration
The BetterShot resource bundle now includes an entitlements file granting audio-input and camera permissions, and an Info.plist defining the 'bettershot' URL scheme and usage descriptions for camera, microphone, screen capture, input monitoring, and speech recognition. This enables the app to operate within a sandboxed environment while supporting URL-based actions and required privacy permissions.
Resources · high confidence
Introduces native SwiftUI app structure with onboarding, release notes, and URL-based capture actions
BetterShot has been rewritten as a native SwiftUI application, replacing the previous architecture with a new \BetterShotApp\ entry point and \BetterShotDelegate\. This change introduces a guided onboarding flow for new users, a release notes window that displays changelog updates, and the ability to trigger specific capture actions (region, fullscreen, window, scroll, recording, OCR, color picker, and settings) via custom \bettershot://\ URL schemes. The app now manages its own window lifecycle for annotation and video editors, handles recording recovery on launch, and respects a user preference to hide the capture bar at startup.
Sources/App · high confidence
Test coverage
Added automated tests for annotation handling, URL routing, clipboard, and export formats
Added a suite of new test files in the Tests directory to verify core product behaviors. AnnotationCommitCheck and AnnotationReopenCheck validate that annotations are correctly committed to the history library, that base images are preserved for re-rendering, and that reopening captures resolves to the correct edited or raw source files. CaptureURLActionCheck ensures the bettershot:// URL scheme correctly maps to capture actions and rejects malformed inputs. ClipboardImageCheck verifies that images pasted from the clipboard retain their original format (PNG, JPEG) or are safely converted (TIFF to PNG) without touching the user's system clipboard. ColorGradeCheck confirms that the nine color grading presets and individual knobs (exposure, saturation, temperature, etc.) produce the expected pixel changes. DeckStagingCheck tests the staging logic for deck cards, ensuring promotion to the library and discard operations work correctly. DefaultLookMappingCheck ensures background styles, padding, and aspect ratios map correctly between configuration and settings. EditorSceneIntegration and EditorUIIntegration verify SwiftUI editor scene behavior, full-screen transitions, tool deselection, gradient persistence, and cursor artwork caching. ExportFormatCheck ensures all offered export formats are encodable by ImageIO and that stale WebP preferences fall back to PNG.
Tests · high confidence
Dependencies
Initialize bettershot-landing with Next.js 15 and React 19
The bettershot-landing project is initialized with a new dependency set, upgrading the framework to Next.js 15.4.10 and the runtime to React 19.2.3. This includes a comprehensive suite of UI components from Radix UI, animation libraries like Framer Motion and Motion, and utility packages such as Zod and Tailwind CSS. Additionally, a separate video rendering environment is established in the remotion subdirectory, pinning Remotion to version 4.0.443 and its own React dependency to 19.2.0.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 43 → 41 (-1.4)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 53 → 42 (-11.0)
- Architecture 83 → 84 (+1.2)
- Maturity 65 → 65 (+0.0)
- Readiness 30 → 28 (-2.2)
- Security 75 → 85 (+10.4)
- Accessibility 43 → 47 (+3.4)
- Performance 71 → 85 (+13.7)
Resolved (15)
- Duplicated block (12 lines × 2) (Sources/BetterShot/RecordingStudioExporter.swift)
- Duplicated block (12 lines × 2) (Sources/Settings/PreferencesView.swift)
- Duplicated block (14 lines × 2) (Sources/BetterShot/AnnotationBackgroundPresetStore.swift)
- Duplicated block (14 lines × 2) (Sources/BetterShot/InkPath.swift)
- Duplicated block (16–18 lines × 2) (Sources/BetterShot/AnnotationBackgroundPreviewViews.swift)
- Duplicated block (28 lines × 2) (Sources/BetterShot/AnnotationTool.swift)
- Duplicated block (5 lines × 2) (Sources/Services/ShortcutService.swift)
- Duplicated block (6 lines × 2) (Sources/BetterShot/InkPath.swift)
- Duplicated block (6 lines × 2) (Sources/Views/MenuBarContentView.swift)
- Duplicated block (7 lines × 2) (Sources/BetterShot/RecordingPointerStream.swift)
- Duplicated block (8 lines × 2) (Sources/BetterShot/AnnotationBackgroundPresetStore.swift)
- Hotspot: Sources/Services/ShortcutService.swift (Sources/Services/ShortcutService.swift)
- Near-duplicate member pair (40 shared lines) (Sources/BetterShot/InkPath.swift)
- No ADRs found
- check-sf-symbols.main (cognitive 23) (scripts/check-sf-symbols.py)
New (97)
- Banned license: @img/sharp-libvips-darwin-arm64 (bettershot-landing/pnpm-lock.yaml)
- Banned license: @img/sharp-libvips-darwin-x64 (bettershot-landing/pnpm-lock.yaml)
- Banned license: @img/sharp-libvips-linux-arm (bettershot-landing/pnpm-lock.yaml)
- Banned license: @img/sharp-libvips-linux-arm64 (bettershot-landing/pnpm-lock.yaml)
- Banned license: @img/sharp-libvips-linux-ppc64 (bettershot-landing/pnpm-lock.yaml)
- Banned license: @img/sharp-libvips-linux-riscv64 (bettershot-landing/pnpm-lock.yaml)
- Banned license: @img/sharp-libvips-linux-s390x (bettershot-landing/pnpm-lock.yaml)
- Banned license: @img/sharp-libvips-linux-x64 (bettershot-landing/pnpm-lock.yaml)
- Banned license: @img/sharp-libvips-linuxmusl-arm64 (bettershot-landing/pnpm-lock.yaml)
- Banned license: @img/sharp-libvips-linuxmusl-x64 (bettershot-landing/pnpm-lock.yaml)
- Banned license: @img/sharp-wasm32 (bettershot-landing/pnpm-lock.yaml)
- Banned license: @img/sharp-win32-arm64 (bettershot-landing/pnpm-lock.yaml)
- Banned license: @img/sharp-win32-ia32 (bettershot-landing/pnpm-lock.yaml)
- Banned license: @img/sharp-win32-x64 (bettershot-landing/pnpm-lock.yaml)
- Duplicated block (14 lines × 2) (Sources/BetterShot/AnnotationBackgroundPresetStore.swift)
- Duplicated block (16–18 lines × 2) (Sources/BetterShot/AnnotationBackgroundPreviewViews.swift)
- Duplicated block (8 lines × 2) (Sources/BetterShot/AnnotationBackgroundPresetStore.swift)
- Edited copies of one member (3 members, 10+ corresponding lines) (Sources/BetterShot/Intersect.swift)
- Edited copies of one member (3 members, 8+ corresponding lines) (Sources/BetterShot/RecordingSession.swift)
- Edited copies of one member (3 members, 9+ corresponding lines) (Sources/BetterShot/RecordingClipTimeline.swift)
- …and 77 more
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
KartikLabhshetwar/better-shot was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 15 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 0e005e9ce4bcf0c35f6672367e659039bbb85f90 — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-3c33c1882dc1.