【完全ガイド】PySide6で実装するタスク管理アプリ開発

デスクトップアプリケーション開発において、PySide6は最も強力で実用的な選択肢の一つです。
この記事では、PySide6を使用してシンプルながら実用的なタスク管理アプリケーションを作成する方法を、完全初心者でも理解できるよう丁寧に解説します。

完成版では、タスクの追加・削除・完了状態の管理、そしてデータの自動保存機能を持つ本格的なアプリケーションを作成します。

PySide6公式ドキュメント

Qt for Pythonの公式ドキュメント。PySide6の詳細な機能とAPIリファレンス

doc.qt.io

PySide6とは？

なぜPySide6を選ぶのか？

PySide6は、Qt 6フレームワークのPythonバインディングです。Nokia（現Qt Company）が開発する20年以上の歴史を持つ成熟したフレームワークで、Windows、macOS、Linuxで同じコードが動作するクロスプラットフォーム対応が特徴です。

Python GUI開発において、TkinterやKivyなど複数の選択肢がありますが、PySide6が特に優れているのはネイティブな外観です。各OS標準のデザインガイドラインに従った自然な見た目で、ユーザーに違和感を与えません。また、C++で実装されたQtの性能をそのまま活用できるため、Pythonコードでありながら高速なアプリケーションを作成できます。

開発効率の面でも大きなメリットがあります。同じ機能を実装する場合、Tkinterに比べて、PySide6では半分程度で済むことが多く、開発時間を大幅に短縮できます。さらに、100種類以上の豊富なウィジェットが用意されているため、ボタンやリスト、テーブルなどの高機能なUI要素を簡単に組み込めます。

ライセンス面でも重要な優位性があります。PySide6はLGPL v3ライセンスのため商用利用に制限がありませんが、類似のPyQt6はGPLライセンスのため商用プロジェクトでは制約があります。このため、将来的にアプリケーションを商用展開する可能性がある場合、PySide6が安全な選択となります。

VLC Media Player、VirtualBox、Autodesk Mayaなど、世界的に有名なソフトウェアがQtフレームワークを採用していることも、その信頼性と実績を物語っています。

 

環境準備・インストール

まず、PySide6をインストールします。Python 3.7以上が必要です。

# PySide6のインストール
pip install PySide6

# インストール確認
python -c "import PySide6; print('PySide6 installed successfully!')"

 

【開発ステップ①】メインウィンドウ作成

最初に、アプリケーションの基盤となるメインウィンドウを作成します。

メインウィンドウ

# task_manager.py
import sys
from PySide6.QtWidgets import QApplication, QMainWindow, QVBoxLayout, QWidget

class TaskManagerApp(QMainWindow):
    def __init__(self):
        super().__init__()
        self.init_ui()
    
    def init_ui(self):
        """UIの初期設定"""
        # ウィンドウの基本設定
        self.setWindowTitle('タスク管理アプリ')
        self.setGeometry(100, 100, 400, 500) # x, y, width, height
        
        # 中央ウィジェットの設定
        central_widget = QWidget()
        self.setCentralWidget(central_widget)
        
        # レイアウト設定
        self.main_layout = QVBoxLayout()
        central_widget.setLayout(self.main_layout)

def main():
    """アプリケーションのメイン実行関数"""
    app = QApplication(sys.argv)
    
    # アプリケーションウィンドウを作成
    task_app = TaskManagerApp()
    task_app.show()
    
    # イベントループの開始
    sys.exit(app.exec())

# アプリケーションの実行
if __name__ == "__main__":
    main()

この時点でアプリケーションを実行してみましょう。

python task_manager.py

空の400×500ピクセルのウィンドウが表示されます。これがアプリケーションの基盤となるメインウィンドウです。

【開発ステップ②】タスクUI要素の追加

開発ステップ①の基本ウィンドウにタスク管理に必要なUI要素を追加します。

タスク入力エリアの追加

開発ステップ①のコードに以下のメソッドを追加します。

def create_input_section(self):
    """タスク入力セクションの作成"""
    # ラベル
    input_label = QLabel("新しいタスク：")
    self.main_layout.addWidget(input_label)
    
    # 入力欄とボタンの横並びレイアウト
    input_layout = QHBoxLayout()
    
    # テキスト入力欄
    self.task_input = QLineEdit()
    self.task_input.setPlaceholderText("タスクを入力してください")
    input_layout.addWidget(self.task_input)
    
    # 追加ボタン
    self.add_button = QPushButton("追加")
    self.add_button.setFixedWidth(80)
    input_layout.addWidget(self.add_button)
    
    # 横並びレイアウトをメインレイアウトに追加
    input_widget = QWidget()
    input_widget.setLayout(input_layout)
    self.main_layout.addWidget(input_widget)

 

タスクリストエリアの追加

def create_task_list_section(self):
    """タスクリストセクションの作成"""
    # ラベル
    list_label = QLabel("タスクリスト：")
    self.main_layout.addWidget(list_label)
    
    # タスクリスト
    self.task_list = QListWidget()
    self.task_list.setAlternatingRowColors(True)  # 行の色を交互に変更
    self.task_list.setSelectionMode(
        QAbstractItemView.SelectionMode.ExtendedSelection
    )
    self.main_layout.addWidget(self.task_list)
    
    # 削除ボタン
    self.delete_button = QPushButton("選択したタスクを削除")
    self.delete_button.setEnabled(False)  # 初期状態では無効
    self.main_layout.addWidget(self.delete_button)

そして、init_ui()メソッドの最後に以下を追加します。

def init_ui(self):
    # ...既存のコード...
    
    # UI要素の作成を追加
    self.create_input_section()
    self.create_task_list_section()

この段階で、視覚的に完成されたUIが表示されます。

【開発ステップ③】基本機能の実装

UIができたので、実際にタスクを管理する機能を実装します。このステップでは、イベント処理とデータ管理の基本を学びます。

まず、開発ステップ②のUIコードにイベント処理を追加します。

イベント接続メソッドの追加

既存のUIコードに以下のメソッドを追加します。

def connect_events(self):
    """シグナルをスロットに接続"""
    # 追加ボタンクリック時
    self.add_button.clicked.connect(self.add_task)
    
    # Enterキー押下時（入力欄）
    self.task_input.returnPressed.connect(self.add_task)
    
    # リストアイテム選択時
    self.task_list.itemSelectionChanged.connect(self.on_selection_changed)
    
    # 削除ボタンクリック時
    self.delete_button.clicked.connect(self.delete_task)

そして、init_ui()メソッドの最後に以下を追加します。

def init_ui(self):
    # ...既存のコード...
    
    # イベント接続を追加
    self.connect_events()

 

タスク追加機能の実装

次に、実際にタスクを追加する処理を実装します。

def add_task(self):
    """タスクを追加する"""
    # 入力欄からテキストを取得
    task_text = self.task_input.text().strip()
    
    # 空文字チェック
    if not task_text:
        return
    
    # リストに追加
    self.task_list.addItem(task_text)
    
    # 入力欄をクリア
    self.task_input.clear()
    
    # 入力欄にフォーカスを戻す
    self.task_input.setFocus()
    
    print(f"タスク追加: {task_text}")

 

タスクの選択状態管理と削除機能の実装

続いて、タスクの選択状態管理と削除機能を実装します。

def on_selection_changed(self):
    """リストの選択状態が変更された時"""
    # 選択されているアイテムがあるかチェック
    has_selection = len(self.task_list.selectedItems()) > 0
    
    # 削除ボタンの有効/無効を切り替え
    self.delete_button.setEnabled(has_selection)

def delete_task(self):
    """選択されたタスクを削除する"""
    # 選択されているアイテムを取得
    selected_items = self.task_list.selectedItems()
    
    if not selected_items:
        return
    
    # 選択されたアイテムを削除
    for item in selected_items:
        row = self.task_list.row(item)
        self.task_list.takeItem(row)
        print(f"タスク削除: {item.text()}")

これで基本的なタスク管理機能が動作するようになりました。

 

【開発ステップ④】チェックボックス機能の追加

基本的なタスク管理機能に加えて、タスクの完了状態を視覚的に管理できるチェックボックス機能を実装します。

カスタムウィジェットの作成

開発ステップ③のadd_task()メソッドを以下のように変更します。

