🪟 PyGetWindowによるウィンドウ操作

📖 はじめに

PyGetWindowは、デスクトップ上で開いているウィンドウをPythonから検索・取得・操作するためのライブラリです。

例えば、次のような処理を実行できます。

開いているウィンドウの一覧を取得する
ウィンドウタイトルから対象を探す
現在アクティブなウィンドウを取得する
対象ウィンドウを前面へ移動する
最小化・最大化・復元を行う
ウィンドウを移動する
ウィンドウサイズを変更する
ウィンドウを閉じる

PyAutoGUIがマウスやキーボードを操作するライブラリであるのに対し、PyGetWindowはウィンドウそのものを探したり、位置や状態を変更したりするために使用します。

両者を組み合わせることで、対象ウィンドウを自動的に探して前面へ表示し、その中をPyAutoGUIで操作できます。

この記事ではWindows環境を対象に説明します。PyGetWindowはクロスプラットフォームを志向して作られていますが、公式版ではWindows向けの機能が中心です。

🧭 PyGetWindowの役割

GUI自動化では、操作を始める前に対象アプリケーションを前面へ表示する必要があります。

例えばPyAutoGUIで次のコードを実行すると、現在アクティブなウィンドウに対してキー入力が送られます。

import pyautogui

pyautogui.write("Hello")

対象のブラウザではなく、エディターやターミナルがアクティブになっていれば、そちらへ文字が入力されてしまいます。

そこでPyGetWindowを使用し、

対象ウィンドウを探す
最小化されていれば復元する
対象ウィンドウを前面へ表示する
PyAutoGUIで操作する

という流れを作ります。

PyGetWindow
    ↓
対象ウィンドウを探す
    ↓
前面へ表示する
    ↓
PyAutoGUI
    ↓
クリックやキー入力を行う

PyGetWindowとPyAutoGUIを組み合わせると、「実行前に対象アプリを手作業で選択しておく」という前提を減らせます。

📦 インストール

PyGetWindowはpipでインストールできます。

pip install pygetwindow

WindowsでPython Launcherを使用する場合は、次のように実行できます。

py -m pip install pygetwindow

仮想環境を使用している場合は、仮想環境を有効化してからインストールします。

.venv\Scripts\activate

python -m pip install pygetwindow

🔍 インストールを確認する

インストール後、Pythonからインポートできるか確認します。

import pygetwindow

print("PyGetWindowを利用できます。")

エラーが表示されなければ、インストールは完了しています。

通常は、次のように短い名前を付けてインポートします。

import pygetwindow as gw

この記事では、以降この書き方を使用します。

📋 開いているウィンドウのタイトルを取得する

現在開いているウィンドウのタイトル一覧はgetAllTitles()で取得できます。

import pygetwindow as gw


titles = gw.getAllTitles()

for title in titles:
    print(title)

実行すると、次のようなタイトルが表示されます。

BookStack - Google Chrome
メモ帳
Windows PowerShell
エクスプローラー

タイトルが空文字列になっているウィンドウも含まれる場合があります。

空のタイトルを除外するには、次のようにします。

import pygetwindow as gw


for title in gw.getAllTitles():
    if title:
        print(title)

ブラウザのウィンドウタイトルには、通常、現在表示しているページのタイトルとブラウザ名が含まれます。

🗂️ すべてのウィンドウを取得する

getAllWindows()を使用すると、ウィンドウタイトルだけでなく、ウィンドウを操作するためのオブジェクトを取得できます。

import pygetwindow as gw


windows = gw.getAllWindows()

for window in windows:
    print(window)

各ウィンドウのタイトルを表示する場合は、titleを参照します。

import pygetwindow as gw


for window in gw.getAllWindows():
    if window.title:
        print(window.title)

ウィンドウオブジェクトを取得すると、位置やサイズの確認、前面表示、移動などが可能になります。

🔎 タイトルからウィンドウを探す

タイトルに特定の文字列を含むウィンドウはgetWindowsWithTitle()で検索できます。

import pygetwindow as gw


