winmica

A simple Python package to enable Windows 11 Mica effects for PyQt6 applications using the official Windows API.

Installation

Install this package (from the project root):

pip install winmica

Usage Example (PyQt6)

from PyQt6.QtWidgets import QApplication, QMainWindow
from PyQt6.QtCore import Qt
from winmica import EnableMica, BackdropType, is_mica_supported
import sys

class MyWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("Mica Example")
        self.setGeometry(100, 100, 600, 400)
        self.setAttribute(Qt.WidgetAttribute.WA_TranslucentBackground, True)
        if is_mica_supported():
            hwnd = int(self.winId())
            EnableMica(hwnd, BackdropType.MICA)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    window = MyWindow()
    window.show()
    sys.exit(app.exec())

Features

• Official Windows 11 Mica Effect
• Simple API: EnableMica(hwnd, backdrop_type)
• Works with PyQt6 windows (may also work with PySide6 or Tkinter, but not tested)
• Detects system theme (light/dark)

Effect Types

• BackdropType.MICA – Standard Mica
• BackdropType.MICA_ALT – Alternative Mica
• BackdropType.AUTO – Auto (let Windows decide)

Result: