Condividere clipboard tra Windows, iPhone e Android

1. Collega i dispositivi alla stessa rete

Per la prima prova, collega PC e telefono allo stesso Wi-Fi o LAN fidata. Il telefono deve poter raggiungere il PC o il server. Alcune reti ospiti impediscono ai dispositivi di comunicare tra loro.

Fuori casa o su Wi-Fi non fidate consigliamo Tailscale. Collega dispositivi e host clipboard alla stessa rete privata Tailscale, poi usa l'indirizzo Tailscale dell'host nelle app e in entrambi i comandi Apple. Funziona anche con Windows in modalità server. Tailscale è facoltativa: puoi usare un'altra VPN privata. Consulta la guida alla rete per configurazione, precauzioni firewall e subnet routing opzionale.

Non esporlo su Internet. Non aprire la porta 5088 del router verso Internet. Account e token sono opzionali; HTTP non cifra contenuti o credenziali, che restano leggibili negli URL degli account.

2. Usa Windows come server

Mantieni Windows aggiornato: dalla 2.0.18 apri Impostazioni > Aggiornamenti per controllare GitHub e installare una nuova versione stabile. Il controllo automatico è attivo; l'installazione automatica è facoltativa e disattivata inizialmente. Salva per abilitarla. Per i client precedenti serve prima un aggiornamento manuale; Windows può ancora richiedere un'autorizzazione. Guida agli aggiornamenti.

Scarica l'installer Windows adatto al processore. Per PC Intel/AMD scegli x64; per Windows 11 su Snapdragon scegli ARM64. Puoi anche usare l'EXE portable.
Avvia Clipboard Bridge e cerca l'icona della clipboard accanto all'orologio, eventualmente sotto la freccia delle icone nascoste.
Clic destro sull'icona, poi Impostazioni > Generale. Seleziona Modalità server, lascia la porta 5088 e salva.
Usa l'indirizzo Server mostrato nel menu dell'icona. Cliccandolo puoi copiarlo. Quando richiesto, consenti l'app nel firewall Windows sulla tua rete privata fidata.
Tieni PC e programma accesi. Inserisci lo stesso indirizzo su Android o nei due Comandi Rapidi iPhone descritti sotto.

Un esempio è http://192.168.1.50:5088: sostituiscilo con quello mostrato dal tuo PC. Sul telefono non usare 127.0.0.1 o localhost, che indicano il telefono stesso.

La modalità server Windows non ha una pagina web. Usa la cronologia dell'app Windows e i client mobili. La pagina browser appartiene al server autonomo facoltativo.

Cronologia dell'app Windows con elementi di esempio e anteprima PDF — La cronologia Windows. La schermata contiene dati dimostrativi, non clipboard private.

Clic sinistro sull'icona per aprire la cronologia. La combinazione predefinita è Ctrl+Alt+H; premila di nuovo per chiuderla. Puoi modificarla in Impostazioni > Scorciatoie.

3. Collega iPhone o iPad

Bastano due Comandi Rapidi: uno invia l'elemento corrente, l'altro riceve il più recente. Si eseguono quando li avvii: non esiste una sincronizzazione continua in background su iPhone.

Dall'iPhone scarica e apri iPhone Load Clipboard e iPhone Download Clipboard. Aggiungili all'app Comandi Rapidi di Apple.
Modifica Load Clipboard: in Ottieni contenuti dell'URL sostituisci l'intero URL di esempio con l'indirizzo del tuo host seguito da /clipboard. Mantieni POST.
Modifica Download Clipboard: inserisci lo stesso host seguito da /clipboard/latest/raw. Mantieni GET.
Per la clipboard generale non protetta su rete fidata, lascia vuoti token e account. Se l'amministratore li ha impostati, segui le istruzioni sugli account in entrambi i comandi.

Invio:     POST http://TUO_HOST:5088/clipboard
Ricezione: GET  http://TUO_HOST:5088/clipboard/latest/raw

Fai la prima prova

