Benvenuto nel centro di supporto di Calíope. Costruisco strumenti potenti e molto reattivi per la gestione dei database, con prestazioni native. Se hai un problema o una domanda, dai un'occhiata alle domande frequenti qui sotto o scrivimi direttamente.
✉️ Supporto diretto
La guida completa di Calíope — la stessa integrata nell'app — è pubblicata in Aiuto, con tutti gli argomenti e una ricerca. Vale la pena guardare lì prima di scrivere: la maggior parte delle domande ha già una risposta.
Le scorciatoie da tastiera sono pubblicate come scheda generata dal codice, per macOS e per iPad con tastiera esterna.
Hai un problema o hai bisogno di aiuto con il tuo acquisto? Scrivimi un'email e ti risponderò, normalmente entro 1-3 giorni lavorativi. Se hai un'idea per una nuova funzionalità, dai un'occhiata a Suggerisci una funzionalità più in basso.
Email: support@caliope.org- Il tuo sistema operativo e la versione (per esempio, macOS 26.1 Tahoe, iPadOS 26.1)
- La tua versione attuale di Calíope (visibile in Calíope → Informazioni su Calíope)
- Una descrizione breve del problema e i passaggi per riprodurlo
- I messaggi di errore mostrati e/o gli screenshot che illustrano il problema
💡 Suggerisci una funzionalità
Calíope cresce a partire da ciò che chiedono i suoi utenti. Se c'è qualcosa che vorresti vedere — un nuovo motore di database, un flusso di lavoro che ti farebbe risparmiare tempo, una lingua mancante, un'integrazione — dimmelo. Ogni richiesta viene registrata nella roadmap pubblica, e quelle che accumulano più segnale sono le prime che affronto.
- Inizia l'oggetto con Feature request: così arriva direttamente alla coda della roadmap.
- Descrivi il problema che stai cercando di risolvere, non solo la soluzione che hai in mente.
- Indica con quale frequenza la useresti e su quale dispositivo.
- Se hai visto la funzionalità in un altro strumento e ti è piaciuta l'implementazione, mettine il link.
📊 Diagnostica trasparente e segnalazione errori
In Calíope, la privacy è fondamentale. Non uso tracciamenti in background. Se accendi il rapporto d'uso, Calíope mantiene un registro JSON locale trasparente con i contatori delle aperture degli strumenti e il registro degli errori. È spento di serie, e non viene mai inviato nulla automaticamente. Condividere questo report è al 100% volontario e mi aiuta a correggere rapidamente i bug e a comprendere le priorità della comunità.
- Apri Calíope → Impostazioni / Preferenze dal menu principale.
- Apri Generale e scorri fino alla sezione Privacy e diagnostica.
- Attiva Tenere un rapporto d'uso su questo dispositivo. È spento di serie, quindi finché non lo fai il rapporto sarà vuoto — non è un guasto.
- Esamina l'anteprima JSON completa con le aperture degli strumenti e i log.
- Clicca su Condividi o copia il JSON da allegare alla tua email a support@caliope.org.
Domande frequenti
Come creo una nuova connessione al database?
Apri il Gestore delle connessioni dalla barra laterale o dalla barra dei menu principale, e fai clic sul pulsante +. Compila host, porta, utente e password del tuo server.
Le tue credenziali vengono salvate in modo sicuro nel Keychain nativo (framework Security di macOS) e non vengono mai trasmesse a server di terze parti né dello sviluppatore.
Come mi connetto tramite un tunnel SSH?
Nel gestore delle connessioni, attiva l'interruttore del Tunnel SSH. Inserisci host, porta e utente SSH.
Calíope supporta l'autenticazione tramite password e l'autenticazione tramite chiave (Ed25519 ed ECDSA P-256/384/521). L'implementazione usa SwiftNIO-SSH nativo — non servono client SSH esterni e le chiavi decifrate non vengono mai scritte su disco.
La mia connessione SSL fallisce. Cosa è cambiato?
Dal rafforzamento della sicurezza di luglio 2026, Calíope verifica di default il certificato TLS del server rispetto alle radici di fiducia del sistema. Se ti connetti a un server con certificato autofirmato e non fornisci una CA, la connessione fallirà.
Hai due opzioni:
- Consigliato: fornisci il file del certificato CA nella sezione SSL del profilo.
- Solo per lo sviluppo: spunta la casella «Accetta certificato non attendibile (non sicuro)». La connessione resterà cifrata, ma sarà vulnerabile agli attacchi man-in-the-middle (MITM).
L'app non riesce a connettersi al mio database. Cosa devo controllare?
Fai questa diagnosi rapida:
- Verifica che host, porta, utente e password siano corretti.
- Assicurati che il tuo server MariaDB/MySQL accetti connessioni remote dal tuo indirizzo IP (controlla l'opzione
bind-addressnel tuomy.cnf). - Se usi SSL, verifica i tuoi certificati e conferma che sia selezionata la modalità SSL corretta.
- Se sei dietro un firewall o una VPN, assicurati che la porta 3306 (o la tua porta personalizzata) sia completamente aperta.
- Isola il problema provando a connetterti dal terminale con il client a riga di comando
mysql -u [utente] -h [host] -p. - PostgreSQL: controlla
listen_addressesinpostgresql.confe che una riga dipg_hba.confautorizzi il tuo indirizzo IP; la porta predefinita è 5432; prova dal terminale conpsql -h [host] -U [utente] -d [database]. - MongoDB: la porta predefinita è 27017 e
bindIpinmongod.confdecide su quali indirizzi resta in ascolto; prova dal terminale conmongosh "mongodb://[utente]@[host]:27017".
Dove viene salvata la mia cronologia delle query?
La tua cronologia delle query viene salvata localmente sul tuo dispositivo, in un database SQLite privato. È strettamente offline di default e non viene mai caricata sul cloud. Puoi navigare, cercare, filtrare e cancellare in modo permanente i record di esecuzione dal pannello Cronologia all'interno dell'editor SQL.
Se attivi la sincronizzazione del log delle query con iCloud, il testo letterale delle query viaggia verso il tuo iCloud privato — Calíope mostra un avviso prima di abilitarla.
Come programmo backup automatici del database?
Vai al motore di Backup nella barra laterale. Seleziona i database e le tabelle che vuoi, definisci la pianificazione (giornaliera o settimanale) e scegli la cartella di destinazione locale. Le operazioni di backup vengono eseguite localmente usando un motore di streaming asincrono non bloccante.
Calíope sincronizza i dati tra i miei dispositivi?
Sì. Calíope offre la sincronizzazione opzionale con iCloud per profili di connessione, snippet e backup programmati, usando l'iCloud Key-Value Store e il database privato di CloudKit di Apple.
Per preservare la sicurezza, le password del database non vengono sincronizzate di default; le voci del Keychain restano sul dispositivo a meno che tu non attivi esplicitamente la sincronizzazione di iCloud Keychain. Puoi gestire la sincronizzazione con iCloud in Preferenze → iCloud.
Come cancello tutti i miei dati?
Apri Preferenze › Generali → Elimina tutti i miei dati. Un solo pulsante cancella ciò che Calíope conserva nei sei posti: su questo dispositivo (profili di connessione, cronologia delle query, registro degli errori, cronologia dell’Assistente IA, telemetria, cache degli schemi, file SQL recenti, frammenti e voci del monitor), nel Portachiavi (password, passphrase SSH e chiavi API), in iCloud Drive, nell’archivio chiave-valore di iCloud, nei record di CloudKit e nei dati del widget. Riguarda tutti i tuoi dispositivi, salva prima un punto di ripristino locale senza password e mostra cosa è stato eliminato in ogni posto. Conforme all'articolo 17 del GDPR.
Perché Calíope è a pagamento?
Perché voglio che Calíope sia guidato da chi lo usa, e questo funziona solo se dall'altra parte c'è qualcuno che ha il tempo di ascoltare. Calíope lo fa una sola persona: leggo e rispondo io a ogni email, e le richieste di funzioni entrano davvero nella lista di lavoro.
Il prezzo è anche ciò che mi permette di non fare altre cose. Calíope non ha pubblicità, non ha tracker, non include analitiche di terze parti e non vende i dati di nessuno. Il tuo rapporto d'uso è un file JSON locale che puoi leggere per intero e che viene condiviso solo se decidi di inviarlo. Mantenere questo modello costa, e preferisco che lo paghi tu piuttosto che un inserzionista.
Se ti manca qualcosa, chiedilo: è la via più diretta per influenzare ciò che viene costruito, e quello che è già in corso si vede nella roadmap pubblica.
E sì, una parte va in caffè. Lo considero infrastruttura critica.
Che fine fa la funzione che ho chiesto?
La leggo, ti rispondo e la annoto nella roadmap pubblica. Da lì pesano due cose: quante persone chiedono la stessa cosa e se si accorda con il modo in cui Calíope è costruito.
Non posso promettere che tutto ciò che viene chiesto venga realizzato — sarebbe una promessa impossibile da mantenere. Quello che prometto è che ogni richiesta viene letta e che, se scarto un'idea, ti dico perché. Scrivimi da Suggerisci una funzione.
Come uso l'assistente SQL con IA?
L'assistente contestuale con IA è opzionale ed è disabilitato di default. Per usarlo, vai in Preferenze → Assistente IA. L'assistente funziona senza alcuna chiave con Apple Intelligence (sul dispositivo) o Ollama (un modello sulla tua macchina). Se preferisci un fornitore cloud — OpenAI, Google Gemini o Anthropic Claude —, fornisci la tua API key, che viene conservata nel Portachiavi e inviata solo a quel fornitore.
All'API dell'IA vengono inviati solo i metadati del database (nomi di tabelle e colonne, chiavi esterne) più il prompt che scrivi. Il contenuto delle righe e le tue credenziali non vengono mai trasmessi.
Il mio acquisto è collegato al mio Apple ID?
Sì. Calíope è un acquisto unico gestito da StoreKit 2 e dall'App Store: è collegato al tuo Apple ID e sblocca ogni dispositivo che vi ha effettuato l'accesso. La prova di 60 giorni è un articolo a parte a prezzo zero, quindi ottenerlo non costa nulla e non chiede la carta, e i sessanta giorni li conta Calíope, dal giorno in cui la inizi. Nulla si rinnova e nulla viene addebitato alla fine, quindi non c'è niente da gestire o annullare. Si può iniziare una sola volta per Apple ID.
Come ripristino il mio acquisto dopo aver reinstallato?
Apri Calíope e tocca o fai clic su Ripristina acquisti nella vista del paywall. L'app interroga l'App Store per convalidare automaticamente il tuo acquisto.
L'app si chiude o si comporta in modo inaspettato. Cosa faccio?
Mi scuso per il disagio. Prova questi passaggi:
- Riavvia Calíope completamente.
- Verifica che il tuo sistema operativo e Calíope siano completamente aggiornati.
- Se il problema persiste, scrivimi a support@caliope.org. Se possibile, allega i log di diagnostica o i report di crash da Console.app (macOS) o Impostazioni → Privacy e sicurezza → Analisi e miglioramenti (iPhone e iPad).
💾 Database compatibili
- MariaDB 10.2.3+, 11.x
- MySQL 5.7.5+, 8.0, 8.4 LTS
- Amazon Aurora (MySQL e PostgreSQL)
- PostgreSQL 13+
- Microsoft SQL Server 2022+
- SQLite 3 e DuckDB 1.5.5 (file locali, senza server; integrati)
- MongoDB 6+
- Compatibile con deployment locali e sul cloud
💻 Requisiti di sistema
- macOS: macOS 26 Tahoe o superiore
- iPad: iPadOS 26 o superiore
- iPhone: iOS 26 o superiore
- Apple Watch: watchOS 26 o superiore
- Apple TV: tvOS 26 o superiore
- Apple Vision Pro: esegue l’app per iPad
- Connessione a internet attiva per server remoti o sul cloud
- Perché il requisito