v3.1.0 — Visualização 3D interativa e melhorias de tradução

Novidades

• Visualização 3D interativa do passador na aba Botões, com rotação livre, zoom, controles por teclado e restauração da vista.
• Clique diretamente no modelo para selecionar um dos 11 controles e ler sua explicação. A seleção respeita peças ocultas e diferencia clique de arraste.
• Identificação separada do laser físico (botão laranja) e dos efeitos digitais (botão com símbolo de mouse).
• Modelo incluído no aplicativo, com carregamento offline e imagem estática de apoio quando o OpenGL não está disponível. Nenhuma nova dependência Python.

Correções

• Textos de gravação, tradução, avisos GNOME e novos arquivos de transcrição acompanham o idioma português/inglês da interface.
• A confirmação de desinstalação usa a palavra exibida no idioma selecionado: DESINSTALAR ou UNINSTALL.
• A desinstalação desabilita e remove a extensão GNOME do Baseus e seus backups, preservando outras extensões e recusando caminhos inseguros.

Compatibilidade

Os efeitos visuais no GNOME 46 em Wayland continuam experimentais. A visualização 3D foi testada em X11 e Wayland; isso não amplia a compatibilidade do backend de overlays com outros compositores ou versões do GNOME.

Validação

• 335 testes automatizados aprovados, incluindo instalação/atualização, traduções, desinstalação e visualizador 3D.
• Seleção dos 11 controles conferida na janela real em X11 e Wayland, incluindo oclusão e atualização das descrições.

v3.0.2 — Correções na instalação e atualização

Correções

• Corrigida a instalação e a atualização após a remoção da documentação interna.
• Removidas referências a arquivos de documentação que não acompanham mais o aplicativo.
• Atualizado o README em português e inglês com orientações sobre o suporte experimental ao GNOME 46 em Wayland.
• Atualizadas as traduções do aviso de indisponibilidade do overlay Wayland.

Compatibilidade

O suporte a efeitos visuais no GNOME 46 em Wayland continua experimental. O funcionamento em X11 foi preservado.

Validação

312 testes automatizados aprovados.

v3.0.1 — Repository Cleanup & Maintenance

🧹 Baseus Presenter v3.0.1 — Limpeza e manutenção

Esta é uma atualização de manutenção da versão 3.0.0, voltada à organização do repositório e à separação entre código-fonte, documentação pública e anotações internas de desenvolvimento.

🔧 Alterações

• Remoção da pasta docs/ do código-fonte distribuído.
• Remoção do arquivo status.md, utilizado para registros internos de desenvolvimento.
• Atualização do .gitignore para evitar que esses arquivos sejam incluídos novamente.
• Preparação do repositório para centralizar a documentação pública na GitHub Wiki.

✅ Compatibilidade

Esta atualização não introduz novas funcionalidades nem altera intencionalmente o comportamento do aplicativo.

Todas as funcionalidades da versão 3.0.0 foram preservadas, incluindo a nova interface gráfica, o suporte experimental ao GNOME Wayland e as melhorias de estabilidade.

As limitações conhecidas da versão 3.0.0 continuam aplicáveis.

Para conhecer as principais novidades, consulte as notas da versão 3.0.0.

---

🇺🇸 English

Baseus Presenter v3.0.1 — Repository Cleanup & Maintenance

This is a maintenance update focused on repository organization and separating application source code from internal development notes.

🔧 Changes

• Removed the docs/ directory from the distributed source tree.
• Removed status.md, previously used for internal development tracking.
• Updated .gitignore to prevent these files from being accidentally included again.
• Prepared the repository to centralize public documentation in the GitHub Wiki.

✅ Compatibility

This release introduces no new features or intentional changes to application behavior.

All v3.0.0 functionality remains unchanged, including the redesigned interface, experimental GNOME Wayland support, and stability improvements.

Known limitations from v3.0.0 still apply.

See the v3.0.0 release notes for the full list of major improvements.

Baseus Presenter v3.0.0 — Nova interface e suporte ao GNOME Wayland

🚀 Baseus Presenter v3.0.0 — Nova interface e suporte ao GNOME Wayland

A versão 3.0.0 marca uma nova etapa no desenvolvimento do Baseus Presenter para Linux!

Esta atualização traz uma interface reorganizada, uma nova arquitetura de renderização, suporte experimental ao GNOME Wayland e melhorias importantes na instalação, atualização e estabilidade do aplicativo.

O objetivo continua o mesmo: oferecer aos usuários Linux uma alternativa livre e completa para utilizar os recursos do apresentador Baseus Orange Dot AI.

✨ Principais novidades

🖥️ Suporte ao GNOME Wayland

Uma das maiores novidades desta versão é a implementação de um novo sistema de sobreposição visual para o GNOME Wayland.

Devido às restrições de acesso global à tela e ao cursor impostas pelo Wayland, foi desenvolvida uma extensão própria para o GNOME Shell, responsável por renderizar os efeitos diretamente no ambiente gráfico.

O novo sistema permite utilizar:

• 🔴 Laser virtual: indicador visual que acompanha o ponteiro.
• 🔍 Lupa: ampliação de uma região da tela.
• 🔦 Spotlight: destaque de uma área, escurecendo o restante da tela.
• ✏️ Pincel: desenho livre sobre a tela.
• ⬛ Tela preta: escurecimento completo do monitor.
• 💬 Legendas: exibição de textos sobre a área de trabalho.

A comunicação entre o aplicativo Python e a extensão GNOME acontece por D-Bus, permitindo controlar os efeitos sem depender de janelas tradicionais do Qt.

O suporte existente ao X11 foi preservado, com melhorias no gerenciamento do cursor.

Compatibilidade: a integração Wayland foi desenvolvida e testada para o GNOME 46. Outros ambientes Wayland, como KDE Plasma e compositores wlroots, ainda não são suportados por essa implementação.

🎨 Interface gráfica renovada

A interface passou por uma reorganização significativa, tanto visual quanto estrutural.

• Novo layout para as configurações.
• Melhor organização dos controles e funcionalidades.
• Separação dos componentes de interface em módulos independentes.
• Novos recursos visuais e ícones.
• Manutenção da interface em português e inglês.

Essa reorganização também facilita futuras melhorias e a manutenção do código.

🛠️ Instalação e atualização aprimoradas

O processo de instalação recebeu melhorias para lidar com as diferentes necessidades dos ambientes Linux.

• Verificação de requisitos do sistema.
• Preparação automática da extensão GNOME no ambiente compatível.
• Preservação de backups durante a atualização dos arquivos da extensão.
• Melhorias nos processos de atualização e desinstalação.
• Tratamento de falhas para evitar que problemas nos efeitos visuais impeçam o uso das funções de navegação.

No GNOME Wayland, uma instalação ou atualização da extensão pode exigir sair e entrar novamente na sessão para carregar os novos arquivos.

🔧 Melhorias de estabilidade

Diversos componentes internos foram revisados, com foco na confiabilidade e na recuperação de falhas.

Entre as mudanças estão:

• Melhor gerenciamento dos efeitos e do cursor.
• Limpeza de elementos visuais ao encerrar o aplicativo ou perder a comunicação com a extensão.
• Melhorias na renderização sobre apresentações em tela cheia.
• Ajustes na estrutura dos módulos de áudio, interface e atualização.
• Ampliação dos testes automatizados e ferramentas de diagnóstico.

O sistema de overlays também conta com mecanismos de expiração de sessão para remover os efeitos quando o aplicativo deixa de responder.

⚠️ Limitações conhecidas

O suporte ao GNOME Wayland ainda possui algumas limitações:

• No GNOME 46, o cursor original pode apresentar uma breve cintilação durante o movimento com determinados efeitos ativos.
• A integração com a extensão GNOME é específica para ambientes compatíveis e não fornece suporte universal a todos os compositores Wayland.
• Configurações com escalas diferentes entre monitores e mudanças de monitores durante a execução ainda exigem validação adicional.

Essas limitações estão sendo acompanhadas para futuras atualizações.

📦 Instalação

Para novas instalações, consulte as instruções no README do projeto.

Para quem já utiliza uma versão anterior, recomenda-se seguir o procedimento de atualização documentado no repositório.

Importante: ao atualizar para a versão 3.0.0 em uma sessão GNOME Wayland, pode ser necessário encerrar a sessão e entrar novamente para carregar a extensão.

🧪 Testes e desenvolvimento

Esta versão inclui novos testes automatizados para os sistemas de overlay, integração com GNOME, gerenciamento do cursor, interface, instalação e atualização.

As mudanças foram desenvolvidas com o objetivo de preservar as funcionalidades existentes e ampliar a compatibilidade do programa com ambientes Linux modernos.

❤️ Projeto open source

O Baseus Presenter é um projeto independente, gratuito e de código aberto, desenvolvido para ampliar o suporte ao apresentador Baseus Orange Dot AI no Linux.

Sugestões, relatórios de bugs e contribuições são bem-vindos!

⭐ Se o projeto foi útil para você, considere deixar uma estrela no repositório.

Repositório: https://github.com/Gpiovesana/baseus-presenter-linux

---

🇺🇸 English

🚀Baseus Presenter v3.0.0 — Redesigned Interface and GNOME Wayland Support

Version 3.0.0 marks a major step forward for Baseus Presenter on Linux!

This release introduces a redesigned interface, a new rendering architecture, experimental GNOME Wayland support, and important improvements to installation, updates, and stability.

✨ What's new

GNOME Wayland integration

A dedicated GNOME Shell extension now handles visual overlays directly within the desktop environment, using D-Bus to communicate with the Python application.

Supported effects include the virtual laser pointer, magnifier, spotlight, drawing tool, black screen, and on-screen subtitles.

The existing X11 backend remains available.

Redesigned interface

The settings interface has been reorganized with a more modular layout, improved visual components, new resources, and continued support for Portuguese and English.

Improved installation and updates

The application now includes system requirement checks, automatic GNOME extension preparation on compatible environments, safer extension file updates, and improvements to update and uninstall workflows.

Stability improvements

This release introduces improved cursor and overlay lifecycle handling, visual cleanup when the application disconnects, better fullscreen rendering, and expanded automated testing.

⚠️ Known limitations

• GNOME Wayland support currently targets GNOME 46.
• The native cursor may briefly flicker while moving with certain effects enabled.
• KDE Plasma and other Wayland compositors are not yet supported by the GNOME extension.
• Mixed display scaling and monitor hotplug scenarios require further testing.

📦 Installation

See the project README for installation and update instructions.

On GNOME Wayland, logging out and back in may be required after installing or updating the Shell extension.

❤️ Open source

Baseus Presenter is a free, independent, open-source project for the Baseus Orange Dot AI wireless presenter on Linux.

Bug reports, suggestions, and contributions are welcome!

⭐ If you find the project useful, consider starring the repository.

v2.1.0 - Translate interface

v2.1.0 — Interface traduzida e idioma por modelo de voz

Agora o Baseus Presenter conta com interface em português e inglês, detecção automática do idioma do sistema e seleção manual nas configurações.

Novidades

• Seleção do idioma falado ao cadastrar um modelo Vosk, com nomes e códigos.
• Botão “Idioma do modelo” para alterar essa informação.
• Tradução da fala baseada no modelo selecionado, independente do idioma da interface.
• Mensagens de instalação, atualização e desinstalação em português e inglês.

Correções

• Atualização do catálogo do Argos antes de listar os destinos de tradução.
• Filtragem dos destinos conforme o idioma do modelo.
• Bloqueio de downloads para pares indisponíveis.

Para quem já usa: os modelos cadastrados serão preservados, e o aplicativo pedirá a definição do idioma quando necessário.

v2.0.3 - Progresso visível na atualização e desinstalação

Melhorias

• A atualização agora mostra uma janela com a etapa de preparação, evitando a impressão de que nada está acontecendo.

• Cliques repetidos são bloqueados enquanto a operação está em andamento.

• A desinstalação mostra o progresso em uma janela independente, com as etapas e o resultado também no terminal.

• A confirmação de desinstalação aceita DESINSTALAR, desinstalar ou qualquer mistura de maiúsculas e minúsculas.

• Documentação atualizada em português e inglês.

Validação

• 223 testes automatizados passaram.

• Observação: quem estiver em uma versão anterior verá a nova janela de progresso de atualização nas próximas atualizações, após instalar esta versão.

v2.0.2 — Escolha de inicialização automática

Novidades

• O instalador agora pergunta se o Baseus Presenter deve iniciar automaticamente ao entrar no sistema. Aceita y/Y e n/N.
• A janela de atualização permite ativar ou desativar a inicialização automática, mostrando a configuração atual.
• A escolha só é aplicada após a nova versão iniciar com sucesso. Cancelamentos ou falhas preservam a configuração anterior.
• Instalações automatizadas podem usar --autostart ou --no-autostart.
• Documentação atualizada em português e inglês.

Validação

221 testes automatizados passaram, incluindo testes da escolha de autostart e da recuperação em caso de falha. A validação utilizou áudio simulado.

Para quem está atualizando de uma versão anterior: a nova opção na janela de atualização estará disponível nas próximas atualizações, após instalar esta versão.

v2.0.1 — Correção multimonitor e desinstalação segura

• Corrigido o acompanhamento do overlay entre monitores no X11.
• Corrigida a continuidade da caneta ao atravessar monitores.
• Ajustada a seleção do monitor ao ativar as ferramentas.
• Adicionada desinstalação pelas configurações e pelo menu de aplicativos.
• Exigida confirmação explícita antes de desinstalar.
• Preservados os dados pessoais fora da pasta de instalação.

v2.0.0 - Baseus Presenter Linux

Baseus Presenter Linux v2.0.0

🇧🇷 Português

A versão 2.0.0 representa uma grande evolução do Baseus Presenter Linux, com uma nova arquitetura modular, melhorias de estabilidade, instalação mais segura e um novo sistema de atualização baseado em releases do GitHub.

✨ Principais novidades

