All notable changes to SaneClip will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Keeps image previews small in memory, and still opens the original picture when you paste. Keeps the original of a pinned picture when synced history is trimmed.

Keeps a paid unlock in place after an update, so you do not have to enter your license key again.

Nine-tab Settings, on-device Rewrite and Summarize, and clearer license recovery.

Keeps image history lighter in memory by storing thumbnails in RAM and loading full originals only when needed. Also cleans up leftover Sparkle updater helpers after automatic update checks.

Adds optional on-device Rewrite, Summarize, and Extract Key Points actions for text clips. They require macOS 26 or later, an eligible Apple Intelligence Mac, Apple Intelligence enabled, and the on-device model ready. Results open in a private preview with explicit Copy or Cancel controls and never replace clipboard history.

Prevents Developer ID, Debug, App Store, and Setapp builds from monitoring the clipboard at the same time.

Improves direct-license validation so the SaneApps Bundle activates SaneClip Pro for valid direct Mac purchases.

Fixes keep-open fixed history pastes so the next selected clip goes back into the app you were using instead of landing in SaneClip or doing nothing.

Improves fixed history focus after keep-open paste and direct update reliability for older installs.

Improves narrow history row resizing, keeps hover metadata and actions stable across window shapes, and tightens Paste Stack controls so compact rows stay readable.

Fixes history keep-open paste reliability, preserves Merge Queue selections after reopening history, keeps Pause Capture countdowns refreshed while idle, and removes direct-store update/donation UI from App Store and Setapp builds.

Important update to onboarding, licensing, and reliability. Recommended for all users.

• Tightens keep-open history focus handoff so the floating history panel is ordered out before paste is attempted.
• Keeps Merge Queue selections and counts through floating/fixed history window reopen and mode switches until you clear or merge them.
• Keeps the Pause Capture countdown updating while the pasteboard is idle.
• Only plays the paste-success sound after the simulated paste succeeds.

• SaneClip now makes sure it only ever runs as one copy. Two copies at once would both watch the clipboard and fight over your history, so a duplicate launch quietly steps aside and brings the running one forward.
• The Pro Paste Stack can now build itself as you copy: turn on "Record copies" (in the stack panel, or Edit ▸ Record Copies to Paste Stack / ⌘⇧R) and everything you copy is added to the stack in order, ready to paste back one after another. It stays a fully editable, reorderable list, and is capped so it can't grow forever. Clips in the stack are kept even as older history scrolls off, so a stack you built by copying is still there after a restart.
• History rows now show which app each clip came from, right next to when it was copied ("Safari · 2m ago"), instead of leading with a word and character count. The count is still there on hover.
• The Pro floating history window now opens a live preview beside the list when it's wide enough: the full clip plus its source app, type, when it was captured, how often it's been pasted, and its collection, tags, and note — with Paste, Plain Text, and Pin right there.
• The empty history window now keeps the search field at the top instead of floating it into the middle.
• Colors in the history window now follow one consistent meaning each: blue for actions, amber for pinned, green for pasted, yellow for Pro, teal for merge, and violet for the paste stack — so a color always tells you the same thing.
• The bottom of the history window is now a fixed bar — item count on the left, Settings and Smart Clear on the right, always in the same place — with merge and paste-stack controls appearing in a band just above it only when you're using them.
• Routine "you're up to date" update checks no longer show up as errors in diagnostics.
• The bottom toolbar collapses to a single clean row when there's nothing queued, instead of showing an empty paste-stack chip.
• Moves the merge queue and paste stack controls to their own footer row, so the horizontal scrollbar can no longer cover Clear Queue at narrow widths.
• Fixes the Pro floating history window closing when you click its own title bar, search field, filter, or pause controls; only clicks truly outside the window close it now.
• Adds a Pro pin button beside history search to keep the history window open after pasting — and the setting (renamed "Keep history window open after pasting") now also applies to normal history pastes, not just the paste stack.
• Keeps the floating history window (and your in-progress edit) open while an Edit, Smart Clear, or preview sheet is showing, even when the sheet extends past the window edge at small window sizes.
• The floating history window now stays non-activating while still accepting row clicks, so the first click on a clip works and the synthetic paste goes back into the app you were using instead of into SaneClip.
• Keep-open mode no longer hides and reopens the floating history window after paste, which removes the visible flicker.
• Fixes pinned clips being lost once your history filled up: a pinned item (and, for an image, its saved copy) could be dropped and quietly unpinned when it aged past your history limit. Pinned clips are now always kept, no matter how much you copy.
• Select several clips (the merge-queue selection) and delete them all at once with a new Delete button, instead of removing them one by one.
• Hover/drag tracking around history rows is wider and less fussy, so row affordances are easier to hit.
• New Pro rule "Strip trailing newline" drops just the final newline from copied text, so pasting a command into a terminal no longer runs it on its own — while keeping your indentation and blank lines intact.
• The "Strip URL tracking parameters" rule now catches many more trackers (Google Ads gbraid/wbraid, Microsoft, X, HubSpot, Mailchimp, and others), not just the common utm_/fbclid ones.
• History with many items from different apps scrolls more smoothly — source-app icons are now cached instead of looked up again for every row on every frame.
• When History Encryption or Touch ID history lock is enabled, SaneClip now clears widget and iOS app-group preview caches instead of keeping plaintext mirrored clips for widgets or companion surfaces.
• Menus and app metadata are now localization-ready, with UI localizations staged for English, French, German, Spanish, Italian, Portuguese (Brazil), Japanese, Simplified Chinese, and Korean.

• Keeps Edit Text Save and Cancel buttons visible while editing long clips.
• Makes Clipboard Rules switches update visibly as soon as they are clicked.
• Keeps the resizable floating history window correctly Pro-gated and closes it when you click outside it.
• Known issues, fixed in 2.3.14: the footer scrollbar could still cover Clear Queue, and clicks on the floating window's own title/search/filter/pause area wrongly closed it.

A big history + window update:

• Clipboard history can now open as a free-floating, resizable window (Settings → General → Appearance → "Open history as a resizable floating window") that remembers its last size and screen position between launches.
• Drag clips straight out of the window into other apps (a subtle handle appears on hover); pinned items keep drag-to-reorder.
• Faster keyboard control: the selection now scrolls into view as you move, with Home/End and Page Up/Down to jump, P to pin the selected clip, and Esc to clear search/filters or close the window.
• Layout is solid at every size now — the bottom toolbar and the filter row no longer squash or clip on narrow widths, and clip badges stay visible.
• Quick-paste (⌘⌃1–9) hints now only show when they're accurate.
• History rows are now color-coded by source app for every app (Mac and iPhone/iPad), not just Apple apps — each source gets its own consistent color instead of everything defaulting to blue.

Pro is now free to try for 14 days. Basic remains included after the trial.

Pro is now free to try for 14 days. Basic remains included after the trial.

Restores the visible iPhone clipboard save prompt, improves multi-clip paste saving, adds a Mac menu bar icon visibility setting that preserves app access, and updates Setapp/App Store signing readiness.

• Tightens the Setapp build entitlements by removing unused Apple Events and Sparkle review surface.

Restores the visible iPhone clipboard save prompt, saves every current iOS pasteboard item SaneClip can access, improves image sharing, and aligns automation/privacy support copy with the shipped Mac and iPhone workflows.

• Clarifies that iPhone/iPad use explicit save, Share sheet, Shortcuts, and iCloud companion flows rather than silent background clipboard capture.
• Fixes iOS share extension image availability and keeps synced CloudKit uploads aligned with the History Encryption setting.
• Tightens public automation and privacy copy so customer-facing claims match the shipped URL scheme, App Intents, Shortcuts, and support flows.

Keeps synced Mac clipboard text appearing on iPhone and iPad automatically while the companion app is foregrounded, without showing the local pasteboard save banner for iCloud-synced clips. Improves settings and history-window structure without changing the customer workflow.

Improves password protection so generated passwords copied from browser extensions are skipped when Protect Passwords is enabled.

Fixes license-key paste reliability in activation and settings.

Fixes Capture Text after the macOS screen picker by capturing the selected content through the picker-backed ScreenCaptureKit stream path instead of the still-image API path that could loop back into Screen Recording/TCC failures. Migrates the unreliable legacy Command-Shift-V clipboard-history shortcut to Command-Shift-Control-Y and updates reset/docs copy to match.

Improves startup reliability on macOS 15, fixes clipboard edit-save behavior, restores shortcut reset and snippet visibility fixes, and keeps App Store builds aligned with Apple review requirements.

Fixes editing saved clipboard items, clarifies Capture Text from Screen permissions, adds visible snippet paste controls, and adds a reset action for the clipboard history shortcut.

Fixes editing saved clipboard items, clarifies Capture Text from Screen permissions, adds visible snippet paste controls, and adds a reset action for the clipboard history shortcut.

Adds the current direct-download and App Store release line with the refreshed Basic/Pro clipboard workflow, updated release packaging, and the latest iCloud/mobile companion polish.

Makes pinning free on Mac so Basic matches the App Store promise and the iPhone companion. Clarifies Pro upgrade messaging around organization tools while keeping advanced workflows in Pro. Keeps the clipboard history popover pinned under the menu bar icon more reliably. Improves the upgrade popup so license entry and dismissal behave cleanly.

Aligns the Pro pricing copy across onboarding, history locks, snippets settings, and other Basic-to-Pro upgrade prompts so every upgrade surface shows the current $14.99 one-time unlock.

Adds Smart Clear and true Unlimited history for Pro, restores the color-coded source indicators on iPhone and iPad, aligns the mobile UI with the approved screenshots, and improves older Mac update recovery.

Restores the color-coded source indicators on iPhone and iPad, brings the mobile settings/history UI back in line with the approved App Store screenshots, and improves recovery for older Mac updater installs.

Fixes iPhone iCloud sync recovery, adds manual iCloud sync reset and diagnostics, and refreshes the sync settings layout across Mac, iPhone, and iPad.

Settings now use the shared SaneUI shell, the menu bar icon preview stays readable, and no-keychain builds keep the correct unlock state.

Adds diagnostics-backed bug reporting on iPhone and iPad, and refreshes the latest sync and support improvements across the release line.

Fixes the Excluded Apps Add App picker in sandboxed builds, restores import/export and PDF file panels, and improves keyboard navigation in history and settings.

Fixes iCloud sync rollout and production schema issues, preserves local history more reliably when enabling sync, improves update reliability, and fixes edit-field keyboard shortcut handling.

Improved iCloud sync bootstrap reliability across Mac, iPhone, and iPad. Fixed Excluded Apps picker behavior in Settings. Sample data now clears cleanly when real history arrives. Stability improvements.

Fixes the direct-download sync release, cleans up onboarding layout, and hardens sync startup across builds.

Improved iCloud sync setup across Mac, iPhone, and iPad. Fixed App Store metadata and review details. Reliability and stability improvements.

Stability improvements, launch reliability hardening, and updated public feature coverage.

Critical quality update: clearer onboarding, stronger permission reliability, robust Basic/Pro gating, and polished settings UX.

Reliability and compatibility update. Improves license gating, update delivery, and setup stability.

• Secure webhook pipeline updates — Improved validation and safer handling around webhook-triggered actions
• Siri Shortcuts and widgets polish — Better reliability and UX consistency across companion surfaces

• Update channel alignment — Sparkle appcast now points to the 2.1 ZIP release artifact
• Release metadata refresh — Versioning and release notes aligned for 2.1 rollout

• Stability fixes — Multiple reliability fixes across clipboard flow and edge-case handling

• Cross-device sync — iCloud-based clipboard sync between macOS and iOS
• Smart paste modes — Context-aware paste behavior for links, code, and standard text
• Paste stack — Queue-based multi-item paste workflow (FIFO/LIFO)
• iOS companion app — Mobile access to clipboard history with shortcuts/widgets

• Default paste behavior options — Configurable default mode in settings
• URL cleanup improvements — Expanded tracking-parameter stripping rules

• General quality improvements — Reliability and UX refinements for history/search/paste flows