windows = gw.getWindowsWithTitle(
    "Google Chrome"
)

print(windows)

結果はリストとして返されます。

対象が1件見つかった場合でも、リストから取り出す必要があります。

window = windows[0]

getWindowsWithTitle()の結果が必ず存在するとは限りません。リストの先頭を取り出す前に、対象が見つかったか確認してください。

✅ ウィンドウが見つかったか確認する

安全に取得する基本形は次のとおりです。

import pygetwindow as gw


windows = gw.getWindowsWithTitle(
    "Google Chrome"
)

if not windows:
    print(
        "対象のウィンドウが"
        "見つかりませんでした。"
    )

else:
    window = windows[0]

    print(
        f"見つかりました: "
        f"{window.title}"
    )

対象が見つからない場合に処理を中止するなら、例外を発生させる方法もあります。

import pygetwindow as gw


windows = gw.getWindowsWithTitle(
    "Google Chrome"
)

if not windows:
    raise RuntimeError(
        "対象のウィンドウが"
        "見つかりませんでした。"
    )

window = windows[0]

🌐 ブラウザのページタイトルで探す

ブラウザのタイトルには、現在開いているページのタイトルが含まれます。

例えばBookStackを開いている場合、次のようなタイトルになっていることがあります。

BookStack - Google Chrome

この場合は、ページ名を使って検索できます。

import pygetwindow as gw


windows = gw.getWindowsWithTitle(
    "BookStack"
)

ブラウザ名ではなくページ名を使うことで、複数のChromeウィンドウから目的のページを選びやすくなります。

特定のWebページを操作する場合は、「Google Chrome」ではなく、ページタイトルに含まれる固有の文字列で検索すると対象を絞り込めます。

⚠️ タブとウィンドウの違い

PyGetWindowが取得するのは、ブラウザのタブではなくWindows上のウィンドウです。

1つのChromeウィンドウに複数のタブを開いている場合、PyGetWindowから確認できるのは、現在選択されているタブのページタイトルだけです。

例えば、次の2つのタブを同じウィンドウで開いているとします。

BookStack
Google検索

Google検索のタブが選択されている場合、ウィンドウタイトルにはBookStackが含まれないため、次の検索では見つからない可能性があります。

gw.getWindowsWithTitle(
    "BookStack"
)

PyGetWindowではブラウザ内部のタブを直接検索・選択できません。タブを操作する場合は、PyAutoGUIのショートカットキーや、Playwrightなどのブラウザ自動化ツールを使用します。

🎯 現在アクティブなウィンドウを取得する

現在アクティブなウィンドウはgetActiveWindow()で取得できます。

import pygetwindow as gw


window = gw.getActiveWindow()

print(window.title)

タイトルだけを取得する場合はgetActiveWindowTitle()を使用できます。

import pygetwindow as gw


title = gw.getActiveWindowTitle()

print(title)

これにより、PyAutoGUIで操作を開始する前に、期待したウィンドウがアクティブか確認できます。

import pygetwindow as gw


title = gw.getActiveWindowTitle()

if "BookStack" not in title:
    raise RuntimeError(
        "BookStackが"
        "アクティブではありません。"
    )

📍 指定座標にあるウィンドウを取得する

getWindowsAt()を使用すると、指定座標に存在するウィンドウを取得できます。

import pygetwindow as gw


windows = gw.getWindowsAt(
    500,
    300
)

for window in windows:
    print(window.title)

マウスカーソルの位置にあるウィンドウを確認する場合は、PyAutoGUIと組み合わせます。

import pyautogui
import pygetwindow as gw


x, y = pyautogui.position()

windows = gw.getWindowsAt(
    x,
    y
)

for window in windows:
    print(window.title)

📐 ウィンドウの位置とサイズを取得する

取得したウィンドウオブジェクトには、位置やサイズの情報が含まれています。

import pygetwindow as gw


windows = gw.getWindowsWithTitle(
    "BookStack"
)

if not windows:
    raise RuntimeError(
        "対象ウィンドウが"
        "見つかりません。"
    )

window = windows[0]

print(f"左端: {window.left}")
print(f"上端: {window.top}")
print(f"幅: {window.width}")
print(f"高さ: {window.height}")

主なプロパティは次のとおりです。

プロパティ	意味
`title`	ウィンドウタイトル
`left`	左端のX座標
`top`	上端のY座標
`right`	右端のX座標
`bottom`	下端のY座標
`width`	ウィンドウの幅
`height`	ウィンドウの高さ
`topleft`	左上座標
`bottomright`	右下座標
`center`	中央座標
`size`	幅と高さ
`area`	ウィンドウの面積

🪟 ウィンドウを前面へ表示する

activate()を使用すると、対象ウィンドウをアクティブにできます。

window.activate()

PyAutoGUIで操作を開始する前に実行します。

import time

import pyautogui
import pygetwindow as gw


windows = gw.getWindowsWithTitle(
    "BookStack"
)

if not windows:
    raise RuntimeError(
        "BookStackが"
        "見つかりません。"
    )

window = windows[0]

window.activate()

time.sleep(0.5)

pyautogui.hotkey(
    "ctrl",
    "l"
)

activate()の直後は、OSやアプリケーションの処理が完了していない場合があります。

短い待機時間を入れてからPyAutoGUIを実行すると安定しやすくなります。

activate()の直後に0.5秒程度待機すると、ウィンドウが前面へ切り替わる前にキー入力を送ってしまう問題を減らせます。

🔍 前面化できたことを確認する

対象をアクティブ化したあと、現在のアクティブウィンドウを確認できます。

import time

import pygetwindow as gw


window.activate()

time.sleep(0.5)

active_window = gw.getActiveWindow()

if active_window is None:
    raise RuntimeError(
        "アクティブウィンドウを"
        "取得できませんでした。"
    )

if active_window.title != window.title:
    raise RuntimeError(
        "対象ウィンドウを"
        "前面へ表示できませんでした。"
    )

完全一致ではなく、タイトルの一部を確認する方法もあります。

active_title = (
    gw.getActiveWindowTitle() or ""
)

if "BookStack" not in active_title:
    raise RuntimeError(
        "BookStackが"
        "アクティブではありません。"
    )

OSのフォーカス制御や別のアプリケーションからの通知などにより、activate()を実行しても期待どおり前面化できない場合があります。重要な操作の前にはアクティブ状態を確認してください。

➖ ウィンドウを最小化する

minimize()を使用すると、対象ウィンドウを最小化できます。

window.minimize()

最小化されているかどうかはisMinimizedで確認できます。

if window.isMinimized:
    print(
        "ウィンドウは"
        "最小化されています。"
    )

⛶ ウィンドウを最大化する

maximize()を使用すると、対象ウィンドウを最大化できます。

window.maximize()

最大化されているかどうかはisMaximizedで確認できます。

if window.isMaximized:
    print(
        "ウィンドウは"
        "最大化されています。"
    )

画面上のボタン位置を一定にしたい場合は、操作前に最大化しておく方法があります。

if not window.isMaximized:
    window.maximize()

↩️ ウィンドウを元のサイズへ戻す

最小化または最大化したウィンドウを元の状態へ戻すにはrestore()を使用します。

window.restore()

最小化されているウィンドウを前面へ表示する場合は、先に復元します。

if window.isMinimized:
    window.restore()

window.activate()

最小化されている可能性がある場合は、restore()を実行してからactivate()を実行します。

🚚 ウィンドウを移動する

絶対座標へ移動する

moveTo()を使用すると、ウィンドウの左上を指定座標へ移動できます。

window.moveTo(
    100,
    100
)

この例では、ウィンドウの左上を座標(100, 100)へ移動します。

現在位置から相対移動する

moveRel()を使用すると、現在位置を基準に移動できます。

window.moveRel(
    100,
    50
)

この例では、現在位置から右へ100ピクセル、下へ50ピクセル移動します。

負の値を指定すると、左または上へ移動します。

window.moveRel(
    -100,
    -50
)

📏 ウィンドウサイズを変更する

指定したサイズへ変更する

resizeTo()を使用すると、ウィンドウを指定した幅と高さへ変更できます。

window.resizeTo(
    1280,
    800
)

画像認識を使用する場合、実行前にウィンドウサイズを固定すると、画面レイアウトの変化を抑えられます。

現在サイズから相対変更する

resizeRel()を使用すると、現在の幅と高さを基準にサイズを変更できます。

window.resizeRel(
    100,
    50
)

この例では、幅を100ピクセル、高さを50ピクセル増やします。

小さくする場合は負の値を指定します。

window.resizeRel(
    -100,
    -50
)

ウィンドウが最大化されている状態では、移動やサイズ変更が期待どおり動作しないことがあります。必要に応じて先にrestore()を実行します。

❌ ウィンドウを閉じる

close()を使用すると、対象ウィンドウを閉じられます。

window.close()

未保存のデータがある場合は、確認ダイアログが表示されることがあります。

close()は確認ダイアログを自動的に処理するものではありません。

close()は実際に対象ウィンドウを閉じます。未保存データが失われる可能性があるため、対象の確認なしに実行しないでください。

🧪 ウィンドウの状態を確認する

主な状態は次のプロパティで確認できます。

プロパティ	意味
`isActive`	アクティブか
`isMinimized`	最小化されているか
`isMaximized`	最大化されているか

使用例は次のとおりです。

print(
    f"アクティブ: "
    f"{window.isActive}"
)

print(
    f"最小化: "
    f"{window.isMinimized}"
)

print(
    f"最大化: "
    f"{window.isMaximized}"
)

状態に応じて処理を分岐できます。

if window.isMinimized:
    window.restore()

if not window.isActive:
    window.activate()

🔢 複数の候補が見つかった場合

同じ文字列を含むウィンドウが複数開いていると、getWindowsWithTitle()は複数の候補を返します。

import pygetwindow as gw


windows = gw.getWindowsWithTitle(
    "Google Chrome"
)

for index, window in enumerate(
    windows
):
    print(
        index,
        window.title
    )

表示結果を確認して、使用するウィンドウを選択できます。

window = windows[0]

ただし、リストの順序が常に同じとは限りません。

タイトルを追加確認して絞り込む方が安全です。

import pygetwindow as gw


windows = gw.getWindowsWithTitle(
    "Google Chrome"
)

matches = [
    window
    for window in windows
    if "BookStack" in window.title
]

if len(matches) != 1:
    raise RuntimeError(
        "対象ウィンドウを"
        "一意に特定できませんでした。"
    )

window = matches[0]

複数の候補がある状態で無条件にwindows[0]を選ぶと、別のウィンドウを操作する可能性があります。

🧰 ウィンドウ検索を関数にする

ウィンドウを探して取得する処理は何度も使うため、関数にすると便利です。

import pygetwindow as gw


def find_window(
    title_text: str
):
    windows = gw.getWindowsWithTitle(
        title_text
    )

    if not windows:
        return None

    return windows[0]

次のように使用します。

window = find_window(
    "BookStack"
)

if window is None:
    print(
        "BookStackが"
        "見つかりませんでした。"
    )

else:
    print(window.title)

🛡️ 対象を一意に特定する関数

誤操作を防ぐ場合は、候補が1件だけであることを確認します。

import pygetwindow as gw


def get_unique_window(
    title_text: str
):
    windows = gw.getWindowsWithTitle(
        title_text
    )

    if not windows:
        raise RuntimeError(
            f"「{title_text}」を含む"
            "ウィンドウが"
            "見つかりませんでした。"
        )

    if len(windows) > 1:
        titles = [
            window.title
            for window in windows
        ]

        raise RuntimeError(
            "対象ウィンドウを"
            "一意に特定できません。\n"
            + "\n".join(titles)
        )

    return windows[0]

使用例は次のとおりです。

window = get_unique_window(
    "BookStack"
)

削除や送信など重要な操作を行う場合は、対象ウィンドウが1件だけ見つかったことを確認してから操作します。

⏳ ウィンドウが開くまで待つ

アプリケーションの起動直後は、対象ウィンドウがまだ作成されていない場合があります。

一定時間、繰り返し検索することで、ウィンドウが開くまで待機できます。

import time

import pygetwindow as gw


def wait_for_window(
    title_text: str,
    timeout: float = 10,
    interval: float = 0.5
):
    start_time = time.time()

    while (
        time.time() - start_time
        < timeout
    ):
        windows = (
            gw.getWindowsWithTitle(
                title_text
            )
        )

        if windows:
            return windows[0]

        time.sleep(interval)

    return None

次のように使用します。

window = wait_for_window(
    "BookStack",
    timeout=10
)

if window is None:
    raise RuntimeError(
        "制限時間内に"
        "BookStackが"
        "見つかりませんでした。"
    )

待機処理にはタイムアウトを設けてください。対象ウィンドウが開かない場合に、プログラムが永久に待ち続けることを防げます。

🖥️ ウィンドウの位置とサイズを固定する

画像認識や座標クリックを安定させるため、操作前にウィンドウ位置とサイズを固定できます。

import time

import pygetwindow as gw


windows = gw.getWindowsWithTitle(
    "BookStack"
)

if not windows:
    raise RuntimeError(
        "BookStackが"
        "見つかりません。"
    )

window = windows[0]

if window.isMinimized:
    window.restore()

if window.isMaximized:
    window.restore()

window.moveTo(
    100,
    100
)

window.resizeTo(
    1280,
    800
)

window.activate()

time.sleep(0.5)

これにより、毎回おおむね同じ画面配置でPyAutoGUIを実行できます。

座標指定や画像認識を使用する場合は、ウィンドウの位置・サイズ、Windowsの表示倍率、ブラウザのズーム倍率を固定すると安定性が向上します。

📸 対象ウィンドウのスクリーンショットを取得する

PyGetWindowで取得した位置とサイズを、PyAutoGUIのscreenshot()へ渡せます。

import time

import pyautogui
import pygetwindow as gw


windows = gw.getWindowsWithTitle(
    "BookStack"
)

if not windows:
    raise RuntimeError(
        "BookStackが"
        "見つかりません。"
    )

window = windows[0]

if window.isMinimized:
    window.restore()

window.activate()

time.sleep(0.5)

region = (
    window.left,
    window.top,
    window.width,
    window.height
)

pyautogui.screenshot(
    "bookstack.png",
    region=region
)

PyGetWindowは撮影を担当しているのではなく、撮影対象の位置とサイズを取得しています。

実際に画面を撮影しているのはPyAutoGUIです。

対象ウィンドウの前に別のウィンドウが重なっていると、その重なった内容も撮影されます。撮影前に対象をアクティブ化してください。

🔍 ウィンドウ内だけを画像検索する

PyGetWindowで取得した範囲を、画像認識の検索範囲として使用できます。

import pyautogui
import pygetwindow as gw


windows = gw.getWindowsWithTitle(
    "BookStack"
)

if not windows:
    raise RuntimeError(
        "BookStackが"
        "見つかりません。"
    )

window = windows[0]

region = (
    window.left,
    window.top,
    window.width,
    window.height
)

center = (
    pyautogui.locateCenterOnScreen(
        "images/save_button.png",
        confidence=0.9,
        region=region
    )
)

画面全体ではなく対象ウィンドウ内だけを検索するため、検索速度や誤認識の改善が期待できます。

🖱️ ウィンドウ基準の相対座標を使う

PyAutoGUIの座標は画面左上を基準にします。

一方、ウィンドウの左上を基準とした相対座標を使用すると、ウィンドウを移動しても同じ場所を操作できます。

例えば、ウィンドウ左上から右へ300ピクセル、下へ200ピクセルの位置をクリックします。

import pyautogui


relative_x = 300
relative_y = 200

screen_x = (
    window.left
    + relative_x
)

screen_y = (
    window.top
    + relative_y
)

pyautogui.click(
    screen_x,
    screen_y
)

処理を関数にすると便利です。

