中級者向け No.093

メール一括送信ツール

CSVで宛先リストとテンプレートを管理しsmtplibで一括メール送信するツール。送信前プレビューと結果ログ付き。

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

1. アプリ概要

CSVで宛先リストとテンプレートを管理しsmtplibで一括メール送信するツール。送信前プレビューと結果ログ付き。

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

Pythonの豊富なライブラリを活用することで、実用的なアプリを短いコードで実装できます。ソースコードをコピーして実行し、仕組みを理解したうえでカスタマイズに挑戦してみてください。

GUIアプリ開発はプログラミングの楽しさを実感できる最も効果的な学習方法のひとつです。変数・関数・クラス・イベント処理などの重要な概念が自然と身につきます。

2. 機能一覧

  • メール一括送信ツールのメイン機能
  • 直感的なGUIインターフェース
  • 入力値のバリデーション
  • エラーハンドリング
  • 結果の見やすい表示
  • クリア機能付き

3. 事前準備・環境

ℹ️
動作確認環境

Python 3.10 以上 / Windows・Mac・Linux すべて対応

以下の環境で動作確認しています。

  • Python 3.10 以上
  • OS: Windows 10/11・macOS 12+・Ubuntu 20.04+

4. 完全なソースコード

💡
コードのコピー方法

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

app093.py
import tkinter as tk
from tkinter import ttk, messagebox, filedialog
import smtplib
import threading
import csv
import os
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart
from email.mime.base import MIMEBase
from email import encoders
from datetime import datetime


