O que é Cosmic-light?

Cosmic-light é um aplicativo inovador e de código aberto que recria a aclamada interface Dynamic Island, popularizada originalmente pelos dispositivos Apple, para o sistema operacional Windows. Ele funciona como um hub de controle centralizado e visualmente deslumbrante que fica elegantemente na sua tela, fornecendo acesso imediato a informações e controles críticos sem sobrecarregar a área de trabalho.

Esta ferramenta transforma o espaço passivo da área de trabalho em uma zona interativa, oferecendo animações fluidas baseadas em física e uma experiência de usuário suave como seda. Ele consolida utilitários essenciais—desde o gerenciamento de reprodução de mídia e atualizações meteorológicas em tempo real até notificações inteligentes de calendário e assistência de IA integrada—em um módulo coeso e personalizável. O Cosmic-light visa aprimorar a produtividade do usuário e a estética da área de trabalho simultaneamente, unindo design de ponta com funcionalidade prática.

Principais Recursos

O Cosmic-light vem repleto de recursos projetados para usuários de desktop modernos:

• 🏝️ Interface de Usuário Dynamic Island:
  • Flexibilidade de posicionamento: Coloque a ilha elegantemente na parte Inferior ou Central da sua tela.
  • Expansão inteligente: A ilha se expande fluidamente apenas quando necessário, mostrando Hora, Data e status da Janela Ativa na visualização Inicial.
  • Animações Avançadas: Utiliza framer-motion e liquid-glass-react para feedback visual de alta qualidade baseado em física.
• 🎵 Integração de Controle de Mídia:
  • Gerencia perfeitamente a reprodução (Reproduzir, Pausar, Próximo, Anterior, Volume) para aplicativos como Spotify e áudio do sistema.
  • Visualizador de Áudio em tempo real que reage dinamicamente à música.
  • Exibe metadados ricos, incluindo arte de álbum grande, informações do artista e progresso da faixa.
  • Detecção inteligente de ícones identifica o aplicativo de origem (Spotify, YouTube, Chrome) e o dispositivo de saída.
• 🌦️ Visualização do Tempo ao Vivo:
  • Exibição atmosférica com renderização de partículas em tempo real (chuva, neve, nuvens, estrelas).
  • Fornece estatísticas detalhadas: Temperatura, Velocidade do Vento, Umidade e chance de Precipitação.
  • Alertas instantâneos para avisos de tempo severo.
• 📅 Sincronização Inteligente de Calendário:
  • Integra-se ao Google Agenda através de um link iCal privado.
  • Notificações Proativas: A ilha se expande automaticamente 5 minutos antes do início de um evento.
  • Inclui uma Visualização Mensal completa e interativa.
• 🧠 Hub de Inteligência de IA:
  • Modo Gemini: Interface de chat integrada alimentada pela IA Gemini do Google, suportando renderização de Markdown, Blocos de Código e KaTeX para matemática.
  • Modo Perplexity: Integração de pesquisa na web em tempo real completa com citações e fontes.
  • Sensível ao Contexto: O histórico de conversas é armazenado localmente para continuidade.
• 🔒 Local Primeiro e Seguro: Todos os dados do usuário, incluindo chaves de API, são armazenados e criptografados localmente na máquina do usuário.
• ⚙️ Personalização Extensa: Controle a opacidade, defina o tempo de "Permanência" (atraso de autocollapse) e gerencie o posicionamento em configurações de múltiplos monitores.

Como Usar o Cosmic-light

Colocar o Cosmic-light para funcionar em sua máquina Windows envolve algumas etapas diretas, aproveitando Node.js e Python para as pontes de sistema necessárias:

1. Verificação de Pré-requisitos: Certifique-se de ter Node.js (v20 ou superior) e Python (v3.10 ou superior) instalados no seu sistema.
2. Instalação: Clone o repositório do GitHub e navegue até o diretório:

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