import pyautogui


def click_relative(
    window,
    x: int,
    y: int
):
    pyautogui.click(
        window.left + x,
        window.top + y
    )

使用例は次のとおりです。

click_relative(
    window,
    300,
    200
)

画面全体の固定座標よりも、対象ウィンドウの左上を基準とした相対座標の方が、ウィンドウ位置の変化に対応しやすくなります。

🌐 実践例：ブラウザを探して操作する

次の例では、

BookStackを開いているウィンドウを探す
最小化されていれば復元する
前面へ表示する
アクティブ化を確認する
ウィンドウ内から検索画像を探す
ボタンをクリックする

という処理を行います。

import time

import pyautogui
import pygetwindow as gw


pyautogui.FAILSAFE = True
pyautogui.PAUSE = 0.3

windows = gw.getWindowsWithTitle(
    "BookStack"
)

if not windows:
    raise RuntimeError(
        "BookStackを開いている"
        "ウィンドウが"
        "見つかりませんでした。"
    )

if len(windows) > 1:
    raise RuntimeError(
        "BookStackを含む"
        "ウィンドウが複数あります。"
    )

window = windows[0]

if window.isMinimized:
    window.restore()

window.activate()

time.sleep(0.5)

active_title = (
    gw.getActiveWindowTitle() or ""
)

if "BookStack" not in active_title:
    raise RuntimeError(
        "BookStackを前面へ"
        "表示できませんでした。"
    )

region = (
    window.left,
    window.top,
    window.width,
    window.height
)

try:
    center = (
        pyautogui.locateCenterOnScreen(
            "images/save_button.png",
            confidence=0.9,
            region=region
        )
    )

except pyautogui.ImageNotFoundException:
    pyautogui.screenshot(
        "button_not_found.png",
        region=region
    )

    raise RuntimeError(
        "保存ボタンが"
        "見つかりませんでした。"
    )

pyautogui.moveTo(
    center.x,
    center.y,
    duration=0.5
)

pyautogui.click()

print(
    "保存ボタンを"
    "クリックしました。"
)

この例には、GUI自動化で重要な処理が含まれています。

対象ウィンドウが存在するか確認する
複数候補による誤操作を防ぐ
最小化されたウィンドウを復元する
対象を前面へ表示する
アクティブ化を確認する
画像検索範囲をウィンドウ内に限定する
画像が見つからない場合に画面を保存する
フェイルセーフを有効にする

🧱 ブラウザ操作用のクラスにまとめる

繰り返し利用する場合は、ウィンドウ操作をクラスへまとめられます。

import time

import pyautogui
import pygetwindow as gw


class BrowserWindow:
    def __init__(
        self,
        title_text: str
    ):
        self.title_text = title_text
        self.window = (
            self._find_unique_window()
        )

    def _find_unique_window(self):
        windows = (
            gw.getWindowsWithTitle(
                self.title_text
            )
        )

        if not windows:
            raise RuntimeError(
                f"「{self.title_text}」を"
                "含むウィンドウが"
                "見つかりません。"
            )

        if len(windows) > 1:
            raise RuntimeError(
                f"「{self.title_text}」を"
                "含むウィンドウが"
                "複数あります。"
            )

        return windows[0]

    def activate(self):
        if self.window.isMinimized:
            self.window.restore()

        self.window.activate()

        time.sleep(0.5)

        active_title = (
            gw.getActiveWindowTitle()
            or ""
        )

        if (
            self.title_text
            not in active_title
        ):
            raise RuntimeError(
                "対象ウィンドウを"
                "前面へ表示できません。"
            )

    def get_region(self):
        return (
            self.window.left,
            self.window.top,
            self.window.width,
            self.window.height
        )

    def screenshot(
        self,
        output_path: str
    ):
        pyautogui.screenshot(
            output_path,
            region=self.get_region()
        )

    def click_relative(
        self,
        x: int,
        y: int
    ):
        pyautogui.click(
            self.window.left + x,
            self.window.top + y
        )

次のように使用できます。

browser = BrowserWindow(
    "BookStack"
)

