qtacrylic is a python module to apply Windows 10's Acrylic Material Theme onto a PyQt/PySide window.
You can also apply the Aero Material Theme using this module.
If you're running a Windows version above 1809, and trying to apply the acrylic material, then you will be very likely to encounter a bug where the window lags behind the cursor when you resize/move the window. Fortunately this bug is only occured with the Acrylic blur. Meaning you can still use the Aero blur without problem.
This bug is located in windows' dwm (desktop window manager), meaning we couldn't do anything to completely mitigate the issue, we have to wait the Windows developers to fix the bug. There's however a very crude and temporary fix to this problem by disabling Acrylic shadow and adding a delay when you resize/move the window:
def moveEvent(self, event) -> None:
time.sleep(0.02) # sleep for 20ms
def resizeEvent(self, event) -> None:
time.sleep(0.02) # sleep for 20msThis may introduce a noticeably minor stutter or unsmooth window moving/resizing.
Import the module:
from qtacrylic import WindowEffectAn example code of how to apply the material:
from PySide2.QtWidgets import QWidget, QApplication
from qtacrylic import WindowEffect # import the module
from PySide2 import QtWidgets
from PySide2.QtCore import Qt
from PySide2.QtGui import QFont
import sys
class Window(QWidget):
def __init__(self):
super(Window, self).__init__()
self.setFixedWidth(400) # set a fixed width for the window
self.setFixedHeight(400) # set a fixed height for the window
self.setWindowFlags(Qt.FramelessWindowHint) # make the window frameless
self.setAttribute(Qt.WA_TranslucentBackground) # make the window translucent
self.ui_layout = QtWidgets.QGridLayout(self) # create a ui layout
self.ui_layout.setAlignment(Qt.AlignCenter) # center the layout
self.label = QtWidgets.QLabel("Hello World!", self) # create a label to display a text
self.label.setFont(QFont("Segoe UI", 14)) # configure the text size and font
self.ui_layout.addWidget(self.label) # add the label widget into the layout
self.windowFX = WindowEffect() # instatiate the WindowEffect class
self.windowFX.setAcrylicEffect(self.winId()) # set the Acrylic effect by specifying the window id
if __name__ == "__main__":
app = QApplication(sys.argv)
win = Window()
win.show()
app.exec_()
To apply the Aero effect simply replace setAcrylicEffect() with setAeroEffect()
self.windowFX = WindowEffect() # instatiate the WindowEffect class
self.windowFX.setAeroEffect(self.winId()) # set the Aero effect by specifying the window id