Home
Softono

ElegantClipboard

Open source MIT TypeScript
GitHub
394
Stars
14
Forks
20
Issues
3
Watchers
2 months
Last Commit
Clipboard & Launchers

 About ElegantClipboard

An elegant and fast clipboard. 低占用、高性能、现代化、高度自定义，本地化离线剪贴板。

Platforms

Web Self-hosted Windows

Languages

TypeScript

Links

Source Code

Need Help Installing ElegantClipboard?

We provide expert installation service for this software. Our team will install, configure, and secure ElegantClipboard on your server. plans start at just $30.

Hire an Expert

Alternatives to ElegantClipboard

View All

EcoPaste

EcoPaste is an open-source cross-platform clipboard management tool built with Tauri v2. It supports Windows, macOS, and Linux (x11), providing a lightweight and efficient solution for managing clipbo

7.1K

TermiT/Flycut

Clean and simple clipboard manager for developers

2.7K

Tiez Clipboard

TieZ 是一款基于 Tauri 的跨平台剪贴板管理器 / A cross-platform clipboard manager with history, tags, sync, privacy protection, and fast daily workflows.

2.1K

PasteBar/PasteBarApp

PasteBar - Limitless, Free Clipboard Manager for Mac and Windows

2.1K

Gnome Shell Pano

Next-gen Clipboard Manager for Gnome Shell

1.4K

Copyous

Modern Clipboard Manager for GNOME

511
Published by
y-aslant
Visit View Profile

ElegantClipboard

View on GitHub

ElegantClipboard

English | 中文

说明：本文档中的界面截图可能与最新版本略有差异，当前截图拍摄于 v0.5.0。

ElegantClipboard

低占用 · 高性能 · 现代化 · 完全本地化离线剪贴板。

version downloads platform license CI

界面截图（v0.5.0）

外观主题

跟随系统强调色

跟随系统

经典黑白 翡翠绿 天空青
经典黑白 翡翠绿 天空青

暗色模式

自动跟随系统深色/浅色模式，实时切换

设置界面

数据管理 显示设置 快捷按键
数据管理 显示设置 快捷按键

图片悬浮预览

图片预览

文本悬浮预览

文本悬浮预览与图片悬浮预览共用预览位置与悬浮预览延时设置（默认 500ms，文本预览默认关闭）。

启动通知

启动通知

设计理念

低占用 · 高性能 · 现代化 · 完全本地化离线

  • 低占用 - 托盘常驻，不打扰核心工作流，窗口不抢占焦点，仅可见时启用监控
  • 高性能 - 优化的 LIKE 搜索（兼容 CJK 文本）、虚拟列表处理万级记录、异步图像处理、内容哈希去重
  • 现代化 - Tauri 2.0 + React 19 + Tailwind CSS 4，类型安全，优雅架构
  • 本地化离线 - 数据完全本地存储，无网络请求，无云同步，隐私至上

功能特性

完整功能列表与术语约定见 FEATURES.md。

快捷键

全局快捷键

快捷键 功能
Alt+C 显示/隐藏窗口（默认，可自定义）
Win+V 显示/隐藏窗口（可选，需在设置中开启）

窗口内快捷键

快捷键 功能
↑ / ↓ 上下选择剪贴板条目
← / → 切换分组标签（全部/文本/图片/文件/收藏）
Enter 粘贴选中条目
Shift+Enter 以纯文本粘贴选中条目
Delete 删除选中条目
ESC 关闭对话框/隐藏窗口
Ctrl+滚轮 缩放图片预览 / 滚动文本预览

技术栈

类别 技术
框架 Tauri 2.0
前端 React 19 + TypeScript
构建 Vite 7
样式 Tailwind CSS 4
组件 shadcn/ui (Radix UI) + Fluent UI Icons
状态管理 Zustand 5（持久化 + 多窗口同步）
虚拟列表 react-virtuoso
拖拽排序 @dnd-kit
后端 Rust
数据库 SQLite (rusqlite) + 优化的 LIKE 查询（支持 CJK 文本）
哈希 BLAKE3（内容去重）
锁 parking_lot（高性能 Mutex/RwLock）
并行 rayon（文件检查并行化）
剪贴板 clipboard-master + arboard + clipboard-rs
窗口特效 window-vibrancy（Mica/Acrylic/Tabbed）
键盘模拟 enigo
输入监控 Win32 LL Hook（WH_MOUSE_LL + WH_KEYBOARD_LL，仅窗口可见时启用键盘钩子）
自动更新 基于 GitHub Release 的检查与下载（支持系统代理）
CI/CD GitHub Actions（CI + Tag 触发 Release）

安装

下载安装包

从 Releases 页面下载最新版本：

  • 安装版（推荐）：ElegantClipboard_x.x.x_x64-setup.exe
  • 便携版：ElegantClipboard_x.x.x_x64_portable.exe（无需安装，直接运行）

winget

winget install Y-ASLant.ElegantClipboard

Scoop

scoop bucket add elegantclipboard https://github.com/Y-ASLant/ElegantClipboard
scoop install elegantclipboard

从源码构建

环境要求

  • Node.js 18+（推荐 LTS 版本）
  • Rust 1.85+（Rust edition 2024）
  • Windows 10/11

构建步骤

# 克隆仓库
git clone https://github.com/Y-ASLant/ElegantClipboard.git
cd ElegantClipboard

# 安装依赖
npm install

# 仅构建前端静态资源（dist/）
npm run build

# 开发模式
npm run tauri dev

# 构建生产版本（默认仅当前机器架构）
npm run tauri build

# 分别构建 x64 / arm64 安装包（需执行两次）
npm run tauri build -- --target x86_64-pc-windows-msvc
npm run tauri build -- --target aarch64-pc-windows-msvc

# 代码检查
npm run lint

说明：

  • npm run build 只会执行 tsc && vite build，用于前端资源构建，不会生成安装包。
  • 安装包由 npm run tauri build 生成；不指定 --target 时只构建当前环境对应架构。
  • 需要同时发布 x64 和 arm64 时，需分别执行两次带 --target 的构建命令（或在 CI 中分架构构建）。

版本管理

# 统一修改三处版本号（package.json, tauri.conf.json, Cargo.toml）
.\scripts\bump-version.ps1 0.5.0

或直接推送 tag，Release workflow 自动同步版本号并构建：

git tag v0.5.0
git push origin v0.5.0

数据存储

默认存储位置（可在设置中修改）：

类型 路径
配置文件 %LOCALAPPDATA%\ElegantClipboard\config.json
数据库 <数据目录>\clipboard.db
图片缓存 <数据目录>\images\

许可证

MIT License

作者

ASLant - @Y-ASLant