Icona dell'app Calíope

Calíope

Client nativo di MariaDB e MySQL per macOS e iPadOS

macOS 14+ iPadOS 17+ Abbonamento di $49.99/anno

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

Hai un problema o hai bisogno di aiuto con il tuo abbonamento? 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
Cosa includere per un'assistenza più rapida:
  • Il tuo sistema operativo e la versione (per esempio, macOS 15.2 Sequoia, iPadOS 18.3)
  • 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.

Consigli per una richiesta utile:
  • 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.

Domande frequenti

🔑 Connessioni e rete
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-address nel tuo my.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.
💾 Archiviazione e backup
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 il mio Mac e l'iPad?

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 → Privacy → Cancella 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.

💳 Abbonamenti, IA e risoluzione dei problemi
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 o Google Gemini.

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 abbonamento è collegato al mio Apple ID?

Sì. Calíope si monetizza con un abbonamento annuale gestito da StoreKit 2 e dall'App Store di Apple. Include una prova gratuita di 7 giorni. Il tuo abbonamento è collegato direttamente al tuo Apple ID, il che ti permette di usare Calíope su qualsiasi tuo dispositivo macOS e iPadOS che abbia effettuato l'accesso con quell'Apple ID.

Per gestire, rivedere o annullare il tuo abbonamento, apri l'app App Store → tocca l'icona del tuo account → Abbonamenti.

Come ripristino il mio abbonamento 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 diritto attivo.

L'app si chiude o si comporta in modo inaspettato. Cosa faccio?

Ci scusiamo per il disagio. Prova questi passaggi:

  1. Riavvia Calíope completamente.
  2. Verifica che il tuo sistema operativo e Calíope siano completamente aggiornati.
  3. 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 14 Sonoma o superiore
  • iPad: iPadOS 17 o superiore
  • Connessione a internet attiva per server remoti o sul cloud