mahpastes

A local clipboard manager for macOS, Windows, and Linux. Store, organize, and quickly access your copied content.

Documentation: https://egeozcan.github.io/mahpastes/

Features

• Paste Anything — Images, text, code, JSON, HTML, and files (paste or drag & drop)
• Fast Navigation — Keyboard-first workflow with drawer + modal shortcuts and a built-in cheatsheet (?)
• Custom Shortcuts — Rebind key mappings from Settings > Shortcuts
• Archive — Keep important clips separate from your active workspace
• Tags — Tag clips, filter by tag, and hide noisy tags from default gallery view
• Image Editor — Annotate images with brush, shapes, and text tools
• Text Editor — Edit text and code clips directly
• Image Comparison — Compare two images with fade, slider, or diff modes
• Bulk Actions — Select multiple clips to tag, archive, download, or delete
• Search — Filter clips by filename or type
• Watch Folders — Auto-import files from monitored directories
• System Notifications — Optional native notifications for imports, received shares and plugin results while the window is in the background
• Plugin System — Install and manage Lua plugins from the dedicated Plugins modal
• mp CLI — Upload, search, tag, pipe and back up clips from the terminal (CLI workflow); see the integration recipes for shell, fzf, tmux, vim, git, file-manager and macOS Quick Action snippets
• REST API — Local, key-authenticated HTTP API with viewer/editor/admin roles and tag-scoped keys (REST API)
• Headless Server — mahpastesd runs the same API and a web UI without the desktop app (setup)
• Claude Code Plugin — Lets Claude Code store artifacts, host sites and search clips through the API (skill, commands; run /mahpastes:setup to connect)
• Backup & Restore — Export and import all data as a ZIP archive
• Background & Startup — Keep running when the window is closed and launch at login, optionally hidden (docs)
• Copy Path — Create a temp file and copy its path to clipboard
• Export — Save individual clips or download multiple as a ZIP
• Auto-Delete Engine — Backend expiration support is implemented; per-clip expiration controls are being surfaced in UI
• Headless Server — Run mahpastesd under systemd or in a container; see docs/docs/features/headless-server.md

Installation

Download Release

Download the latest release from the Releases page:

• macOS (13+, universal): mahpastes-macos-universal.zip, signed and notarized, with Finder integration. Drag mahpastes.app to Applications.
• Windows (x64 or ARM): mahpastes-windows-amd64-installer.exe (or arm64) installs with Start Menu shortcuts; mahpastes-windows-amd64.zip or mahpastes-windows-arm64.zip is the portable archive; scoop install https://github.com/egeozcan/mahpastes/releases/latest/download/mahpastes.json also works. See packaging/README.md for the Scoop and Homebrew manifests.
• Linux (x64; GTK 3, WebKitGTK 4.1, glibc 2.39+: Ubuntu 24.04, Debian 13, Fedora 40 and later): mahpastes-linux-amd64.tar.gz. Extract and run ./install.sh, which installs the app and mp to ~/.local/bin with a desktop entry and icon (./install.sh --uninstall removes them).
• Standalone mp CLI and mahpastesd headless server for each platform, plus SHA256SUMS to verify downloads.

Every app archive includes the mp CLI, the bundled plugins and examples. See the installation guide for details.

Build from Source

Prerequisites

• Go 1.25.7+ (fetches the 1.26.11 toolchain go.mod asks for)
• Wails CLI v2.12.0
• Node.js 18+

# Install Wails CLI
go install github.com/wailsapp/wails/v2/cmd/[email protected]

Build

# Clone the repository
git clone https://github.com/egeozcan/mahpastes.git
cd mahpastes

# Build for your platform
wails build

# The app will be in build/bin/

Platform-specific builds

# macOS (Universal - Intel + Apple Silicon)
wails build -platform darwin/universal

# Windows
wails build -platform windows/amd64

# Linux (WebKitGTK 4.1: Ubuntu 24.04+, Debian 13, Fedora 40+)
wails build -platform linux/amd64 -tags webkit2_41

Install on macOS

After building, copy to Applications:

cp -R build/bin/mahpastes.app /Applications/

Every build uses the bundle identifier io.github.egeozcan.mahpastes (from the committed build/darwin/Info.plist). Builds made before it was committed were com.wails.mahpastes unless they included Finder integration, so after upgrading from one of those macOS asks once more for folder and network permissions; your clips are not affected. The installed app appears under Finder's Open With, accepts files dropped on its Dock icon and handles mahpastes:// clip links.

This is the beginning of the README. Read the rest at the original. Read the full README ↗