clip-sync/README.md

clip-sync

Daemon de synchronisation bidirectionnelle du presse-papiers sur réseau local.

Copier sur une machine → coller sur une autre, automatiquement et instantanément.

┌──────────────┐         POST /clip          ┌──────────────┐
│  Machine A   │◄──────────────────────────►│  Machine B   │
│  (bureau)    │    {text, ts, origin}       │  (portable)  │
│  :9137       │                             │  :9137       │
└──────────────┘                             └──────────────┘

Fonctionnalités

• Bidirectionnel — copie A → B et B → A, chaque nœud est client et serveur
• Anti-boucle — double filtre (hash SHA-256 + timestamp/origine) empêche le ping-pong
• Multi-plateforme — Linux (X11/Wayland), Windows, macOS
• Binaire unique — zéro runtime externe, compilation Go native
• Configuration simple — fichier TOML + variables d'environnement
• LAN uniquement — aucune donnée ne quitte votre réseau local

Installation

Méthode 1 : Script automatique (tous OS)

curl -sSL https://git.dracodev.net/Projets/clip-sync/raw/branch/main/install.sh | bash

Le script détecte OS + architecture, télécharge le binaire, l'installe dans ~/.local/bin/ et crée une config par défaut.

---

Méthode 2 : Instructions détaillées par OS

🐧 Linux (X11 ou Wayland)

1. Installer les dépendances

Distribution	X11	Wayland
Debian / Ubuntu	sudo apt install xclip	sudo apt install wl-clipboard
Arch / Manjaro	sudo pacman -S xclip	sudo pacman -S wl-clipboard
Fedora / RHEL	sudo dnf install xclip	sudo dnf install wl-clipboard
Alpine	sudo apk add xclip	sudo apk add wl-clipboard

clip-sync détecte automatiquement X11 vs Wayland via $XDG_SESSION_TYPE.

2. Télécharger le binaire

# amd64
curl -sSL -o ~/.local/bin/clip-sync \
  https://git.dracodev.net/Projets/clip-sync/releases/download/latest/clip-sync-linux-amd64
chmod +x ~/.local/bin/clip-sync

# arm64 (Raspberry Pi, etc.)
curl -sSL -o ~/.local/bin/clip-sync \
  https://git.dracodev.net/Projets/clip-sync/releases/download/latest/clip-sync-linux-arm64
chmod +x ~/.local/bin/clip-sync

3. Vérifier le PATH

# Ajouter ~/.local/bin au PATH si ce n'est pas déjà fait
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

4. Vérifier l'installation

clip-sync --version
# → clip-sync v0.1.0

5. Installer comme service (systemd --user)

mkdir -p ~/.config/systemd/user/
curl -sSL -o ~/.config/systemd/user/clip-sync.service \
  https://git.dracodev.net/Projets/clip-sync/raw/branch/main/clip-sync.service
systemctl --user daemon-reload
systemctl --user enable --now clip-sync
systemctl --user status clip-sync

---

🍎 macOS

1. Aucune dépendance externe — pbpaste/pbcopy sont intégrés à macOS.

2. Télécharger le binaire

# Apple Silicon (M1/M2/M3)
curl -sSL -o ~/.local/bin/clip-sync \
  https://git.dracodev.net/Projets/clip-sync/releases/download/latest/clip-sync-darwin-arm64
chmod +x ~/.local/bin/clip-sync

# Intel Mac
curl -sSL -o ~/.local/bin/clip-sync \
  https://git.dracodev.net/Projets/clip-sync/releases/download/latest/clip-sync-darwin-amd64
chmod +x ~/.local/bin/clip-sync

3. Vérifier le PATH

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

4. Vérifier l'installation

clip-sync --version
# → clip-sync v0.1.0

5. Installer comme service (launchd)