Copia Ciao da Windows sul PC e usa Invia clipboard dal menu dell'app. Esegui Download Clipboard su iPhone, poi incolla in una nota vuota. Per il percorso opposto, copia un messaggio su iPhone, esegui Load Clipboard e usa Ricevi ultimo su Windows prima di incollarlo.

Aggiungili al Centro di Controllo

Schermata Apple: Centro di Controllo in modifica, con Aggiungi un controllo in basso — **1. Aggiungi un controllo**Apri il Centro di Controllo e tocca il pulsante +.

Schermata Apple: galleria dei controlli in cui cercare Comando rapido — **2. Cerca Comando rapido**Nella galleria, aggiungi il controllo Comando rapido.

3. Tocca Scegli. Seleziona Load Clipboard per inviare. Aggiungi un secondo controllo e seleziona Download Clipboard per ricevere. Istruzioni Apple per i Comandi Rapidi.

Esempi ufficiali iOS 26, © Apple, caricati dal sito Apple. Non mostrano Clipboard Bridge configurato; l'aspetto cambia secondo la versione iOS. Clipboard Bridge è un progetto indipendente.

Menu Condividi, schermata Home e altri consigli utili

Invia senza copiare prima: Nei dettagli del comando di invio, attiva Mostra in Condivisione. Seleziona una foto, un file o un link in un'altra app e usa Condividi > Load Clipboard. Il comando deve usare l'input ricevuto quando presente: segui la guida per input e gruppi di file. Guida Apple per Condividi.
Preferisci un'icona sulla schermata Home?: Apri i dettagli del comando e scegli Aggiungi alla schermata Home. Ripeti per Ricevi. Guida Apple per la schermata Home.
Il comando non compare?: Importalo e configuralo prima. Nel Centro di Controllo cerca Comando rapido, non un controllo separato dell'app Clipboard Bridge. In Condividi scorri verso il basso; se manca, verifica l'opzione Mostra in Condivisione e i tipi di input accettati.
Fai una prova prima dell'uso quotidiano: Tieni l'host acceso e usa la stessa rete fidata o una VPN privata. Invia un breve messaggio e ricevilo sull'altro dispositivo. Se iOS lo chiede, consenti l'accesso alla rete locale.

Per il menu Condividi, i nomi originali e più file insieme, segui la variante avanzata dei Comandi Rapidi. I file firmati della release non sono cambiati: non presumere che includano già la nuova variante multi-file. Questa invia uno ZIP temporaneo a /clipboard/bundle e può estrarre il gruppo ricevuto leggendo prima /clipboard/latest/meta.

Su Mac puoi creare lo stesso flusso manuale in Comandi Rapidi. Non c'è un client Mac nativo: consulta la guida Mac.

4. Collega Android

Installa l'APK Android firmato. Richiede Android 10 o successivo ed è una beta pubblica.
Apri le impostazioni dell'app, inserisci l'indirizzo del PC o del server Docker e salva. Lascia vuote le credenziali facoltative, salvo che siano state configurate sul server.
Copia un messaggio di esempio, apri l'app e premi Invia clipboard. Ricevilo da Windows.
Invia un altro messaggio da Windows e premi Ricevi ultimo su Android. Incolla il risultato in una nota.

Da altre app puoi inviare foto e documenti con Condividi > Clipboard Bridge. Più file selezionati insieme rimangono nello stesso elemento. La cronologia è quella del server e dell'account selezionato, non una lista solo locale.

Sono disponibili comandi nella tendina Android, notifiche e opzioni di ricezione. Android limita la lettura della clipboard in background: non aspettarti che ogni copia in un'altra app venga rilevata a programma non visibile. Parti da invio e ricezione manuali, poi abilita le opzioni automatiche necessarie.

Dettagli nella guida Android.

5. Testo, immagini e file

