Установка RealtimeClipboard

RealtimeClipboard работает в браузере на каждом вашем устройстве, и ради этого ставить ничего не нужно. Установка даёт ровно одну вещь, и только на части платформ: приложение замечает, что вы скопировали, пока вы работали в другом окне.

Начните отсюда: нужно ли вообще что-то устанавливать?

Скорее всего нет. Откройте приложение на двух устройствах, введите на каждом один и тот же короткий ключ — и у них общий буфер обмена. Всё, что ниже, посвящено одной функции — фоновому захвату — и тому, справляется ли с ней ваша платформа.

ПлатформаЧто ставитьФоновый захват
Windows 10 / 11Настольное приложениеДа
macOS 11+Настольное приложениеДа
Linux, X11Настольное приложениеДа
Linux, WaylandНастольное приложениеKDE и wlroots да; GNOME нет
Android / ChromeOSДобавить на главный экранНет — запрещает Android
iPhone / iPadДобавить на главный экранНет — запрещает iOS
Серверы, SSHnpx realtimeclipboardНе применимо — работает через конвейер
Всё остальноеНичего — откройте в браузереНет

Ниже у каждой платформы есть короткая справка, а ещё отдельное полное руководство — как выглядит рабочая установка, как передать первый фрагмент и что именно этому мешает.

  • Установка в Windows

    .msi, что должны показывать значок в области уведомлений и строка состояния, и три вещи, которые всё ломают: SmartScreen, закрытый рабочий компьютер и собственная синхронизация буфера обмена в Windows — это другая функция.

  • Установка в macOS

    Одна универсальная загрузка для Intel и Apple Silicon, что скажет Gatekeeper в первый раз и почему здесь нечего разрешать: доступа к буферу обмена система не спрашивает — именно поэтому приложение говорит об этом само.

  • Установка в Linux

    .deb, .rpm и AppImage, нижняя граница webkit2gtk 4.1 и вся матрица Wayland в одной таблице: X11 да, KDE и wlroots да, GNOME нет, и починить это нечем.

  • Android и ChromeOS

    Два касания в Chrome, никакой страницы в магазине и правило Android 10, из-за которого нативное приложение теряет смысл. Как на самом деле выглядит отправка, когда фоновый захват исключён.

  • iPhone и iPad

    Меню «Поделиться» в Safari — это весь механизм: Chrome на iOS так не умеет, и никакого предложения установить не появится. Плюс что за баннер о вставке и почему ни одно приложение не может его выключить.

  • Командная строка

    Конвейер в send, перенаправление из watch и все четыре команды целиком. То же шифрование, что и в браузере, на любой машине с Node 22.

  • Свой ретранслятор

    Один контейнер и никакой базы данных. Как его проверить, как поставить перед ним TLS — и ловушка с числом реплик, которая проявляется как фрагменты, молча не доходящие до устройства.

Что на самом деле значит «фоновый захват»

В браузере RealtimeClipboard может читать ваш буфер обмена, только пока его окно в фокусе. Это не ограничение приложения — это правило, которое каждый браузер применяет к каждому сайту, потому что страница, способная незаметно читать буфер обмена, собрала бы все пароли, которые вы копируете. Поэтому браузерная версия работает так: вы что-то копируете, переключаетесь на RealtimeClipboard, и он забирает это в момент получения фокуса.

Нативное настольное приложение этим правилом не связано. Приложение для Windows, macOS и Linux следит за системным буфером обмена непрерывно, так что копирование в любой программе отправляется сразу, без переключений.

А значит, настольное приложение читает каждое ваше копирование, пока запущено, — включая пароли, скопированные совсем по другому поводу. Всё шифруется до того, как покинет вашу машину, и никогда не пишется на диск, но согласиться на это придётся всерьёз. Приложение говорит об этом в памятке при первом запуске, и переключатель стоит прямо в диалоге: Приложение значит, что ничего не уходит с машины, пока вы сами не вставите это внутрь; он же есть в меню значка в области уведомлений как Делиться тем, что я копирую, чтобы приостановить отправку перед копированием пароля, не открывая окно.

Windows

Скачайте .msi со страницы загрузок. Фоновый захват работает без оговорок и без запроса разрешений — Windows это платформа, на которой настольное приложение полезнее всего.