def add_task(self):
    """タスクを追加する"""
    # 入力欄からテキストを取得
    task_text = self.task_input.text().strip()
    
    # 空文字チェック
    if not task_text:
        return
    
    # カスタムウィジェット（チェックボックス付き）を作成
    self.create_task_item(task_text)
    
    # 入力欄をクリア
    self.task_input.clear()
    
    # 入力欄にフォーカスを戻す
    self.task_input.setFocus()
    
    print(f"タスク追加: {task_text}")

 

チェックボックス付きタスクアイテムの実装

新しく以下のメソッドを追加します。

def create_task_item(self, task_text):
    """チェックボックス付きのタスクアイテムを作成"""
    # リストアイテムを作成
    list_item = QListWidgetItem()
    
    # チェックボックス付きウィジェットを作成
    task_widget = QWidget()
    task_layout = QHBoxLayout()
    task_layout.setContentsMargins(5, 2, 5, 2)  # 余白を設定
    
    # チェックボックス
    checkbox = QCheckBox()
    checkbox.stateChanged.connect(lambda state, item=list_item: self.on_task_completed(state, item))
    task_layout.addWidget(checkbox)
    
    # タスクテキストラベル
    task_label = QLabel(task_text)
    task_layout.addWidget(task_label)
    
    # 右側に余白を追加
    task_layout.addStretch()
    
    task_widget.setLayout(task_layout)
    
    # リストアイテムのサイズを設定
    list_item.setSizeHint(task_widget.sizeHint())
    
    # リストに追加
    self.task_list.addItem(list_item)
    self.task_list.setItemWidget(list_item, task_widget)
    
    # タスクテキストをアイテムに保存（削除時に使用）
    list_item.setData(Qt.ItemDataRole.UserRole, task_text)

 

（補足）データの管理とQt.ItemDataRole.UserRole

このタスク管理アプリでは、各タスクが2つの要素（表示用のウィジェット（チェックボックスとテキスト）とデータ）で構成されています。

list_item.setData(Qt.ItemDataRole.UserRole, task_text)は、リストアイテムにタスクのテキストデータを保存するメソッドです。なぜこれが必要かというと、ユーザーがタスクを削除したい時に「どのタスクを削除するか」を特定する必要があるためです。

Qt.ItemDataRole.UserRoleは、Qtフレームワークが内部で使用する領域とは別の開発者が自由に使える保存領域です。これにより、表示されている内容とは独立してデータを安全に管理できます。

つまり、見た目（ウィジェット）とデータ（テキスト）を分離することで、削除時やその他の操作時に正確な情報を取得できる仕組みになっています。

 

完了状態の処理と見た目の更新

チェックボックスの状態変化を処理するメソッドを追加します。

def on_task_completed(self, state, item):
    """タスクの完了状態が変更された時"""
    task_text = item.data(Qt.ItemDataRole.UserRole)
    
    # 完了状態を判定
    completed = state == Qt.CheckState.Checked.value

    if completed:
        print(f"タスク完了: {task_text}")

    else:
        print(f"タスク未完了: {task_text}")

    # 見た目を更新
    self.update_task_appearance(item, completed=completed)

def update_task_appearance(self, item, completed):
    """タスクの見た目を更新（完了/未完了）"""
    widget = self.task_list.itemWidget(item)
    if widget:
        # ラベルを取得（レイアウトの2番目の要素）
        label = widget.layout().itemAt(1).widget()
        if completed:
            # 完了時: 取り消し線 + グレーアウト
            label.setStyleSheet("text-decoration: line-through; color: gray;")
        else:
            # 未完了時: 通常表示
            label.setStyleSheet("")

 

削除機能の更新

既存のdelete_task()メソッドも、新しいデータ保存方法に対応するよう更新が必要です：

def delete_task(self):
    """選択されたタスクを削除する"""
    selected_items = self.task_list.selectedItems()
    
    if not selected_items:
        return
    
    # 選択されたアイテムを削除
    for item in selected_items:
        task_text = item.data(Qt.ItemDataRole.UserRole)  # 保存されたタスクテキストを取得
        row = self.task_list.row(item)
        self.task_list.takeItem(row)
        print(f"タスクを削除しました: {task_text}")

この段階で実行すると、以下の機能が利用できます。

 

【開発ステップ⑤】データの永続化

これまでのタスク管理アプリは、アプリを閉じるとすべてのタスクが消えてしまいます。最後のステップとして、タスクをJSONファイルに保存・読み込みする機能を実装し、データを永続化させます。