browser.activate()

browser.screenshot(
    "bookstack.png"
)

browser.click_relative(
    300,
    200
)

処理の流れを記述するコードから、ウィンドウ検索や座標計算の詳細を分離できます。

⚠️ PyGetWindow利用時の注意

📝 ウィンドウタイトルは変化する

ブラウザでは、選択中のタブや表示中のページによってタイトルが変わります。

テキストエディターでは、開いているファイル名や未保存状態によってタイトルが変わることがあります。

完全なタイトルを固定するのではなく、対象を識別できる固有の一部分を使用します。

🔢 同じタイトルのウィンドウが複数ある

複数のブラウザウィンドウで同じページを開いている場合などは、同じ条件に複数のウィンドウが一致します。

重要な処理では、候補が1件だけであることを確認します。

🎯 前面化が成功するとは限らない

Windowsのフォーカス制御、確認ダイアログ、通知、別のアプリケーションなどによって、対象を前面化できない場合があります。

activate()の実行だけで成功したと判断せず、getActiveWindowTitle()などで確認します。

🖼️ ウィンドウ内部の部品は取得できない

PyGetWindowで取得できるのは、ウィンドウのタイトル、位置、サイズ、状態などです。

次のようなウィンドウ内部の要素を直接取得する機能はありません。

ブラウザのボタン
HTML要素
入力欄
メニュー項目
ブラウザのタブ
Excelのセル

これらを操作する場合は、PyAutoGUI、画像認識、ショートカットキー、Playwrightなどを組み合わせます。

PyGetWindowはウィンドウの外枠を扱うライブラリです。アプリケーション内部の部品を解析するライブラリではありません。

🖥️ 複数ディスプレイ

複数ディスプレイ環境では、ウィンドウのX座標やY座標が負の値になることがあります。

例えば、メインディスプレイの左側に別のディスプレイを配置している場合、そのディスプレイ上のウィンドウは負のX座標を持つことがあります。

位置やスクリーンショット範囲を扱う場合は、取得した値を確認してください。

🔐 管理者権限

操作対象のアプリケーションが管理者権限で実行されている場合、通常権限で実行しているPythonからの操作が制限されることがあります。

対象アプリケーションとPythonの権限レベルが異なると、前面化や入力操作が期待どおり動作しない場合があります。

🧵 操作中にユーザーが触らない

PyGetWindowで対象を前面化したあと、ユーザーが別のウィンドウを選択すると、PyAutoGUIの入力先が変わります。

長い処理では、重要な操作の直前にアクティブウィンドウを再確認します。

対象ウィンドウを確認せずに、削除、送信、保存、確定などの操作を実行しないでください。 フォーカスが別のウィンドウへ移ると、意図しない対象を操作する危険があります。

🔄 PyAutoGUIとの違い

PyGetWindowとPyAutoGUIの役割は次のように整理できます。

操作	PyGetWindow	PyAutoGUI
ウィンドウを探す	○	△
ウィンドウタイトルを取得	○	△
ウィンドウを前面化	○	△
ウィンドウを移動	○	×
ウィンドウサイズを変更	○	×
最小化・最大化	○	×
マウス操作	×	○
キーボード操作	×	○
画像認識	×	○
スクリーンショット	×	○

基本的には、次のように使い分けます。

PyGetWindow
    対象ウィンドウを特定する
    位置・サイズ・状態を整える
    前面へ表示する

PyAutoGUI
    マウスを動かす
    クリックする
    キーボード入力する
    画像を探す
    スクリーンショットを撮る

📝 まとめ

PyGetWindowは、開いているウィンドウをPythonから検索・取得・操作するためのライブラリです。

代表的な機能は次のとおりです。