Приложению не нужны права администратора, оно не ставит ни драйвер, ни службу. Исходящие соединения идут только по 443 и только к одному имени хоста — ровно такую форму ИТ-отделы вносят в список разрешённых. Если SmartScreen предупреждает, сначала проверьте, что файл взят со страницы официальных релизов, и только потом продолжайте.

Полное руководство: установка в Windows

macOS

Один .dmg покрывает и Intel, и Apple Silicon — сборка универсальная, второй загрузки искать не нужно.

macOS не требует особого разрешения на чтение буфера обмена, поэтому и выдавать нечего. Это работает в обе стороны: операционная система никак не сообщит вам, что приложение начало читать каждое ваше копирование, — потому это приложение говорит об этом само, в памятке при первом запуске, с переключателем Приложение в диалоге.

Полное руководство: установка в macOS

Linux

.deb, .rpm или AppImage со страницы релизов. Пакета во Flathub, Snap или AUR нет, и здесь нет команды, которая делала бы вид, что он есть. Приложению нужен webkit2gtk 4.1 — это примерно Ubuntu 22.04 или Fedora 36 и новее; на чём-то более старом используйте браузер или клиент командной строки.

Оговорка про Wayland, прямым текстом. В X11 приложению сообщают об изменении буфера обмена, и фоновый захват работает. В Wayland всё зависит от композитора: KDE и те, что построены на wlroots, дают для этого протокол, а GNOME нет — в GNOME Wayland ни одно приложение не может следить за буфером обмена. Приложение это определяет и пишет в строке состояния, а не молча бездействует, и переходит на захват по фокусу, ровно как браузер.

Полное руководство: установка в Linux

Android и ChromeOS

Приложения для Android нет и не будет. Начиная с Android 10 читать буфер обмена разрешено только приложению, которым вы пользуетесь прямо сейчас, активной клавиатуре или службе специальных возможностей. Приложение RealtimeClipboard свелось бы к кнопке в меню «Поделиться» и значку — всё остальное, что оно могло бы делать, установленное веб-приложение уже делает.

  1. Откройте приложение в Chrome.
  2. Нажмите на меню, затем Добавить на главный экран.

После этого у него свой значок и своё окно, и работает оно офлайн. Чтобы что-то отправить, вставьте это в приложение или воспользуйтесь меню «Поделиться» в Android.

Полное руководство: Android и ChromeOS

iPhone и iPad

Ответ тот же и по той же причине: iOS никогда не разрешала читать буфер обмена в фоне, а с iOS 16 показывает баннер каждый раз, когда его читает вообще любое приложение.

  1. Откройте приложение в Safari. Chrome и Firefox на iOS устанавливать веб-приложения не умеют.
  2. Нажмите Поделиться, затем На экран «Домой».

Собственного предложения установить iOS не показывает, так что, если вы ждёте его появления, оно не появится. Меню «Поделиться» — это весь механизм.

Полное руководство: iPhone и iPad

Серверы, сессии SSH и скрипты

npx realtimeclipboard D75LV

Для машин без буфера обмена и без экрана. Клиент читает стандартный ввод и пишет в стандартный вывод, поэтому собирается со всем остальным:

echo "deploy key" | npx realtimeclipboard send D75LV
npx realtimeclipboard watch D75LV --once > token.txt

Нужен Node 22 или новее. Это не отдельная реализация — клиент подключает те же файлы шифрования и транспорта, которые выполняет браузер, так что фрагмент, отправленный с сервера, неотличим от отправленного с ноутбука.

Полное руководство: командная строка

Свой ретранслятор

Ретранслятор передаёт зашифрованные фрагменты между вашими устройствами. Прочитать их он не может — ему видны только хеш комнаты и шифротекст, — но если вы предпочитаете не принимать это на веру, поднимите его сами:

docker run -p 8000:8000 ghcr.io/akshaynikhare/realtimeclipboard-relay

Затем укажите его приложению в разделе Настройки → Ретранслятор. В каталоге deploy лежат docker-compose.yml с автоматическим TLS и чарт Helm. Оставьте одну реплику, если только вы не дали ему Redis.

Полное руководство: свой ретранслятор

Готовы ставить: страница загрузок. Здесь что-то неверно или устарело? Откройте issue.