1.1　PySimpleGUIとは

　PySimpleGUIは、GUIを作成するためのPythonのサードパーティーライブラリーです。サードパーティーライブラリーとは、Pythonをインストールしただけでは使えない外部ライブラリーで、各自でインストールして使う必要があります。インストール方法については、1.4節で説明します。

1.2　なぜPySimpleGUIなのか

　PythonでGUIを作成するライブラリーは、他にもいくつかあります。有名なところではtkinterがあります。tkinterはPythonの標準ライブラリーに含まれているため、インストールしなくてもimportするだけで使えるメリットがあります。

　しかし、tkinterはGUI部品の設定が少し複雑で、部品サイズを意識して配置していく必要があります。設定や呼び出しの構文も直感的ではなく、作りたい部品の種類ごとに書き方を習得していく必要があるため、その都度学習コストがかかります。

　ここで、tkinterとPySimpleGUIを比較してみましょう。

　次の図は、テキストボックスとボタンだけの簡単な名前入力アプリです。テキストボックスに文字列を入力して「Submit」ボタンをクリックすると、その結果をポップアップウィンドウに表示します。左がtkinterで作ったもので、右がPySimpleGUIで作ったものです。

　どちらも、色やフォントなどの見た目はデフォルト設定です。見た目の好みはあるかもしれませんが、PySimpleGUIの方が色がついていて、見た目がいい感じです。もちろんtkinterも設定をすれば、同じように色をつけたGUIを作ることができますが、その分コードが長くなります。

　次に、この部品を作るためのコードを比較してみましょう。コードの中身については3章で説明しますので、ここでは内容は理解できなくても問題ありません。

　これはtkinter版のコードです。コードの長さは26行です。

リスト1.1: 1_name_app_tkinter.py

import tkinter as tk
from tkinter import messagebox

def clicked():
  messagebox.showinfo(
    '', f'あなたの名前は {entry_1.get()} です'
    )

root = tk.Tk()
root.geometry('250x120')
root.title('名前入力アプリ')

label_1 = tk.Label(root, text='名前を入力してください')
entry_1 = tk.Entry(root, width=20)
button_1 = tk.Button(root, text='Submit', command=clicked)
root.columnconfigure(0, weight=1)

root.rowconfigure(0, weight=1)
root.rowconfigure(1, weight=1)
root.rowconfigure(2, weight=1)

label_1.grid(column=0, row=0, sticky='s')
entry_1.grid(column=0, row=1)
button_1.grid(column=0, row=2, sticky='n')

root.mainloop()

　次は、PySimpleGUIで書いたコードです。

リスト1.2: 1_name_app_pysimplegui.py

import PySimpleGUI as sg

layout = [
    [sg.Text('名前を入力してください')],
    [sg.Input()],
    [sg.Button('Submit')],
    ]

window = sg.Window('名前入力アプリ', layout)

while True:
    event, values = window.read()
    if event == sg.WIN_CLOSED:
        break
    if event == 'Submit':
        sg.popup(f'あなたの名前は {values[0]} です', title='')

window.close()

　tkinterの26行に対して、PySimpleGUIは18行で書けます。tkinterはウィンドウ内の部品の配置場所やサイズを指定する必要がありますが、PySimpleGUIは部品をリストとして並べるだけなので、コードもtkinterよりもスッキリしていて直感的に書けます。

　このように、PySimpleGUIは直感的かつ短いコードでGUIが作れます。ノンプログラマーが作りたいのは作業を自動化・効率化するためのツールであり、一般に販売するようなツールではないと思います。GUI作成のためのコード作成に時間をかけることなく、必要な機能が実現できるプログラムを速く作れる方がいいですよね。

　よって、PySimpleGUIはPythonでデスクトップアプリを作りたいノンプログラマーに適しているライブラリーだと言えます。

1.3　開発環境

　次に、PySimpleGUIの開発環境について説明します。

　この本では、以下の環境で実行確認しています。

　・OS：Windows11

　・Pythonバージョン：3.12.4

　・PySimpleGUIバージョン：5.0.6

　この本ではWindows11で実行していますが、LinuxやmacOSでもPython環境があれば同じコードで実行できます。OSやバージョンにより、この本の画像とGUIの見た目が少し変わる可能性はありますが、GUIの機能は変わりません。

　Pythonのバージョンは、2024年7月時点の最新バージョン3.12.4を使っています。ただし、PySimpleGUIはPython3.4以降に対応しているため、お使いのPythonバージョンが3.4以降であれば問題なく実行できます。

　Anaconda環境でも使えます。Anaconda環境は次節で説明するインストール時のコマンドが公式Pythonと違いますが、コードの書き方や実行結果は変わりません。

　2024年7月時点のPySimpleGUIの最新バージョンは、5.0.6です。バージョン5以降はライセンス登録が必要です。

　個人利用であればライセンスは無料ですが、商用利用ではライセンス料がかかります。ライセンス料と個人利用、商用利用の違いについては、公式Webサイト（https://www.pysimplegui.com/pricing）を参照ください。

　個人利用でも商用利用でも、アカウント登録とライセンスキーの設定が必要です。設定方法は次節で説明します。

　もしアカウント登録をせずに使いたい場合は、ライセンス登録が不要なバージョン4台の最終版である4.60.5を使うことも可能ですが、すでにバージョン4台はサポートが停止されています。将来的に使えなくなる可能性もあるため、ご注意ください。バージョン5はバージョン4台と互換性があるため、本書のコードはバージョン4.60.5でも問題なく動作します。

　コードは普段使っている環境で実行できます。プロンプトからの実行、IDLE・PyCharm・VS Codeなどの統合開発環境、Jupyter NotebookやJupyter Labなど、パソコン上の環境であればいずれの環境でも動作します。

　ただし、Google Colaboratoryのようなクラウド上で実行する環境では動作しません。PySimpleGUIはパソコン上で動作するデスクトップアプリであり、パソコンにインストールした環境でしか実行できないので、注意が必要です。

1.4　インストール方法

　次に、PySimpleGUIのインストール方法およびライセンス登録方法について説明します。インストール最初の1回だけでよいです。すでにインストールしてある環境であれば、importだけで使えます。

　Windowsの公式Python環境

python -m pip install pysimplegui

　Linux, macOSの公式Python環境

python3 -m pip install pysimplegui

　Anaconda環境

conda install -c conda-forge pysimplegui

　正しくインストールできているかは、以下のコマンドで確認します。

　公式Python環境

pip list

　Anaconda環境

conda list

　実行すると、以下の図のように、インストールしているライブラリーの一覧を表示します。この場合は、PySimpleGUIの5.0.6のインストールを確認できます。

　次に、ライセンス登録方法について説明します。

　インストールが完了したら、なんでもよいので、PySimpleGUIのライブラリーを使用したプログラムを実行します。すると、初回は以下のような画面が出てきます。

　「I accept the terms in the License Agreement」にチェックを入れて、OKをクリックします。

　この画面で「Register」をクリックするとブラウザーの登録画面が開くので、アカウント登録に進みます。

　なお、ここで「Free Trial」をクリックすると、30日はそのまま使用できますが、以下のようにメッセージが出ます。

　この場合は下に出ている「TRIAL PERIOD...」の赤い文字をクリックすると、ブラウザーで登録画面が開きます。

　次に、アカウント登録方法です。

　この本では、個人利用としての登録手順を説明します。ブラウザーの登録画面で左側の「Get Started For Hobbyists」をクリックします。

　クリックすると、このような画面が出てきます。

　チェックを入れて名前を記入して、「Submit」をクリックします。

　登録画面になるので、必要事項を記入します。GitHub IDは記入しなくても問題ありません。

　「Register」をクリックすると、以下の画面になります。

　先ほど登録したメールアドレスに届いているVerification Codeを入力し、「Validate Code」をクリックします。

　以下のようにライセンスキーが表示されます。なお、ライセンスキーはメールでも送られてきます。

　クリップボードにコピーし、最初の画面の下にある「Enter your Developer Key here」に貼り付けてOKをクリックすれば、ライセンス登録完了です。

　なお、最初に「Free Trial」を選択している場合は、ライセンス登録の画面が出てきませんので、以下の手順でライセンス登録します。

　まず、以下のコードを実行します。

import PySimpleGUI as sg

sg.main()

　すると、以下のようなGUIが表示されます。

　License Keyタブをクリックし、先ほど表示されていたライセンスキーを貼り付けて「Install」をクリックすれば、登録完了です。

　登録完了するとこのような画面が表示され、登録が完了しました。

　このウィンドウの下の「TRIAL PERIOD...」の文字は、トライアル登録していた場合のみ表示されます。

　ちなみに、ライセンスキーがわからなくなった場合は、PySimpleGUIのWebサイト（https://www.pysimplegui.com/）の右上にあるLoginボタンからメールアドレス、パスワードを入力すると再表示されます。

　これで、PySimpleGUIを使う準備ができました。2章では、PySimpleGUIでどんなGUIが作れるのかについて説明します。