파이썬 웹 브라우저 – PySide6으로 주소창과 확대/축소 기능 추가하기

PySide6으로 나만의 파이썬 웹브라우저 만들기

파이썬으로 웹 브라우저를 직접 만들고, 웹 브라우저 상단에 주소창과 확대/축소기능을 구현할 수 있는 코드 자료입니다. 웹 브라우저 제작 시 자주 사용되는 코드이기도 합니다. 웹 브라우저는 우리가 일상적으로 사용하는 크롬(Chrome), 엣지(Edge), 파이어폭스(Firefox)와 같은 프로그램들입니다.

이 프로그램들은 웹 서버에서 받은 HTML, CSS, JavaScript를 해석하여 우리가 보는 웹 페이지 형태로 표시해줍니다. 이번 글에서는 직접 웹브라우저를 파이썬으로 제작하고 웹 주소(URL)를 입력하고, 페이지를 확대하거나 축소할 수 있는 기능을 갖춘 주소창과 줌 컨트롤 패널을 만드는 방법을 소개합니다.

PySide6으로 나만의 파이썬 웹브라우저 만들기

파이썬에서는 다음과 같은 다양한 방법으로 웹 브라우저 기능을 구현할 수 있습니다:

PyQt5 / PySide6 파이썬 GUI 라이브러리

PyQt5 / PySide6 둘 다 Qt라는 GUI 프레임워크를 파이썬에서 사용할 수 있게 해주는 라이브러리입니다. 파이썬으로 프로그램을 만들다 보면 단순한 텍스트 기반 콘솔 화면만으로는 부족할 때가 있습니다. 이럴 때 "윈도우 창이 있는 프로그램", 즉 그래픽 사용자 인터페이스(GUI)가 필요할 때가 있는데, 그럴 때 사용하는 대표적인 파이썬 도구가 바로 PyQt5와 PySide6입니다.

항목	PyQt5	PySide6
개발사	Riverbank	Qt Company (Qt 공식)
라이선스	GPL 또는 상용	LGPL (상업용에도 자유롭게 사용 가능)
버전	Qt 5 기반	Qt 6 기반
설치	pip install pyqt5	pip install pyside6
기능	거의 동일 (버튼, 창, 입력창, 레이아웃 등 모두 가능)	거의 동일 (버튼, 창, 입력창, 레이아웃 등 모두 가능)

개인 학습 및 오픈소스 프로젝트에 적합한 선택

• 개인 공부용, 오픈소스 프로젝트라면 둘 중 아무거나 써도 괜찮습니다.
• 상업용 소프트웨어를 만들 예정이라면 PySide6이 더 유리합니다. 라이선스 제한이 덜합니다.
• 최신 기술과 장기적인 지원을 고려한다면 PySide6이 더 추천됩니다. (Qt 6 기반)

반응형

Qt 프레임워크로 GUI 애플리케이션 개발하기

• Qt 프레임워크 기반 GUI 애플리케이션을 만들 수 있는 도구입니다.
• 내부적으로 QWebEngineView 라는 웹 뷰 컴포넌트를 사용해 웹페이지를 표시할 수 있습니다.
• 실제로 크롬 엔진(Chromium) 을 기반으로 하기에 매우 강력합니다.

가장 추천하는 방법은 PySide6 또는 PyQt5를 활용하는 것입니다. 이 방식은 크롬 기반 웹 뷰를 사용할 수 있고, 사용자가 직접 조작할 수 있는 브라우저 형태로 만들 수 있습니다.

• URL 입력창 만들기
• 이전/다음 이동, 새로고침 버튼 구현
• 페이지 확대/축소 (Zoom In/Out) 기능 추가
• 주소 자동 업데이트 구현

[ 이미지 변환 툴 소개 ] 포토샵 없이 블로그에 활용할 이미지를 손쉽게 변환하는 팁

코딩하기

1. PySide6 설치

pip install PySide6

2. 웹 엔진 모듈 포함 확인

PySide6에는 웹 브라우저를 구성할 수 있는 QWebEngineView가 포함되어 있습니다.

