中級者向け No.25

ポモドーロタイマー

25分作業・5分休憩サイクルで生産性を高めるポモドーロタイマー。音声通知・統計・カスタム設定付きです。

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

📋 目次

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

1. アプリ概要

25分作業・5分休憩サイクルで生産性を高めるポモドーロタイマー。音声通知・統計・カスタム設定付きです。

このアプリは中級カテゴリに分類される実践的なGUIアプリです。使用ライブラリは tkinter（標準ライブラリ） で、難易度は ★★☆ です。

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

コードを読む前に実行することをおすすめします。動いている挙動を先に把握しておくと、解説で出てくる関数や処理がどこに対応するかが頭に入りやすくなります。

応用のヒントは、機能を 1 つ増やす・見た目を整える・例外を一つでも丁寧に扱う、のいずれかから始めるのがおすすめです。

ポモドーロタイマー実行画面（Linux Mint） — 実行画面（Linux Mint）

2. 機能一覧

「⚙ 設定」ボタン（_open_settings()）・「▶ スタート」ボタン（_toggle()）・「⏭ スキップ」ボタン（_next_session()）・「🔄 リセット」ボタン（_reset()）・「保存」ボタンで操作
after(1000, ...) による1000ミリ秒間隔の _tick() 呼び出し（画面の自動更新）
tk.Listbox による一覧表示
JSON ファイルの保存・読み込み（起動時に自動実行）
messagebox.showinfo() によるダイアログ通知
ウィンドウはタイトル「ポモドーロタイマー」・サイズ 480x611 で起動

3. 事前準備・環境

ℹ️

動作確認環境

Python 3.10 以上 / Windows 11（実機）で起動・基本操作を確認／ Linux Mint 22.3（仮想マシン）で起動・画面表示を確認（macOS は未検証）

Windows 11（実機）で起動と基本操作を確認しています（全機能の網羅テストではありません）。Linux Mint 22.3（仮想マシン）では起動と画面表示を確認しました。macOS は標準ライブラリの範囲で動作する想定ですが、未検証です。

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

4. 完全なソースコード

💡

コードのコピー方法

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

✅ 追加インストール不要（標準ライブラリのみ使用）

app25.py

import tkinter as tk
from tkinter import ttk, messagebox
import time
import threading
import json
import os
import platform

try:
    import winsound
    SOUND_AVAILABLE = platform.system() == "Windows"
except ImportError:
    SOUND_AVAILABLE = False


