Cos'è Cosmic-light?

Cosmic-light è un'applicazione innovativa e open-source che ricrea l'acclamatissima interfaccia Dynamic Island, originariamente resa popolare dai dispositivi Apple, per il sistema operativo Windows. Funziona come un hub di controllo centralizzato e visivamente sbalorditivo che si posiziona elegantemente sullo schermo, fornendo accesso immediato a informazioni e controlli critici senza ingombrare il desktop.

Questo strumento trasforma lo spazio desktop passivo in una zona interattiva, offrendo animazioni fluide basate sulla fisica e un'esperienza utente fluida come il liquido. Consolida utility essenziali—dalla gestione della riproduzione multimediale e aggiornamenti meteo in tempo reale alle notifiche del calendario intelligenti e all'assistenza AI integrata—in un unico modulo coeso e personalizzabile. Cosmic-light mira a migliorare contemporaneamente la produttività dell'utente e l'estetica del desktop fondendo design di alto livello con funzionalità pratiche.

Caratteristiche Principali

Cosmic-light è ricco di funzionalità progettate per gli utenti desktop moderni:

• 🏝️ UI Dynamic Island:
  • Flessibilità di posizionamento: Posiziona l'isola elegantemente in Basso o al Centro del tuo schermo.
  • Espansione Intelligente: L'isola si espande fluidamente solo quando necessario, mostrando Ora, Data e stato della Finestra Attiva nella vista Home.
  • Animazioni Avanzate: Utilizza framer-motion e liquid-glass-react per un feedback visivo di alta qualità basato sulla fisica.
• 🎵 Integrazione Controllo Media:
  • Gestisce senza interruzioni la riproduzione (Play, Pausa, Avanti, Indietro, Volume) per applicazioni come Spotify e l'audio di sistema.
  • Visualizzatore Audio in tempo reale che reagisce dinamicamente alla musica.
  • Visualizza metadati ricchi, inclusi enormi copertine degli album, informazioni sull'artista e stato di avanzamento del brano.
  • Rilevamento intelligente delle icone identifica l'applicazione sorgente (Spotify, YouTube, Chrome) e il dispositivo di output.
• 🌦️ Visualizzazione Meteo in Diretta:
  • Display atmosferico con rendering di particelle in tempo reale (pioggia, neve, nuvole, stelle).
  • Fornisce statistiche dettagliate: Temperatura, Velocità del vento, Umidità e Probabilità di precipitazioni.
  • Avvisi istantanei per allerte meteo severe.
• 📅 Sincronizzazione Calendario Intelligente:
  • Si integra con Google Calendar tramite un link iCal privato.
  • Notifiche Proattive: L'isola si espande automaticamente 5 minuti prima dell'inizio di un evento.
  • Include una vista Mese completa e interattiva.
• 🧠 Hub di Intelligenza AI:
  • Modalità Gemini: Interfaccia di chat integrata basata sull'AI Gemini di Google, che supporta Markdown, blocchi di codice e rendering matematico KaTeX.
  • Modalità Perplexity: Integrazione di ricerca web in tempo reale completa di citazioni e fonti.
  • Consapevole del Contesto: La cronologia delle conversazioni viene salvata localmente per la continuità.
• 🔒 Locale Prima di Tutto e Sicuro: Tutti i dati utente, incluse le chiavi API, vengono archiviati e crittografati localmente sulla macchina dell'utente.
• ⚙️ Ampia Personalizzazione: Controlla l'opacità, imposta il tempo di "Stayback" (ritardo di collasso automatico) e gestisci il posizionamento su configurazioni multi-monitor.

Come Usare Cosmic-light

Avviare Cosmic-light sulla tua macchina Windows comporta alcuni semplici passaggi, sfruttando Node.js e Python per i bridge di sistema necessari:

1. Verifica Prerequisiti: Assicurati di avere installato Node.js (v20 o superiore) e Python (v3.10 o superiore) sul tuo sistema.
2. Installazione: Clona il repository da GitHub e naviga nella directory:

git clone https://github.com/uspraveen/Cosmic-light.git cd Cosmic-light

3.  **Configurazione Dipendenze:** Installa le dipendenze frontend usando npm e le dipendenze backend (necessarie per il bridging dei dati di sistema) usando pip:
    ```bash
npm install
pip install -r requirements.txt

1. Esecuzione in Locale: Avvia il server di sviluppo dell'applicazione:

npm run dev

5.  **Configurazione:** Una volta avviato, fai clic sull'icona della Dynamic Island per espanderla, quindi accedi all'Ingranaggio delle Impostazioni. Qui devi inserire le tue chiavi API personali (Gemini/Perplexity) e incollare il link iCal di Google Calendar per sbloccare tutte le funzionalità.
6.  **Compilazione:** Per creare un installer `.exe` autonomo e distribuibile per Windows, esegui `npm run build`. L'installer finale sarà disponibile nella directory `release/`.

## Casi d'Uso

Cosmic-light è ideale per gli utenti che cercano di massimizzare l'efficienza del desktop e l'attrattiva visiva:

1.  **Il Multitasker/Sviluppatore:** Controlla rapidamente gli avvisi del calendario senza perdere il focus sulla codifica, gestisci istantaneamente la riproduzione di Spotify e utilizza la chat AI integrata per ricerche rapide di contesto o assistenza nel debugging, tutto da un unico elemento UI non invasivo.
2.  **L'Appassionato di Media:** Gli utenti che trasmettono frequentemente musica o video beneficiano del visualizzatore in tempo reale e dei controlli multimediali precisi, assicurandosi di non perdere mai un cambio di brano o di dover cercare il cursore del volume.
3.  **Il Professionista Orientato alle Informazioni:** I professionisti che necessitano di una consapevolezza costante delle condizioni locali possono utilizzare il modulo meteo in diretta, assicurandosi di essere preparati a improvvisi cambiamenti meteorologici senza aprire una scheda del browser.
4.  **Il Minimalista della Produttività:** Le persone che mirano a un ambiente desktop pulito possono consolidare più widget (orologio, meteo, promemoria calendario) nella compatta Dynamic Island a scomparsa automatica, mantenendo la concentrazione pur rimanendo informati.
5.  **L'Appassionato di Personalizzazione:** Gli utenti che amano personalizzare il proprio spazio di lavoro digitale possono sfruttare il posizionamento, il tema e il supporto multi-monitor per integrare perfettamente l'isola nella loro configurazione unica.

## FAQ

**D: Cosmic-light è compatibile con macOS o Linux?**
A: Cosmic-light è sviluppato specificamente come centro di controllo per il sistema operativo **Windows**, utilizzando ponti Electron e Python adattati per l'interazione con il sistema Windows.

**D: Devo pagare per le funzionalità AI?**
A: L'applicazione Cosmic-light è open-source e gratuita. Tuttavia, l'utilizzo delle modalità AI Gemini o Perplexity richiede che tu fornisca le tue chiavi API valide da Google AI Studio o Perplexity.ai, rispettivamente, per le quali potrebbero essere applicate tariffe di utilizzo in base alla struttura dei prezzi del fornitore.

**D: Quanto sono sicuri i miei dati, specialmente le mie chiavi API?**
A: Cosmic-light dà priorità alla privacy dell'utente. Opera su un principio "locale prima di tutto", il che significa che tutti i dati di configurazione e le chiavi API vengono archiviati e **crittografati** direttamente sulla tua macchina locale, senza mai essere trasmessi agli sviluppatori.

**D: Cosa succede se non installo Python?**

A: Python (v3.10+) è un prerequisito obbligatorio. L'applicazione si basa su script Python per stabilire i bridge di sistema necessari per recuperare dati in tempo reale come i controlli multimediali attivi e le statistiche meteorologiche dettagliate. Senza di esso, le funzionalità principali non saranno disponibili.

**D: Posso cambiare dove appare la Dynamic Island sul mio schermo?**
A: Sì. Tramite le impostazioni nell'app (accessibili tramite l'icona a forma di ingranaggio dopo aver espanso l'isola), puoi scegliere di posizionare l'isola in **Basso** o al **Centro** del tuo display principale, oppure selezionare un monitor specifico se utilizzi una configurazione multi-monitor.