中級者向け No.16

音楽プレイヤー

プレイリスト管理・再生・一時停止・音量調整ができる音楽プレイヤー。pygameのmixerモジュールを活用します。

🎯 難易度: ★★☆ 📦 ライブラリ: tkinter（標準ライブラリ）, pygame 🧩 作るもの: 曲やフォルダを並べて聴く音楽プレイヤー

📋 目次

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

1. アプリ概要

パソコンに保存した MP3・WAV・OGG・FLAC をファイルやフォルダ単位でリストに並べ、順番に聴くための音楽プレイヤーです。プレイリスト管理・再生・一時停止・音量調整ができ、音を鳴らす部分は pygame の mixer モジュールが受け持ちます。

pygame が入っていないときや音声デバイスを初期化できないときは、起動直後に pip install pygame-ce を案内するダイアログを出す作りです（音声デバイスが原因なら、再インストールでは直りません）。

音楽プレイヤー実行画面（Linux Mint） — 実行画面（Linux Mint）

2. 機能一覧

ループで生成するボタン群（それぞれ _add_files()・_add_folder()・_remove_selected()・_clear_playlist() を実行）
「⏮」ボタン（_prev()）・「▶」ボタン（_play_pause()）・「⏹」ボタン（_stop()）・「⏭」ボタン（_next()）で操作
マウス操作 <Double-1> から _on_double_click() を実行
tk.Listbox による一覧表示（スクロールバー付き）
filedialog.askdirectory() によるフォルダ選択ダイアログ
filedialog.askopenfilenames() によるファイル選択ダイアログ（複数）
messagebox.showerror()・messagebox.showwarning() によるダイアログ通知
ウィンドウはタイトル「音楽プレイヤー」・サイズ 560x543 で起動

3. 事前準備・環境

ℹ️

動作確認環境

Python 3.11 以上（Ubuntu で 3.14・3.15 の起動を確認） / Windows 11（実機）で起動と一部の操作（音量の変更）を確認・曲の再生は未確認／ Linux Mint 22.3（仮想マシン）で起動・画面表示を確認（macOS は未検証）

2026年10月3日に、起動時の例外処理を修正しました（内容は下の注記）。修正後のコードを同じ日に、Windows 11（実機・Python 3.12.10）で pygame 2.6.1 を入れた状態で起動し、音量を変えられることを確認しました（曲の読み込み・再生は確認していません）。Linux Mint 22.3（仮想マシン・Python 3.12.3）では起動と画面表示を確認しています。操作は確認用のスクリプトから行ったもので、全機能の網羅テストではありません。macOS は必要なライブラリ（pip install）を入れれば動作する想定ですが、未検証です。

Python 3.11 以上（Ubuntu で 3.14・3.15 の起動を確認）
OS: Windows 11（実機で起動と一部の操作を確認）・Linux Mint 22.3（仮想マシンで起動・画面表示を確認）

⚠️

Python 3.14・3.15 の Windows では、pygame が通常の手順では入りません（2026年10月3日時点）

pygame の最新版 2.6.1 は、Windows 用の wheel（ビルド済みのパッケージ）が Python 3.13 用までで、3.14・3.15 用はありません（2026年10月3日に PyPI の配布ファイル一覧で確認）。この場合 pip install pygame はソースからのビルドを試み、SDL 系のライブラリの準備が必要になるため、通常の手順では入りません。これは Windows の Python 3.14 で実際に pip install を試した結果ではなく、配布ファイルの有無からの判断です。対処は次のどちらかです。

pygame-ce を使う：pygame-ce 2.5.8 は Python 3.10〜3.15 に対応し、3.15 用の Windows 用 wheel もあります。pygame を入れていた場合は、先に下の1行目でアンインストールします。コードは import pygame のまま変えずに使えます。
Python 3.13 の仮想環境を使う：x64／x86 の Windows なら、3.13 用の pygame の wheel があります（ARM 版の Windows 用はありません）。当サイトで確認したのは wheel があることまでで、3.13 の仮想環境への導入と動作は未検証です。

pip uninstall pygame
pip install pygame-ce

当サイトが pygame-ce でこのアプリを確認したのは、Linux（Ubuntu・Python 3.15.0rc2）で import pygame と起動までです。音の再生は確認していません。

💡

起動時の例外処理を except Exception に変えました（2026年10月3日）

コード冒頭の except ImportError: を except Exception: に変えました。音声デバイスが無い環境では pygame.mixer.init() が pygame.error を出し、except ImportError では拾えずに起動時に落ちていたためです。Windows 11（Python 3.12.10・pygame 2.6.1）では、存在しない音声ドライバを指定して、音声デバイスを使えない状態を作りました。この状態で pygame.mixer.init() は pygame.error を出し、修正後のコードは読み込み時に例外を出さず「pygame なし」の扱いになりました（2026年10月3日）。確認したのは画面を開かない読み込みまでで、この状態での起動画面は Windows では見ていません。修正後は、pygame が入っていないときと同じ扱い（警告を出し、再生はしない）で起動する作りです。警告の文面は、2026年10月14日に pygame-ce のインストールを促し、pygame が入っている環境では先に pip uninstall pygame をするよう書き添えたものに変えました（Python 3.14・3.15 の Windows では pygame の wheel が無いため・上の注記）。

4. 完全なソースコード

💡

コードのコピー方法

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

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

pip install pygame

app16.py

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

try:
    import pygame
    pygame.mixer.init()
    PYGAME_AVAILABLE = True
except Exception:  # ImportError に加え pygame.error（音声デバイスなし）も
    PYGAME_AVAILABLE = False