class App25:
    """ポモドーロタイマー"""

    SETTINGS_FILE = os.path.join(os.path.dirname(__file__), "pomodoro_settings.json")

    DEFAULT_SETTINGS = {
        "work_min": 25,
        "short_break_min": 5,
        "long_break_min": 15,
        "long_break_interval": 4,
    }

    def __init__(self, root):
        self.root = root
        self.root.title("ポモドーロタイマー")
        self.root.geometry("480x611")
        self.root.minsize(480, 611)
        self.root.configure(bg="#c62828")
        self.settings = self._load_settings()
        self.running = False
        self.pomodoro_count = 0
        self.session_type = "work"  # work, short_break, long_break
        self.remaining = self.settings["work_min"] * 60
        self.total_today = 0
        self._timer_id = None
        self._stats = {"work": 0, "short_break": 0, "long_break": 0}
        self._build_ui()
        self._update_display()

    def _load_settings(self):
        if os.path.exists(self.SETTINGS_FILE):
            try:
                with open(self.SETTINGS_FILE) as f:
                    return {**self.DEFAULT_SETTINGS, **json.load(f)}
            except Exception:
                pass
        return dict(self.DEFAULT_SETTINGS)

    def _save_settings(self):
        with open(self.SETTINGS_FILE, "w") as f:
            json.dump(self.settings, f)

    def _build_ui(self):
        # ヘッダー
        header = tk.Frame(self.root, bg="#b71c1c", pady=6)
        header.pack(fill=tk.X)
        tk.Label(header, text="🍅 ポモドーロタイマー",
                 font=("Noto Sans JP", 14, "bold"),
                 bg="#b71c1c", fg="white").pack(side=tk.LEFT, padx=12)
        ttk.Button(header, text="⚙ 設定",
                   command=self._open_settings).pack(side=tk.RIGHT, padx=8)

        # セッション種別バッジ
        self.session_frame = tk.Frame(self.root, bg="#c62828")
        self.session_frame.pack(pady=6)
        self.session_label = tk.Label(self.session_frame,
                                      text="🍅 作業中",
                                      font=("Noto Sans JP", 13, "bold"),
                                      bg="#c62828", fg="white")
        self.session_label.pack()

        # タイマー表示
        timer_outer = tk.Frame(self.root, bg="#c62828")
        timer_outer.pack(pady=10)
        self.canvas = tk.Canvas(timer_outer, width=240, height=240,
                                bg="#c62828", highlightthickness=0)
        self.canvas.pack()
        # 円形プログレス
        self.canvas.create_oval(20, 20, 220, 220, outline="#b71c1c",
                                width=12, tags="bg_arc")
        self.arc_id = self.canvas.create_arc(20, 20, 220, 220,
                                              start=90, extent=360,
                                              style="arc", outline="#ff8a80",
                                              width=12, tags="arc")
        self.timer_text_id = self.canvas.create_text(
            120, 120, text="25:00",
            font=("Courier New", 40, "bold"),
            fill="white", tags="timer_text")

        # コントロール
        ctrl_f = tk.Frame(self.root, bg="#c62828")
        ctrl_f.pack(pady=8)
        btn_s = {"bg": "#e53935", "fg": "white", "relief": tk.FLAT,
                 "font": ("Noto Sans JP", 12), "padx": 20, "pady": 8,
                 "activebackground": "#b71c1c", "activeforeground": "white", "bd": 0}
        self.start_btn = tk.Button(ctrl_f, text="▶ スタート",
                                   command=self._toggle, **btn_s)
        self.start_btn.pack(side=tk.LEFT, padx=8)
        tk.Button(ctrl_f, text="⏭ スキップ",
                  command=self._next_session, **btn_s).pack(side=tk.LEFT, padx=8)
        tk.Button(ctrl_f, text="🔄 リセット",
                  command=self._reset, **btn_s).pack(side=tk.LEFT, padx=8)

        # ポモドーロカウンター
        count_f = tk.Frame(self.root, bg="#c62828")
        count_f.pack(pady=4)
        tk.Label(count_f, text="今日の達成:",
                 bg="#c62828", fg="#ffcdd2",
                 font=("Noto Sans JP", 11)).pack(side=tk.LEFT)
        self.count_label = tk.Label(count_f, text="🍅 × 0",
                                    bg="#c62828", fg="white",
                                    font=("Noto Sans JP", 14, "bold"))
        self.count_label.pack(side=tk.LEFT, padx=8)

        # 今日の統計
        stats_f = ttk.LabelFrame(self.root, text="今日の統計", padding=10)
        stats_f.pack(fill=tk.X, padx=16, pady=8)
        self.stats_labels = {}
        inner = tk.Frame(stats_f, bg=ttk.Style().lookup("TLabelframe", "background"))
        inner.pack()
        for key, lbl in [("work", "🍅 作業時間"),
                          ("short_break", "☕ 短い休憩"),
                          ("long_break", "😴 長い休憩")]:
            f2 = tk.Frame(inner, bg=inner.cget("bg"), padx=12)
            f2.pack(side=tk.LEFT)
            tk.Label(f2, text=lbl, bg=f2.cget("bg"),
                     font=("Arial", 9), fg="#555").pack()
            lbl2 = tk.Label(f2, text="0分", bg=f2.cget("bg"),
                            font=("Arial", 12, "bold"))
            lbl2.pack()
            self.stats_labels[key] = lbl2

        # ログ
        log_f = ttk.LabelFrame(self.root, text="セッションログ", padding=4)
        log_f.pack(fill=tk.BOTH, expand=True, padx=16, pady=(0, 8))
        self.log_listbox = tk.Listbox(log_f, height=5,
                                       font=("Arial", 9))
        self.log_listbox.pack(fill=tk.BOTH, expand=True)

    def _toggle(self):
        if self.running:
            self.running = False
            self.start_btn.config(text="▶ スタート")
            if self._timer_id:
                self.root.after_cancel(self._timer_id)
        else:
            self.running = True
            self.start_btn.config(text="⏸ 一時停止")
            self._tick()

    def _tick(self):
        if not self.running:
            return
        if self.remaining > 0:
            self.remaining -= 1
            self._update_display()
            self._timer_id = self.root.after(1000, self._tick)
        else:
            self._session_complete()

    def _session_complete(self):
        self.running = False
        self.start_btn.config(text="▶ スタート")
        self._beep()
        dur_min = self._session_minutes()
        self._stats[self.session_type] += dur_min
        self._update_stats_display()

        now_str = self._now_str()
        if self.session_type == "work":
            self.pomodoro_count += 1
            self.count_label.config(text=f"🍅 × {self.pomodoro_count}")
            self.log_listbox.insert(0,
                f"{now_str}  🍅 作業 {dur_min}分 完了")
            messagebox.showinfo("完了", f"🍅 ポモドーロ #{self.pomodoro_count} 完了！\n休憩しましょう！")
        else:
            label = "短い休憩" if self.session_type == "short_break" else "長い休憩"
            self.log_listbox.insert(0,
                f"{now_str}  ☕ {label} {dur_min}分 完了")
        self._next_session()

    def _next_session(self):
        if self.running:
            self._toggle()
        if self.session_type == "work":
            interval = self.settings["long_break_interval"]
            if self.pomodoro_count % interval == 0 and self.pomodoro_count > 0:
                self.session_type = "long_break"
            else:
                self.session_type = "short_break"
        else:
            self.session_type = "work"
        self.remaining = self._session_minutes() * 60
        self._update_display()

    def _reset(self):
        if self.running:
            self._toggle()
        self.remaining = self._session_minutes() * 60
        self._update_display()

    def _session_minutes(self):
        return {
            "work": self.settings["work_min"],
            "short_break": self.settings["short_break_min"],
            "long_break": self.settings["long_break_min"],
        }[self.session_type]

    def _update_display(self):
        mins = self.remaining // 60
        secs = self.remaining % 60
        self.canvas.itemconfig(self.timer_text_id,
                               text=f"{mins:02d}:{secs:02d}")
        # アーク更新
        total = self._session_minutes() * 60
        ratio = self.remaining / total if total else 0
        extent = 360 * ratio
        self.canvas.itemconfig(self.arc_id, extent=extent)
        # セッションラベル
        labels = {
            "work": ("🍅 作業中", "#c62828"),
            "short_break": ("☕ 短い休憩", "#1565c0"),
            "long_break": ("😴 長い休憩", "#1b5e20"),
        }
        lbl, bg = labels[self.session_type]
        self.session_label.config(text=lbl)
        self.root.configure(bg=bg)
        self.session_label.configure(bg=bg)

    def _update_stats_display(self):
        for key, lbl in self.stats_labels.items():
            lbl.config(text=f"{self._stats[key]}分")

    def _beep(self):
        if SOUND_AVAILABLE:
            try:
                winsound.Beep(880, 500)
                winsound.Beep(1100, 500)
            except Exception:
                pass

    def _now_str(self):
        return time.strftime("%H:%M")

    def _open_settings(self):
        win = tk.Toplevel(self.root)
        win.title("設定")
        win.geometry("280x220")
        win.configure(bg="#f8f9fc")
        fields = [("作業時間(分)", "work_min"),
                  ("短い休憩(分)", "short_break_min"),
                  ("長い休憩(分)", "long_break_min"),
                  ("長い休憩間隔(ポモドーロ数)", "long_break_interval")]
        vars_ = {}
        for i, (lbl, key) in enumerate(fields):
            tk.Label(win, text=f"{lbl}:",
                     bg="#f8f9fc").grid(row=i, column=0, sticky="w",
                                        padx=8, pady=4)
            var = tk.IntVar(value=self.settings[key])
            ttk.Entry(win, textvariable=var, width=8).grid(
                row=i, column=1, padx=8)
            vars_[key] = var

        def save():
            for key, var in vars_.items():
                self.settings[key] = var.get()
            self._save_settings()
            self._reset()
            win.destroy()

        ttk.Button(win, text="保存", command=save).grid(
            row=len(fields), column=0, columnspan=2, pady=10)


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

5. コード解説

ポモドーロタイマーのコードを、実際に書かれている実装に沿って解説します。

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

App25 クラスにアプリの全機能をまとめています（メソッド15個・全283行）。__init__ ではタイトル「ポモドーロタイマー」とウィンドウサイズ 480x611 を設定します。あわせて状態を保持する変数（self.running・self.pomodoro_count・self.session_type・self._timer_id）を初期化し、そのあと _build_ui() → _update_display() の順に呼び出して初期状態を作ります。