Repolode
Enviar
zhiyiYo

zhiyiYo/PyQt-Frameless-Window

Biblioteca de Python para crear ventanas PyQt/PySide sin bordes, con barras de título personalizadas, redimensionamiento y efectos de desenfoque nativos en Windows, Linux y macOS.

Ver en GitHubSitio web
Estrellas
766
Forks
96
Issues abiertos
18
Último commit
hace 3 meses

¿Qué es?

PyQt-Frameless-Window es una biblioteca de Python que elimina la barra de título nativa de las ventanas Qt y conserva el comportamiento que esperan los usuarios, como moverlas, cambiar su tamaño y mostrar sombras. Hereda de FramelessWindow o FramelessMainWindow para obtener una barra de título personalizada predeterminada, que puedes sustituir por la tuya.

La biblioteca también añade efectos visuales específicos de cada plataforma: desenfoque acrílico en Windows 10, desenfoque mica en Windows 11, desenfoque Aero en Windows 7 y desenfoque en macOS. En Windows 11 puede activar el diseño de ajuste de ventanas, y permite desactivar la captura de pantalla de la ventana. Se admiten Windows, Linux y macOS; según la plataforma, se requiere pywin32, xcffib o pyobjc.

El paquete principal está destinado a PyQt5. Hay ramas para PySide2, PySide6 y PyQt6.

Funciones clave

  • 01Ventana sin bordes con compatibilidad para moverla y cambiar su tamaño
  • 02Sombra y animación de ventana
  • 03Efectos de desenfoque acrílico en Win10 y mica en Win11
  • 04Efectos de desenfoque Aero en Win7 y de macOS
  • 05Diseño de ajuste de ventanas en Win11, que debe activarse manualmente
  • 06Opción para desactivar la captura de pantalla de la ventana

Casos de uso

  • Crear una aplicación de escritorio PyQt con una barra de título personalizada y de aspecto moderno
  • Añadir fondos acrílicos o mica a una aplicación de Windows
  • Crear una ventana principal sin bordes en un proyecto PySide o PyQt6

Inicio rápido

  1. 1

    Instala la biblioteca con pip

    pip install PyQt5-Frameless-Window
  2. 2

    Crea una ventana heredando de FramelessWindow y muéstrala (consulta el ejemplo mínimo del README)

Antes de usarlo

  • Está basado en PyQt5; quienes usen PySide o PyQt6 deben utilizar las ramas correspondientes.
  • Requiere dependencias específicas de cada plataforma, como pywin32, xcffib o pyobjc.
  • Al mover una ventana acrílica en Win10, puede quedarse atascada; no se conoce ninguna solución.
  • La licencia GPL-3.0 es copyleft y puede limitar su uso en proyectos de código cerrado.

Temas

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

Preguntas frecuentes

¿Qué es PyQt-Frameless-Window?
Biblioteca de Python para crear ventanas PyQt/PySide sin bordes, con barras de título personalizadas, redimensionamiento y efectos de desenfoque nativos en Windows, Linux y macOS. PyQt-Frameless-Window es una biblioteca de Python que elimina la barra de título nativa de las ventanas Qt y conserva el comportamiento que esperan los usuarios, como moverlas, cambiar su tamaño y mostrar sombras. Hereda de FramelessWindow o FramelessMainWindow para obtener una barra de título personalizada predeterminada, que puedes sustituir por la tuya.
¿PyQt-Frameless-Window es gratuito? ¿Qué licencia tiene?
PyQt-Frameless-Window es open source bajo la licencia GPL-3.0. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿PyQt-Frameless-Window sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de PyQt-Frameless-Window fue el 2 ago 2026.
¿Para qué puedo usar PyQt-Frameless-Window?
Crear una aplicación de escritorio PyQt con una barra de título personalizada y de aspecto moderno Añadir fondos acrílicos o mica a una aplicación de Windows Crear una ventana principal sin bordes en un proyecto PySide o PyQt6
¿Cómo se instala PyQt-Frameless-Window?
Instala la biblioteca con pip: pip install PyQt5-Frameless-Window Crea una ventana heredando de FramelessWindow y muéstrala (consulta el ejemplo mínimo del README)
¿Dónde consigo PyQt-Frameless-Window?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/zhiyiYo/PyQt-Frameless-Window

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados