Repolode
Enviar
zhiyiYo

zhiyiYo/PyQt-Frameless-Window

Biblioteca Python para criar janelas PyQt/PySide sem bordas, com barras de título personalizadas, redimensionamento e efeitos nativos de desfoque no Windows, Linux e macOS.

Ver no GitHubSite
Estrelas
766
Forks
96
Issues abertas
18
Último commit
há 3 meses

O que é?

PyQt-Frameless-Window é uma biblioteca Python que remove a barra de título nativa das janelas Qt sem abrir mão do comportamento esperado pelos usuários, como mover e redimensionar a janela e exibir sombras. Herde de FramelessWindow ou FramelessMainWindow para obter uma barra de título personalizada padrão, que você pode substituir pela sua.

A biblioteca também oferece efeitos visuais específicos de cada plataforma: desfoque acrylic no Windows 10, desfoque mica no Windows 11, desfoque Aero no Windows 7 e desfoque no macOS. No Windows 11, ela pode ativar o layout de encaixe e desabilitar a captura de tela da janela. Há suporte para Windows, Linux e macOS; cada plataforma requer pywin32, xcffib ou pyobjc.

O pacote principal tem como alvo o PyQt5. Também há branches para PySide2, PySide6 e PyQt6.

Recursos principais

  • 01Janela sem bordas com suporte para mover e redimensionar
  • 02Sombra e animação da janela
  • 03Efeitos de desfoque acrylic no Win10 e mica no Win11
  • 04Efeitos de desfoque Aero no Win7 e no macOS
  • 05Layout de encaixe do Win11, que precisa ser ativado manualmente
  • 06Opção para desabilitar a captura de tela da janela

Casos de uso

  • Criar um aplicativo desktop PyQt com uma barra de título personalizada e visual moderno
  • Adicionar fundos acrylic ou mica a um aplicativo Windows
  • Criar uma janela principal sem bordas em um projeto PySide ou PyQt6

Início rápido

  1. 1

    Instale a biblioteca com pip

    pip install PyQt5-Frameless-Window
  2. 2

    Crie uma janela herdando de FramelessWindow e exiba-a (consulte o exemplo mínimo no README)

Antes de usar

  • É baseado em PyQt5; quem usa PySide ou PyQt6 precisa recorrer às branches separadas.
  • Requer dependências específicas da plataforma, como pywin32, xcffib ou pyobjc.
  • Ao mover uma janela acrílica no Win10, ela pode travar; não há solução conhecida.
  • A licença GPL-3.0 é copyleft e pode restringir o uso em projetos de código fechado.

Tópicos

#pyqt#pyside#qt#gui#frameless-window#desktop-app#python#acrylic#aero#cross-platform

Perguntas frequentes

O que é PyQt-Frameless-Window?
Biblioteca Python para criar janelas PyQt/PySide sem bordas, com barras de título personalizadas, redimensionamento e efeitos nativos de desfoque no Windows, Linux e macOS. PyQt-Frameless-Window é uma biblioteca Python que remove a barra de título nativa das janelas Qt sem abrir mão do comportamento esperado pelos usuários, como mover e redimensionar a janela e exibir sombras. Herde de FramelessWindow ou FramelessMainWindow para obter uma barra de título personalizada padrão, que você pode substituir pela sua.
PyQt-Frameless-Window é gratuito? Qual é a licença?
PyQt-Frameless-Window é open source sob a licença GPL-3.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
PyQt-Frameless-Window ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de PyQt-Frameless-Window foi em 2 de ago. de 2026.
Para que posso usar PyQt-Frameless-Window?
Criar um aplicativo desktop PyQt com uma barra de título personalizada e visual moderno Adicionar fundos acrylic ou mica a um aplicativo Windows Criar uma janela principal sem bordas em um projeto PySide ou PyQt6
Como instalar PyQt-Frameless-Window?
Instale a biblioteca com pip: pip install PyQt5-Frameless-Window Crie uma janela herdando de FramelessWindow e exiba-a (consulte o exemplo mínimo no README)
Onde consigo PyQt-Frameless-Window?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/zhiyiYo/PyQt-Frameless-Window

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados