zhiyiYo/PyQt-Frameless-Window

これは何？

主な機能

• 01移動とサイズ変更に対応したフレームレスウィンドウ
• 02ウィンドウの影とアニメーション
• 03Windows 10のアクリルぼかしとWindows 11のMicaぼかし効果
• 04Windows 7のAeroぼかしとmacOSのぼかし効果
• 05手動で有効にする必要があるWindows 11のスナップレイアウト
• 06ウィンドウの画面キャプチャを無効にするオプション

ユースケース

• モダンな見た目のカスタムタイトルバーを備えたPyQtデスクトップアプリの開発
• WindowsアプリケーションにアクリルまたはMicaの背景を追加
• PySideまたはPyQt6プロジェクトでフレームレスなメインウィンドウを作成

クイックスタート

1. 1

   pipでライブラリをインストールします

   pip install PyQt5-Frameless-Window
2. 2

   FramelessWindowを継承したウィンドウを作成して表示します（READMEの最小限のサンプルを参照）

使う前に知っておきたいこと

• !PyQt5をベースにしています。PySideおよびPyQt6のユーザーは別のブランチを利用する必要があります。
• !pywin32、xcffib、pyobjcなど、プラットフォーム固有の依存関係が必要です。
• !Win10でアクリルウィンドウを移動すると、動かなくなることがあります。既知の修正方法はありません。
• !GPL-3.0ライセンス（コピーレフト）のため、クローズドソースプロジェクトでの使用が制限される場合があります。

トピック

よくある質問

PyQt-Frameless-Window とは？

Windows、Linux、macOSで、独自のタイトルバーやリサイズ、ネイティブのぼかし効果を備えたフレームレスなPyQt/PySideウィンドウを作成するPythonライブラリ。 PyQt-Frameless-Windowは、ウィンドウの移動やサイズ変更、ウィンドウの影といったユーザーが期待する動作を保ちながら、Qtウィンドウのネイティブタイトルバーを取り除くPythonライブラリです。FramelessWindowまたはFramelessMainWindowを継承するだけで、デフォルトのカスタムタイトルバーを利用できます。独自のタイトルバーに置き換えることもできます。

PyQt-Frameless-Window は無料で使えますか？ライセンスは？

PyQt-Frameless-Window は GPL-3.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

PyQt-Frameless-Window は今もメンテナンスされていますか？

半年以内に更新あり。PyQt-Frameless-Window の最終コミットは 2026年8月2日 です。

PyQt-Frameless-Window は何に使えますか？

モダンな見た目のカスタムタイトルバーを備えたPyQtデスクトップアプリの開発 WindowsアプリケーションにアクリルまたはMicaの背景を追加 PySideまたはPyQt6プロジェクトでフレームレスなメインウィンドウを作成

PyQt-Frameless-Window のインストール方法は？

pipでライブラリをインストールします: pip install PyQt5-Frameless-Window FramelessWindowを継承したウィンドウを作成して表示します（READMEの最小限のサンプルを参照）

PyQt-Frameless-Window はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/zhiyiYo/PyQt-Frameless-Window