title: CLIPIK

CLIPIK - сервис для реализации общего буфера обмена по локальной сети

Быстрый старт

Тут должен быть установлен PATH=${HOME}/.local/bin:${PATH}

uv tool install clipik
clipik

или

git clone https://gitflic.ru/project/kurilka/clipik
cd clipik
uv pip install -e .
clipik

Использование

При передаче опций, они перезаписывают данные с конфига и переменных окружения.

$ clipik --help
usage: clipik [-h] [--config PATH] [--graphic-protocol {x11,wayland}] [--port PORT] [--size-limit BYTES]
              [--handshake-timeout SECONDS] [--log-level LEVEL]

Synchronize clipboard by network

options:
  -h, --help            show this help message and exit
  --config PATH         Force choice config file
  --graphic-protocol {x11,wayland}
                        force choice graphic protocol, elsewhere set from env WAYLAND_DISPLAY
  --port PORT           WebSocket TCP-port
  --size-limit BYTES    Max size WS-messages and stdout from wayland/x11 clipboard
  --handshake-timeout SECONDS
                        Timeout for wait to websocket handshake
  --log-level LEVEL     Logging level, default [INFO]

Конфигурация

По-умолчанию конфигурация находиться по пути ~/.config/clipik/config.json, если его не существует, при запуске clipik он создается автоматически, но не все параметры там будут прописаны.

Конфиг будет иметь вид:

{
  "port": 8765,
  "size_limit": 67108864,
  "log_level": "INFO",
  "handshake_timeout": 7
}

Со всеми параметрами такой:

{
  "graphic_protocol": "wayland",
  "port": 8765,
  "size_limit": 67108864,
  "log_level": "INFO",
  "handshake_timeout": 7,
  "allowed_ips": [
      "192.164.0.1/24",
      "100.0.0.1",
      "100.0.0.2"
  ]
}

Graphic Protocol (параметр `graphic_protocol`)

Если его не указывать в конфигурации, он будет определен исходя переданной опции в cli, либо из наличия переменной окружения WAYLAND_DISPLAY

Переменные окружения

Имеются только переменные окружения, за счет которых можно менять свойства:

CLIPIK_LOG_LEVEL=INFO - Уровель логирования: INFO, DEBUG, ERROR, CRITICAL …
WAYLAND_DISPLAY - Если оно установлено, будет использовать wayland clipboard
CLIPIK_PORT=8765 - На каком порту поднять websocket (передача буфера)
CLIPIK_HANDSHAKE_TIMEOUT=7 - Сколько ждать HANDSHAKE при подключении
CLIPIK_SIZE_LIMIT=67108864 - Макс. размер передаваемых данных

Обязательные утилиты (зависимости)

Linux

X11 (xorg)

xclip
clipnotify

Wayland

wl-paste
wl-copy

MacOs (пока не поддерживается)

Windows (пока не поддерживается)

TODO [2/7]

Возможность регестрировать сервисы для подключения к удаленным сетями
Регистрацию при подключении (ввод pin-кода/разрешенные хосты в конфиге)
Поддержка всех типов данных, в том числе при копировании из файловых менеджеров
Поддержка MacOS
Поддержка Windows
Фоновая загрузка больших файлов с ожиданием вставки (до конца загрузки)
Поддержка передачи данных не только через переменные окружения, но и через опции и конфиги

Release files for clipik 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for clipik 0.4.0
File	Size	Uploaded
clipik-0.4.0.tar.gz	10.4 kB	Sep 13, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for clipik 0.4.0
File	Interpreter	ABI	Platform	Reset
clipik-0.4.0-py3-none-any.whl 15.2 kB Sep 13, 2026	Python 3	none	any	Details

Total release size: 25.6 kB

Release files / clipik-0.4.0.tar.gz

Download URL	clipik-0.4.0.tar.gz
Size	10.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`9c147a349a6e25b0dc5a3e6b411ed9621e6a0c613dd318dac265f697676389cc`
BLAKE2b-256 checksum How to use checksums	`4d12d9f20b013a1f99487daae7b4af1c93a1055f404d3ecc6df0bdcccf83fdf5`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Arch Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Release files / clipik-0.4.0-py3-none-any.whl

Download URL	clipik-0.4.0-py3-none-any.whl
Size	15.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`8fe0efea592ebfdb802a507fa4ea9ba4de6112224563fb9e52636a06ba6ebc4b`
BLAKE2b-256 checksum How to use checksums	`f990f6b31cbfb74f431e7fcf5248b0e3e7a95d01afa8e1b978969e3431c0c41f`
Upload date	Sep 13, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Arch Linux","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`