Testo: quello formattato arriva come testo Unicode normale, conservando emoji, accenti e righe, senza font o colori.
Documenti originali: PDF, file RTF e altri file mantengono i byte originali. Un documento non viene convertito solo perché contiene testo.
File Windows: copiali in Esplora file e usa Invia clipboard, oppure Invia un file. I ricevuti vengono salvati in Downloads\Clipboard Bridge e copiati nella clipboard Windows.
Gruppi: più file inviati in una volta diventano un solo elemento. Windows e Android possono ripristinarli insieme. Il browser riceve uno ZIP; per estrarlo su Apple serve la variante multi-file del comando.
Ordine: vince l'elemento più recente. Un vecchio file non nasconde un messaggio nuovo.

Nella cronologia Windows seleziona un elemento e abilita Anteprima per leggere tutto il testo con scorrimento, vedere immagini o la prima pagina dei PDF. Leggere l'anteprima non modifica la clipboard. Usa Copia per ripristinarlo. Le impostazioni permettono di scegliere hotkey, notifiche e sincronizzazione opzionale.

Attiva l'invio automatico consapevolmente. Può trasmettere anche contenuti sensibili che copi. Il programma deve essere attivo; una versione eseguita come utente normale può non rilevare copie da app avviate come amministratore. Vale sia per installer sia per portable.

Facoltativo: server Docker o NAS sempre acceso

La pagina del server e l'accesso sono disponibili in inglese, italiano, spagnolo, francese, tedesco, portoghese e cinese semplificato. Scegli la lingua nell'intestazione e apri Collega i tuoi dispositivi per istruzioni, indirizzo del server e link alla guida. Il browser ricorda la scelta; le app native mantengono le proprie impostazioni di lingua.

Ti permette di usare la clipboard anche a PC spento, avere la pagina web e separare gli account. Il server rimane tuo: non è un servizio cloud obbligatorio.

Per i cataloghi personalizzati consulta la guida App Store. ZimaOS usa la sorgente JSON permanente. Non si tratta di un'approvazione negli store ufficiali.

Con Docker e Compose già installati, salva questo file come compose.yaml in una cartella di progetto vuota:

services:
  clipboard-bridge:
    image: ghcr.io/mattboxx/clipboard-bridge-server:1.0.11
    restart: unless-stopped
    ports:
      - "5088:5088"
    environment:
      CLIPBOARD_DATA_DIR: /data
    volumes:
      - ./data:/data

Esegui docker compose up -d nella cartella e verifica con docker compose ps. Apri http://TUO_HOST:5088/ da un dispositivo della rete fidata.

Su Windows seleziona Modalità client e inserisci l'indirizzo del server nelle impostazioni. Usa lo stesso host su Android e nei due Comandi Rapidi. L'endpoint /health mostra la versione del server autonomo.

Aggiornamento senza perdere i dati

Fai una copia dei dati e del Compose. Cambia il tag dell'immagine mantenendo variabili, account e volume montato su /data. Se c'è un vecchio digest @sha256, devi cambiarlo o rimuoverlo insieme al vecchio tag.

docker compose pull
docker compose up -d
docker compose ps

Non cancellare la cartella dati e non usare docker compose down -v per aggiornare. Consulta la guida Docker completa per account, backup e configurazioni aggiuntive.

Facoltativo: account separati

Il server autonomo può isolare le cronologie. La modalità server Windows non ha account distinti. La clipboard generale resta disponibile anche aggiungendo nuovi utenti.

L'amministratore configura CLIPBOARD_ACCOUNTS o il file account descritto nella guida. Windows e Android usano nome e password dell'account nelle impostazioni. La password della pagina web non è necessariamente la stessa dell'account.

Su Apple aggiungi le stesse credenziali, codificate per URL, a entrambi gli indirizzi. Questi sono segnaposto, non credenziali reali:

http://TUO_HOST:5088/clipboard?user=alice&password=TUA_PASSWORD
http://TUO_HOST:5088/clipboard/latest/raw?user=alice&password=TUA_PASSWORD

Se l'URL contiene già un parametro come ?filename=..., aggiungi l'account con & anziché ?. Codifica i caratteri riservati nei valori, non l'intero URL. Per la clipboard generale protetta usa invece il token configurato. Dettagli nella guida agli account.

