中級者向け No.084

ホットキーランチャー

キーボードショートカットにアプリ起動やコマンド実行を割り当てて管理するランチャーツール。

🎯 難易度: ★★★ 📦 ライブラリ: tkinter（標準ライブラリ）, keyboard ⏱️ 制作時間: 30〜90分

📋 目次

1. アプリ概要
2. 機能一覧
3. 事前準備・環境
4. 完全なソースコード
5. コード解説
6. ステップバイステップガイド
7. カスタマイズアイデア
8. よくある問題と解決法
9. 練習問題

1. アプリ概要

キーボードショートカットにアプリ起動やコマンド実行を割り当てて管理するランチャーツール。

このアプリはutilカテゴリの実践的なPythonアプリです。使用ライブラリは tkinter（標準ライブラリ）、難易度は ★★★ です。

このアプリは「ユーティリティ」カテゴリです。小回りの効くユーティリティは Python の真骨頂で、汎用的なユーザー操作を組み合わせる発想が他のアプリにもそのまま流用できます。tkinter（標準ライブラリ） を活かして実装するこの構造は、他のアプリにも応用が効きます。

動かしながら読むことが理解の最短経路です。まずはコードをコピーして実行し、想定どおりに動くことを確認したうえで解説と照らし合わせてください。

カスタマイズでは「機能追加」「UI 改善」「エラー耐性」の三方向で考えると視野が広がります。練習問題にもそれぞれの方向の具体例を用意しています。

Linux Mint 22.3 で起動したホットキーランチャー。画面上部に「⚠ keyboard が未インストールです (pip install keyboard) ※管理者権限が必要」の警告バーが出ており、その下に登録済みの2件が一覧表示されている — 実行画面（Linux Mint・keyboard 未インストールの状態）

2. 機能一覧

ループで生成するボタン群を lambda v=v: v.set(filedialog.askopenfilename() or v.get()) で接続
「＋追加」ボタン（_add()）・「✏ 編集」ボタン（_edit()）・「🗑 削除」ボタン（_delete()）・「▶ 実行」ボタン（_run_selected()）・「🔃 ホットキー再登録」ボタン（_rebind_all()）・「保存」ボタンで操作
マウス操作 <Double-1> から _run_selected() を実行
ttk.Treeview による表形式の一覧表示
JSON ファイルの保存・読み込み（起動時に自動実行）
filedialog.askopenfilename() によるファイル選択ダイアログ
ウィンドウはタイトル「ホットキーランチャー」・サイズ 760x500 で起動

3. 事前準備・環境

ℹ️

動作確認環境

Python 3.10 以上 / Windows 11（実機）で起動・基本操作を確認／ Linux Mint 22.3（仮想マシン）で起動を確認（ホットキー登録は Windows のみ・macOS は未検証）

Windows 11（実機）で起動と基本操作を確認しています（全機能の網羅テストではありません）。Linux Mint 22.3（仮想マシン）では、keyboard を入れずに起動しました（1章の図の上部の警告バーがその状態です）。macOS は必要なライブラリ（pip install）を入れれば動作する想定ですが、未検証です。

Python 3.10 以上
OS: Windows 11（実機で起動・基本操作を確認）／Linux Mint 22.3（仮想マシンで起動を確認）

⚠️

Linux では keyboard に root 権限が必要です

keyboard は Linux では入力デバイスを直接読むため、root 権限（または input グループへの所属）が要ります。権限が足りないとホットキーの登録で失敗します。当サイトの Linux Mint 22.3 では、keyboard 無しで起動して警告バーが出る状態を確認しました。ホットキーの登録と実行を確認したのは Windows 11 だけです。

4. 完全なソースコード

💡

コードのコピー方法

右上の「コピー」ボタンをクリックするとコードをクリップボードにコピーできます。

📦 必要なライブラリをインストール（初回のみ）

pip install keyboard

app084.py

import tkinter as tk
from tkinter import ttk, messagebox, filedialog
import subprocess
import threading
import os
import json

try:
    import keyboard
    KEYBOARD_AVAILABLE = True
except ImportError:
    KEYBOARD_AVAILABLE = False


SAVE_PATH = os.path.join(os.path.dirname(__file__), "hotkey_launcher.json")


