Repolode
zhiyiYo

zhiyiYo/PyQt-Frameless-Window

Библиотека Python для создания окон PyQt/PySide без рамки с настраиваемой строкой заголовка, изменением размера и системными эффектами размытия в Windows, Linux и macOS.

Звёзды
766
Форки
96
Открытые issues
18
Последний коммит
3 месяца назад

Что это?

PyQt-Frameless-Window — библиотека Python, которая убирает системную строку заголовка у окон Qt, сохраняя привычные функции: перемещение, изменение размера и тени. Достаточно унаследоваться от FramelessWindow или FramelessMainWindow — и вы получите настраиваемую строку заголовка, которую можно заменить собственной.

Библиотека также добавляет визуальные эффекты, зависящие от платформы: размытие acrylic в Windows 10, mica в Windows 11, Aero в Windows 7 и размытие в macOS. В Windows 11 можно включить макеты привязки окон, а также запретить захват изображения окна. Поддерживаются Windows, Linux и macOS; для каждой платформы требуется pywin32, xcffib или pyobjc.

Основной пакет предназначен для PyQt5. Для PySide2, PySide6 и PyQt6 доступны отдельные ветки.

Ключевые возможности

  • 01Окно без рамки с поддержкой перемещения и изменения размера
  • 02Тень окна и анимация окна
  • 03Эффекты размытия acrylic в Win10 и mica в Win11
  • 04Эффекты размытия Aero в Win7 и в macOS
  • 05Макеты привязки окон в Win11, которые нужно включить вручную
  • 06Возможность запретить захват изображения окна

Сценарии использования

  • Создание настольного приложения PyQt с современной настраиваемой строкой заголовка
  • Добавление фона с эффектом acrylic или mica в приложение для Windows
  • Создание главного окна без рамки в проекте на PySide или PyQt6

Быстрый старт

  1. 1

    Установите библиотеку с помощью pip

    pip install PyQt5-Frameless-Window
  2. 2

    Создайте окно, унаследовав его от FramelessWindow, и покажите его (см. минимальный пример в README)

Что важно знать

  • Библиотека построена на PyQt5; пользователям PySide и PyQt6 нужны отдельные ветки.
  • Требуются платформозависимые зависимости, например pywin32, xcffib или pyobjc.
  • При перемещении акрилового окна в Win10 оно может зависнуть; известного решения нет.
  • Лицензия GPL-3.0 с принципом copyleft может ограничивать использование в проектах с закрытым исходным кодом.

Темы

Частые вопросы

Что такое PyQt-Frameless-Window?
Библиотека Python для создания окон PyQt/PySide без рамки с настраиваемой строкой заголовка, изменением размера и системными эффектами размытия в Windows, Linux и macOS. PyQt-Frameless-Window — библиотека Python, которая убирает системную строку заголовка у окон Qt, сохраняя привычные функции: перемещение, изменение размера и тени. Достаточно унаследоваться от FramelessWindow или FramelessMainWindow — и вы получите настраиваемую строку заголовка, которую можно заменить собственной.
PyQt-Frameless-Window можно использовать бесплатно? Какая у него лицензия?
PyQt-Frameless-Window распространяется с открытым исходным кодом под лицензией GPL-3.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
PyQt-Frameless-Window всё ещё поддерживается?
Обновлялся за последние 6 месяцев. Последний коммит в PyQt-Frameless-Window — 2 авг. 2026 г..
Для чего можно использовать PyQt-Frameless-Window?
Создание настольного приложения PyQt с современной настраиваемой строкой заголовка Добавление фона с эффектом acrylic или mica в приложение для Windows Создание главного окна без рамки в проекте на PySide или PyQt6
Как установить PyQt-Frameless-Window?
Установите библиотеку с помощью pip: pip install PyQt5-Frameless-Window Создайте окно, унаследовав его от FramelessWindow, и покажите его (см. минимальный пример в README)
Где скачать PyQt-Frameless-Window?
Исходный код и инструкции по установке — на GitHub: https://github.com/zhiyiYo/PyQt-Frameless-Window

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Кроссплатформенное десктопное приложение, которое сортирует файлы с помощью локальных или удалённых LLM и предлагает более понятные имена, позволяя проверить результат до внесения изменений.

1,8 тыс.185C++AGPL-3.0Обновлён позавчера