• Nova arquitetura modular, separando hardware, áudio, interface gráfica, overlay, configurações e atualização.
• Melhorias no suporte a múltiplos monitores e projetores.
• Melhorias no pincel digital e no sistema de overlay.
• Tratamento mais robusto de desconexão e reconexão do passador.
• Melhorias no sistema de transcrição offline com Vosk.
• Melhorias na tradução simultânea offline com Argos Translate.
• Gerenciamento de dispositivos de áudio mais confiável.
• Salvamento de configurações mais seguro e resistente a corrupção.
• Melhor gerenciamento de threads e encerramento do aplicativo.
• Novo sistema de instalação com ambiente virtual Python isolado.
• Novo sistema de atualização baseado nas releases estáveis do GitHub.
• Proteções contra instalações incompletas, atualizações simultâneas e substituição acidental de checkouts de desenvolvimento.
• Novo sistema de versionamento.
• Inclusão de testes automatizados para os principais componentes do projeto.

🔄 Atualizações

A partir da versão 2.0.0, o aplicativo passa a utilizar as releases estáveis publicadas no GitHub como referência para instalação e atualização.

O instalador verifica automaticamente a última release estável disponível, ignorando drafts e pré-releases.

⚠️ Observação

Esta é uma atualização significativa em relação à versão 1.1. Recomenda-se utilizar o instalador oficial disponível no README para instalações novas.

---

🇺🇸 English

Version 2.0.0 is a major evolution of Baseus Presenter Linux, introducing a new modular architecture, improved stability, safer installation, and a new GitHub Releases-based update system.

✨ Main changes

• New modular architecture separating hardware, audio, graphical interface, overlay, configuration, and update logic.
• Improved multi-monitor and projector support.
• Improvements to the digital pen and overlay system.
• More robust presenter disconnection and reconnection handling.
• Improved offline transcription using Vosk.
• Improved offline live translation using Argos Translate.
• More reliable audio device management.
• Safer and more corruption-resistant configuration saving.
• Improved thread management and application shutdown.
• New installation system using an isolated Python virtual environment.
• New update system based on stable GitHub Releases.
• Protections against incomplete installations, concurrent updates, and accidental replacement of development checkouts.
• New versioning system.
• Automated tests covering the main project components.

🔄 Updates

Starting with version 2.0.0, the application uses stable GitHub Releases as the reference for installation and automatic updates.

The installer automatically checks the latest stable release while ignoring drafts and pre-releases.

⚠️ Note

This is a significant update compared to version 1.1. For new installations, using the official installer available in the README is recommended.

Versão 1.1: Estabilidade e IA Offline

🇧🇷 Versão 1.1: Primeira Versão Estável 🚀

Esta é a primeira versão de produção do Baseus Presenter para Linux. O aplicativo foi estabilizado, testado e auditado para oferecer uma experiência segura e fluida em ambientes de apresentação e aulas.

✨ Principais Recursos:

• Overlay Inteligente (Multi-Telas): O laser digital, lupa, spotlight e pincel agora detectam automaticamente múltiplos monitores/Datashows e "teletransportam" a área de desenho para a tela onde o cursor está ativo.

• Inteligência Artificial Offline: Integração completa com Vosk (Transcrição) e Argos Translate (Tradução Simultânea) rodando 100% localmente no seu hardware, sem enviar áudio para a nuvem.

• Arquitetura de Segurança: Instalador aprimorado com criação de ambiente virtual isolado (venv). As regras udev restritivas limitam o acesso ao hardware apenas ao grupo de segurança baseus, permitindo a execução em user space (sem root).

• Blindagem de Hardware: Implementada tolerância a falhas na leitura bruta da porta USB (hidraw) e sistema atômico de salvamento de configurações para evitar corrupção em caso de queda de energia. Prevenção de instâncias duplicadas via trava de arquivo no Kernel (fcntl).

🇺🇸 Version 1.1: First Stable Release 🚀

This is the first production-ready release of the Baseus Presenter for Linux. The application has been stabilized, tested, and audited to provide a secure and smooth experience for presentations and lectures.

✨ Key Features:

• Smart Overlay (Multi-Monitor): The digital laser, magnifier, spotlight, and pen now automatically detect multiple monitors/projectors and "teleport" the drawing area to the active screen.

• Offline AI: Full integration with Vosk (Transcription) and Argos Translate (Live Translation) running 100% locally on your hardware, ensuring privacy.

• Security Architecture: Enhanced installer using an isolated virtual environment (venv). Restrictive udev rules limit hardware access strictly to the baseus security group, allowing execution in user space (no root required).

• Hardware Shielding: Implemented fault tolerance for raw USB reading (hidraw) and atomic config saving to prevent data corruption. Duplicate instances are blocked via Kernel-level file locking (fcntl).