제 목 :
Meshy AI 를 3D모델링 하기 #2 - PySide6 화면만들기

지난 번 글에서 Python 개발환경도 만들고 필요한 패키지들도 설치했다. 이제 화면을 만들어보자. 그런데… 어떻게?
나는 UI라고는 HTML, Javascript 정도만 만든 경험 뿐이고, 물론 15년 전엔 Action Script로 Flash UI를 만들거나 강사시절 Python Qt를 이용해 예제용 GUI를 만들어본게 전부인데 막막하기 그지 없었다. 그래서 PySide 사이트에서 이것저것 문서를 읽다보니 돌파구를 찾았다!!

일단 VS Code에서 Qt Python 이라는 확장 프로그램을 먼저 설치하자. PySide 홈페이지에서도 설치하라고 했다.

그래서 확장프로그램을 검색해서 설치한다.

주의할 점은 Qt For Python이 아니라 Qt Python이라는 것이다. 낚일뻔.
근데 뭐… 설치하고 확인해보니 별 내용은 없다. 그냥 파일 만들기나 프로젝트 만들기가 편하다 정도?
그보다 더 중요한건 PySide designer 툴이라는게 있다는 거다.
(.venv) pyside6-designer콘솔창에 가상환경 위에서 pyside6 패키지를 설치했다면 pyside6-designer가 자동으로 설치되어있단다. 콘솔에서 저렇게 입력하면!

이렇게 디자인 툴을 확인해볼 수 있다. 오오 맙소사.

그럼 이걸로 이리저리 디자인을 해보도록 하겠다.
메인 윈도우 만들기
메인 윈도우를 만드는 것 자체는 별로 어렵지 않다.
요 다이얼로그에 Main Window를 선택하고 생성하면 된다.

그럼 이런 기본 윈도우가 생성되는데 여기에 대고 화면들을 만들면 된다.
그리고 작업을 한 뒤에 저장을 하면 파일명.ui 파일이 생성되는데 예를 들어 이렇게 만들었다고 생각해보자.

그리고 나는 sample.ui라고 저장을 했다. 그리고 나서 파일을 확인해보면

이렇게 XML로 만들어진 것을 볼 수 있다. 이걸 그대로 사용할 수는 없고 이 ui 파일을 pyside6-uic로 Python 코드로 변환시켜야하는데. 아래의 명령으로 수정할 수 있다.
(.venv) pyside6-uic src/ui/sample.ui -o src/ui/sample.py이렇게 명령을 치면 ui 파일이 py 파일로 변환되어 저장되는 것을 확인 할 수 있다.

UI는 대충 어떻게 만드는 줄 알았으니까. 이제 UI를 만들어보자.


제기랄. PySide6 Designer는 넘기 힘든 산이 분명했다. 저딴걸 어떻게 쓰라고! 문서를 읽다보니 이게 뭔가 애매하다. 설명에 알맹이가 빠져있는 느낌이랄까. 그래서 난 결심을 했다. 개발하려는 내용을 클로드에게 전달하고 Figma MCP를 디자인 시킨 이후 내가 검토한 뒤에 이 디자인을 PySide6 ui 파일로 만들어달라고 요청했다.

물론 PyQt 같은 책도 있고 유튜브에 강의도 많다. 하지만 난 바쁘고, 코딩할 일이 많고 똑똑한 AI와 함께 일하고 있는데 그만 고민하자. AI 구독료가 아깝다. PyQt 공부는 한국으로 돌아가는 비행기에서 해야지.
아무튼 이런저런 고민을 하는 동안 클로드가 만들어준 디자인은 잘 PyQt Designer로 만들어졌다.

그럼 이렇게 만들어준 ui 파일을 python으로 변형해보자.
(.venv) pyside6-uic src/ui/main_window.ui -o src/ui/main_window.py(.venv) pyside6-uic src/ui/job_item.ui -o src/ui/job_item.py(.venv) pyside6-uic src/ui/settings_dialog.ui -o src/ui/settings_dialog.py이렇게 실행했더니 파일이 잘 만들어진걸 확인할 수 있었다.