3.  **Configuração de Dependências:** Instale as dependências do frontend usando npm e as dependências do backend (necessárias para a ponte de dados do sistema) usando pip:
    ```bash
npm install
pip install -r requirements.txt

1. Executando Localmente: Inicie o servidor de desenvolvimento do aplicativo:

npm run dev

5.  **Configuração:** Uma vez em execução, clique no ícone da Dynamic Island para expandi-lo e, em seguida, acesse a Engrenagem de Configurações. Aqui, você deve inserir suas chaves de API pessoais (Gemini/Perplexity) e colar seu link iCal do Google Agenda para desbloquear o conjunto completo de recursos.
6.  **Compilação:** Para criar um instalador `.exe` autônomo e distribuível para Windows, execute `npm run build`. O instalador final estará disponível no diretório `release/`.

## Casos de Uso

O Cosmic-light é ideal para usuários que buscam maximizar a eficiência da área de trabalho e o apelo visual:

1.  **O Multitarefa/Desenvolvedor:** Verifique rapidamente os alertas do calendário sem perder o foco na codificação, gerencie a reprodução do Spotify instantaneamente e use o chat de IA integrado para pesquisas rápidas de contexto ou assistência de depuração, tudo a partir de um único elemento de interface de usuário não intrusivo.
2.  **O Entusiasta de Mídia:** Usuários que transmitem música ou vídeo com frequência se beneficiam do visualizador em tempo real e dos controles de mídia precisos, garantindo que nunca percam uma mudança de faixa ou precisem procurar o controle de volume.
3.  **O Profissional Orientado a Informação:** Profissionais que precisam de consciência constante das condições locais podem utilizar o módulo de clima ao vivo, garantindo que estejam preparados para mudanças climáticas repentinas sem abrir uma aba do navegador.
4.  **O Minimalista de Produtividade:** Indivíduos que buscam um ambiente de trabalho limpo podem consolidar vários widgets (relógio, clima, lembretes de calendário) na ilha compacta e de ocultação automática, mantendo o foco enquanto se mantêm informados.
5.  **O Defensor da Personalização:** Usuários que gostam de adaptar seu espaço de trabalho digital podem aproveitar o posicionamento, a tematização e o suporte a múltiplos monitores para integrar perfeitamente a ilha à sua configuração exclusiva.

## FAQ

**P: O Cosmic-light é compatível com macOS ou Linux?**
A: O Cosmic-light é desenvolvido especificamente como um centro de controle para o sistema operacional **Windows**, utilizando pontes Electron e Python adaptadas para a interação do sistema Windows.

**P: Preciso pagar pelos recursos de IA?**
A: O aplicativo Cosmic-light em si é de código aberto e gratuito. No entanto, a utilização dos modos de IA Gemini ou Perplexity exige que você forneça suas próprias chaves de API válidas do Google AI Studio ou Perplexity.ai, respectivamente, para as quais podem ser aplicadas taxas de uso com base na estrutura de preços do provedor.

**P: Quão seguros são meus dados, especialmente minhas chaves de API?**
A: O Cosmic-light prioriza a privacidade do usuário. Ele opera sob um princípio local primeiro, o que significa que todos os dados de configuração e chaves de API são armazenados e **criptografados** diretamente na sua máquina local, nunca transmitidos aos desenvolvedores.

**P: O que acontece se eu não instalar o Python?**

A: Python (v3.10+) é um pré-requisito obrigatório. O aplicativo depende de scripts Python para estabelecer as pontes de sistema necessárias para buscar dados em tempo real, como controles de mídia ativos e estatísticas meteorológicas detalhadas. Sem ele, a funcionalidade principal ficará indisponível.

**P: Posso mudar onde a Dynamic Island aparece na minha tela?**
A: Sim. Através das configurações no aplicativo (acessadas pelo ícone de engrenagem após expandir a ilha), você pode optar por posicionar a ilha na parte **Inferior** ou no **Centro** do seu monitor principal, ou selecionar um monitor específico se você usar uma configuração de múltiplos monitores.