2.1 KiB
2.1 KiB
pyqt-liquidglass
macOS Liquid Glass effects for PySide6 and PyQt6.
Overview
pyqt-liquidglass provides a Python API to apply Apple's native glass visual effects to Qt windows and widgets. On macOS 26+, it uses NSGlassEffectView for Liquid Glass. On older versions, it falls back to NSVisualEffectView.
Features
- Apply glass effects to entire windows or specific widgets
- Configure corner radius, padding, and materials
- Reposition, hide, or show window traffic lights
- Automatic Qt binding detection (PySide6, PyQt6)
- Safe no-ops on non-macOS platforms
Installation
pip install pyqt-liquidglass
Or with uv:
uv add pyqt-liquidglass
Quick Start
from PySide6.QtWidgets import QApplication, QMainWindow
import pyqt_liquidglass as glass
app = QApplication([])
window = QMainWindow()
window.resize(800, 600)
# Prepare before showing
glass.prepare_window_for_glass(window)
window.show()
# Apply glass after showing
glass.apply_glass_to_window(window)
app.exec()
Sidebar Pattern
# Apply glass to a sidebar widget
glass.apply_glass_to_widget(sidebar, options=glass.GlassOptions.sidebar())
# Position traffic lights
glass.setup_traffic_lights_inset(window, x_offset=18, y_offset=12)
Custom Options
options = glass.GlassOptions(
corner_radius=16.0,
padding=(10, 10, 10, 10),
)
glass.apply_glass_to_window(window, options=options)
Requirements
- Python 3.12+
- macOS
- PySide6 or PyQt6
Tested with PySide6. PyQt6 should work but is not explicitly tested.
Documentation
Full documentation: pyqt-liquidglass.readthedocs.io
License
MIT