在 macOS 上安装
一个下载同时覆盖 Intel 和 Apple Silicon。macOS 读取剪贴板不需要任何 授权，这让安装变得毫无难度 —— 也正因为这样，应用才要在第一次启动时 自己把这件事说清楚。
安装
- 从发布页下载
RealtimeClipboard_<version>_universal.dmg。 - 打开它，把 RealtimeClipboard 拖进“应用程序”。
- 启动它。需要 macOS 11 或更高版本。
下载只有一个，不是两个。发布流程构建的是
--target universal-apple-darwin，所以同一个文件在两种架构上
都是原生运行。如果你在找单独的 Apple Silicon 版本，你手上这个就是。
或者用包管理器
brew install --cask akshaynikhare/tap/realtimeclipboard
这个 cask 放在
akshaynikhare/homebrew-tap，
由 tools/release/manifest.mjs 从每一次发布生成，所以它的版本号
和校验和都来自一个真正构建出来的产物。不用先 brew tap ——
在安装命令里写明 tap 就够了。
它也是绕开 Gatekeeper 那道坎最省事的办法：cask 会在装完之后去掉隔离属性， 应用直接就能打开，不必再跑一趟“隐私与安全性”。那是 Homebrew 替你做了你 本来要手动做的事，不是签名 —— 这个构建仍然是未签名的。
命令行客户端是另一个 formula，realtimeclipboard-cli，和桌面
应用不是一回事 —— 见命令行指南。
确认装好了
- 菜单栏里出现一个图标。点它，菜单就打开，跟菜单栏图标本该有的 样子一样 —— Open RealtimeClipboard 是第一项，Quit 是最后 一项，这是有意为之：一个盯着你剪贴板的应用，必须有一个看得见的地方让你 把它停掉。用红色按钮关掉窗口并不会退出，它把应用留在菜单栏里，好让它 继续盯着。
- 状态栏显示
T0 · watching the system clipboard， 在窗口右下角。那是原生监听器在自报家门。同一台机器上的 Safari 显示的是T1 · paste only，而这个差别正是你装它的理由。
第一次同步
- 记下应用顶部那个短密钥，或者自己输一个。
- 在第二台设备上打开应用，输入同一个密钥。
- 在 Mac 上复制点什么，不用切回 RealtimeClipboard。它会出现在另一台 设备上。
什么都没发生？看看窗口顶部那个开关是不是在 Clipboard（剪贴板）。 切到 App（应用）之后，你不把内容粘贴进来，就没有任何东西离开这台 Mac。这个开关值得你知道它在那儿：macOS 把剪贴板访问权发给任何一个正在 运行的程序，完全不弹提示，所以系统里没有任何东西会告诉你这个应用已经 开始读取你的每一次复制 —— 正因为这样，应用在第一次启动时自己把话说明白， 并且把同一个开关以 Share what I copy 的名字放进菜单栏。
不工作的时候
“无法打开‘RealtimeClipboard’，因为无法验证开发者”
这是意料之中的，不代表下载坏了。这个构建既没有签名也没有做公证，因为两者 都需要一个付费的 Apple Developer 账号，而这个项目目前还没有。凡是没公证的 东西，Gatekeeper 第一次都会拒绝。
- 先试着打开一次，让它被拒绝掉。
- 打开系统设置 → 隐私与安全性，往下滚：现在会多出一行写着 RealtimeClipboard，后面跟着一个仍要打开按钮。
在 macOS 14 及更早的版本上，右键点应用再选打开，一步就能做完同样的 事。这个捷径在 macOS 15 里被去掉了，所以这里先写长的那条路。
两种做法都只为这一个应用记录一条例外 —— 这比把 Gatekeeper 整体调低要窄得 多，后者你不该做。只对你从 官方发布页 拿到的文件这么做；想更保险的话，把发布页上的 SHA256 和文件对一遍。
没有弹出任何权限请求
本来就没有可弹的。跟摄像头、麦克风或者屏幕不一样，macOS 上的剪贴板任何 正在运行的程序都能读，不用问谁。应用没办法给你看一个根本不存在的系统提示， 所以它在第一次启动时自己说清楚，就是那个提示的替代品。
内容能传到 Mac，却传不出去
那是 App/Clipboard 那个设置，不是 bug：接收永远是通的，发送才是你主动选的。
一直停在 “Connecting…”
应用先试 WebSocket，在升级被挡住的地方回退到 server-sent events 加 POST。 如果两条都连不上，那就是中继服务器的域名被整个封了 —— 在 Settings → Relay 里把应用指向你自己的一台。 自己跑一个只要一个容器。
卸载
从菜单栏退出它，再把它从“应用程序”拖到“废纸篓”，或者
brew uninstall --cask realtimeclipboard。
剪贴板内容从来不会写到磁盘上，所以事后没有什么可找、可删的。你的设置和 剪贴历史存在应用自己的浏览器存储里，跟着它一起走。