class App16:
    """音楽プレイヤー"""

    SUPPORTED_EXT = (".mp3", ".wav", ".ogg", ".flac")

    def __init__(self, root):
        self.root = root
        self.root.title("音楽プレイヤー")
        self.root.geometry("560x543")
        self.root.minsize(560, 543)
        self.root.configure(bg="#1a1a2e")
        self.playlist = []
        self.current_idx = -1
        self.playing = False
        self.paused = False
        self._build_ui()

        if not PYGAME_AVAILABLE:
            messagebox.showwarning(
                "ライブラリ未インストール",
                "pygame が必要です。\n"
                "pip install pygame-ce でインストールしてください。\n"
                "（pygame が入っている場合は先に pip uninstall pygame）")
        else:
            self._start_monitor()

        self.root.protocol("WM_DELETE_WINDOW", self._on_close)

    def _build_ui(self):
        # ヘッダー
        header = tk.Frame(self.root, bg="#16213e", pady=10)
        header.pack(fill=tk.X)
        tk.Label(header, text="🎵 音楽プレイヤー",
                 font=("Noto Sans JP", 14, "bold"),
                 bg="#16213e", fg="#e2b96f").pack(side=tk.LEFT, padx=12)

        # 現在の曲
        info_frame = tk.Frame(self.root, bg="#0f3460", pady=12)
        info_frame.pack(fill=tk.X, padx=8, pady=6)
        self.title_label = tk.Label(info_frame, text="♪ 曲が選択されていません",
                                    font=("Noto Sans JP", 13, "bold"),
                                    bg="#0f3460", fg="#e2b96f",
                                    wraplength=500)
        self.title_label.pack()
        self.artist_label = tk.Label(info_frame, text="",
                                     font=("Arial", 10),
                                     bg="#0f3460", fg="#8b949e")
        self.artist_label.pack()

        # シークバー
        seek_frame = tk.Frame(self.root, bg="#1a1a2e")
        seek_frame.pack(fill=tk.X, padx=16, pady=4)
        self.pos_label = tk.Label(seek_frame, text="0:00",
                                  bg="#1a1a2e", fg="#8b949e",
                                  font=("Arial", 9), width=5)
        self.pos_label.pack(side=tk.LEFT)
        self.seek_var = tk.DoubleVar(value=0)
        self.seek_bar = ttk.Scale(seek_frame, variable=self.seek_var,
                                   from_=0, to=100, orient=tk.HORIZONTAL)
        self.seek_bar.pack(side=tk.LEFT, fill=tk.X, expand=True, padx=6)
        self.dur_label = tk.Label(seek_frame, text="0:00",
                                  bg="#1a1a2e", fg="#8b949e",
                                  font=("Arial", 9), width=5)
        self.dur_label.pack(side=tk.LEFT)

        # コントロール
        ctrl = tk.Frame(self.root, bg="#1a1a2e")
        ctrl.pack(pady=8)
        btn_style = {"bg": "#0f3460", "fg": "#e2b96f", "relief": tk.FLAT,
                     "font": ("Segoe UI Emoji", 18), "padx": 12, "pady": 4,
                     "activebackground": "#16213e", "activeforeground": "#fff",
                     "bd": 0}
        tk.Button(ctrl, text="⏮", command=self._prev, **btn_style).pack(side=tk.LEFT, padx=4)
        self.play_btn = tk.Button(ctrl, text="▶", command=self._play_pause, **btn_style)
        self.play_btn.pack(side=tk.LEFT, padx=4)
        tk.Button(ctrl, text="⏹", command=self._stop, **btn_style).pack(side=tk.LEFT, padx=4)
        tk.Button(ctrl, text="⏭", command=self._next, **btn_style).pack(side=tk.LEFT, padx=4)

        # 音量
        vol_frame = tk.Frame(self.root, bg="#1a1a2e")
        vol_frame.pack(fill=tk.X, padx=16, pady=4)
        tk.Label(vol_frame, text="🔊", bg="#1a1a2e", fg="#8b949e").pack(side=tk.LEFT)
        self.vol_var = tk.IntVar(value=70)
        vol_scale = ttk.Scale(vol_frame, variable=self.vol_var,
                               from_=0, to=100, orient=tk.HORIZONTAL,
                               length=150,
                               command=lambda v: self._set_volume())
        vol_scale.pack(side=tk.LEFT, padx=6)
        tk.Label(vol_frame, text="シャッフル:",
                 bg="#1a1a2e", fg="#8b949e").pack(side=tk.LEFT, padx=(16, 4))
        self.shuffle_var = tk.BooleanVar(value=False)
        ttk.Checkbutton(vol_frame, variable=self.shuffle_var).pack(side=tk.LEFT)
        tk.Label(vol_frame, text="リピート:",
                 bg="#1a1a2e", fg="#8b949e").pack(side=tk.LEFT, padx=(12, 4))
        self.repeat_var = tk.StringVar(value="off")
        for val, lbl in [("off", "オフ"), ("one", "1曲"), ("all", "全曲")]:
            ttk.Radiobutton(vol_frame, text=lbl, variable=self.repeat_var,
                            value=val).pack(side=tk.LEFT, padx=2)

        # プレイリスト
        pl_frame = ttk.LabelFrame(self.root, text="プレイリスト", padding=4)
        pl_frame.pack(fill=tk.BOTH, expand=True, padx=8, pady=4)
        toolbar = tk.Frame(pl_frame, bg=ttk.Style().lookup("TLabelframe", "background"))
        toolbar.pack(fill=tk.X)
        for text, cmd in [("➕ ファイル追加", self._add_files),
                           ("📁 フォルダ追加", self._add_folder),
                           ("🗑️ 削除", self._remove_selected),
                           ("📋 クリア", self._clear_playlist)]:
            ttk.Button(toolbar, text=text, command=cmd).pack(side=tk.LEFT, padx=2, pady=2)
        self.pl_listbox = tk.Listbox(pl_frame, bg="#161b22", fg="#c9d1d9",
                                      selectbackground="#0f3460",
                                      font=("Arial", 10), relief=tk.FLAT)
        sb = ttk.Scrollbar(pl_frame, command=self.pl_listbox.yview)
        self.pl_listbox.configure(yscrollcommand=sb.set)
        sb.pack(side=tk.RIGHT, fill=tk.Y)
        self.pl_listbox.pack(fill=tk.BOTH, expand=True)
        self.pl_listbox.bind("<Double-1>", self._on_double_click)

        self.status_var = tk.StringVar(value="")
        tk.Label(self.root, textvariable=self.status_var,
                 bg="#16213e", fg="#8b949e", font=("Arial", 9),
                 anchor="w", padx=8).pack(fill=tk.X, side=tk.BOTTOM)

    def _add_files(self):
        paths = filedialog.askopenfilenames(
            filetypes=[("音楽ファイル", "*.mp3 *.wav *.ogg *.flac"),
                       ("すべて", "*.*")])
        for p in paths:
            self._add_to_playlist(p)

    def _add_folder(self):
        folder = filedialog.askdirectory()
        if folder:
            for f in sorted(os.listdir(folder)):
                if f.lower().endswith(self.SUPPORTED_EXT):
                    self._add_to_playlist(os.path.join(folder, f))

    def _add_to_playlist(self, path):
        if path not in self.playlist:
            self.playlist.append(path)
            self.pl_listbox.insert(tk.END, os.path.basename(path))
        self.status_var.set(f"{len(self.playlist)} 曲")

    def _remove_selected(self):
        sel = self.pl_listbox.curselection()
        for idx in reversed(sel):
            self.playlist.pop(idx)
            self.pl_listbox.delete(idx)
        self.status_var.set(f"{len(self.playlist)} 曲")

    def _clear_playlist(self):
        self._stop()
        self.playlist.clear()
        self.pl_listbox.delete(0, tk.END)
        self.current_idx = -1

    def _on_double_click(self, event):
        sel = self.pl_listbox.curselection()
        if sel:
            self.current_idx = sel[0]
            self._load_and_play()

    def _load_and_play(self):
        if not PYGAME_AVAILABLE or not self.playlist:
            return
        if 0 <= self.current_idx < len(self.playlist):
            path = self.playlist[self.current_idx]
            try:
                pygame.mixer.music.load(path)
                pygame.mixer.music.set_volume(self.vol_var.get() / 100)
                pygame.mixer.music.play()
                self.playing = True
                self.paused = False
                self.play_btn.config(text="⏸")
                name = os.path.basename(path)
                self.title_label.config(text=name)
                self.pl_listbox.selection_clear(0, tk.END)
                self.pl_listbox.selection_set(self.current_idx)
                self.pl_listbox.see(self.current_idx)
                self.status_var.set(f"再生中: {name}")
            except Exception as e:
                messagebox.showerror("エラー", str(e))

    def _play_pause(self):
        if not PYGAME_AVAILABLE:
            return
        if not self.playlist:
            return
        if self.current_idx < 0:
            self.current_idx = 0
        if not self.playing:
            self._load_and_play()
        elif self.paused:
            pygame.mixer.music.unpause()
            self.paused = False
            self.play_btn.config(text="⏸")
        else:
            pygame.mixer.music.pause()
            self.paused = True
            self.play_btn.config(text="▶")

    def _stop(self):
        if PYGAME_AVAILABLE:
            pygame.mixer.music.stop()
        self.playing = False
        self.paused = False
        self.play_btn.config(text="▶")
        self.title_label.config(text="♪ 曲が選択されていません")

    def _prev(self):
        if not self.playlist:
            return
        self.current_idx = (self.current_idx - 1) % len(self.playlist)
        self._load_and_play()

    def _next(self):
        if not self.playlist:
            return
        repeat = self.repeat_var.get()
        if repeat == "one":
            pass
        elif self.shuffle_var.get():
            import random
            self.current_idx = random.randint(0, len(self.playlist) - 1)
        else:
            self.current_idx = (self.current_idx + 1) % len(self.playlist)
        self._load_and_play()

    def _set_volume(self):
        if PYGAME_AVAILABLE:
            pygame.mixer.music.set_volume(self.vol_var.get() / 100)

    def _start_monitor(self):
        def monitor():
            while True:
                try:
                    if (self.playing and not self.paused
                            and not pygame.mixer.music.get_busy()):
                        self.playing = False
                        repeat = self.repeat_var.get()
                        if repeat == "one":
                            self.root.after(0, self._load_and_play)
                        elif repeat == "all" or self.current_idx < len(self.playlist) - 1:
                            self.root.after(0, self._next)
                except Exception:
                    pass
                import time
                time.sleep(0.5)

        threading.Thread(target=monitor, daemon=True).start()

    def _on_close(self):
        if PYGAME_AVAILABLE:
            pygame.mixer.quit()
        self.root.destroy()


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

5. コード解説

音楽プレイヤーのコードを、実際に書かれている実装に沿って解説します。

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

App16 クラスにアプリの全機能をまとめています（メソッド16個・全273行）。__init__ ではタイトル「音楽プレイヤー」とウィンドウサイズ 560x543 を設定します。あわせて状態を保持する変数（self.playing・self.paused）を初期化し、最後に _build_ui() で画面を組み立てます。