Live Wallpaper do Kwiq

Ativação

O Live Wallpaper do Kwiq pode ser ativado de duas formas:

1. Pelo seletor de wallpapers do Android: vá em Configurações > Papel de parede > Live Wallpapers e escolha "Kwiq Live Wallpaper".
2. Pelo hub de configuração do Kwiq: abra as Configurações do Kwiq, vá em "Wallpaper" e toque em "Ativar Live Wallpaper".

Ao ativar, você pode configurar cada slot individualmente, escolher imagens da galeria ou de provedores online, e ajustar as configurações de slideshow e overlay.

Os 4 Slots

O Kwiq possui 4 slots de wallpaper que se adaptam ao contexto do dispositivo:

O Kwiq seleciona automaticamente o slot correto baseado no tema (claro/escuro) e na orientação do dispositivo (retrato/paisagem).

Fallback inteligente: se um slot estiver vazio, o sistema tenta, nesta ordem:

1. Mesmo tema com orientação oposta
2. Tema oposto com mesma orientação
3. Tema oposto com orientação oposta

Isso garante que nunca haja um wallpaper em branco, mesmo que você só tenha configurado um único slot.

Slideshow

Cada slot pode conter múltiplas imagens que formam um slideshow em loop. As principais características:

• Tempo por imagem: cada wallpaper pode ter sua própria duração de exibição, de 5 segundos a 1 hora, configurada por wallpaper.
• Transição: crossfade suave de 220ms entre as imagens.
• Avanço manual: a qualquer momento, você pode avançar manualmente para a próxima imagem pelo atalho de wallpaper nas Quick Tools.
• Loop automático: o slideshow roda em loop infinito, reiniciando do início quando chega ao fim.

Provedores de Imagem

O Kwiq oferece 12 fontes para buscar wallpapers diretamente do app. Provedores focados em anime (Waifu.im e Safebooru, mais o Wallhaven com sua categoria Anime) ficam agrupados em um submenu "Anime" expansível para acesso rápido. Cada provedor tem suas próprias opções de filtro:

Provedores focados em anime (Waifu.im, Safebooru e um atalho do Wallhaven pré-configurado para a categoria Anime) ficam agrupados em um submenu Anime expansível no seletor de provedores para acesso rápido.

Chaves de API

Os provedores Unsplash, Pixabay e Pexels exigem que você crie uma conta e obtenha suas próprias chaves de API. Veja como obter cada uma:

Unsplash

1. Acesse https://unsplash.com/developers
2. Crie uma conta ou faça login no Unsplash.
3. Registre um aplicativo em "Your Apps" > "New Application".
4. Copie a chave "Access Key" gerada.
5. Cole nas Configurações do Kwiq > "Chaves de API" > "Unsplash".

Pixabay

1. Acesse https://pixabay.com/api/docs/
2. Crie uma conta ou faça login no Pixabay.
3. Copie sua chave de API em "API Key" na página de documentação.
4. Cole nas Configurações do Kwiq > "Chaves de API" > "Pixabay".

Pexels

1. Acesse https://www.pexels.com/api/
2. Crie uma conta ou faça login no Pexels.
3. Solicite uma chave de API gratuita.
4. Copie a chave fornecida.
5. Cole nas Configurações do Kwiq > "Chaves de API" > "Pexels".

O Wallhaven e o Waifu.im não requerem chave de API, mas oferecem filtros avançados como categoria, pureza (SFW/Sketchy/NSFW), ordenação e modo NSFW. Os demais provedores (Safebooru, Wikimedia Commons, Openverse, Picsum Photos, LoremFlickr) também são gratuitos e sem chave.

Indicador de Bateria Líquida

Transforme a tela de bloqueio do Live Wallpaper em um medidor de bateria sutil e elegante:

• Ativação: nas Configurações do Kwiq > Wallpaper > "Bateria Líquida".
• Tipo de preenchimento: opaco ou transparente.

Cores dinâmicas: a cor do líquido muda conforme o nível da bateria:

• Vermelho: ≤ 5%
• Laranja: ≤ 10%
• Amarelo: ≤ 20%
• Azul: enquanto carregando

• Efeito Caffeine: quando o Caffeine está ativo, ondas de "vapor" aparecem no líquido (cores disponíveis: Coffee, CoffeeMilk, Milk ou cor de destaque).
• Bolhas: aparecem quando o dispositivo está carregando.

Sistema de Presets

Presets permitem salvar e restaurar configurações completas de wallpaper: os 4 slots com imagens, configurações por wallpaper e preferências de recorte.

Estrutura de pastas:

Operações disponíveis:

1. Salvar preset: copia os wallpapers dos slots ativos para o diretório do preset.
2. Aplicar preset: copia os arquivos do preset para os slots ativos, preservando todas as configurações por wallpaper.
3. Salvar current para preset: mesma lógica do Salvar, mas marca o preset como ativo.
4. Renomear / Excluir: gerencia os presets existentes.
5. Exportar como ZIP: compacta todo o preset para compartilhar.
6. Importar de ZIP: restaura um preset a partir de um arquivo ZIP.
7. Compartilhar: envia o preset via Bluetooth, email, etc.

O preset ativo é rastreado automaticamente: ao aplicar um preset, ele se torna o "ativo". Você pode ver qual preset está ativo nas configurações de wallpaper.

Metadados dos Wallpapers

Cada wallpaper tem suas próprias configurações: posição na sequência, opacidade de sobreposição, duração de exibição, deslocamento panorâmico e nível de zoom — então cada imagem lembra sua configuração para o slideshow.

Wallpaper Estático

O Kwiq também oferece um seletor de wallpaper estático tradicional para quem prefere não usar o Live Wallpaper:

• Acesso: pelo hub de wallpaper do Kwiq (Configurações > Wallpaper > "Escolher Estático").
• Destinos: Tela inicial (Home), Tela de bloqueio (Lock) ou ambas.
• Ajustes: recorte, zoom e pan (arrastar) para posicionar a imagem perfeitamente antes de aplicar.
• Fontes: galeria do dispositivo ou qualquer provedor online configurado.

Backup e Restauração

As configurações de wallpaper são incluídas no sistema de backup do Kwiq:

• O que é salvo: presets de wallpaper e preferências da bateria líquida.
• O que NÃO é salvo: as imagens em si (elas já estão na pasta Kwiq/Wallpapers/ no armazenamento e ficam visíveis para o usuário).
• Formato: arquivo .kwiqbkp.
• Restauração: ao importar um backup, os presets e configurações são restaurados automaticamente.

Web Wallpaper

O Kwiq suporta web wallpapers — temas animados feitos com HTML, CSS e JavaScript, no estilo do Wallpaper Engine para desktop. Eles rodam em segundo plano usando uma WebView invisível e podem reagir a áudio, toque e configurações personalizadas.

Como importar

1. Empacote seus arquivos (index.html + assets) em um arquivo .zip.
2. No app, abra o painel de wallpapers e toque em "Importar Web Wallpaper (ZIP)".
3. Selecione o arquivo ZIP — o Kwiq extrai e registra automaticamente.
4. Atribua o web wallpaper a um slot nas configurações de wallpaper.

Você também pode importar via MCP (web_wallpaper_import) ou pelo Kwiq Dashboard (rota POST /api/web-wallpapers/import).

Propriedades customizadas

Web wallpapers podem expor controles que aparecem na interface do Kwiq como sliders, cores, botões e seletores. Basta registrar as propriedades via window.wallpaperRegisterProperties() no JavaScript e incluir a seção properties no project.json.

Reação a áudio (FFT)

O Kwiq captura o espectro de áudio do dispositivo (32 bins FFT) e disponibiliza para o web wallpaper via window.wallpaperRegisterAudioListener(). Use os dados para criar visualizações, ondas reativas, pulsos e qualquer efeito sincronizado com a música ou sons ao redor.

APIs JavaScript disponíveis

• window.wallpaperRegisterProperties(properties[]) — registra propriedades customizadas
• window.wallpaperPropertyListener — objeto para receber mudanças de propriedades
• window.wallpaperRegisterAudioListener(callback) — recebe array FFT 32 bins em tempo real
• window.wallpaperRegisterPauseListener(callback) — notifica quando o wallpaper entra/sai de pausa

Estrutura de arquivos

O wallpaper é armazenado em Kwiq/Wallpapers/{nome}/ com a seguinte estrutura:

Kwiq/Wallpapers/MeuWallpaper/
  index.html      (obrigatório)
  project.json    (manifesto Wallpaper Engine — opcional)
  web.json        (manifesto Kwiq — gerado automaticamente)
  assets/         (arquivos auxiliares — CSS, JS, imagens)

Gerenciamento

• Listar: painel de wallpapers, MCP (web_wallpaper_list) ou Dashboard
• Atribuir a slot: MCP (web_wallpaper_assign) ou Dashboard
• Remover: MCP (web_wallpaper_delete) ou Dashboard — remove de todos os slots e apaga os arquivos