A cross-platform frameless window based on pyqt5, support Win32, X11, Wayland and macOS.
Project description
PyQt-Frameless-Window
A cross-platform frameless window based on PyQt5
Features
- Moving
- Stretching
- Window shadow
- Window animation
- Win11 snap layout
- Win10 acrylic blur
- Win11 mica blur
- Win7 Aero blur
- MacOS blur
Install
To install use pip:
pip install PyQt5-Frameless-Window
Or clone the repo:
git clone https://github.com/zhiyiYo/PyQt-Frameless-Window.git
python setup.py install
Requirements
Platform | Requirement |
---|---|
Win32 | pywin32 |
Linux | xcffib |
MacOS | pyobjc |
Usage
To use the frameless window, you only need to inherit FramelessWindow
or FramelessMainWindow
. Here is a minimal example:
import sys
from PyQt5.QtWidgets import QApplication
from qframelesswindow import FramelessWindow
class Window(FramelessWindow):
def __init__(self, parent=None):
super().__init__(parent=parent)
self.setWindowTitle("PyQt-Frameless-Window")
self.titleBar.raise_()
if __name__ == '__main__':
app = QApplication(sys.argv)
demo = Window()
demo.show()
sys.exit(app.exec_())
For more complex requirements, see demo.py and main_window.py.
Examples
- Normal frameless window
- Acrylic frameless window
Document
Want to know more about PyQt-Frameless-Window? Please read the help document 👈
Notes
-
FramelessWindow
provides a default custom title bar. If you don't like it, just rewrite it as demo.py does. -
Moving the acrylic window on Win10 may get stuck. At present, there is no good solution. Maybe you can disable the acrylic effect when moving the window, but I haven't done this in the source code.
-
Snap layout is not enabled by default. See #56 to learn how to enable it.
-
If you encounter this problem on Windows:
ImportError: DLL load failed while importing win32api
see my answer on stackoverflow or my blog for the solution.
-
If you are using PySide2, PySide6 or PyQt6, you can download the code in PySide2, PySide6 or PyQt6 branch.
Support
If this project helps you a lot and you want to support the development and maintenance of this project, feel free to sponsor me via 爱发电 or ko-fi. Your support is highly appreciated 🥰
See Also
Here are some projects that use PyQt-Frameless-Window:
- zhiyiYo/Groove: A cross-platform music player based on PyQt5
- zhiyiYo/Alpha-Gobang-Zero: A gobang robot based on reinforcement learning
- zhiyiYo/PyQt-Fluent-Widgets: A fluent design widgets library based on PyQt5
- zhiyiYo/QMaterialWidgets: A material design widgets library based on PySide
Reference
- wangwenx190/framelesshelper: Frameless windows for Qt Widgets and Qt Quick applications. Support Win32, X11, Wayland and macOS
- libxcb: Basic Graphics Programming With The XCB Library
License
PyQt-Frameless-Window is licensed under GPLv3.
Copyright © 2021 by zhiyiYo.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for PyQt5-Frameless-Window-0.3.3.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | c54a9f20afcbce06f27ad0b9c25bef5a0442ebf3b2a60105cd91b119b495771b |
|
MD5 | 0e1cc4bfb6b7092e1a23515ca546d2ff |
|
BLAKE2b-256 | 0a317f504c65acbe44145a5e2eda4f90ad0ca5bb76f6dea584ee4c15f26eb51c |
Hashes for PyQt5_Frameless_Window-0.3.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 99a93aa532ea9dd7df73fb7afb96e55474ea944d563519153c085840a3f30afb |
|
MD5 | d354abb8eb08c0fb3af950500c739028 |
|
BLAKE2b-256 | b67c7070bbd152dee305eea2d9f8eefef51b86433e84f9d1c12d29bb71898cf1 |