Hanabi é uma extensão desenvolvida para o ambiente de desktop GNOME, destinada a trazer vida ao seu ambiente de trabalho Linux através de papéis de parede animados e transições inteligentes de tema. Ela permite desde alternâncias automáticas baseadas no nascer e pôr do sol até a reprodução fluida de vídeos como plano de fundo, proporcionando uma experiência visual imersiva e personalizada.

Funcionalidades Principais

Esta ferramenta vai além de um simples aplicativo de papel de parede, integrando características que tornam o desktop GNOME mais inteligente e personalizável.

Alternância Inteligente de Temas

O Hanabi sincroniza automaticamente a aparência do desktop com o ciclo natural de luz. Você pode configurar horários específicos para nascer e pôr do sol, ou definir gatilhos personalizados, permtiindo transições suaves entre diferentes estilos visuais.

Suporte a Vídeos como Papel de Parede

É possível definir qualquer vídeo local como fundo da área de trabalho. A ferramenta suporta formatos comuns de vídeo, transformando cenas dinâmicas, animações ou coleções pessoais em um fundo único e interativo.

Execução de Comandos Personalizados

Durante as transições de tema, você pode associar a execução de comandos do sistema. Isso permite automações como iniciar um reprodutor de música ao amanhecer, ativar o modo noturno ao entardecer, ou acionar scripts personalizados para outras tarefas.

Início Rápido: Instalação e Configuração

1. Instalação

Para instalar o Hanabi, comece clonando o repositório do projeto:

git clone https://github.com/jeffshee/gnome-ext-hanabi

Em seguida, acesse o diretório do projeto e execute o script de instalação:

cd gnome-ext-hanabi
./run.sh

2. Configuração Básica

Após a instalação, acesse as configurações da extensão GNOME para ajustar parâmetros essenciais:

• Agendamento: Defina os horários de transição ou use a detecção automática do sol.
• Planos de Fundo: Selecione imagens estáticas ou arquivos de vídeo.
• Comandos: Vincule scripts ou programas às transições.
• Temas: Escolha os esquemas visuais para cada período.

3. Recursos Avançados

Para usuários que desejam maior controle, a extensão oferece:

• Efeitos Dinâmicos: Através do módulo src/roundedCornersEffect.js, é possível adicionar efeitos visuais como bordas arredondadas nas janelas.
• Gerenciamento de Mídia: O script src/wallpaper.js contém a lógica cantral para alternância e gerenciamento dos papéis de parede.
• Localização: Traduções para vários idiomas estão disponíveis no diretório src/po/.

Documentação e Personalização

O projeto inclui documentação detalhada para auxiliar na instalação e customização:

• Guias de Instalação: Instruções específicas para distribuições como Ubuntu 24.04 e Fedora 41 estão na pasta docs.
• Exemplos de Scripts: Um exemplo prático para alternar papéis de parede aleatoriamente está em docs/scripts/random-wallpaper.py.
• Extensibilidade: Para desenvolvedores, o arquivo src/extension.js serve como ponto de partida para entender a arquitetura principal.

Dicas de Uso

• Formato de Vídeo: Para melhor desempenho, utilize vídeos no formato MP4 com resolução moderada.
• Automatização: Use a funcionalidade de comandos para integrar com outras ferramentas, como ajustar o brilho do monitor automaticamente.
• Personalização Profunda: Parâmetros avançados do tema podem ser ajustados diretamente no esquema de configuração em src/schemas/io.github.jeffshee.hanabi-extension.gschema.xml.

Hanabi oferece uma maneira eficaz de revitalizar o desktop GNOME, tornando-o mais dinâmico e adaptável às necessidades do usuário.