그럼 다음 단계로 이제 이걸 실행할 수 있도록 작업들을 해보자. 일단 main_window.py 파일을 띄우기 위한 작업부터 진행하자.
UI 다음단계. 실행해보자.
일단 src/ui 디렉토리에 windows.py 파일을 만들어서 .ui파일을 변환한 Python 파일들을 실제 위젯으로 감싸는 역할을 수행하게 한다.
"""pyside6-uic 로 변환한 Ui_* 클래스를 실제 창(위젯)으로 감싸는 모듈
main_window.py / settings_dialog.py / job_item.py 는 .ui 를 다시 변환하면 덮어써지므로
직접 수정하지 않고, 여기서 상속해 화면 동작을 구현
"""
from __future__ import annotations
from PySide6.QtCore import QSizefrom PySide6.QtWidgets import (QDialog,QDialogButtonBox,QLabel,QLineEdit,QListWidgetItem,QMainWindow,QWidget,)
from ui.job_item import Ui_JobItemfrom ui.main_window import Ui_MainWindowfrom ui.settings_dialog import Ui_SettingsDialogfrom ui.theme import polish, refresh_style
def set_chip(label: QLabel, status: str, text: str) -> None: """상태 칩 문구와 status 속성(pending | in_progress | succeeded | failed)을 바꿉니다""" label.setText(text) label.setProperty("status", status) refresh_style(label)
class JobItemWidget(QWidget, Ui_JobItem): """작업 목록(jobListWidget)의 한 줄""" ROW_HEIGHT = 60
def __init__(self, parent: QWidget | None = None) -> None: super().__init__(parent) self.setupUi(self) polish(self)
def set_job(self, name: str, status: str, chip_text: str, detail: str) -> None: self.nameLabel.setText(name) self.detailLabel.setText(detail) set_chip(self.statusChipLabel, status, chip_text)
class SettingsDialog(QDialog, Ui_SettingsDialog): """설정 다이얼로그"""
def __init__(self, parent: QWidget | None = None) -> None: super().__init__(parent) self.setupUi(self)
# 표준 버튼 문구는 Qt 번역(qtbase_ko)을 로드하지 않으면 영어로 나오므로 직접 지정합니다. save = self.buttonBox.button(QDialogButtonBox.StandardButton.Save) cancel = self.buttonBox.button(QDialogButtonBox.StandardButton.Cancel) save.setText("저장") cancel.setText("취소") save.setProperty("variant", "primary") refresh_style(save)
self.showApiKeyButton.toggled.connect(self._toggle_api_key_visible) polish(self)
def _toggle_api_key_visible(self, visible: bool) -> None: mode = QLineEdit.EchoMode.Normal if visible else QLineEdit.EchoMode.Password self.apiKeyEdit.setEchoMode(mode)
class MainWindow(QMainWindow, Ui_MainWindow): """메인 윈도우"""
def __init__(self, parent: QWidget | None = None) -> None: super().__init__(parent) self.setupUi(self) self.mainSplitter.setSizes([264, 656, 360])
self.actionSettings.triggered.connect(self.open_settings) self.settingsButton.clicked.connect(self.open_settings) self.actionQuit.triggered.connect(self.close)
polish(self)
def open_settings(self) -> None: SettingsDialog(self).exec()
def add_job(self, name: str, status: str, chip_text: str, detail: str) -> JobItemWidget: """작업 목록에 JobItemWidget 한 줄을 추가""" row = JobItemWidget() row.set_job(name, status, chip_text, detail)
item = QListWidgetItem(self.jobListWidget) item.setSizeHint(QSize(0, JobItemWidget.ROW_HEIGHT))
self.jobListWidget.setItemWidget(item, row) self.jobCountLabel.setText(str(self.jobListWidget.count())) return row나도 PySide는 처음이라 이리저리 찾아보고 AI한테 물어봐서 이렇게 작업을 진행했다. 그리고 진입점을 만들어야지. main.py 파일이다.
"""Meshy Desktop 실행 진입점.
사용법 (프로젝트 루트에서): python src/main.py # 메인 윈도우 python src/main.py settings # 설정 다이얼로그만 띄우기 python src/main.py --sample # 작업 목록에 샘플 JobItem 을 채워서 띄우기"""
from __future__ import annotationsimport sysfrom pathlib import Path
sys.path.insert(0, str(Path(__file__).resolve().parent))
from PySide6.QtWidgets import QApplication
from ui.theme import apply_themefrom ui.windows import MainWindow, SettingsDialog
SAMPLE_JOBS = [ ("chair_front.png", "in_progress", "진행 중", "62% · 약 1분 남음"), ("sneaker_photo.jpg", "succeeded", "완료", "12분 전"), ("ceramic_mug.webp", "succeeded", "완료", "어제"), ("lamp_side.jpg", "failed", "실패", "크레딧 환불됨 · 어제"),]
def main() -> int: app = QApplication(sys.argv) app.setApplicationName("Meshy Desktop") apply_theme(app) args = sys.argv[1:]
if "settings" in args: return SettingsDialog().exec()
window = MainWindow()
if "--sample" in args: for job in SAMPLE_JOBS: window.add_job(*job) window.jobListWidget.setCurrentRow(0)
window.show() return app.exec()
if __name__ == "__main__": raise SystemExit(main())일단 아직 동작들을 다 만든게 아니라서 Sample 모드를 만들어봤다.
그래서 src 디렉토리에 간 뒤에 python main.py --sample 라고 명령을 실행했다.
함께 도전할 사람들은 Git 저장소 에서 Clone 받고 실행하는 것도 나쁘지 않을 것 같다.
다음 시간은 프로토 타입으로 기능들을 붙여넣는 작업을 진행해보자.
오늘은 여기까지야!

꼬리말을 불러오는 중...