LynavoPaste Community

A local-first clipboard history manager for macOS.

Releases · Issues

LynavoPaste Community runs quietly in the menu bar, captures clipboard history, classifies entries, and lets you find and reuse copied content in seconds. It is built with SwiftUI, AppKit, and Core Data, with history stored locally on your Mac.

Highlights

• Global shortcut: Open the clipboard panel with Option + V by default, or record your own shortcut.
• Automatic capture: Keep a searchable history of copied content without manual filing.
• Smart classification: Recognize text, links, email addresses, images, files, folders, colors, and other content.
• Fast search and filtering: Search by text, category, or source application with paginated history loading.
• Rich previews: Preview text, web links, images, colors, PDFs, and files before using an entry.
• Original or plain-text paste: Restore the original pasteboard representations or paste text only.
• Pin and reorder: Keep frequently used entries at the top of the panel and adjust their order.
• Drag and drop: Drag text, images, links, and files from history into other applications.
• History controls: Retain history for 1 day, 1 week, 1 month, or 3 months, or clear it on demand.
• Source application views: Browse and remove history captured from a specific application.
• Settings: Configure appearance, language, launch at login, retention, shortcuts, and excluded applications.

Requirements

• macOS 13.0 or later
• Xcode 26 or later
• Apple Silicon or Intel Mac

Installation

Download a release

Download the latest DMG from the project Releases page:

1. Download and open the DMG.
2. Drag LynavoPaste Community.app to Applications.
3. Launch the app from Applications.

Build from source

git clone https://github.com/Lynavo/lynavo-paste.git
cd lynavo-paste
xcodebuild \
  -project LynavoPaste.xcodeproj \
  -scheme LynavoPasteCommunity \
  -configuration Debug \
  -derivedDataPath build

The built app is usually located at:

build/Build/Products/Debug/LynavoPaste Community.app

You can also open LynavoPaste.xcodeproj in Xcode, select the LynavoPasteCommunity scheme and a macOS run destination, then choose Product > Run.

Quick start

1. Launch LynavoPaste Community. It will continue running from the macOS menu bar.
2. Copy content in any application. New clipboard entries are captured automatically.
3. Press Option + V to open the panel.
4. Search or filter the history, select an entry, and press Return to paste it into the previous application.
5. Use the context menu to preview, copy, paste as plain text, pin, reorder, delete, or reveal file entries in Finder.

Accessibility permission

Automatic paste uses macOS keyboard event automation. On first use, macOS may ask for Accessibility permission. Grant it under System Settings > Privacy & Security > Accessibility for LynavoPaste Community.

For sensitive sources such as password managers, keep the default excluded applications or add additional applications under Settings > Excluded Apps.

Privacy and storage

Clipboard history is stored locally in a Core Data database. Link previews may contact the destination website when opened. Clipboard contents should be treated as sensitive local data: review retention and excluded-app settings before using the app with confidential material.

Development

List project schemes:

xcodebuild -list -project LynavoPaste.xcodeproj

Build a Debug version:

xcodebuild \
  -project LynavoPaste.xcodeproj \
  -scheme LynavoPasteCommunity \
  -configuration Debug \
  build

Run unit and UI tests:

xcodebuild test \
  -project LynavoPaste.xcodeproj \
  -scheme LynavoPasteCommunity \
  -destination 'platform=macOS'

The main source directories are organized by responsibility:

Directory	Responsibility
Services/	Pasteboard capture, classification, formatting, writing, and history services
Persistence/	Core Data model, DAO, and repository
Models/	Clipboard entries, categories, and pasteboard representations
Panel/	Global panel, shortcuts, paste automation, and drag and drop
Home/	History home, search, and source-application views
Settings/	Settings state and preference screens
Components/	Entry previews and file/text drop components
Support/	Logging, JSON, localization, and shared helpers

Contributing

Issues and pull requests are welcome. See CONTRIBUTING.md for development and review expectations. Participation is governed by the Code of Conduct.

Security and privacy

Report vulnerabilities according to SECURITY.md. Details about local clipboard storage, web previews, diagnostic logs, retention, and deletion controls are documented in PRIVACY.md.

Building release packages

For public distribution, archive the app in Xcode, sign it with a Developer ID certificate, package it as a DMG, and submit it for Apple notarization. Verify the signed app and notarized DMG before publishing a release.

License

LynavoPaste Community is licensed under the GNU Affero General Public License v3.0.