データファイルの設定

__init__メソッドにデータファイルの設定を追加します。

def __init__(self):
    super().__init__()
    self.data_file = "tasks.json"  # データファイル名
    self.init_ui()
    self.load_tasks()  # アプリ起動時にタスクを読み込む

 

データの保存機能

タスクをJSONファイルに保存するsave_tasks()メソッドを追加します。

def save_tasks(self):
    """タスクをJSONファイルに保存"""
    tasks = []
    
    # 現在のタスクリストからデータを収集
    for i in range(self.task_list.count()):
        item = self.task_list.item(i)
        task_data = item.data(Qt.ItemDataRole.UserRole)
        if task_data:
            tasks.append(task_data)
    
    try:
        # JSONファイルに保存
        with open(self.data_file, "w", encoding="utf-8") as f:
            json.dump(tasks, f, ensure_ascii=False, indent=2)
            print(f"タスク保存：{len(tasks)}件")
            
    except Exception as e:
        print(f"保存エラー：{e}")

 

データの読み込み機能

アプリ起動時に保存されたタスクを読み込むload_tasks()メソッドを追加します。

def load_tasks(self):
    """JSONファイルからデータを読み込む"""
    if not os.path.exists(self.data_file):
        print("データファイルが存在しません")
        return
    
    try:
        with open(self.data_file, "r", encoding="utf-8") as f:
            tasks = json.load(f)
        
        for task_data in tasks:
            text = task_data.get("text", "")
            completed = task_data.get("completed", False)
            if text:  # 空でないタスクを追加
                self.create_task_item(text, completed)
        
        print(f"タスクを読み込み：{len(tasks)}件")
        
    except Exception as e:
        print(f"読み込みエラー：{e}")

 

既存メソッドの修正

データを永続化するため、タスクの追加・削除・状態変更時に保存処理を追加します。

①タスク追加時の保存

add_task()メソッドに保存処理を追加

def add_task(self):
    # ... 既存の処理 ...
    
    # タスクを保存
    self.save_tasks()
    
    print(f"タスク追加: {task_text}")

②タスク削除時の保存

delete_task()メソッドに保存処理を追加

def delete_task(self):
    # ... 既存の削除処理 ...
    
    self.save_tasks()

③チェックボックス状態変更時の保存

on_task_completed()メソッドに保存処理を追加

def on_task_completed(self, state, item):
    # ... 既存の処理 ...
    
    # データを更新して保存
    task_data["completed"] = completed
    item.setData(Qt.ItemDataRole.UserRole, task_data)
    self.save_tasks()

 

データ構造の変更

開発ステップ④では単純な文字列でしたが、完了状態も保存するため辞書形式に変更します。

# 変更前（開発ステップ④）
list_item.setData(Qt.ItemDataRole.UserRole, task_text)

# 変更後（開発ステップ⑤）
list_item.setData(Qt.ItemDataRole.UserRole, {"text": task_text, "completed": completed})

 

create_task_item()メソッドの更新

読み込み時に完了状態を反映できるよう、completedパラメータを追加

def create_task_item(self, task_text, completed=False):
    # ... 既存のウィジェット作成処理 ...
    
    # チェックボックス
    checkbox = QCheckBox()
    checkbox.setChecked(completed)  # 読み込み時の状態を設定
    
    # ... 残りの処理 ...
    
    # タスクテキストと完了状態をアイテムに保存
    list_item.setData(Qt.ItemDataRole.UserRole, {"text": task_text, "completed": completed})
    
    # 見た目を状態に合わせて更新
    self.update_task_appearance(list_item, completed=completed)

この段階で実行すると、以下の機能が利用できます。

 

完成したコード

これまでの全ステップを統合した最終的なコードです。

import json
import os
import sys

from PySide6.QtCore import Qt
from PySide6.QtWidgets import (
    QAbstractItemView,
    QApplication,
    QCheckBox,
    QHBoxLayout,
    QLabel,
    QLineEdit,
    QListWidget,
    QListWidgetItem,
    QMainWindow,
    QPushButton,
    QVBoxLayout,
    QWidget,
)