3. 전체 코드 예제 (주소창 + 줌 컨트롤)

from PySide6.QtWidgets import (
    QWidget, QVBoxLayout, QHBoxLayout,
    QPushButton, QLineEdit
)
from PySide6.QtWebEngineWidgets import QWebEngineView
from PySide6.QtCore import QUrl

class BrowserWidget(QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("PySide6 웹 브라우저")
        self.resize(1000, 800)

        self.webview = QWebEngineView()
        self.webview.setUrl(QUrl("https://www.google.com"))

        layout = QVBoxLayout(self)
        layout.addWidget(self._create_url_input_with_zoom(self.webview, "URL을 입력하세요..."))
        layout.addWidget(self.webview)

    def _load_url(self, webview, url_input):
        url = url_input.text()
        if not url.startswith("http"):
            url = "https://" + url
        webview.setUrl(QUrl(url))

    def _create_url_input_with_zoom(self, webview, placeholder):
        widget = QWidget()
        layout = QVBoxLayout(widget)
        layout.setContentsMargins(5, 5, 5, 5)
        widget.setFixedHeight(90)

        # 네비게이션 버튼 바
        nav_bar = QHBoxLayout()
        buttons = [
            ("←", webview.back),
            ("→", webview.forward),
            ("↻", webview.reload),
            ("-", lambda: webview.setZoomFactor(webview.zoomFactor() - 0.1)),
            ("+", lambda: webview.setZoomFactor(webview.zoomFactor() + 0.1)),
        ]

        for i, (text, action) in enumerate(buttons):
            btn = QPushButton(text)
            btn.setFixedSize(40, 30)
            btn.clicked.connect(action)
            nav_bar.addWidget(btn)
            if i == 2:
                nav_bar.addStretch()

        # URL 입력 필드
        url_input = QLineEdit()
        url_input.setPlaceholderText(placeholder)
        url_input.setFixedHeight(50)
        url_input.returnPressed.connect(lambda: self._load_url(webview, url_input))

        layout.addLayout(nav_bar)
        layout.addWidget(url_input)

        def update_url():
            url_input.setText(webview.url().toString())
            nav_bar.itemAt(0).widget().setEnabled(webview.history().canGoBack())
            nav_bar.itemAt(1).widget().setEnabled(webview.history().canGoForward())

        webview.urlChanged.connect(update_url)
        webview.loadFinished.connect(update_url)
        update_url()

        return widget

파이썬 코드 설명

QWebEngineView란?

QWebEngineView는 웹 브라우저처럼 웹 페이지를 표시할 수 있게 해주는 위젯입니다. 구글, 네이버, 유튜브 등 실제 웹사이트를 그대로 표시할 수 있어요. 단 완벽하지는 않습니다.

URL 입력창 (QLineEdit)

• 사용자가 웹 주소를 입력하는 곳입니다.
• returnPressed.connect()를 사용해 엔터를 누르면 입력된 URL로 이동하게 만듭니다.
• 주소창에 https://가 없으면 자동으로 붙여줍니다.

뒤로, 앞으로, 새로고침 버튼

• 각각 웹브라우저의 기본 기능과 연결합니다.
  • webview.back()
  • webview.forward()
  • webview.reload()

화면 확대/축소 (Zoom In/Out)

• webview.zoomFactor()를 기준으로 배율을 조절합니다.
• 기본 배율은 1.0 (100%)이고, 여기에 +0.1 또는 -0.1씩 가감합니다.
• 예: 1.2면 120%, 0.8이면 80%

주소 자동 갱신

웹 페이지를 이동할 때마다 주소창이 자동으로 바뀌게 하기 위해 다음 시그널을 연결합니다:

webview.urlChanged.connect(update_url)
webview.loadFinished.connect(update_url)

실행 코드

아래 코드를 추가하면 브라우저를 실행할 수 있습니다.

if __name__ == "__main__":
    import sys
    from PySide6.QtWidgets import QApplication

    app = QApplication(sys.argv)
    browser = BrowserWidget()
    browser.show()
    sys.exit(app.exec())