cat > ~/Library/LaunchAgents/com.clip-sync.plist << 'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.clip-sync</string>
    <key>ProgramArguments</key>
    <array>
        <string>/Users/$(whoami)/.local/bin/clip-sync</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
    <key>StandardOutPath</key>
    <string>/Users/$(whoami)/Library/Logs/clip-sync.log</string>
    <key>StandardErrorPath</key>
    <string>/Users/$(whoami)/Library/Logs/clip-sync.err</string>
</dict>
</plist>
EOF

launchctl load ~/Library/LaunchAgents/com.clip-sync.plist
launchctl list | grep clip-sync

---

🪟 Windows

1. Aucune dépendance externe — clip-sync utilise l'API Win32 native (user32.dll, kernel32.dll) sans CGo ni runtime externe.

2. Télécharger le binaire

# amd64 (standard)
Invoke-WebRequest -Uri `
  "https://git.dracodev.net/Projets/clip-sync/releases/download/latest/clip-sync-windows-amd64.exe" `
  -OutFile "$env:USERPROFILE\bin\clip-sync.exe"

# arm64 (Surface Pro X, etc.)
Invoke-WebRequest -Uri `
  "https://git.dracodev.net/Projets/clip-sync/releases/download/latest/clip-sync-windows-arm64.exe" `
  -OutFile "$env:USERPROFILE\bin\clip-sync.exe"

3. Ajouter au PATH

# PowerShell (admin) — permanent
[Environment]::SetEnvironmentVariable(
  "Path",
  [Environment]::GetEnvironmentVariable("Path", "User") + ";$env:USERPROFILE\bin",
  "User"
)

4. Vérifier l'installation (redémarrer le terminal après l'étape 3)

clip-sync --version
# → clip-sync v0.1.0

5. Installer comme service Windows (NSSM)

Télécharger NSSM et l'extraire, puis :

nssm install clip-sync %USERPROFILE%\bin\clip-sync.exe
nssm set clip-sync AppStdout %USERPROFILE%\AppData\Local\clip-sync\stdout.log
nssm set clip-sync AppStderr %USERPROFILE%\AppData\Local\clip-sync\stderr.log
nssm set clip-sync AppStdoutCreationDisposition 4
nssm set clip-sync AppStderrCreationDisposition 4
nssm start clip-sync

6. Pare-feu Windows — la première exécution peut déclencher une alerte. Autoriser l'accès réseau privé.

---

Compilation depuis les sources

Prérequis : Go 1.21+

git clone https://git.dracodev.net/Projets/clip-sync.git
cd clip-sync
make build        # binaire dans ./bin/
make install      # copie vers ~/.local/bin/

Démarrage rapide

1. Créer la configuration

mkdir -p ~/.config/clip-sync

Machine A (bureau, 192.168.1.10) :

# ~/.config/clip-sync/peers.toml
[daemon]
port = 9137
poll_interval_ms = 500

[[peers]]
name = "portable"
addr = "192.168.1.20:9137"

Machine B (portable, 192.168.1.20) :

# ~/.config/clip-sync/peers.toml
[daemon]
port = 9137
poll_interval_ms = 500

[[peers]]
name = "bureau"
addr = "192.168.1.10:9137"

2. Lancer le daemon

clip-sync

3. Tester

Copiez du texte sur la machine A (Ctrl+C), collez sur la machine B (Ctrl+V). Ça marche !

Configuration

Fichier TOML

Clé	Défaut	Description
daemon.port	9137	Port d'écoute HTTP
daemon.poll_interval_ms	500	Intervalle de scrutation du presse-papiers (ms)
peers[].name	—	Nom descriptif du pair
peers[].addr	—	Adresse host:port du pair

Variables d'environnement (override)

Variable	Équivalent TOML
CLIP_SYNC_PORT	daemon.port
CLIP_SYNC_POLL_MS	daemon.poll_interval_ms

Déboguer

# Tester la connectivité entre pairs
curl -X POST http://192.168.1.20:9137/clip \
  -H 'Content-Type: application/json' \
  -d '{"text":"test","ts":0,"origin":"debug"}'

Licence

MIT © 2026