Benvenuto nel centro di supporto di Calíope. Costruiamo 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 contattaci 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? Scrivici un'email e ti risponderemo, 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 — diccelo. Ogni richiesta viene registrata nella roadmap pubblica, e quelle che accumulano più segnale sono le prime che affrontiamo.
- 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 piattaforma (macOS, iPad o entrambe).
- 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 usiamo 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 ci 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.
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, settimanale, personalizzata) 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 ripulisce profili di connessione, voci del Keychain, log delle query, snippet, impostazioni e cache del widget. Conforme all'articolo 17 del GDPR.
Perché Calíope è a pagamento?
Perché vogliamo 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. Siamo una squadra piccola: le email le leggiamo e le risposte le scriviamo noi, e le richieste di funzioni entrano davvero nella lista di lavoro.
Il prezzo è anche ciò che ci 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 preferiamo 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 consideriamo infrastruttura critica.
Che fine fa la funzione che ho chiesto?
La leggiamo, ti rispondiamo e la annotiamo 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 possiamo promettere che tutto ciò che viene chiesto venga realizzato — sarebbe una promessa impossibile da mantenere. Quello che promettiamo è che ogni richiesta viene letta e che, se scartiamo un'idea, ti diciamo perché. Scrivici 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 e fornisci la tua API key personale di OpenAI, Google Gemini o Anthropic Claude.
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?
Ci scusiamo 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, scrivici 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 (iPadOS).
💾 Database compatibili
- MariaDB 10.2.3+, 11.x
- MySQL 5.7.5+, 8.0, 8.4 LTS
- 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
- Connessione a internet attiva per server remoti o sul cloud
- Calíope 1.2 resta disponibile e supportata su macOS 15 Sequoia e iPadOS 18 — l'App Store la installa automaticamente su quei sistemi; perché il requisito.