# clip-sync

[![Go Version](https://img.shields.io/badge/Go-1.21+-00ADD8?logo=go)](https://go.dev)
[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Tests](https://img.shields.io/badge/tests-100%25-brightgreen)](.)

**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 rapide

### Via install.sh (recommandé)

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

Le script détecte automatiquement votre OS et architecture.

### Compilation manuelle

```bash
git clone https://git.dracodev.net/Projets/clip-sync.git
cd clip-sync
make build        # binaire dans ./bin/
```

### Prérequis par plateforme

| Plateforme | Dépendance        | Installation                              |
|-----------|-------------------|-------------------------------------------|
| Linux X11 | `xclip`           | `apt install xclip` / `pacman -S xclip`   |
| Linux Wayland | `wl-clipboard` | `apt install wl-clipboard`               |
| macOS     | intégré (pbpaste/pbcopy) | —                                |
| Windows   | intégré (Win32 API, pas de dépendance externe) | — |

## Démarrage rapide

### 1. Créer la configuration

```bash
mkdir -p ~/.config/clip-sync
```

**Machine A** (bureau, 192.168.1.10) :

```toml
# ~/.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) :

```toml
# ~/.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

```bash
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` |

## Exécution en tant que service

### Linux (systemd --user)

```bash
mkdir -p ~/.config/systemd/user/
cp clip-sync.service ~/.config/systemd/user/
systemctl --user daemon-reload
systemctl --user enable --now clip-sync
```

### Windows (NSSM)

```powershell
nssm install clip-sync C:\Users\<user>\bin\clip-sync.exe
nssm set clip-sync AppStdout C:\Users\<user>\AppData\Local\clip-sync\stdout.log
nssm set clip-sync AppStderr C:\Users\<user>\AppData\Local\clip-sync\stderr.log
nssm start clip-sync
```

## Déboguer

```bash
# 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