class App093:
    """メール一括送信ツール"""

    def __init__(self, root):
        self.root = root
        self.root.title("メール一括送信ツール")
        self.root.geometry("960x640")
        self.root.configure(bg="#1e1e1e")
        self._recipients = []    # [{"name": ..., "email": ..., "status": ...}]
        self._attachment = None
        self._build_ui()

    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)

        tk.Label(self.root,
                 text="⚠ 送信テストは必ずダミーメールサービス (Mailtrap等) で行ってください。",
                 bg="#fff3cd", fg="#856404", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X)

        # メインPaned
        paned = ttk.PanedWindow(self.root, orient=tk.HORIZONTAL)
        paned.pack(fill=tk.BOTH, expand=True, padx=4, pady=4)

        # 左: SMTP + 宛先
        left = tk.Frame(paned, bg="#1e1e1e", width=420)
        paned.add(left, weight=0)

        # SMTP設定
        smtp_f = tk.LabelFrame(left, text="SMTP設定", bg="#252526",
                                fg="#ccc", font=("Arial", 9), padx=6, pady=4)
        smtp_f.pack(fill=tk.X, padx=4, pady=4)

        fields = [
            ("SMTPサーバー",   "smtp_host", "smtp.gmail.com"),
            ("ポート",         "smtp_port", "587"),
            ("ユーザー名",     "smtp_user", "your@email.com"),
            ("パスワード",     "smtp_pass", ""),
            ("差出人名",       "from_name", "送信者名"),
        ]
        self._smtp_vars = {}
        for i, (label, key, default) in enumerate(fields):
            tk.Label(smtp_f, text=f"{label}:", bg="#252526", fg="#ccc",
                     font=("Arial", 9), width=12, anchor="e").grid(
                row=i, column=0, sticky="e", pady=1)
            v = tk.StringVar(value=default)
            self._smtp_vars[key] = v
            show = "*" if key == "smtp_pass" else ""
            ttk.Entry(smtp_f, textvariable=v, width=22,
                      show=show).grid(row=i, column=1, padx=4, pady=1, sticky="w")

        self.tls_var = tk.BooleanVar(value=True)
        tk.Checkbutton(smtp_f, text="TLS/STARTTLS を使用",
                       variable=self.tls_var,
                       bg="#252526", fg="#ccc", selectcolor="#3c3c3c",
                       activebackground="#252526").grid(
            row=len(fields), column=0, columnspan=2, sticky="w")

        # 宛先リスト
        tk.Label(left, text="宛先一覧", bg="#1e1e1e", fg="#888",
                 font=("Arial", 9)).pack(anchor="w", padx=4, pady=(8, 0))
        btn_row = tk.Frame(left, bg="#1e1e1e")
        btn_row.pack(fill=tk.X, padx=4)
        ttk.Button(btn_row, text="+ 追加",
                   command=self._add_recipient).pack(side=tk.LEFT, padx=2)
        ttk.Button(btn_row, text="📂 CSVインポート",
                   command=self._import_csv).pack(side=tk.LEFT, padx=2)
        ttk.Button(btn_row, text="🗑 削除",
                   command=self._remove_recipient).pack(side=tk.LEFT, padx=2)
        ttk.Button(btn_row, text="全クリア",
                   command=self._clear_recipients).pack(side=tk.LEFT, padx=2)

        cols = ("status", "name", "email")
        self.rec_tree = ttk.Treeview(left, columns=cols, show="headings", height=10)
        self.rec_tree.heading("status", text="状態")
        self.rec_tree.heading("name",   text="名前")
        self.rec_tree.heading("email",  text="メールアドレス")
        self.rec_tree.column("status", width=60,  anchor="center")
        self.rec_tree.column("name",   width=100, anchor="w")
        self.rec_tree.column("email",  width=200, anchor="w")
        rsb = ttk.Scrollbar(left, command=self.rec_tree.yview)
        self.rec_tree.configure(yscrollcommand=rsb.set)
        rsb.pack(side=tk.RIGHT, fill=tk.Y)
        self.rec_tree.pack(fill=tk.BOTH, expand=True, padx=(4, 0))
        self.rec_tree.tag_configure("sent",  foreground="#26a69a")
        self.rec_tree.tag_configure("error", foreground="#ef5350")

        # 右: メール本文
        right = tk.Frame(paned, bg="#1e1e1e")
        paned.add(right, weight=1)

        tk.Label(right, text="件名:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(anchor="w", padx=4)
        self.subject_var = tk.StringVar(value="お知らせ")
        ttk.Entry(right, textvariable=self.subject_var).pack(
            fill=tk.X, padx=4, pady=2)

        tk.Label(right, text="本文 ({name} で宛先名を差し込み):",
                 bg="#1e1e1e", fg="#ccc", font=("Arial", 9)).pack(
            anchor="w", padx=4)
        self.body_text = tk.Text(right, bg="#0d1117", fg="#c9d1d9",
                                  font=("Arial", 10), relief=tk.FLAT,
                                  insertbackground="white", wrap=tk.WORD)
        bsb = ttk.Scrollbar(right, command=self.body_text.yview)
        self.body_text.configure(yscrollcommand=bsb.set)
        bsb.pack(side=tk.RIGHT, fill=tk.Y)
        self.body_text.pack(fill=tk.BOTH, expand=True, padx=(4, 0))
        self.body_text.insert("1.0",
                               "{name} 様\n\nいつもお世話になっております。\n\nよろしくお願いいたします。")

        # 添付ファイル
        att_row = tk.Frame(right, bg="#1e1e1e")
        att_row.pack(fill=tk.X, padx=4, pady=2)
        tk.Label(att_row, text="添付:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(side=tk.LEFT)
        self.att_var = tk.StringVar(value="(なし)")
        tk.Label(att_row, textvariable=self.att_var, bg="#1e1e1e",
                 fg="#888", font=("Arial", 9)).pack(side=tk.LEFT, padx=4)
        ttk.Button(att_row, text="ファイル選択",
                   command=self._pick_attachment).pack(side=tk.LEFT)
        ttk.Button(att_row, text="クリア",
                   command=lambda: (self.att_var.set("(なし)"),
                                    setattr(self, "_attachment", None))
                   ).pack(side=tk.LEFT, padx=2)

        # 送信ボタン
        btn_row2 = tk.Frame(right, bg="#1e1e1e", pady=4)
        btn_row2.pack(fill=tk.X, padx=4)
        tk.Button(btn_row2, text="📧 一括送信開始", command=self._send_all,
                  bg="#1565c0", fg="white", relief=tk.FLAT,
                  font=("Arial", 12, "bold"), padx=20, pady=6,
                  activebackground="#0d47a1", bd=0).pack(side=tk.LEFT)
        ttk.Button(btn_row2, text="🔧 接続テスト",
                   command=self._test_connection).pack(side=tk.LEFT, padx=8)

        self.progress = ttk.Progressbar(self.root, mode="determinate")
        self.progress.pack(fill=tk.X, padx=8)
        self.status_var = tk.StringVar(value="SMTP設定と宛先を入力してください")
        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 _add_recipient(self):
        dlg = tk.Toplevel(self.root)
        dlg.title("宛先追加")
        dlg.configure(bg="#252526")
        dlg.grab_set()
        name_var  = tk.StringVar()
        email_var = tk.StringVar()
        for label, var in [("名前:", name_var), ("メール:", email_var)]:
            row = tk.Frame(dlg, bg="#252526")
            row.pack(fill=tk.X, padx=12, pady=4)
            tk.Label(row, text=label, bg="#252526", fg="#ccc",
                     width=8, anchor="w").pack(side=tk.LEFT)
            ttk.Entry(row, textvariable=var, width=26).pack(side=tk.LEFT)
        def _ok():
            n = name_var.get().strip()
            e = email_var.get().strip()
            if not e:
                return
            self._recipients.append({"name": n, "email": e, "status": "未送信"})
            self.rec_tree.insert("", tk.END, values=("─", n, e))
            dlg.destroy()
        ttk.Button(dlg, text="追加", command=_ok).pack(pady=8)

    def _import_csv(self):
        path = filedialog.askopenfilename(
            filetypes=[("CSV", "*.csv"), ("すべて", "*.*")])
        if not path:
            return
        try:
            with open(path, encoding="utf-8-sig", newline="") as f:
                reader = csv.DictReader(f)
                for row in reader:
                    name  = row.get("name", row.get("名前", ""))
                    email = row.get("email", row.get("メール", row.get("mail", "")))
                    if email:
                        self._recipients.append(
                            {"name": name, "email": email, "status": "未送信"})
                        self.rec_tree.insert("", tk.END,
                                              values=("─", name, email))
            self.status_var.set(f"インポート完了: {len(self._recipients)} 件")
        except Exception as e:
            messagebox.showerror("エラー", str(e))

    def _remove_recipient(self):
        for sel in self.rec_tree.selection():
            idx = self.rec_tree.index(sel)
            if idx < len(self._recipients):
                del self._recipients[idx]
            self.rec_tree.delete(sel)

    def _clear_recipients(self):
        self._recipients.clear()
        self.rec_tree.delete(*self.rec_tree.get_children())

    def _pick_attachment(self):
        path = filedialog.askopenfilename()
        if path:
            self._attachment = path
            self.att_var.set(os.path.basename(path))

    # ── SMTP ────────────────────────────────────────────────
    def _get_smtp(self):
        host = self._smtp_vars["smtp_host"].get()
        port = int(self._smtp_vars["smtp_port"].get())
        user = self._smtp_vars["smtp_user"].get()
        pwd  = self._smtp_vars["smtp_pass"].get()
        tls  = self.tls_var.get()
        s = smtplib.SMTP(host, port, timeout=10)
        if tls:
            s.starttls()
        if user and pwd:
            s.login(user, pwd)
        return s

    def _test_connection(self):
        self.status_var.set("接続テスト中...")
        def _do():
            try:
                s = self._get_smtp()
                s.quit()
                self.root.after(0, self.status_var.set, "接続テスト: 成功")
            except Exception as e:
                self.root.after(0, self.status_var.set, f"接続テスト: 失敗 - {e}")
        threading.Thread(target=_do, daemon=True).start()

    def _build_msg(self, recipient):
        from_name  = self._smtp_vars["from_name"].get()
        from_email = self._smtp_vars["smtp_user"].get()
        subject    = self.subject_var.get()
        body_tpl   = self.body_text.get("1.0", tk.END)
        body       = body_tpl.replace("{name}", recipient["name"])

        msg = MIMEMultipart()
        msg["From"]    = f"{from_name} <{from_email}>"
        msg["To"]      = recipient["email"]
        msg["Subject"] = subject
        msg.attach(MIMEText(body, "plain", "utf-8"))

        if self._attachment:
            with open(self._attachment, "rb") as f:
                part = MIMEBase("application", "octet-stream")
                part.set_payload(f.read())
            encoders.encode_base64(part)
            part.add_header("Content-Disposition",
                             f'attachment; filename="{os.path.basename(self._attachment)}"')
            msg.attach(part)
        return msg

    def _send_all(self):
        if not self._recipients:
            messagebox.showwarning("警告", "宛先を追加してください")
            return
        if not messagebox.askyesno("確認",
                                    f"{len(self._recipients)} 件にメールを送信しますか?"):
            return
        self.progress["maximum"] = len(self._recipients)
        self.progress["value"]   = 0
        threading.Thread(target=self._do_send, daemon=True).start()

    def _do_send(self):
        ok = err = 0
        try:
            smtp = self._get_smtp()
        except Exception as e:
            self.root.after(0, self.status_var.set, f"SMTP接続失敗: {e}")
            return

        iids = self.rec_tree.get_children()
        for i, (rec, iid) in enumerate(zip(self._recipients, iids)):
            try:
                msg = self._build_msg(rec)
                smtp.sendmail(self._smtp_vars["smtp_user"].get(),
                               [rec["email"]], msg.as_string())
                rec["status"] = "送信済"
                self.root.after(0, self.rec_tree.item, iid,
                                 {"values": ("✔", rec["name"], rec["email"]),
                                  "tags": ("sent",)})
                ok += 1
            except Exception as e:
                rec["status"] = f"エラー: {e}"
                self.root.after(0, self.rec_tree.item, iid,
                                 {"values": (f"✘", rec["name"], rec["email"]),
                                  "tags": ("error",)})
                err += 1
            self.root.after(0, self.progress.configure, {"value": i + 1})

        smtp.quit()
        self.root.after(0, self.status_var.set,
                         f"送信完了: {ok} 件成功 / {err} 件失敗")


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

5. コード解説

メール一括送信ツールのコードを詳しく解説します。クラスベースの設計で各機能を整理して実装しています。

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

App093クラスにアプリの全機能をまとめています。__init__でウィンドウ設定、_build_ui()でUI構築、process()でメイン処理を担当します。責任の分離により、コードが読みやすくなります。

import tkinter as tk
from tkinter import ttk, messagebox, filedialog
import smtplib
import threading
import csv
import os
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart
from email.mime.base import MIMEBase
from email import encoders
from datetime import datetime


class App093:
    """メール一括送信ツール"""

    def __init__(self, root):
        self.root = root
        self.root.title("メール一括送信ツール")
        self.root.geometry("960x640")
        self.root.configure(bg="#1e1e1e")
        self._recipients = []    # [{"name": ..., "email": ..., "status": ...}]
        self._attachment = None
        self._build_ui()

    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)

        tk.Label(self.root,
                 text="⚠ 送信テストは必ずダミーメールサービス (Mailtrap等) で行ってください。",
                 bg="#fff3cd", fg="#856404", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X)

        # メインPaned
        paned = ttk.PanedWindow(self.root, orient=tk.HORIZONTAL)
        paned.pack(fill=tk.BOTH, expand=True, padx=4, pady=4)

        # 左: SMTP + 宛先
        left = tk.Frame(paned, bg="#1e1e1e", width=420)
        paned.add(left, weight=0)

        # SMTP設定
        smtp_f = tk.LabelFrame(left, text="SMTP設定", bg="#252526",
                                fg="#ccc", font=("Arial", 9), padx=6, pady=4)
        smtp_f.pack(fill=tk.X, padx=4, pady=4)

        fields = [
            ("SMTPサーバー",   "smtp_host", "smtp.gmail.com"),
            ("ポート",         "smtp_port", "587"),
            ("ユーザー名",     "smtp_user", "your@email.com"),
            ("パスワード",     "smtp_pass", ""),
            ("差出人名",       "from_name", "送信者名"),
        ]
        self._smtp_vars = {}
        for i, (label, key, default) in enumerate(fields):
            tk.Label(smtp_f, text=f"{label}:", bg="#252526", fg="#ccc",
                     font=("Arial", 9), width=12, anchor="e").grid(
                row=i, column=0, sticky="e", pady=1)
            v = tk.StringVar(value=default)
            self._smtp_vars[key] = v
            show = "*" if key == "smtp_pass" else ""
            ttk.Entry(smtp_f, textvariable=v, width=22,
                      show=show).grid(row=i, column=1, padx=4, pady=1, sticky="w")

        self.tls_var = tk.BooleanVar(value=True)
        tk.Checkbutton(smtp_f, text="TLS/STARTTLS を使用",
                       variable=self.tls_var,
                       bg="#252526", fg="#ccc", selectcolor="#3c3c3c",
                       activebackground="#252526").grid(
            row=len(fields), column=0, columnspan=2, sticky="w")

        # 宛先リスト
        tk.Label(left, text="宛先一覧", bg="#1e1e1e", fg="#888",
                 font=("Arial", 9)).pack(anchor="w", padx=4, pady=(8, 0))
        btn_row = tk.Frame(left, bg="#1e1e1e")
        btn_row.pack(fill=tk.X, padx=4)
        ttk.Button(btn_row, text="+ 追加",
                   command=self._add_recipient).pack(side=tk.LEFT, padx=2)
        ttk.Button(btn_row, text="📂 CSVインポート",
                   command=self._import_csv).pack(side=tk.LEFT, padx=2)
        ttk.Button(btn_row, text="🗑 削除",
                   command=self._remove_recipient).pack(side=tk.LEFT, padx=2)
        ttk.Button(btn_row, text="全クリア",
                   command=self._clear_recipients).pack(side=tk.LEFT, padx=2)

        cols = ("status", "name", "email")
        self.rec_tree = ttk.Treeview(left, columns=cols, show="headings", height=10)
        self.rec_tree.heading("status", text="状態")
        self.rec_tree.heading("name",   text="名前")
        self.rec_tree.heading("email",  text="メールアドレス")
        self.rec_tree.column("status", width=60,  anchor="center")
        self.rec_tree.column("name",   width=100, anchor="w")
        self.rec_tree.column("email",  width=200, anchor="w")
        rsb = ttk.Scrollbar(left, command=self.rec_tree.yview)
        self.rec_tree.configure(yscrollcommand=rsb.set)
        rsb.pack(side=tk.RIGHT, fill=tk.Y)
        self.rec_tree.pack(fill=tk.BOTH, expand=True, padx=(4, 0))
        self.rec_tree.tag_configure("sent",  foreground="#26a69a")
        self.rec_tree.tag_configure("error", foreground="#ef5350")

        # 右: メール本文
        right = tk.Frame(paned, bg="#1e1e1e")
        paned.add(right, weight=1)

        tk.Label(right, text="件名:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(anchor="w", padx=4)
        self.subject_var = tk.StringVar(value="お知らせ")
        ttk.Entry(right, textvariable=self.subject_var).pack(
            fill=tk.X, padx=4, pady=2)

        tk.Label(right, text="本文 ({name} で宛先名を差し込み):",
                 bg="#1e1e1e", fg="#ccc", font=("Arial", 9)).pack(
            anchor="w", padx=4)
        self.body_text = tk.Text(right, bg="#0d1117", fg="#c9d1d9",
                                  font=("Arial", 10), relief=tk.FLAT,
                                  insertbackground="white", wrap=tk.WORD)
        bsb = ttk.Scrollbar(right, command=self.body_text.yview)
        self.body_text.configure(yscrollcommand=bsb.set)
        bsb.pack(side=tk.RIGHT, fill=tk.Y)
        self.body_text.pack(fill=tk.BOTH, expand=True, padx=(4, 0))
        self.body_text.insert("1.0",
                               "{name} 様\n\nいつもお世話になっております。\n\nよろしくお願いいたします。")

        # 添付ファイル
        att_row = tk.Frame(right, bg="#1e1e1e")
        att_row.pack(fill=tk.X, padx=4, pady=2)
        tk.Label(att_row, text="添付:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(side=tk.LEFT)
        self.att_var = tk.StringVar(value="(なし)")
        tk.Label(att_row, textvariable=self.att_var, bg="#1e1e1e",
                 fg="#888", font=("Arial", 9)).pack(side=tk.LEFT, padx=4)
        ttk.Button(att_row, text="ファイル選択",
                   command=self._pick_attachment).pack(side=tk.LEFT)
        ttk.Button(att_row, text="クリア",
                   command=lambda: (self.att_var.set("(なし)"),
                                    setattr(self, "_attachment", None))
                   ).pack(side=tk.LEFT, padx=2)

        # 送信ボタン
        btn_row2 = tk.Frame(right, bg="#1e1e1e", pady=4)
        btn_row2.pack(fill=tk.X, padx=4)
        tk.Button(btn_row2, text="📧 一括送信開始", command=self._send_all,
                  bg="#1565c0", fg="white", relief=tk.FLAT,
                  font=("Arial", 12, "bold"), padx=20, pady=6,
                  activebackground="#0d47a1", bd=0).pack(side=tk.LEFT)
        ttk.Button(btn_row2, text="🔧 接続テスト",
                   command=self._test_connection).pack(side=tk.LEFT, padx=8)

        self.progress = ttk.Progressbar(self.root, mode="determinate")
        self.progress.pack(fill=tk.X, padx=8)
        self.status_var = tk.StringVar(value="SMTP設定と宛先を入力してください")
        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 _add_recipient(self):
        dlg = tk.Toplevel(self.root)
        dlg.title("宛先追加")
        dlg.configure(bg="#252526")
        dlg.grab_set()
        name_var  = tk.StringVar()
        email_var = tk.StringVar()
        for label, var in [("名前:", name_var), ("メール:", email_var)]:
            row = tk.Frame(dlg, bg="#252526")
            row.pack(fill=tk.X, padx=12, pady=4)
            tk.Label(row, text=label, bg="#252526", fg="#ccc",
                     width=8, anchor="w").pack(side=tk.LEFT)
            ttk.Entry(row, textvariable=var, width=26).pack(side=tk.LEFT)
        def _ok():
            n = name_var.get().strip()
            e = email_var.get().strip()
            if not e:
                return
            self._recipients.append({"name": n, "email": e, "status": "未送信"})
            self.rec_tree.insert("", tk.END, values=("─", n, e))
            dlg.destroy()
        ttk.Button(dlg, text="追加", command=_ok).pack(pady=8)

    def _import_csv(self):
        path = filedialog.askopenfilename(
            filetypes=[("CSV", "*.csv"), ("すべて", "*.*")])
        if not path:
            return
        try:
            with open(path, encoding="utf-8-sig", newline="") as f:
                reader = csv.DictReader(f)
                for row in reader:
                    name  = row.get("name", row.get("名前", ""))
                    email = row.get("email", row.get("メール", row.get("mail", "")))
                    if email:
                        self._recipients.append(
                            {"name": name, "email": email, "status": "未送信"})
                        self.rec_tree.insert("", tk.END,
                                              values=("─", name, email))
            self.status_var.set(f"インポート完了: {len(self._recipients)} 件")
        except Exception as e:
            messagebox.showerror("エラー", str(e))

    def _remove_recipient(self):
        for sel in self.rec_tree.selection():
            idx = self.rec_tree.index(sel)
            if idx < len(self._recipients):
                del self._recipients[idx]
            self.rec_tree.delete(sel)

    def _clear_recipients(self):
        self._recipients.clear()
        self.rec_tree.delete(*self.rec_tree.get_children())

    def _pick_attachment(self):
        path = filedialog.askopenfilename()
        if path:
            self._attachment = path
            self.att_var.set(os.path.basename(path))

    # ── SMTP ────────────────────────────────────────────────
    def _get_smtp(self):
        host = self._smtp_vars["smtp_host"].get()
        port = int(self._smtp_vars["smtp_port"].get())
        user = self._smtp_vars["smtp_user"].get()
        pwd  = self._smtp_vars["smtp_pass"].get()
        tls  = self.tls_var.get()
        s = smtplib.SMTP(host, port, timeout=10)
        if tls:
            s.starttls()
        if user and pwd:
            s.login(user, pwd)
        return s

    def _test_connection(self):
        self.status_var.set("接続テスト中...")
        def _do():
            try:
                s = self._get_smtp()
                s.quit()
                self.root.after(0, self.status_var.set, "接続テスト: 成功")
            except Exception as e:
                self.root.after(0, self.status_var.set, f"接続テスト: 失敗 - {e}")
        threading.Thread(target=_do, daemon=True).start()

    def _build_msg(self, recipient):
        from_name  = self._smtp_vars["from_name"].get()
        from_email = self._smtp_vars["smtp_user"].get()
        subject    = self.subject_var.get()
        body_tpl   = self.body_text.get("1.0", tk.END)
        body       = body_tpl.replace("{name}", recipient["name"])

        msg = MIMEMultipart()
        msg["From"]    = f"{from_name} <{from_email}>"
        msg["To"]      = recipient["email"]
        msg["Subject"] = subject
        msg.attach(MIMEText(body, "plain", "utf-8"))

        if self._attachment:
            with open(self._attachment, "rb") as f:
                part = MIMEBase("application", "octet-stream")
                part.set_payload(f.read())
            encoders.encode_base64(part)
            part.add_header("Content-Disposition",
                             f'attachment; filename="{os.path.basename(self._attachment)}"')
            msg.attach(part)
        return msg

    def _send_all(self):
        if not self._recipients:
            messagebox.showwarning("警告", "宛先を追加してください")
            return
        if not messagebox.askyesno("確認",
                                    f"{len(self._recipients)} 件にメールを送信しますか?"):
            return
        self.progress["maximum"] = len(self._recipients)
        self.progress["value"]   = 0
        threading.Thread(target=self._do_send, daemon=True).start()

    def _do_send(self):
        ok = err = 0
        try:
            smtp = self._get_smtp()
        except Exception as e:
            self.root.after(0, self.status_var.set, f"SMTP接続失敗: {e}")
            return

        iids = self.rec_tree.get_children()
        for i, (rec, iid) in enumerate(zip(self._recipients, iids)):
            try:
                msg = self._build_msg(rec)
                smtp.sendmail(self._smtp_vars["smtp_user"].get(),
                               [rec["email"]], msg.as_string())
                rec["status"] = "送信済"
                self.root.after(0, self.rec_tree.item, iid,
                                 {"values": ("✔", rec["name"], rec["email"]),
                                  "tags": ("sent",)})
                ok += 1
            except Exception as e:
                rec["status"] = f"エラー: {e}"
                self.root.after(0, self.rec_tree.item, iid,
                                 {"values": (f"✘", rec["name"], rec["email"]),
                                  "tags": ("error",)})
                err += 1
            self.root.after(0, self.progress.configure, {"value": i + 1})

        smtp.quit()
        self.root.after(0, self.status_var.set,
                         f"送信完了: {ok} 件成功 / {err} 件失敗")


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

UIレイアウトの構築

LabelFrameで入力エリアと結果エリアを視覚的に分けています。pack()で縦に並べ、expand=Trueで結果エリアが画面いっぱいに広がるよう設定しています。

import tkinter as tk
from tkinter import ttk, messagebox, filedialog
import smtplib
import threading
import csv
import os
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart
from email.mime.base import MIMEBase
from email import encoders
from datetime import datetime


class App093:
    """メール一括送信ツール"""

    def __init__(self, root):
        self.root = root
        self.root.title("メール一括送信ツール")
        self.root.geometry("960x640")
        self.root.configure(bg="#1e1e1e")
        self._recipients = []    # [{"name": ..., "email": ..., "status": ...}]
        self._attachment = None
        self._build_ui()

    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)

        tk.Label(self.root,
                 text="⚠ 送信テストは必ずダミーメールサービス (Mailtrap等) で行ってください。",
                 bg="#fff3cd", fg="#856404", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X)

        # メインPaned
        paned = ttk.PanedWindow(self.root, orient=tk.HORIZONTAL)
        paned.pack(fill=tk.BOTH, expand=True, padx=4, pady=4)

        # 左: SMTP + 宛先
        left = tk.Frame(paned, bg="#1e1e1e", width=420)
        paned.add(left, weight=0)

        # SMTP設定
        smtp_f = tk.LabelFrame(left, text="SMTP設定", bg="#252526",
                                fg="#ccc", font=("Arial", 9), padx=6, pady=4)
        smtp_f.pack(fill=tk.X, padx=4, pady=4)

        fields = [
            ("SMTPサーバー",   "smtp_host", "smtp.gmail.com"),
            ("ポート",         "smtp_port", "587"),
            ("ユーザー名",     "smtp_user", "your@email.com"),
            ("パスワード",     "smtp_pass", ""),
            ("差出人名",       "from_name", "送信者名"),
        ]
        self._smtp_vars = {}
        for i, (label, key, default) in enumerate(fields):
            tk.Label(smtp_f, text=f"{label}:", bg="#252526", fg="#ccc",
                     font=("Arial", 9), width=12, anchor="e").grid(
                row=i, column=0, sticky="e", pady=1)
            v = tk.StringVar(value=default)
            self._smtp_vars[key] = v
            show = "*" if key == "smtp_pass" else ""
            ttk.Entry(smtp_f, textvariable=v, width=22,
                      show=show).grid(row=i, column=1, padx=4, pady=1, sticky="w")

        self.tls_var = tk.BooleanVar(value=True)
        tk.Checkbutton(smtp_f, text="TLS/STARTTLS を使用",
                       variable=self.tls_var,
                       bg="#252526", fg="#ccc", selectcolor="#3c3c3c",
                       activebackground="#252526").grid(
            row=len(fields), column=0, columnspan=2, sticky="w")

        # 宛先リスト
        tk.Label(left, text="宛先一覧", bg="#1e1e1e", fg="#888",
                 font=("Arial", 9)).pack(anchor="w", padx=4, pady=(8, 0))
        btn_row = tk.Frame(left, bg="#1e1e1e")
        btn_row.pack(fill=tk.X, padx=4)
        ttk.Button(btn_row, text="+ 追加",
                   command=self._add_recipient).pack(side=tk.LEFT, padx=2)
        ttk.Button(btn_row, text="📂 CSVインポート",
                   command=self._import_csv).pack(side=tk.LEFT, padx=2)
        ttk.Button(btn_row, text="🗑 削除",
                   command=self._remove_recipient).pack(side=tk.LEFT, padx=2)
        ttk.Button(btn_row, text="全クリア",
                   command=self._clear_recipients).pack(side=tk.LEFT, padx=2)

        cols = ("status", "name", "email")
        self.rec_tree = ttk.Treeview(left, columns=cols, show="headings", height=10)
        self.rec_tree.heading("status", text="状態")
        self.rec_tree.heading("name",   text="名前")
        self.rec_tree.heading("email",  text="メールアドレス")
        self.rec_tree.column("status", width=60,  anchor="center")
        self.rec_tree.column("name",   width=100, anchor="w")
        self.rec_tree.column("email",  width=200, anchor="w")
        rsb = ttk.Scrollbar(left, command=self.rec_tree.yview)
        self.rec_tree.configure(yscrollcommand=rsb.set)
        rsb.pack(side=tk.RIGHT, fill=tk.Y)
        self.rec_tree.pack(fill=tk.BOTH, expand=True, padx=(4, 0))
        self.rec_tree.tag_configure("sent",  foreground="#26a69a")
        self.rec_tree.tag_configure("error", foreground="#ef5350")

        # 右: メール本文
        right = tk.Frame(paned, bg="#1e1e1e")
        paned.add(right, weight=1)

        tk.Label(right, text="件名:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(anchor="w", padx=4)
        self.subject_var = tk.StringVar(value="お知らせ")
        ttk.Entry(right, textvariable=self.subject_var).pack(
            fill=tk.X, padx=4, pady=2)

        tk.Label(right, text="本文 ({name} で宛先名を差し込み):",
                 bg="#1e1e1e", fg="#ccc", font=("Arial", 9)).pack(
            anchor="w", padx=4)
        self.body_text = tk.Text(right, bg="#0d1117", fg="#c9d1d9",
                                  font=("Arial", 10), relief=tk.FLAT,
                                  insertbackground="white", wrap=tk.WORD)
        bsb = ttk.Scrollbar(right, command=self.body_text.yview)
        self.body_text.configure(yscrollcommand=bsb.set)
        bsb.pack(side=tk.RIGHT, fill=tk.Y)
        self.body_text.pack(fill=tk.BOTH, expand=True, padx=(4, 0))
        self.body_text.insert("1.0",
                               "{name} 様\n\nいつもお世話になっております。\n\nよろしくお願いいたします。")

        # 添付ファイル
        att_row = tk.Frame(right, bg="#1e1e1e")
        att_row.pack(fill=tk.X, padx=4, pady=2)
        tk.Label(att_row, text="添付:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(side=tk.LEFT)
        self.att_var = tk.StringVar(value="(なし)")
        tk.Label(att_row, textvariable=self.att_var, bg="#1e1e1e",
                 fg="#888", font=("Arial", 9)).pack(side=tk.LEFT, padx=4)
        ttk.Button(att_row, text="ファイル選択",
                   command=self._pick_attachment).pack(side=tk.LEFT)
        ttk.Button(att_row, text="クリア",
                   command=lambda: (self.att_var.set("(なし)"),
                                    setattr(self, "_attachment", None))
                   ).pack(side=tk.LEFT, padx=2)

        # 送信ボタン
        btn_row2 = tk.Frame(right, bg="#1e1e1e", pady=4)
        btn_row2.pack(fill=tk.X, padx=4)
        tk.Button(btn_row2, text="📧 一括送信開始", command=self._send_all,
                  bg="#1565c0", fg="white", relief=tk.FLAT,
                  font=("Arial", 12, "bold"), padx=20, pady=6,
                  activebackground="#0d47a1", bd=0).pack(side=tk.LEFT)
        ttk.Button(btn_row2, text="🔧 接続テスト",
                   command=self._test_connection).pack(side=tk.LEFT, padx=8)

        self.progress = ttk.Progressbar(self.root, mode="determinate")
        self.progress.pack(fill=tk.X, padx=8)
        self.status_var = tk.StringVar(value="SMTP設定と宛先を入力してください")
        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 _add_recipient(self):
        dlg = tk.Toplevel(self.root)
        dlg.title("宛先追加")
        dlg.configure(bg="#252526")
        dlg.grab_set()
        name_var  = tk.StringVar()
        email_var = tk.StringVar()
        for label, var in [("名前:", name_var), ("メール:", email_var)]:
            row = tk.Frame(dlg, bg="#252526")
            row.pack(fill=tk.X, padx=12, pady=4)
            tk.Label(row, text=label, bg="#252526", fg="#ccc",
                     width=8, anchor="w").pack(side=tk.LEFT)
            ttk.Entry(row, textvariable=var, width=26).pack(side=tk.LEFT)
        def _ok():
            n = name_var.get().strip()
            e = email_var.get().strip()
            if not e:
                return
            self._recipients.append({"name": n, "email": e, "status": "未送信"})
            self.rec_tree.insert("", tk.END, values=("─", n, e))
            dlg.destroy()
        ttk.Button(dlg, text="追加", command=_ok).pack(pady=8)

    def _import_csv(self):
        path = filedialog.askopenfilename(
            filetypes=[("CSV", "*.csv"), ("すべて", "*.*")])
        if not path:
            return
        try:
            with open(path, encoding="utf-8-sig", newline="") as f:
                reader = csv.DictReader(f)
                for row in reader:
                    name  = row.get("name", row.get("名前", ""))
                    email = row.get("email", row.get("メール", row.get("mail", "")))
                    if email:
                        self._recipients.append(
                            {"name": name, "email": email, "status": "未送信"})
                        self.rec_tree.insert("", tk.END,
                                              values=("─", name, email))
            self.status_var.set(f"インポート完了: {len(self._recipients)} 件")
        except Exception as e:
            messagebox.showerror("エラー", str(e))

    def _remove_recipient(self):
        for sel in self.rec_tree.selection():
            idx = self.rec_tree.index(sel)
            if idx < len(self._recipients):
                del self._recipients[idx]
            self.rec_tree.delete(sel)

    def _clear_recipients(self):
        self._recipients.clear()
        self.rec_tree.delete(*self.rec_tree.get_children())

    def _pick_attachment(self):
        path = filedialog.askopenfilename()
        if path:
            self._attachment = path
            self.att_var.set(os.path.basename(path))

    # ── SMTP ────────────────────────────────────────────────
    def _get_smtp(self):
        host = self._smtp_vars["smtp_host"].get()
        port = int(self._smtp_vars["smtp_port"].get())
        user = self._smtp_vars["smtp_user"].get()
        pwd  = self._smtp_vars["smtp_pass"].get()
        tls  = self.tls_var.get()
        s = smtplib.SMTP(host, port, timeout=10)
        if tls:
            s.starttls()
        if user and pwd:
            s.login(user, pwd)
        return s

    def _test_connection(self):
        self.status_var.set("接続テスト中...")
        def _do():
            try:
                s = self._get_smtp()
                s.quit()
                self.root.after(0, self.status_var.set, "接続テスト: 成功")
            except Exception as e:
                self.root.after(0, self.status_var.set, f"接続テスト: 失敗 - {e}")
        threading.Thread(target=_do, daemon=True).start()

    def _build_msg(self, recipient):
        from_name  = self._smtp_vars["from_name"].get()
        from_email = self._smtp_vars["smtp_user"].get()
        subject    = self.subject_var.get()
        body_tpl   = self.body_text.get("1.0", tk.END)
        body       = body_tpl.replace("{name}", recipient["name"])

        msg = MIMEMultipart()
        msg["From"]    = f"{from_name} <{from_email}>"
        msg["To"]      = recipient["email"]
        msg["Subject"] = subject
        msg.attach(MIMEText(body, "plain", "utf-8"))

        if self._attachment:
            with open(self._attachment, "rb") as f:
                part = MIMEBase("application", "octet-stream")
                part.set_payload(f.read())
            encoders.encode_base64(part)
            part.add_header("Content-Disposition",
                             f'attachment; filename="{os.path.basename(self._attachment)}"')
            msg.attach(part)
        return msg

    def _send_all(self):
        if not self._recipients:
            messagebox.showwarning("警告", "宛先を追加してください")
            return
        if not messagebox.askyesno("確認",
                                    f"{len(self._recipients)} 件にメールを送信しますか?"):
            return
        self.progress["maximum"] = len(self._recipients)
        self.progress["value"]   = 0
        threading.Thread(target=self._do_send, daemon=True).start()

    def _do_send(self):
        ok = err = 0
        try:
            smtp = self._get_smtp()
        except Exception as e:
            self.root.after(0, self.status_var.set, f"SMTP接続失敗: {e}")
            return

        iids = self.rec_tree.get_children()
        for i, (rec, iid) in enumerate(zip(self._recipients, iids)):
            try:
                msg = self._build_msg(rec)
                smtp.sendmail(self._smtp_vars["smtp_user"].get(),
                               [rec["email"]], msg.as_string())
                rec["status"] = "送信済"
                self.root.after(0, self.rec_tree.item, iid,
                                 {"values": ("✔", rec["name"], rec["email"]),
                                  "tags": ("sent",)})
                ok += 1
            except Exception as e:
                rec["status"] = f"エラー: {e}"
                self.root.after(0, self.rec_tree.item, iid,
                                 {"values": (f"✘", rec["name"], rec["email"]),
                                  "tags": ("error",)})
                err += 1
            self.root.after(0, self.progress.configure, {"value": i + 1})

        smtp.quit()
        self.root.after(0, self.status_var.set,
                         f"送信完了: {ok} 件成功 / {err} 件失敗")


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

イベント処理

ボタンのcommand引数でクリックイベントを、bind('')でEnterキーイベントを処理します。どちらの操作でも同じprocess()が呼ばれ、コードの重複を避けられます。

import tkinter as tk
from tkinter import ttk, messagebox, filedialog
import smtplib
import threading
import csv
import os
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart
from email.mime.base import MIMEBase
from email import encoders
from datetime import datetime


class App093:
    """メール一括送信ツール"""

    def __init__(self, root):
        self.root = root
        self.root.title("メール一括送信ツール")
        self.root.geometry("960x640")
        self.root.configure(bg="#1e1e1e")
        self._recipients = []    # [{"name": ..., "email": ..., "status": ...}]
        self._attachment = None
        self._build_ui()

    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)

        tk.Label(self.root,
                 text="⚠ 送信テストは必ずダミーメールサービス (Mailtrap等) で行ってください。",
                 bg="#fff3cd", fg="#856404", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X)

        # メインPaned
        paned = ttk.PanedWindow(self.root, orient=tk.HORIZONTAL)
        paned.pack(fill=tk.BOTH, expand=True, padx=4, pady=4)

        # 左: SMTP + 宛先
        left = tk.Frame(paned, bg="#1e1e1e", width=420)
        paned.add(left, weight=0)

        # SMTP設定
        smtp_f = tk.LabelFrame(left, text="SMTP設定", bg="#252526",
                                fg="#ccc", font=("Arial", 9), padx=6, pady=4)
        smtp_f.pack(fill=tk.X, padx=4, pady=4)

        fields = [
            ("SMTPサーバー",   "smtp_host", "smtp.gmail.com"),
            ("ポート",         "smtp_port", "587"),
            ("ユーザー名",     "smtp_user", "your@email.com"),
            ("パスワード",     "smtp_pass", ""),
            ("差出人名",       "from_name", "送信者名"),
        ]
        self._smtp_vars = {}
        for i, (label, key, default) in enumerate(fields):
            tk.Label(smtp_f, text=f"{label}:", bg="#252526", fg="#ccc",
                     font=("Arial", 9), width=12, anchor="e").grid(
                row=i, column=0, sticky="e", pady=1)
            v = tk.StringVar(value=default)
            self._smtp_vars[key] = v
            show = "*" if key == "smtp_pass" else ""
            ttk.Entry(smtp_f, textvariable=v, width=22,
                      show=show).grid(row=i, column=1, padx=4, pady=1, sticky="w")

        self.tls_var = tk.BooleanVar(value=True)
        tk.Checkbutton(smtp_f, text="TLS/STARTTLS を使用",
                       variable=self.tls_var,
                       bg="#252526", fg="#ccc", selectcolor="#3c3c3c",
                       activebackground="#252526").grid(
            row=len(fields), column=0, columnspan=2, sticky="w")

        # 宛先リスト
        tk.Label(left, text="宛先一覧", bg="#1e1e1e", fg="#888",
                 font=("Arial", 9)).pack(anchor="w", padx=4, pady=(8, 0))
        btn_row = tk.Frame(left, bg="#1e1e1e")
        btn_row.pack(fill=tk.X, padx=4)
        ttk.Button(btn_row, text="+ 追加",
                   command=self._add_recipient).pack(side=tk.LEFT, padx=2)
        ttk.Button(btn_row, text="📂 CSVインポート",
                   command=self._import_csv).pack(side=tk.LEFT, padx=2)
        ttk.Button(btn_row, text="🗑 削除",
                   command=self._remove_recipient).pack(side=tk.LEFT, padx=2)
        ttk.Button(btn_row, text="全クリア",
                   command=self._clear_recipients).pack(side=tk.LEFT, padx=2)

        cols = ("status", "name", "email")
        self.rec_tree = ttk.Treeview(left, columns=cols, show="headings", height=10)
        self.rec_tree.heading("status", text="状態")
        self.rec_tree.heading("name",   text="名前")
        self.rec_tree.heading("email",  text="メールアドレス")
        self.rec_tree.column("status", width=60,  anchor="center")
        self.rec_tree.column("name",   width=100, anchor="w")
        self.rec_tree.column("email",  width=200, anchor="w")
        rsb = ttk.Scrollbar(left, command=self.rec_tree.yview)
        self.rec_tree.configure(yscrollcommand=rsb.set)
        rsb.pack(side=tk.RIGHT, fill=tk.Y)
        self.rec_tree.pack(fill=tk.BOTH, expand=True, padx=(4, 0))
        self.rec_tree.tag_configure("sent",  foreground="#26a69a")
        self.rec_tree.tag_configure("error", foreground="#ef5350")

        # 右: メール本文
        right = tk.Frame(paned, bg="#1e1e1e")
        paned.add(right, weight=1)

        tk.Label(right, text="件名:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(anchor="w", padx=4)
        self.subject_var = tk.StringVar(value="お知らせ")
        ttk.Entry(right, textvariable=self.subject_var).pack(
            fill=tk.X, padx=4, pady=2)

        tk.Label(right, text="本文 ({name} で宛先名を差し込み):",
                 bg="#1e1e1e", fg="#ccc", font=("Arial", 9)).pack(
            anchor="w", padx=4)
        self.body_text = tk.Text(right, bg="#0d1117", fg="#c9d1d9",
                                  font=("Arial", 10), relief=tk.FLAT,
                                  insertbackground="white", wrap=tk.WORD)
        bsb = ttk.Scrollbar(right, command=self.body_text.yview)
        self.body_text.configure(yscrollcommand=bsb.set)
        bsb.pack(side=tk.RIGHT, fill=tk.Y)
        self.body_text.pack(fill=tk.BOTH, expand=True, padx=(4, 0))
        self.body_text.insert("1.0",
                               "{name} 様\n\nいつもお世話になっております。\n\nよろしくお願いいたします。")

        # 添付ファイル
        att_row = tk.Frame(right, bg="#1e1e1e")
        att_row.pack(fill=tk.X, padx=4, pady=2)
        tk.Label(att_row, text="添付:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(side=tk.LEFT)
        self.att_var = tk.StringVar(value="(なし)")
        tk.Label(att_row, textvariable=self.att_var, bg="#1e1e1e",
                 fg="#888", font=("Arial", 9)).pack(side=tk.LEFT, padx=4)
        ttk.Button(att_row, text="ファイル選択",
                   command=self._pick_attachment).pack(side=tk.LEFT)
        ttk.Button(att_row, text="クリア",
                   command=lambda: (self.att_var.set("(なし)"),
                                    setattr(self, "_attachment", None))
                   ).pack(side=tk.LEFT, padx=2)

        # 送信ボタン
        btn_row2 = tk.Frame(right, bg="#1e1e1e", pady=4)
        btn_row2.pack(fill=tk.X, padx=4)
        tk.Button(btn_row2, text="📧 一括送信開始", command=self._send_all,
                  bg="#1565c0", fg="white", relief=tk.FLAT,
                  font=("Arial", 12, "bold"), padx=20, pady=6,
                  activebackground="#0d47a1", bd=0).pack(side=tk.LEFT)
        ttk.Button(btn_row2, text="🔧 接続テスト",
                   command=self._test_connection).pack(side=tk.LEFT, padx=8)

        self.progress = ttk.Progressbar(self.root, mode="determinate")
        self.progress.pack(fill=tk.X, padx=8)
        self.status_var = tk.StringVar(value="SMTP設定と宛先を入力してください")
        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 _add_recipient(self):
        dlg = tk.Toplevel(self.root)
        dlg.title("宛先追加")
        dlg.configure(bg="#252526")
        dlg.grab_set()
        name_var  = tk.StringVar()
        email_var = tk.StringVar()
        for label, var in [("名前:", name_var), ("メール:", email_var)]:
            row = tk.Frame(dlg, bg="#252526")
            row.pack(fill=tk.X, padx=12, pady=4)
            tk.Label(row, text=label, bg="#252526", fg="#ccc",
                     width=8, anchor="w").pack(side=tk.LEFT)
            ttk.Entry(row, textvariable=var, width=26).pack(side=tk.LEFT)
        def _ok():
            n = name_var.get().strip()
            e = email_var.get().strip()
            if not e:
                return
            self._recipients.append({"name": n, "email": e, "status": "未送信"})
            self.rec_tree.insert("", tk.END, values=("─", n, e))
            dlg.destroy()
        ttk.Button(dlg, text="追加", command=_ok).pack(pady=8)

    def _import_csv(self):
        path = filedialog.askopenfilename(
            filetypes=[("CSV", "*.csv"), ("すべて", "*.*")])
        if not path:
            return
        try:
            with open(path, encoding="utf-8-sig", newline="") as f:
                reader = csv.DictReader(f)
                for row in reader:
                    name  = row.get("name", row.get("名前", ""))
                    email = row.get("email", row.get("メール", row.get("mail", "")))
                    if email:
                        self._recipients.append(
                            {"name": name, "email": email, "status": "未送信"})
                        self.rec_tree.insert("", tk.END,
                                              values=("─", name, email))
            self.status_var.set(f"インポート完了: {len(self._recipients)} 件")
        except Exception as e:
            messagebox.showerror("エラー", str(e))

    def _remove_recipient(self):
        for sel in self.rec_tree.selection():
            idx = self.rec_tree.index(sel)
            if idx < len(self._recipients):
                del self._recipients[idx]
            self.rec_tree.delete(sel)

    def _clear_recipients(self):
        self._recipients.clear()
        self.rec_tree.delete(*self.rec_tree.get_children())

    def _pick_attachment(self):
        path = filedialog.askopenfilename()
        if path:
            self._attachment = path
            self.att_var.set(os.path.basename(path))

    # ── SMTP ────────────────────────────────────────────────
    def _get_smtp(self):
        host = self._smtp_vars["smtp_host"].get()
        port = int(self._smtp_vars["smtp_port"].get())
        user = self._smtp_vars["smtp_user"].get()
        pwd  = self._smtp_vars["smtp_pass"].get()
        tls  = self.tls_var.get()
        s = smtplib.SMTP(host, port, timeout=10)
        if tls:
            s.starttls()
        if user and pwd:
            s.login(user, pwd)
        return s

    def _test_connection(self):
        self.status_var.set("接続テスト中...")
        def _do():
            try:
                s = self._get_smtp()
                s.quit()
                self.root.after(0, self.status_var.set, "接続テスト: 成功")
            except Exception as e:
                self.root.after(0, self.status_var.set, f"接続テスト: 失敗 - {e}")
        threading.Thread(target=_do, daemon=True).start()

    def _build_msg(self, recipient):
        from_name  = self._smtp_vars["from_name"].get()
        from_email = self._smtp_vars["smtp_user"].get()
        subject    = self.subject_var.get()
        body_tpl   = self.body_text.get("1.0", tk.END)
        body       = body_tpl.replace("{name}", recipient["name"])

        msg = MIMEMultipart()
        msg["From"]    = f"{from_name} <{from_email}>"
        msg["To"]      = recipient["email"]
        msg["Subject"] = subject
        msg.attach(MIMEText(body, "plain", "utf-8"))

        if self._attachment:
            with open(self._attachment, "rb") as f:
                part = MIMEBase("application", "octet-stream")
                part.set_payload(f.read())
            encoders.encode_base64(part)
            part.add_header("Content-Disposition",
                             f'attachment; filename="{os.path.basename(self._attachment)}"')
            msg.attach(part)
        return msg

    def _send_all(self):
        if not self._recipients:
            messagebox.showwarning("警告", "宛先を追加してください")
            return
        if not messagebox.askyesno("確認",
                                    f"{len(self._recipients)} 件にメールを送信しますか?"):
            return
        self.progress["maximum"] = len(self._recipients)
        self.progress["value"]   = 0
        threading.Thread(target=self._do_send, daemon=True).start()

    def _do_send(self):
        ok = err = 0
        try:
            smtp = self._get_smtp()
        except Exception as e:
            self.root.after(0, self.status_var.set, f"SMTP接続失敗: {e}")
            return

        iids = self.rec_tree.get_children()
        for i, (rec, iid) in enumerate(zip(self._recipients, iids)):
            try:
                msg = self._build_msg(rec)
                smtp.sendmail(self._smtp_vars["smtp_user"].get(),
                               [rec["email"]], msg.as_string())
                rec["status"] = "送信済"
                self.root.after(0, self.rec_tree.item, iid,
                                 {"values": ("✔", rec["name"], rec["email"]),
                                  "tags": ("sent",)})
                ok += 1
            except Exception as e:
                rec["status"] = f"エラー: {e}"
                self.root.after(0, self.rec_tree.item, iid,
                                 {"values": (f"✘", rec["name"], rec["email"]),
                                  "tags": ("error",)})
                err += 1
            self.root.after(0, self.progress.configure, {"value": i + 1})

        smtp.quit()
        self.root.after(0, self.status_var.set,
                         f"送信完了: {ok} 件成功 / {err} 件失敗")


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

Textウィジェットでの結果表示

tk.Textウィジェットをstate=DISABLED(読み取り専用)で作成し、更新時はNORMALに変更してinsert()で内容を書き込み、再びDISABLEDに戻します。

import tkinter as tk
from tkinter import ttk, messagebox, filedialog
import smtplib
import threading
import csv
import os
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart
from email.mime.base import MIMEBase
from email import encoders
from datetime import datetime


class App093:
    """メール一括送信ツール"""

    def __init__(self, root):
        self.root = root
        self.root.title("メール一括送信ツール")
        self.root.geometry("960x640")
        self.root.configure(bg="#1e1e1e")
        self._recipients = []    # [{"name": ..., "email": ..., "status": ...}]
        self._attachment = None
        self._build_ui()

    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)

        tk.Label(self.root,
                 text="⚠ 送信テストは必ずダミーメールサービス (Mailtrap等) で行ってください。",
                 bg="#fff3cd", fg="#856404", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X)

        # メインPaned
        paned = ttk.PanedWindow(self.root, orient=tk.HORIZONTAL)
        paned.pack(fill=tk.BOTH, expand=True, padx=4, pady=4)

        # 左: SMTP + 宛先
        left = tk.Frame(paned, bg="#1e1e1e", width=420)
        paned.add(left, weight=0)

        # SMTP設定
        smtp_f = tk.LabelFrame(left, text="SMTP設定", bg="#252526",
                                fg="#ccc", font=("Arial", 9), padx=6, pady=4)
        smtp_f.pack(fill=tk.X, padx=4, pady=4)

        fields = [
            ("SMTPサーバー",   "smtp_host", "smtp.gmail.com"),
            ("ポート",         "smtp_port", "587"),
            ("ユーザー名",     "smtp_user", "your@email.com"),
            ("パスワード",     "smtp_pass", ""),
            ("差出人名",       "from_name", "送信者名"),
        ]
        self._smtp_vars = {}
        for i, (label, key, default) in enumerate(fields):
            tk.Label(smtp_f, text=f"{label}:", bg="#252526", fg="#ccc",
                     font=("Arial", 9), width=12, anchor="e").grid(
                row=i, column=0, sticky="e", pady=1)
            v = tk.StringVar(value=default)
            self._smtp_vars[key] = v
            show = "*" if key == "smtp_pass" else ""
            ttk.Entry(smtp_f, textvariable=v, width=22,
                      show=show).grid(row=i, column=1, padx=4, pady=1, sticky="w")

        self.tls_var = tk.BooleanVar(value=True)
        tk.Checkbutton(smtp_f, text="TLS/STARTTLS を使用",
                       variable=self.tls_var,
                       bg="#252526", fg="#ccc", selectcolor="#3c3c3c",
                       activebackground="#252526").grid(
            row=len(fields), column=0, columnspan=2, sticky="w")

        # 宛先リスト
        tk.Label(left, text="宛先一覧", bg="#1e1e1e", fg="#888",
                 font=("Arial", 9)).pack(anchor="w", padx=4, pady=(8, 0))
        btn_row = tk.Frame(left, bg="#1e1e1e")
        btn_row.pack(fill=tk.X, padx=4)
        ttk.Button(btn_row, text="+ 追加",
                   command=self._add_recipient).pack(side=tk.LEFT, padx=2)
        ttk.Button(btn_row, text="📂 CSVインポート",
                   command=self._import_csv).pack(side=tk.LEFT, padx=2)
        ttk.Button(btn_row, text="🗑 削除",
                   command=self._remove_recipient).pack(side=tk.LEFT, padx=2)
        ttk.Button(btn_row, text="全クリア",
                   command=self._clear_recipients).pack(side=tk.LEFT, padx=2)

        cols = ("status", "name", "email")
        self.rec_tree = ttk.Treeview(left, columns=cols, show="headings", height=10)
        self.rec_tree.heading("status", text="状態")
        self.rec_tree.heading("name",   text="名前")
        self.rec_tree.heading("email",  text="メールアドレス")
        self.rec_tree.column("status", width=60,  anchor="center")
        self.rec_tree.column("name",   width=100, anchor="w")
        self.rec_tree.column("email",  width=200, anchor="w")
        rsb = ttk.Scrollbar(left, command=self.rec_tree.yview)
        self.rec_tree.configure(yscrollcommand=rsb.set)
        rsb.pack(side=tk.RIGHT, fill=tk.Y)
        self.rec_tree.pack(fill=tk.BOTH, expand=True, padx=(4, 0))
        self.rec_tree.tag_configure("sent",  foreground="#26a69a")
        self.rec_tree.tag_configure("error", foreground="#ef5350")

        # 右: メール本文
        right = tk.Frame(paned, bg="#1e1e1e")
        paned.add(right, weight=1)

        tk.Label(right, text="件名:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(anchor="w", padx=4)
        self.subject_var = tk.StringVar(value="お知らせ")
        ttk.Entry(right, textvariable=self.subject_var).pack(
            fill=tk.X, padx=4, pady=2)

        tk.Label(right, text="本文 ({name} で宛先名を差し込み):",
                 bg="#1e1e1e", fg="#ccc", font=("Arial", 9)).pack(
            anchor="w", padx=4)
        self.body_text = tk.Text(right, bg="#0d1117", fg="#c9d1d9",
                                  font=("Arial", 10), relief=tk.FLAT,
                                  insertbackground="white", wrap=tk.WORD)
        bsb = ttk.Scrollbar(right, command=self.body_text.yview)
        self.body_text.configure(yscrollcommand=bsb.set)
        bsb.pack(side=tk.RIGHT, fill=tk.Y)
        self.body_text.pack(fill=tk.BOTH, expand=True, padx=(4, 0))
        self.body_text.insert("1.0",
                               "{name} 様\n\nいつもお世話になっております。\n\nよろしくお願いいたします。")

        # 添付ファイル
        att_row = tk.Frame(right, bg="#1e1e1e")
        att_row.pack(fill=tk.X, padx=4, pady=2)
        tk.Label(att_row, text="添付:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(side=tk.LEFT)
        self.att_var = tk.StringVar(value="(なし)")
        tk.Label(att_row, textvariable=self.att_var, bg="#1e1e1e",
                 fg="#888", font=("Arial", 9)).pack(side=tk.LEFT, padx=4)
        ttk.Button(att_row, text="ファイル選択",
                   command=self._pick_attachment).pack(side=tk.LEFT)
        ttk.Button(att_row, text="クリア",
                   command=lambda: (self.att_var.set("(なし)"),
                                    setattr(self, "_attachment", None))
                   ).pack(side=tk.LEFT, padx=2)

        # 送信ボタン
        btn_row2 = tk.Frame(right, bg="#1e1e1e", pady=4)
        btn_row2.pack(fill=tk.X, padx=4)
        tk.Button(btn_row2, text="📧 一括送信開始", command=self._send_all,
                  bg="#1565c0", fg="white", relief=tk.FLAT,
                  font=("Arial", 12, "bold"), padx=20, pady=6,
                  activebackground="#0d47a1", bd=0).pack(side=tk.LEFT)
        ttk.Button(btn_row2, text="🔧 接続テスト",
                   command=self._test_connection).pack(side=tk.LEFT, padx=8)

        self.progress = ttk.Progressbar(self.root, mode="determinate")
        self.progress.pack(fill=tk.X, padx=8)
        self.status_var = tk.StringVar(value="SMTP設定と宛先を入力してください")
        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 _add_recipient(self):
        dlg = tk.Toplevel(self.root)
        dlg.title("宛先追加")
        dlg.configure(bg="#252526")
        dlg.grab_set()
        name_var  = tk.StringVar()
        email_var = tk.StringVar()
        for label, var in [("名前:", name_var), ("メール:", email_var)]:
            row = tk.Frame(dlg, bg="#252526")
            row.pack(fill=tk.X, padx=12, pady=4)
            tk.Label(row, text=label, bg="#252526", fg="#ccc",
                     width=8, anchor="w").pack(side=tk.LEFT)
            ttk.Entry(row, textvariable=var, width=26).pack(side=tk.LEFT)
        def _ok():
            n = name_var.get().strip()
            e = email_var.get().strip()
            if not e:
                return
            self._recipients.append({"name": n, "email": e, "status": "未送信"})
            self.rec_tree.insert("", tk.END, values=("─", n, e))
            dlg.destroy()
        ttk.Button(dlg, text="追加", command=_ok).pack(pady=8)

    def _import_csv(self):
        path = filedialog.askopenfilename(
            filetypes=[("CSV", "*.csv"), ("すべて", "*.*")])
        if not path:
            return
        try:
            with open(path, encoding="utf-8-sig", newline="") as f:
                reader = csv.DictReader(f)
                for row in reader:
                    name  = row.get("name", row.get("名前", ""))
                    email = row.get("email", row.get("メール", row.get("mail", "")))
                    if email:
                        self._recipients.append(
                            {"name": name, "email": email, "status": "未送信"})
                        self.rec_tree.insert("", tk.END,
                                              values=("─", name, email))
            self.status_var.set(f"インポート完了: {len(self._recipients)} 件")
        except Exception as e:
            messagebox.showerror("エラー", str(e))

    def _remove_recipient(self):
        for sel in self.rec_tree.selection():
            idx = self.rec_tree.index(sel)
            if idx < len(self._recipients):
                del self._recipients[idx]
            self.rec_tree.delete(sel)

    def _clear_recipients(self):
        self._recipients.clear()
        self.rec_tree.delete(*self.rec_tree.get_children())

    def _pick_attachment(self):
        path = filedialog.askopenfilename()
        if path:
            self._attachment = path
            self.att_var.set(os.path.basename(path))

    # ── SMTP ────────────────────────────────────────────────
    def _get_smtp(self):
        host = self._smtp_vars["smtp_host"].get()
        port = int(self._smtp_vars["smtp_port"].get())
        user = self._smtp_vars["smtp_user"].get()
        pwd  = self._smtp_vars["smtp_pass"].get()
        tls  = self.tls_var.get()
        s = smtplib.SMTP(host, port, timeout=10)
        if tls:
            s.starttls()
        if user and pwd:
            s.login(user, pwd)
        return s

    def _test_connection(self):
        self.status_var.set("接続テスト中...")
        def _do():
            try:
                s = self._get_smtp()
                s.quit()
                self.root.after(0, self.status_var.set, "接続テスト: 成功")
            except Exception as e:
                self.root.after(0, self.status_var.set, f"接続テスト: 失敗 - {e}")
        threading.Thread(target=_do, daemon=True).start()

    def _build_msg(self, recipient):
        from_name  = self._smtp_vars["from_name"].get()
        from_email = self._smtp_vars["smtp_user"].get()
        subject    = self.subject_var.get()
        body_tpl   = self.body_text.get("1.0", tk.END)
        body       = body_tpl.replace("{name}", recipient["name"])

        msg = MIMEMultipart()
        msg["From"]    = f"{from_name} <{from_email}>"
        msg["To"]      = recipient["email"]
        msg["Subject"] = subject
        msg.attach(MIMEText(body, "plain", "utf-8"))

        if self._attachment:
            with open(self._attachment, "rb") as f:
                part = MIMEBase("application", "octet-stream")
                part.set_payload(f.read())
            encoders.encode_base64(part)
            part.add_header("Content-Disposition",
                             f'attachment; filename="{os.path.basename(self._attachment)}"')
            msg.attach(part)
        return msg

    def _send_all(self):
        if not self._recipients:
            messagebox.showwarning("警告", "宛先を追加してください")
            return
        if not messagebox.askyesno("確認",
                                    f"{len(self._recipients)} 件にメールを送信しますか?"):
            return
        self.progress["maximum"] = len(self._recipients)
        self.progress["value"]   = 0
        threading.Thread(target=self._do_send, daemon=True).start()

    def _do_send(self):
        ok = err = 0
        try:
            smtp = self._get_smtp()
        except Exception as e:
            self.root.after(0, self.status_var.set, f"SMTP接続失敗: {e}")
            return

        iids = self.rec_tree.get_children()
        for i, (rec, iid) in enumerate(zip(self._recipients, iids)):
            try:
                msg = self._build_msg(rec)
                smtp.sendmail(self._smtp_vars["smtp_user"].get(),
                               [rec["email"]], msg.as_string())
                rec["status"] = "送信済"
                self.root.after(0, self.rec_tree.item, iid,
                                 {"values": ("✔", rec["name"], rec["email"]),
                                  "tags": ("sent",)})
                ok += 1
            except Exception as e:
                rec["status"] = f"エラー: {e}"
                self.root.after(0, self.rec_tree.item, iid,
                                 {"values": (f"✘", rec["name"], rec["email"]),
                                  "tags": ("error",)})
                err += 1
            self.root.after(0, self.progress.configure, {"value": i + 1})

        smtp.quit()
        self.root.after(0, self.status_var.set,
                         f"送信完了: {ok} 件成功 / {err} 件失敗")


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

例外処理とエラーハンドリング

try-exceptでValueErrorとExceptionを捕捉し、messagebox.showerror()でエラーメッセージを表示します。予期しないエラーも処理することで、アプリの堅牢性が向上します。

import tkinter as tk
from tkinter import ttk, messagebox, filedialog
import smtplib
import threading
import csv
import os
from email.mime.text import MIMEText
from email.mime.multipart import MIMEMultipart
from email.mime.base import MIMEBase
from email import encoders
from datetime import datetime


class App093:
    """メール一括送信ツール"""

    def __init__(self, root):
        self.root = root
        self.root.title("メール一括送信ツール")
        self.root.geometry("960x640")
        self.root.configure(bg="#1e1e1e")
        self._recipients = []    # [{"name": ..., "email": ..., "status": ...}]
        self._attachment = None
        self._build_ui()

    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)

        tk.Label(self.root,
                 text="⚠ 送信テストは必ずダミーメールサービス (Mailtrap等) で行ってください。",
                 bg="#fff3cd", fg="#856404", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X)

        # メインPaned
        paned = ttk.PanedWindow(self.root, orient=tk.HORIZONTAL)
        paned.pack(fill=tk.BOTH, expand=True, padx=4, pady=4)

        # 左: SMTP + 宛先
        left = tk.Frame(paned, bg="#1e1e1e", width=420)
        paned.add(left, weight=0)

        # SMTP設定
        smtp_f = tk.LabelFrame(left, text="SMTP設定", bg="#252526",
                                fg="#ccc", font=("Arial", 9), padx=6, pady=4)
        smtp_f.pack(fill=tk.X, padx=4, pady=4)

        fields = [
            ("SMTPサーバー",   "smtp_host", "smtp.gmail.com"),
            ("ポート",         "smtp_port", "587"),
            ("ユーザー名",     "smtp_user", "your@email.com"),
            ("パスワード",     "smtp_pass", ""),
            ("差出人名",       "from_name", "送信者名"),
        ]
        self._smtp_vars = {}
        for i, (label, key, default) in enumerate(fields):
            tk.Label(smtp_f, text=f"{label}:", bg="#252526", fg="#ccc",
                     font=("Arial", 9), width=12, anchor="e").grid(
                row=i, column=0, sticky="e", pady=1)
            v = tk.StringVar(value=default)
            self._smtp_vars[key] = v
            show = "*" if key == "smtp_pass" else ""
            ttk.Entry(smtp_f, textvariable=v, width=22,
                      show=show).grid(row=i, column=1, padx=4, pady=1, sticky="w")

        self.tls_var = tk.BooleanVar(value=True)
        tk.Checkbutton(smtp_f, text="TLS/STARTTLS を使用",
                       variable=self.tls_var,
                       bg="#252526", fg="#ccc", selectcolor="#3c3c3c",
                       activebackground="#252526").grid(
            row=len(fields), column=0, columnspan=2, sticky="w")

        # 宛先リスト
        tk.Label(left, text="宛先一覧", bg="#1e1e1e", fg="#888",
                 font=("Arial", 9)).pack(anchor="w", padx=4, pady=(8, 0))
        btn_row = tk.Frame(left, bg="#1e1e1e")
        btn_row.pack(fill=tk.X, padx=4)
        ttk.Button(btn_row, text="+ 追加",
                   command=self._add_recipient).pack(side=tk.LEFT, padx=2)
        ttk.Button(btn_row, text="📂 CSVインポート",
                   command=self._import_csv).pack(side=tk.LEFT, padx=2)
        ttk.Button(btn_row, text="🗑 削除",
                   command=self._remove_recipient).pack(side=tk.LEFT, padx=2)
        ttk.Button(btn_row, text="全クリア",
                   command=self._clear_recipients).pack(side=tk.LEFT, padx=2)

        cols = ("status", "name", "email")
        self.rec_tree = ttk.Treeview(left, columns=cols, show="headings", height=10)
        self.rec_tree.heading("status", text="状態")
        self.rec_tree.heading("name",   text="名前")
        self.rec_tree.heading("email",  text="メールアドレス")
        self.rec_tree.column("status", width=60,  anchor="center")
        self.rec_tree.column("name",   width=100, anchor="w")
        self.rec_tree.column("email",  width=200, anchor="w")
        rsb = ttk.Scrollbar(left, command=self.rec_tree.yview)
        self.rec_tree.configure(yscrollcommand=rsb.set)
        rsb.pack(side=tk.RIGHT, fill=tk.Y)
        self.rec_tree.pack(fill=tk.BOTH, expand=True, padx=(4, 0))
        self.rec_tree.tag_configure("sent",  foreground="#26a69a")
        self.rec_tree.tag_configure("error", foreground="#ef5350")

        # 右: メール本文
        right = tk.Frame(paned, bg="#1e1e1e")
        paned.add(right, weight=1)

        tk.Label(right, text="件名:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(anchor="w", padx=4)
        self.subject_var = tk.StringVar(value="お知らせ")
        ttk.Entry(right, textvariable=self.subject_var).pack(
            fill=tk.X, padx=4, pady=2)

        tk.Label(right, text="本文 ({name} で宛先名を差し込み):",
                 bg="#1e1e1e", fg="#ccc", font=("Arial", 9)).pack(
            anchor="w", padx=4)
        self.body_text = tk.Text(right, bg="#0d1117", fg="#c9d1d9",
                                  font=("Arial", 10), relief=tk.FLAT,
                                  insertbackground="white", wrap=tk.WORD)
        bsb = ttk.Scrollbar(right, command=self.body_text.yview)
        self.body_text.configure(yscrollcommand=bsb.set)
        bsb.pack(side=tk.RIGHT, fill=tk.Y)
        self.body_text.pack(fill=tk.BOTH, expand=True, padx=(4, 0))
        self.body_text.insert("1.0",
                               "{name} 様\n\nいつもお世話になっております。\n\nよろしくお願いいたします。")

        # 添付ファイル
        att_row = tk.Frame(right, bg="#1e1e1e")
        att_row.pack(fill=tk.X, padx=4, pady=2)
        tk.Label(att_row, text="添付:", bg="#1e1e1e", fg="#ccc",
                 font=("Arial", 9)).pack(side=tk.LEFT)
        self.att_var = tk.StringVar(value="(なし)")
        tk.Label(att_row, textvariable=self.att_var, bg="#1e1e1e",
                 fg="#888", font=("Arial", 9)).pack(side=tk.LEFT, padx=4)
        ttk.Button(att_row, text="ファイル選択",
                   command=self._pick_attachment).pack(side=tk.LEFT)
        ttk.Button(att_row, text="クリア",
                   command=lambda: (self.att_var.set("(なし)"),
                                    setattr(self, "_attachment", None))
                   ).pack(side=tk.LEFT, padx=2)

        # 送信ボタン
        btn_row2 = tk.Frame(right, bg="#1e1e1e", pady=4)
        btn_row2.pack(fill=tk.X, padx=4)
        tk.Button(btn_row2, text="📧 一括送信開始", command=self._send_all,
                  bg="#1565c0", fg="white", relief=tk.FLAT,
                  font=("Arial", 12, "bold"), padx=20, pady=6,
                  activebackground="#0d47a1", bd=0).pack(side=tk.LEFT)
        ttk.Button(btn_row2, text="🔧 接続テスト",
                   command=self._test_connection).pack(side=tk.LEFT, padx=8)

        self.progress = ttk.Progressbar(self.root, mode="determinate")
        self.progress.pack(fill=tk.X, padx=8)
        self.status_var = tk.StringVar(value="SMTP設定と宛先を入力してください")
        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 _add_recipient(self):
        dlg = tk.Toplevel(self.root)
        dlg.title("宛先追加")
        dlg.configure(bg="#252526")
        dlg.grab_set()
        name_var  = tk.StringVar()
        email_var = tk.StringVar()
        for label, var in [("名前:", name_var), ("メール:", email_var)]:
            row = tk.Frame(dlg, bg="#252526")
            row.pack(fill=tk.X, padx=12, pady=4)
            tk.Label(row, text=label, bg="#252526", fg="#ccc",
                     width=8, anchor="w").pack(side=tk.LEFT)
            ttk.Entry(row, textvariable=var, width=26).pack(side=tk.LEFT)
        def _ok():
            n = name_var.get().strip()
            e = email_var.get().strip()
            if not e:
                return
            self._recipients.append({"name": n, "email": e, "status": "未送信"})
            self.rec_tree.insert("", tk.END, values=("─", n, e))
            dlg.destroy()
        ttk.Button(dlg, text="追加", command=_ok).pack(pady=8)

    def _import_csv(self):
        path = filedialog.askopenfilename(
            filetypes=[("CSV", "*.csv"), ("すべて", "*.*")])
        if not path:
            return
        try:
            with open(path, encoding="utf-8-sig", newline="") as f:
                reader = csv.DictReader(f)
                for row in reader:
                    name  = row.get("name", row.get("名前", ""))
                    email = row.get("email", row.get("メール", row.get("mail", "")))
                    if email:
                        self._recipients.append(
                            {"name": name, "email": email, "status": "未送信"})
                        self.rec_tree.insert("", tk.END,
                                              values=("─", name, email))
            self.status_var.set(f"インポート完了: {len(self._recipients)} 件")
        except Exception as e:
            messagebox.showerror("エラー", str(e))

    def _remove_recipient(self):
        for sel in self.rec_tree.selection():
            idx = self.rec_tree.index(sel)
            if idx < len(self._recipients):
                del self._recipients[idx]
            self.rec_tree.delete(sel)

    def _clear_recipients(self):
        self._recipients.clear()
        self.rec_tree.delete(*self.rec_tree.get_children())

    def _pick_attachment(self):
        path = filedialog.askopenfilename()
        if path:
            self._attachment = path
            self.att_var.set(os.path.basename(path))

    # ── SMTP ────────────────────────────────────────────────
    def _get_smtp(self):
        host = self._smtp_vars["smtp_host"].get()
        port = int(self._smtp_vars["smtp_port"].get())
        user = self._smtp_vars["smtp_user"].get()
        pwd  = self._smtp_vars["smtp_pass"].get()
        tls  = self.tls_var.get()
        s = smtplib.SMTP(host, port, timeout=10)
        if tls:
            s.starttls()
        if user and pwd:
            s.login(user, pwd)
        return s

    def _test_connection(self):
        self.status_var.set("接続テスト中...")
        def _do():
            try:
                s = self._get_smtp()
                s.quit()
                self.root.after(0, self.status_var.set, "接続テスト: 成功")
            except Exception as e:
                self.root.after(0, self.status_var.set, f"接続テスト: 失敗 - {e}")
        threading.Thread(target=_do, daemon=True).start()

    def _build_msg(self, recipient):
        from_name  = self._smtp_vars["from_name"].get()
        from_email = self._smtp_vars["smtp_user"].get()
        subject    = self.subject_var.get()
        body_tpl   = self.body_text.get("1.0", tk.END)
        body       = body_tpl.replace("{name}", recipient["name"])

        msg = MIMEMultipart()
        msg["From"]    = f"{from_name} <{from_email}>"
        msg["To"]      = recipient["email"]
        msg["Subject"] = subject
        msg.attach(MIMEText(body, "plain", "utf-8"))

        if self._attachment:
            with open(self._attachment, "rb") as f:
                part = MIMEBase("application", "octet-stream")
                part.set_payload(f.read())
            encoders.encode_base64(part)
            part.add_header("Content-Disposition",
                             f'attachment; filename="{os.path.basename(self._attachment)}"')
            msg.attach(part)
        return msg

    def _send_all(self):
        if not self._recipients:
            messagebox.showwarning("警告", "宛先を追加してください")
            return
        if not messagebox.askyesno("確認",
                                    f"{len(self._recipients)} 件にメールを送信しますか?"):
            return
        self.progress["maximum"] = len(self._recipients)
        self.progress["value"]   = 0
        threading.Thread(target=self._do_send, daemon=True).start()

    def _do_send(self):
        ok = err = 0
        try:
            smtp = self._get_smtp()
        except Exception as e:
            self.root.after(0, self.status_var.set, f"SMTP接続失敗: {e}")
            return

        iids = self.rec_tree.get_children()
        for i, (rec, iid) in enumerate(zip(self._recipients, iids)):
            try:
                msg = self._build_msg(rec)
                smtp.sendmail(self._smtp_vars["smtp_user"].get(),
                               [rec["email"]], msg.as_string())
                rec["status"] = "送信済"
                self.root.after(0, self.rec_tree.item, iid,
                                 {"values": ("✔", rec["name"], rec["email"]),
                                  "tags": ("sent",)})
                ok += 1
            except Exception as e:
                rec["status"] = f"エラー: {e}"
                self.root.after(0, self.rec_tree.item, iid,
                                 {"values": (f"✘", rec["name"], rec["email"]),
                                  "tags": ("error",)})
                err += 1
            self.root.after(0, self.progress.configure, {"value": i + 1})

        smtp.quit()
        self.root.after(0, self.status_var.set,
                         f"送信完了: {ok} 件成功 / {err} 件失敗")


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

6. ステップバイステップガイド

このアプリをゼロから自分で作る手順を解説します。コードをコピーするだけでなく、実際に手順を追って自分で書いてみましょう。

  1. 1
    ファイルを作成する

    新しいファイルを作成して app093.py と保存します。

  2. 2
    クラスの骨格を作る

    App093クラスを定義し、__init__とmainloop()の最小構成を作ります。

  3. 3
    タイトルバーを作る

    Frameを使ってカラーバー付きのタイトルエリアを作ります。

  4. 4
    入力フォームを実装する

    LabelFrameとEntryウィジェットで入力エリアを作ります。

  5. 5
    処理ロジックを実装する

    _execute()メソッドにメインロジックを実装します。

  6. 6
    結果表示を実装する

    TextウィジェットかLabelに結果を表示する_show_result()を実装します。

  7. 7
    エラー処理を追加する

    try-exceptとmessageboxでエラーハンドリングを追加します。

7. カスタマイズアイデア

基本機能を習得したら、以下のカスタマイズに挑戦してみましょう。

💡 ダークモードを追加する

bg色・fg色を辞書で管理し、ボタン1つでダークモード・ライトモードを切り替えられるようにしましょう。

💡 データの保存機能

処理結果をCSV・TXTファイルに保存する機能を追加しましょう。filedialog.asksaveasfilename()でファイル保存ダイアログが使えます。

💡 設定ダイアログ

フォントサイズや色などの設定をユーザーが変更できるオプションダイアログを追加しましょう。

8. よくある問題と解決法

❌ 日本語フォントが表示されない

原因:システムに日本語フォントが見つからない場合があります。

解決法:font引数を省略するかシステムに合ったフォントを指定してください。

❌ ライブラリのインポートエラー

原因:必要なライブラリがインストールされていません。

解決法:pip install コマンドで必要なライブラリをインストールしてください。

❌ ウィンドウサイズが合わない

原因:画面解像度や表示スケールによって異なる場合があります。

解決法:root.geometry()で適切なサイズに調整してください。

9. 練習問題

アプリの理解を深めるための練習問題です。

  1. 課題1:機能拡張

    メール一括送信ツールに新しい機能を1つ追加してみましょう。

  2. 課題2:UIの改善

    色・フォント・レイアウトを変更して、より使いやすいUIにカスタマイズしましょう。

  3. 課題3:保存機能の追加

    処理結果をファイルに保存する機能を追加しましょう。

🚀
次に挑戦するアプリ

このアプリをマスターしたら、次のアプリに挑戦しましょう。