• Keychain Integration — All secrets (webhook keys, encryption keys) now stored securely in macOS Keychain
• History Encryption-at-Rest — AES-256-GCM encryption for clipboard history (enabled by default)
• URL Scheme Confirmation — Destructive commands (copy, paste, clear) require user confirmation
• HTTPS Enforcement — Webhooks must use HTTPS (localhost exempt for testing)
• Seamless Migration — Existing plaintext data auto-migrates to encrypted format on first launch

• New KeychainHelper with Sendable conformance for secure credential storage
• New HistoryEncryption service using CryptoKit AES-GCM
• Enhanced URLSchemeHandler with command parsing and confirmation requirements
• App Store sandbox keychain-access-groups entitlement added
• 22 new security tests (47 total tests, all passing)

• URL scheme security validation
• Keychain round-trip verification
• Encryption/decryption integrity checks
• HTTPS enforcement validation

• iCloud Sync — Removed CloudKit sync infrastructure pending Apple Developer provisioning resolution
• End-to-End Encryption — Removed encryption service (was for sync feature)
• Sync Settings UI — Removed sync settings panel from preferences

• 100% Local — All clipboard data now stays entirely on-device
• Simplified architecture — Reduced complexity by removing sync-related code

• Deleted CloudKitSyncService.swift, EncryptionService.swift, SyncSettingsView.swift
• Updated entitlements to remove iCloud containers
• Distribution now via Cloudflare R2 (dist.saneclip.com)

iCloud sync may return in a future version once provisioning issues are resolved. The current version is fully functional as a local-only clipboard manager.

• First-launch onboarding — Welcome tutorial with permissions setup and keyboard shortcuts guide
• App source attribution — See which app each clip came from with app icon
• Excluded apps list — Block sensitive apps (1Password, banking apps) from clipboard capture
• Duplicate detection — Automatically consolidate identical clips
• Keyboard navigation — Arrow keys and vim-style j/k navigation in history
• Paste count badges — Track how many times each item was pasted
• Menu bar icon options — Choose between List and Minimal icon styles
• Sound effects toggle — Optional paste confirmation sounds (opt-in)
• URL tracking stripping — Automatically removes utm_*, fbclid, gclid from copied URLs
• Pinned items persistence — Pinned items survive app restart
• Hover highlighting — Visual feedback with glass material effect on hover
• Content-type icons — Link, code, or text icons for faster visual scanning

• Security-by-default — Authentication now required to reduce any security setting
• Smarter time display — Compact format (41s → 15m → 2h → 3d)
• Compact stats — Shows "21w · 350c" instead of verbose text
• Aligned metadata — Fixed-width columns for cleaner visual scanning
• Renamed setting — "Protect passwords" → "Detect & skip passwords" for clarity

• Metadata no longer wraps — Single-line metadata regardless of content length

• Touch ID unlock loop — Using Touch ID no longer closes the clipboard history. Added 30-second grace period so you stay authenticated between accesses.
• Smoother popover after auth — Added slight delay for Touch ID dialog to fully dismiss before showing clipboard.

• Broader compatibility — Now supports macOS 14 Sonoma and later (was Sequoia-only). All Apple Silicon Macs supported (M1+).
• Updated website — New saneclip.com with improved Open Graph previews.

• Clipboard history — Automatically captures everything you copy
• Touch ID protection — Optional biometric lock for clipboard access
• Keyboard shortcuts — ⌘⇧V for history, ⌘⌃1-9 for quick paste
• Paste as plain text — ⌘⇧⌥V strips formatting
• Pin favorites — Keep important clips always accessible
• Search — Filter history by content
• Password protection — Auto-removes quick-cleared items (password managers)
• Settings — Configurable history size, Touch ID, keyboard shortcuts
• Auto-updates — Sparkle integration for seamless updates
• Launch at login — Optional startup on login

• Native SwiftUI app for macOS
• Hardened runtime with notarization
• Open source on GitHub

• Multiple paste modes (plain text, UPPERCASE, lowercase, Title Case)
• Smart snippets with placeholders
• Rich search filters
• See GitHub Issues for full plans