Le credenziali restano leggibili negli URL e HTTP non cifra i dati. Non includerle in screenshot, post o log condivisi. Usa rete fidata o VPN privata; la VPN non cifra necessariamente ogni tratto della LAN.

Prova il trasferimento Windows e iPhone

Copia Ciao da Windows sul PC e scegli Invia clipboard.
Avvia Download Clipboard su iPhone e incolla in una nota vuota.
Per il percorso opposto, copia un testo su iPhone e avvia Load Clipboard.
Scegli Ricevi ultimo su Windows e incolla in un documento.

Sono istruzioni da provare sui tuoi dispositivi, non un test registrato sul telefono. Puoi usare la modalità server Windows senza un server separato.

Un host Docker/NAS facoltativo può sostituire Windows e mantenere la clipboard disponibile a PC spento. Android si collega allo stesso host scelto. I dispositivi devono raggiungerlo tramite LAN fidata o VPN privata.

Verifica tecnica: registrazione web del server autonomo facoltativo

La registrazione usa il server autonomo 1.0.8, in un'istanza locale temporanea con soli dati di esempio. Mostra testo Unicode, un'immagine, un gruppo di due file e un nuovo testo che diventa l'ultimo elemento.

Interfaccia web reale, con didascalie aggiunte alla registrazione e azioni browser automatizzate. Testo e byte dei file sono stati verificati da un client HTTP indipendente. Non è una prova su iPhone/Android fisici o della clipboard tra dispositivi.

Scarica il video MP4

Leggi la descrizione della demo

Salva un testo con emoji, accento e link.
Leggi lo stesso testo tramite un client HTTP separato.
Carica l'icona SVG pubblica del progetto come immagine.
Invia insieme note e checklist: appare un elemento con due file.
Scarica lo ZIP e verifica che i file originali non siano cambiati.
Salva un testo più recente: diventa l'ultimo elemento, mantenendo i precedenti in cronologia.

Se qualcosa non funziona

Condivido un link Reddit ma ricevo HTML anziché l'indirizzo

Il flusso di invio potrebbe aver scaricato la pagina, oppure l'app di origine potrebbe aver fornito HTML. In Load Clipboard, inserisci il link in un'azione Testo; per una pagina Safari estrai prima la proprietà URL. Invia quel testo al tuo host Clipboard Bridge con POST > Corpo della richiesta: JSON > text (Testo), non File con l'URL originale. L'indirizzo della richiesta deve essere quello del tuo host, non Reddit. I rami di foto e file restano invariati. Segui la procedura dettagliata. La modifica va applicata sul dispositivo Apple: i file firmati scaricabili non sono stati cambiati.

Il telefono non raggiunge l'host

Verifica host acceso, rete fidata comune e indirizzo corretto, non localhost. Controlla firewall su rete privata, isolamento Wi-Fi e rotte VPN. La modalità server Windows non ha una pagina browser: la sua assenza non indica da sola un errore.

Vedo una cronologia diversa da quella attesa

Controlla indirizzo e account su ogni client. Senza username accedi alla clipboard generale; gli account nominativi hanno cronologie separate. Usa lo stesso account anche in entrambi gli URL Apple.

Un file non si incolla in un'altra app

Non tutte le app accettano file dalla clipboard. Aprilo da Downloads o usa il selettore file/Condividi dell'app destinataria. Il browser riceve i gruppi come ZIP; Apple richiede la variante di estrazione per ripristinarne i membri.

Windows mostra un avviso sul download

I pacchetti Windows non sono ancora firmati digitalmente. Non disabilitare le protezioni. Leggi CODE_SIGNING.md e le note della release.

Quali prove sono state completate?

Sono passati i test automatici Python/Android, le verifiche dei pacchetti Windows x64/ARM64 e l'aggiornamento Docker con persistenza. La demo web è registrata e i trasferimenti HTTP sono verificati. Restano da fare prove fisiche sui telefoni, installazione dalla GUI NAS e routing VPN reale.

Segnala problemi riproducibili nelle Issue GitHub con versioni, modalità host e passaggi. Non allegare password, URL con token, clipboard private o log non ripuliti.