class TaskManagerApp(QMainWindow):
    def __init__(self):
        super().__init__()
        self.data_file = "tasks.json"  # データファイル名
        self.init_ui()
        self.load_tasks()  # アプリ起動時にタスクを読み込む

    def init_ui(self):
        # 基本設定
        self.setWindowTitle("タスク管理アプリ")
        self.setGeometry(100, 100, 400, 500)

        # 中央ウィジェット設定
        central_widget = QWidget()
        self.setCentralWidget(central_widget)

        # メインレイアウト
        self.main_layout = QVBoxLayout()
        central_widget.setLayout(self.main_layout)

        # UI要素の作成
        self.create_input_section()
        self.create_task_list_section()

        # イベント接続
        self.connect_events()

    def create_input_section(self):
        """入力セクション"""
        # ラベル
        input_label = QLabel("新しいタスク")
        self.main_layout.addWidget(input_label)

        # 入力値とボタンの横並びレイアウト
        input_layout = QHBoxLayout()

        # テキスト入力値
        self.task_input = QLineEdit()
        self.task_input.setPlaceholderText("タスクを入力してください")
        input_layout.addWidget(self.task_input)

        # 追加ボタン
        self.add_button = QPushButton("追加")
        self.add_button.setFixedWidth(80)
        input_layout.addWidget(self.add_button)

        # 横並びのレイアウトをメインレイアウトに追加
        input_widget = QWidget()
        input_widget.setLayout(input_layout)
        self.main_layout.addWidget(input_widget)

    def create_task_list_section(self):
        """リストセクション"""
        # ラベル
        list_label = QLabel("タスクリスト")
        self.main_layout.addWidget(list_label)

        # タスクリスト
        self.task_list = QListWidget()
        self.task_list.setAlternatingRowColors(True)
        self.task_list.setSelectionMode(
            QAbstractItemView.SelectionMode.ExtendedSelection
        )
        self.main_layout.addWidget(self.task_list)

        # 削除ボタン
        self.delete_button = QPushButton("削除（複数選択可）")
        self.delete_button.setEnabled(False)
        self.main_layout.addWidget(self.delete_button)

    def connect_events(self):
        """イベントを関数に接続"""
        # 追加ボタンをクリック時
        self.add_button.clicked.connect(self.add_task)

        # Enterキーを押下時（入力欄）
        self.task_input.returnPressed.connect(self.add_task)

        # リストのタスクを選択時
        self.task_list.itemSelectionChanged.connect(self.on_selection_changed)

        # 削除ボタンをクリック時
        self.delete_button.clicked.connect(self.delete_task)

    def add_task(self):
        """タスクを追加"""
        # 入力値からテキストを取得
        task_text = self.task_input.text().strip()

        # 空文字をチェック
        if not task_text:
            return

        # リストに追加
        self.create_task_item(task_text)

        # 入力値をクリア
        self.task_input.clear()

        # 入力欄にフォーカスを戻す
        self.task_input.setFocus()

        # タスクを保存
        self.save_tasks()

        print(f"タスク追加: {task_text}")

    def create_task_item(self, task_text, completed=False):
        """チェックボックス付きのタスクアイテムを作成"""
        # リストアイテムを作成
        list_item = QListWidgetItem()

        # チェックボックス付きウィジェットを作成
        task_widget = QWidget()
        task_layout = QHBoxLayout()
        task_layout.setContentsMargins(5, 2, 5, 2)

        # チェックボックス
        checkbox = QCheckBox()
        checkbox.setChecked(completed)  # 読み込み時の状態を設定
        checkbox.stateChanged.connect(
            lambda state, item=list_item: self.on_task_completed(state, item)
        )
        task_layout.addWidget(checkbox)

        # タスクテキストラベル
        task_label = QLabel(task_text)
        task_layout.addWidget(task_label)

        # 右側に余白を追加
        task_layout.addStretch()

        # ウィジェットにレイアウトを設定
        task_widget.setLayout(task_layout)

        # リストアイテムのサイズ設定
        list_item.setSizeHint(task_widget.sizeHint())

        # リストに追加
        self.task_list.addItem(list_item)
        self.task_list.setItemWidget(list_item, task_widget)

        # タスクテキストと完了状態をアイテムに保存
        list_item.setData(Qt.ItemDataRole.UserRole, {"text": task_text, "completed": completed})

        # 見た目を状態に合わせて更新
        self.update_task_appearance(list_item, completed=completed)

    def on_task_completed(self, state, item):
        """タスクの完了状態が変更された時"""
        task_data = item.data(Qt.ItemDataRole.UserRole)
        task_text = task_data["text"]

        # 完了状態を判定
        completed = state == Qt.CheckState.Checked.value

        if completed:
            print(f"タスク完了: {task_text}")
        else:
            print(f"タスク未完了: {task_text}")

        # 見た目を更新
        self.update_task_appearance(item, completed=completed)

        # データを更新して保存
        task_data["completed"] = completed
        item.setData(Qt.ItemDataRole.UserRole, task_data)
        self.save_tasks()

    def update_task_appearance(self, item, completed):
        """タスクの見た目を更新（完了/未完了）"""
        widget = self.task_list.itemWidget(item)
        if widget:
            # ラベルを取得（レイアウトの2番目の要素）
            label = widget.layout().itemAt(1).widget()
            if completed:
                # 完了時: 取り消し線 + グレーアウト
                label.setStyleSheet("text-decoration: line-through; color: gray;")
            else:
                # 未完了時: 通常表示
                label.setStyleSheet("")

    def on_selection_changed(self):
        """リストの選択状態が変更された時"""
        # タスクがあるかチェック
        has_selection = len(self.task_list.selectedItems()) > 0

        # 削除ボタンの切り替え
        self.delete_button.setEnabled(has_selection)

    def delete_task(self):
        """選択したタスクを削除する"""
        # 選択されているタスクを取得する
        selected_task = self.task_list.selectedItems()

        if not selected_task:
            return

        # 選択されたタスクを削除する
        for task in selected_task:
            task_data = task.data(Qt.ItemDataRole.UserRole)
            task_text = task_data["text"]
            row = self.task_list.row(task)
            self.task_list.takeItem(row)
            print(f"タスク削除：{task_text}")

        self.save_tasks()

    def save_tasks(self):
        """タスクをJSONファイルに保存"""
        tasks = []

        # 現在のタスクリストからデータを収集
        for i in range(self.task_list.count()):
            item = self.task_list.item(i)
            task_data = item.data(Qt.ItemDataRole.UserRole)
            if task_data:
                tasks.append(task_data)

        try:
            # JSONファイルに保存
            with open(self.data_file, "w", encoding="utf-8") as f:
                json.dump(tasks, f, ensure_ascii=False, indent=2)
                print(f"タスク保存：{len(tasks)}件")

        except Exception as e:
            print(f"保存エラー：{e}")

    def load_tasks(self):
        """JSONファイルからデータを読み込む"""
        if not os.path.exists(self.data_file):
            print("データファイルが存在しません")
            return

        try:
            with open(self.data_file, "r", encoding="utf-8") as f:
                tasks = json.load(f)

            for task_data in tasks:
                text = task_data.get("text", "")
                completed = task_data.get("completed", False)
                if text:  # 空でないタスクを追加
                    self.create_task_item(text, completed)

            print(f"タスクを読み込み：{len(tasks)}件")

        except Exception as e:
            print(f"読み込みエラー：{e}")


def main():
    app = QApplication(sys.argv)

    # アプリケーションウィンドウを作成
    window = TaskManagerApp()
    window.show()

    # イベントループの開始
    sys.exit(app.exec())


if __name__ == "__main__":
    main()

まとめ

基本的なタスク管理機能とチェックボックス機能、そしてデータの永続化が完成しました！この記事で学んだ技術を応用すれば、さらに高度な機能を追加できます：

• タスクの優先度設定
• 期日管理機能
• 検索・フィルタリング機能
• 異なるファイル形式での保存（CSV、XMLなど）

より高度なPySide6アプリケーションに興味がある方は、以下のポートフォリオをご覧ください。

RX Scanner - 処方箋OCRアプリケーション

Tesseract OCRを活用した医療機関向け処方箋画像認識・薬剤データ管理デスクトップアプリケーション。PySide6、OpenCV、SQLiteを使用した実践的なプロジェクト

---

PySide6公式ドキュメント - Qt for Python

PySide6の公式ドキュメント。より高度なウィジェットと機能を学べる包括的なリファレンス

docs.python.org