class App084:
    """ホットキーランチャー"""

    def __init__(self, root):
        self.root = root
        self.root.title("ホットキーランチャー")
        self.root.geometry("760x500")
        self.root.configure(bg="#1e1e1e")
        self._entries = []    # [{"name": ..., "hotkey": ..., "command": ..., "enabled": bool}]
        self._hooks   = {}    # {hotkey_str: hook_obj}
        self._build_ui()
        self._load()
        if not KEYBOARD_AVAILABLE:
            pass  # 警告ラベルはビルド時に表示済み

    def _build_ui(self):
        header = tk.Frame(self.root, bg="#252526", pady=6)
        header.pack(fill=tk.X)
        tk.Label(header, text="⌨ ホットキーランチャー",
                 font=("Noto Sans JP", 12, "bold"),
                 bg="#252526", fg="#4fc3f7").pack(side=tk.LEFT, padx=12)

        if not KEYBOARD_AVAILABLE:
            tk.Label(self.root,
                     text="⚠ keyboard が未インストールです (pip install keyboard)  ※管理者権限が必要",
                     bg="#fff3cd", fg="#856404", font=("Arial", 9),
                     anchor="w", padx=8).pack(fill=tk.X)

        # ツールバー
        tb = tk.Frame(self.root, bg="#2d2d2d", pady=4)
        tb.pack(fill=tk.X)
        tk.Button(tb, text="＋ 追加", command=self._add,
                  bg="#2e7d32", fg="white", relief=tk.FLAT,
                  font=("Arial", 10), padx=12, pady=4,
                  activebackground="#1b5e20", bd=0).pack(side=tk.LEFT, padx=4)
        tk.Button(tb, text="✏ 編集", command=self._edit,
                  bg="#1565c0", fg="white", relief=tk.FLAT,
                  font=("Arial", 10), padx=12, pady=4,
                  activebackground="#0d47a1", bd=0).pack(side=tk.LEFT, padx=2)
        tk.Button(tb, text="🗑 削除", command=self._delete,
                  bg="#c62828", fg="white", relief=tk.FLAT,
                  font=("Arial", 10), padx=12, pady=4,
                  activebackground="#b71c1c", bd=0).pack(side=tk.LEFT, padx=2)
        tk.Button(tb, text="▶ 実行", command=self._run_selected,
                  bg="#f57c00", fg="white", relief=tk.FLAT,
                  font=("Arial", 10), padx=12, pady=4,
                  activebackground="#e65100", bd=0).pack(side=tk.LEFT, padx=8)
        ttk.Button(tb, text="🔃 ホットキー再登録",
                   command=self._rebind_all).pack(side=tk.LEFT, padx=4)

        # ランチャーリスト
        cols = ("enabled", "name", "hotkey", "command")
        self.tree = ttk.Treeview(self.root, columns=cols, show="headings",
                                  selectmode="browse")
        self.tree.heading("enabled", text="有効")
        self.tree.heading("name",    text="名前")
        self.tree.heading("hotkey",  text="ホットキー")
        self.tree.heading("command", text="コマンド / パス")
        self.tree.column("enabled", width=50,  anchor="center")
        self.tree.column("name",    width=160, anchor="w")
        self.tree.column("hotkey",  width=120, anchor="center")
        self.tree.column("command", width=380, anchor="w")
        tsb = ttk.Scrollbar(self.root, command=self.tree.yview)
        self.tree.configure(yscrollcommand=tsb.set)
        tsb.pack(side=tk.RIGHT, fill=tk.Y)
        self.tree.pack(fill=tk.BOTH, expand=True, padx=8, pady=4)
        self.tree.bind("<Double-1>", lambda e: self._run_selected())

        # ログ
        log_f = tk.Frame(self.root, bg="#0d1117")
        log_f.pack(fill=tk.X, padx=8, pady=2)
        self.log_text = tk.Text(log_f, height=4, bg="#0d1117", fg="#8b949e",
                                 font=("Courier New", 8), relief=tk.FLAT,
                                 state=tk.DISABLED)
        self.log_text.pack(fill=tk.X)

        self.status_var = tk.StringVar(value="ホットキーを追加してください")
        tk.Label(self.root, textvariable=self.status_var,
                 bg="#252526", fg="#858585", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _log(self, msg):
        self.log_text.configure(state=tk.NORMAL)
        self.log_text.insert(tk.END, msg + "\n")
        self.log_text.see(tk.END)
        self.log_text.configure(state=tk.DISABLED)

    def _refresh(self):
        self.tree.delete(*self.tree.get_children())
        for e in self._entries:
            self.tree.insert("", tk.END,
                              values=("✔" if e["enabled"] else "✘",
                                      e["name"], e["hotkey"], e["command"]))

    def _add(self):
        self._edit_dialog(None)

    def _edit(self):
        sel = self.tree.selection()
        if not sel:
            return
        idx = self.tree.index(sel[0])
        self._edit_dialog(idx)

    def _edit_dialog(self, idx):
        """追加/編集ダイアログ"""
        entry = self._entries[idx] if idx is not None else {
            "name": "", "hotkey": "ctrl+alt+a", "command": "", "enabled": True}

        dlg = tk.Toplevel(self.root)
        dlg.title("ホットキー設定")
        dlg.configure(bg="#252526")
        dlg.grab_set()

        fields = [
            ("名前",       "name",    entry["name"]),
            ("ホットキー", "hotkey",  entry["hotkey"]),
            ("コマンド",   "command", entry["command"]),
        ]
        vars_ = {}
        for label, key, default in fields:
            row = tk.Frame(dlg, bg="#252526")
            row.pack(fill=tk.X, padx=12, pady=4)
            tk.Label(row, text=f"{label}:", bg="#252526", fg="#ccc",
                     width=10, anchor="w").pack(side=tk.LEFT)
            v = tk.StringVar(value=default)
            vars_[key] = v
            ttk.Entry(row, textvariable=v, width=32).pack(side=tk.LEFT, padx=4)
            if key == "command":
                ttk.Button(row, text="参照",
                           command=lambda v=v: v.set(
                               filedialog.askopenfilename() or v.get())
                           ).pack(side=tk.LEFT)

        en_var = tk.BooleanVar(value=entry["enabled"])
        tk.Checkbutton(dlg, text="有効", variable=en_var,
                       bg="#252526", fg="#ccc", selectcolor="#3c3c3c",
                       activebackground="#252526").pack(padx=12, pady=4, anchor="w")

        def _ok():
            new_entry = {
                "name":    vars_["name"].get(),
                "hotkey":  vars_["hotkey"].get(),
                "command": vars_["command"].get(),
                "enabled": en_var.get(),
            }
            if idx is None:
                self._entries.append(new_entry)
            else:
                # 古いホットキーを解除
                if KEYBOARD_AVAILABLE:
                    old_hk = entry["hotkey"]
                    if old_hk in self._hooks:
                        try:
                            keyboard.remove_hotkey(self._hooks[old_hk])
                        except Exception:
                            pass
                        del self._hooks[old_hk]
                self._entries[idx] = new_entry
            self._refresh()
            self._save()
            self._bind_entry(new_entry)
            dlg.destroy()

        ttk.Button(dlg, text="保存", command=_ok).pack(pady=8)

    def _delete(self):
        sel = self.tree.selection()
        if not sel:
            return
        idx = self.tree.index(sel[0])
        e = self._entries[idx]
        if KEYBOARD_AVAILABLE and e["hotkey"] in self._hooks:
            try:
                keyboard.remove_hotkey(self._hooks[e["hotkey"]])
            except Exception:
                pass
            del self._hooks[e["hotkey"]]
        del self._entries[idx]
        self._refresh()
        self._save()

    def _run_selected(self):
        sel = self.tree.selection()
        if not sel:
            return
        idx = self.tree.index(sel[0])
        self._run(self._entries[idx])

    def _run(self, entry):
        cmd = entry["command"].strip()
        if not cmd:
            return
        self._log(f"実行: {entry['name']}  [{cmd}]")
        self.status_var.set(f"実行: {entry['name']}")
        threading.Thread(target=lambda: subprocess.Popen(
            cmd, shell=True,
            creationflags=subprocess.CREATE_NO_WINDOW if os.name == "nt" else 0),
            daemon=True).start()

    def _bind_entry(self, entry):
        if not KEYBOARD_AVAILABLE or not entry["enabled"] or not entry["hotkey"]:
            return
        try:
            hook = keyboard.add_hotkey(entry["hotkey"],
                                        lambda e=entry: self.root.after(0, self._run, e))
            self._hooks[entry["hotkey"]] = hook
            self._log(f"登録: {entry['hotkey']} → {entry['name']}")
        except Exception as ex:
            self._log(f"登録失敗: {entry['hotkey']} ({ex})")

    def _rebind_all(self):
        if KEYBOARD_AVAILABLE:
            for hook in self._hooks.values():
                try:
                    keyboard.remove_hotkey(hook)
                except Exception:
                    pass
        self._hooks.clear()
        for e in self._entries:
            self._bind_entry(e)
        self.status_var.set("ホットキーを再登録しました")

    def _save(self):
        try:
            with open(SAVE_PATH, "w", encoding="utf-8") as f:
                json.dump(self._entries, f, ensure_ascii=False, indent=2)
        except Exception:
            pass

    def _load(self):
        if not os.path.exists(SAVE_PATH):
            self._entries = [
                {"name": "メモ帳", "hotkey": "ctrl+alt+n",
                 "command": "notepad.exe", "enabled": True},
                {"name": "電卓",   "hotkey": "ctrl+alt+c",
                 "command": "calc.exe",    "enabled": True},
            ]
        else:
            try:
                with open(SAVE_PATH, encoding="utf-8") as f:
                    self._entries = json.load(f)
            except Exception:
                self._entries = []
        self._refresh()
        self._rebind_all()


if __name__ == "__main__":
    root = tk.Tk()
    app = App084(root)
    root.mainloop()

5. コード解説

ホットキーランチャーのコードを、実際に書かれている実装に沿って解説します。

クラス設計とコンストラクタ

App084 クラスにアプリの全機能をまとめています（メソッド14個・全269行）。__init__ ではタイトル「ホットキーランチャー」とウィンドウサイズ 760x500 を設定します。そのあと _build_ui() → _load() の順に呼び出して初期状態を作ります。