Repository navigation
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.