getAllTitles()：ウィンドウタイトルの一覧を取得する
getAllWindows()：すべてのウィンドウを取得する
getWindowsWithTitle()：タイトルからウィンドウを探す
getActiveWindow()：アクティブウィンドウを取得する
getActiveWindowTitle()：アクティブウィンドウのタイトルを取得する
getWindowsAt()：指定座標にあるウィンドウを取得する
activate()：ウィンドウを前面へ表示する
minimize()：最小化する
maximize()：最大化する
restore()：元の状態へ戻す
moveTo()：指定座標へ移動する
moveRel()：現在位置から相対移動する
resizeTo()：指定サイズへ変更する
resizeRel()：現在サイズから相対変更する
close()：ウィンドウを閉じる

PyGetWindowだけでブラウザ内部を操作することはできません。

実際のGUI自動化では、

PyGetWindowで対象ウィンドウを探す
ウィンドウを復元して前面へ表示する
位置やサイズを整える
PyAutoGUIで画像認識、クリック、キー入力を行う

という形で組み合わせます。

特に、特定のブラウザウィンドウを自動操作する場合は、対象ウィンドウを手作業でアクティブにする必要がなくなり、スクリプトを単独で起動しやすくなります。

FastAPIとGradioの使い分け

FastAPIとGradioの連携サンプル

Gradio Blocks入門：Blocksだからできる複雑UIを体験しよう

Gradio.interface と Gradio.Blocks

Gradio（グラディオ）について

Gradioで作る！英作文の自動添削アプリ

Gradioで単語カウンターアプリを作る

gradioの部品まとめ

Tkとの比較～なぜスタンドアローンでもよいのにhttp使うのか？

matplotlibで山手線上の駅を移動する点をアニメーションで描写する

matplotlibの概要

VOICEVOX Dockerイメージを使用して音声合成APIサーバーを構築して遊ぶ手順書

pytestをVS Codeで快適に運用する方法

pytestのデコレータ実践ガイド（parametrize / fixture / mark / skip / xfail）

🖱️ PyAutoGUI 概要

💿 PyAutoGUI インストール方法

🖱️ PyAutoGUI マウス操作

⌨️ PyAutoGUI キーボード操作

🔍 PyAutoGUI 画像認識

📸 PyAutoGUI スクリーンショット

🪟 PyGetWindowによるウィンドウ操作

🪟 PyGetWindowによるウィンドウ操作

📖 はじめに

🧭 PyGetWindowの役割

📦 インストール

🔍 インストールを確認する

📋 開いているウィンドウのタイトルを取得する

🗂️ すべてのウィンドウを取得する

🔎 タイトルからウィンドウを探す

✅ ウィンドウが見つかったか確認する

🌐 ブラウザのページタイトルで探す

⚠️ タブとウィンドウの違い

🎯 現在アクティブなウィンドウを取得する

📍 指定座標にあるウィンドウを取得する

📐 ウィンドウの位置とサイズを取得する

🪟 ウィンドウを前面へ表示する

🔍 前面化できたことを確認する

➖ ウィンドウを最小化する

⛶ ウィンドウを最大化する

↩️ ウィンドウを元のサイズへ戻す

🚚 ウィンドウを移動する

絶対座標へ移動する

現在位置から相対移動する

📏 ウィンドウサイズを変更する

指定したサイズへ変更する

現在サイズから相対変更する

❌ ウィンドウを閉じる

🧪 ウィンドウの状態を確認する

🔢 複数の候補が見つかった場合

🧰 ウィンドウ検索を関数にする

🛡️ 対象を一意に特定する関数

⏳ ウィンドウが開くまで待つ

🖥️ ウィンドウの位置とサイズを固定する

📸 対象ウィンドウのスクリーンショットを取得する

🔍 ウィンドウ内だけを画像検索する

🖱️ ウィンドウ基準の相対座標を使う

🌐 実践例：ブラウザを探して操作する

🧱 ブラウザ操作用のクラスにまとめる

⚠️ PyGetWindow利用時の注意

📝 ウィンドウタイトルは変化する

🔢 同じタイトルのウィンドウが複数ある

🎯 前面化が成功するとは限らない

🖼️ ウィンドウ内部の部品は取得できない

🖥️ 複数ディスプレイ

🔐 管理者権限

🧵 操作中にユーザーが触らない

🔄 PyAutoGUIとの違い

📝 まとめ