zhiyiYo/PyQt-Frameless-Window

어떤 프로젝트인가요?

핵심 기능

• 01이동 및 크기 조절을 지원하는 프레임리스 창
• 02창 그림자 및 창 애니메이션
• 03Win10 acrylic 및 Win11 mica 블러 효과
• 04Win7 Aero 및 macOS 블러 효과
• 05수동으로 활성화해야 하는 Win11 스냅 레이아웃
• 06창 화면 캡처를 비활성화하는 옵션

활용 사례

• 현대적인 느낌의 사용자 지정 타이틀 바를 갖춘 PyQt 데스크톱 앱 제작
• Windows 애플리케이션에 acrylic 또는 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은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. PyQt-Frameless-Window의 마지막 커밋은 2026년 8월 2일입니다.

PyQt-Frameless-Window은(는) 어디에 사용할 수 있나요?

현대적인 느낌의 사용자 지정 타이틀 바를 갖춘 PyQt 데스크톱 앱 제작 Windows 애플리케이션에 acrylic 또는 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