Changelog

Toda mudança que um usuário do veil pode perceber é registrada aqui. O formato segue o Keep a Changelog (abre em uma nova aba), e o veil usa o versionamento semântico (abre em uma nova aba) a partir da 1.0. O que conta como interface do veil para o número da versão: a linha de comando (comandos, flags, valores, o que o --json imprime), os códigos de saída, o protocolo do socket de controle (docs/ipc.md), as chaves do arquivo de configuração (docs/configuration.md) e o arquivo de estado.

O veil 1.0.0-beta.1 é o primeiro lançamento, um beta. Tudo o que está abaixo faz parte dele. As limitações conhecidas e deixadas em aberto de propósito estão em docs/known-issues.md; as mais importantes são listadas ao fim da seção.

Não lançado (abre em uma nova aba)#

1.0.0-beta.1 (abre em uma nova aba) - 2026-10-20#

Adicionado#

• O veil é de código-fonte disponível sob a PolyForm Strict License 1.0.0 com permissões adicionais (ADDITIONAL-PERMISSIONS.md), de uso gratuito para fins não comerciais; não é código aberto. Os tarballs de lançamento e o pacote do Nix incluem LICENSE, ADDITIONAL-PERMISSIONS.md e THIRD-PARTY-NOTICES, as licenças dos crates Rust que o veil usa.
• veil daemon: um papel de parede em cada saída de um compositor Wayland com wlr-layer-shell (Hyprland, sway e outros compositores wlroots), também nas saídas conectadas depois, ou apenas nas saídas indicadas com --output. Uma saída que é desconectada recebe de volta o seu papel de parede quando retorna.
• Imagens nos formatos do crate image (PNG, JPEG, WebP, BMP, TIFF, GIF, ...), decodificadas uma única vez e compostas na resolução da saída; imagens com mais de 16384 pixels por lado, ou que precisariam de mais de 512 MiB, são recusadas antes de serem decodificadas.
• Papéis de parede em vídeo pelo GStreamer (waylandsink), sem áudio, em loop sem reconstruir o pipeline, decodificados por hardware quando o GStreamer tem um decodificador para a placa. O log informa o decodificador.
• Imagens e vídeos são distinguidos pelo conteúdo do arquivo. GIFs animados são reproduzidos como vídeos. Arquivos que não podem ser um papel de parede (um diretório, um arquivo vazio, HEIF, JPEG XL, algo desconhecido) são recusados com o motivo.
• Os modos de ajuste fill, fit, stretch, center e tile (--mode) e uma cor de fundo para as barras (--bg-color), para imagens e vídeos.
• Escalas HiDPI e fracionárias (wp_viewporter, wp_fractional_scale_v1): as imagens são desenhadas na resolução física da saída.
• Um novo papel de parede substitui o antigo apenas quando já tem algo para mostrar (para um vídeo, o seu primeiro quadro); um que falha deixa o antigo na tela.
• Um vídeo que falha durante a reprodução é reiniciado (no máximo quatro vezes seguidas) e depois abandonado, com uma única notificação de desktop. As notificações são limitadas em frequência.
• Pausa automática de um vídeo atrás de uma janela em tela cheia ou, com --pause-on covered, atrás de janelas que cobrem a saída inteira, lida do IPC do Hyprland ou do sway, por saída.
• Um vídeo que ninguém vê (uma tela bloqueada, um monitor desligado) é parado após dois segundos e iniciado de novo quando a saída volta a ser desenhada, em qualquer compositor (--release-unseen-after).
• Comandos para um daemon em execução: veil set, clear, pause, resume e toggle, para todas as saídas ou para uma (--output), status e outputs (ambos com --json), quit (alias stop) e ping, com códigos de saída estáveis.
• Um socket de controle em XDG_RUNTIME_DIR para outros programas (barras de status, scripts), um objeto JSON por linha, versionado e apenas para processos do mesmo usuário. Referência: docs/ipc.md.
• O papel de parede de cada saída é salvo ($XDG_STATE_HOME/veil/state.json) e exibido de novo após uma reinicialização; veil set --no-persist dispensa isso.
• Um arquivo de configuração, ~/.config/veil/config.toml: as opções do daemon e o papel de parede de cada saída, verificado com veil config check. Referência: docs/configuration.md, exemplo: contrib/config.example.toml.
• Uma unidade de usuário do systemd (contrib/systemd/veil.service): ativa quando todas as saídas exibem o seu papel de parede, reiniciada após uma falha grave com os papéis de parede que tinha, com um watchdog no loop de eventos.
• Um daemon por compositor; um segundo termina com código de saída 4.
• Autocompletar de shell para bash, zsh, fish e nushell (veil completions) e uma página de manual por comando.
• Um flake do Nix: o pacote (envolvido com os seus plugins do GStreamer e um registro do GStreamer próprio), nix run, um overlay e dev shells.
• Binários pré-compilados para Linux x86_64 e aarch64 em todo lançamento: um tarball com o binário, a unidade do systemd, as páginas de manual, o autocompletar de shell, os documentos e o install.sh (em /usr/local, ou --prefix ~/.local; --uninstall), com SHA256SUMS e uma atestação de proveniência de compilação por tarball. Eles usam o GStreamer do sistema e exigem a glibc 2.34 ou mais nova; rodam no Debian 12 e 13, no Ubuntu 22.04 e 24.04, no Fedora 44 e no Arch Linux.
• Documentação: um README com um guia rápido, os recursos e a sua situação, os números medidos e a instalação a partir do código-fonte no Arch, Debian, Ubuntu e Fedora; solução de problemas e uma tabela de compatibilidade, o que foi medido, problemas conhecidos.

Obsoleto#

• veil --daemon ..., a linha de comando do primeiro protótipo. Ela ainda inicia o daemon, com um aviso; use veil daemon ....

Problemas conhecidos#

• Um monitor que é alterado, conectado ou ligado enquanto um vídeo é reproduzido derruba o daemon, dentro do waylandsink do GStreamer (problema conhecido 1). Sob a unidade do systemd, ele volta em segundos com os seus papéis de parede.
• Na NVIDIA, todo quadro de vídeo é convertido para RGB na CPU: cerca de 18 % de um núcleo para 1080p a 30 fps (problema conhecido 7).
• Sem MALLOC_ARENA_MAX=1, que o pacote do Nix e a unidade do systemd definem, a memória cresce a cada troca de vídeo (problema conhecido 3).
• Com o binário pré-compilado em um GStreamer anterior à 1.26 (Debian 12, Ubuntu 22.04 e 24.04), GIFs animados ficam parados ou não iniciam, por causa do demuxer de GIF do GStreamer (no Debian 12 ele também mantém um núcleo de CPU ocupado); convertidos para vídeo, eles são reproduzidos. No Ubuntu 24.04, vídeos 1080p mostraram apenas parte dos seus quadros em um sway headless (problema conhecido 8).
• Tudo até agora foi verificado em um sway headless com uma placa NVIDIA; as verificações em uma sessão real do Hyprland e em placas Intel e AMD ainda estão por fazer.