ファイル一括リネーマー

1. アプリ概要

正規表現・日付・連番でファイルを一括リネームするツール。プレビュー機能付きで安全に操作できます。

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

このアプリは「ファイル操作」カテゴリです。ファイル操作は業務スクリプトの心臓部で、I/O のパターンは他のあらゆる Python プログラムで再利用できます。tkinter（標準ライブラリ） を活かして実装するこの構造は、他のアプリにも応用が効きます。

コピー＆実行で動作確認 → コード解説で構造理解 → カスタマイズで応用、の 3 ステップで進めると、短時間で本質を押さえられます。

アプリを完成させた後は、自分の使い方に合わせて改造するのが学びを定着させる近道です。カスタマイズ章のアイデアを足がかりに、独自機能を一つ追加してみてください。

2. 機能一覧

• 「📂 参照」ボタン（_browse_folder()）・「読込」ボタン（_load_files()）・「🔍 プレビュー」ボタン（_preview()）・「✅ リネーム実行」ボタン（_apply()）・「↩️ 元に戻す」ボタン（_undo()）で操作
• マウス操作 <Double-1> から _toggle_exclude() を実行
• ttk.Treeview による表形式の一覧表示
• filedialog.askdirectory() によるファイル選択ダイアログ
• messagebox.showinfo()・messagebox.showwarning() によるダイアログ通知
• ウィンドウはタイトル「ファイル一括リネーマー」・サイズ 920x620 で起動

3. 事前準備・環境

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

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

4. 完全なソースコード

import tkinter as tk
from tkinter import ttk, messagebox, filedialog
import os
import re
from datetime import datetime


class App15:
    """ファイル一括リネーマー"""

    def __init__(self, root):
        self.root = root
        self.root.title("ファイル一括リネーマー")
        self.root.geometry("920x620")
        self.root.configure(bg="#f8f9fc")
        self.files = []
        self._build_ui()

    def _build_ui(self):
        title_frame = tk.Frame(self.root, bg="#3776ab", pady=10)
        title_frame.pack(fill=tk.X)
        tk.Label(title_frame, text="✏️ ファイル一括リネーマー",
                 font=("Noto Sans JP", 15, "bold"),
                 bg="#3776ab", fg="white").pack(side=tk.LEFT, padx=12)

        # フォルダ選択
        folder_frame = tk.Frame(self.root, bg="#e8eef5", pady=6)
        folder_frame.pack(fill=tk.X)
        tk.Label(folder_frame, text="フォルダ:",
                 bg="#e8eef5").pack(side=tk.LEFT, padx=8)
        self.folder_var = tk.StringVar()
        ttk.Entry(folder_frame, textvariable=self.folder_var,
                  width=50, font=("Arial", 10)).pack(side=tk.LEFT, padx=4)
        ttk.Button(folder_frame, text="📂 参照",
                   command=self._browse_folder).pack(side=tk.LEFT, padx=4)
        tk.Label(folder_frame, text="拡張子フィルター:",
                 bg="#e8eef5").pack(side=tk.LEFT, padx=(16, 4))
        self.ext_var = tk.StringVar(value="*")
        ttk.Entry(folder_frame, textvariable=self.ext_var,
                  width=10).pack(side=tk.LEFT)
        ttk.Button(folder_frame, text="読込",
                   command=self._load_files).pack(side=tk.LEFT, padx=4)

        # ルール設定
        rule_frame = ttk.LabelFrame(self.root, text="リネームルール", padding=10)
        rule_frame.pack(fill=tk.X, padx=8, pady=6)

        self.mode_var = tk.StringVar(value="replace")
        modes = [("テキスト置換", "replace"), ("正規表現", "regex"),
                 ("連番追加", "serial"), ("日時追加", "datetime"),
                 ("大文字/小文字", "case")]
        for text, val in modes:
            ttk.Radiobutton(rule_frame, text=text, variable=self.mode_var,
                            value=val, command=self._update_rule_ui).pack(
                side=tk.LEFT, padx=6)

        self.rule_frame2 = tk.Frame(rule_frame, bg=ttk.Style().lookup("TLabelframe", "background"))
        self.rule_frame2.pack(fill=tk.X, pady=(8, 0))
        self._update_rule_ui()

        # プレビュー + 実行
        btn_frame = tk.Frame(self.root, bg="#f8f9fc")
        btn_frame.pack(fill=tk.X, padx=8)
        ttk.Button(btn_frame, text="🔍 プレビュー",
                   command=self._preview).pack(side=tk.LEFT, padx=4, pady=4)
        self.apply_btn = ttk.Button(btn_frame, text="✅ リネーム実行",
                                     command=self._apply,
                                     state=tk.DISABLED)
        self.apply_btn.pack(side=tk.LEFT, padx=4)
        ttk.Button(btn_frame, text="↩️ 元に戻す",
                   command=self._undo).pack(side=tk.LEFT, padx=4)

        # ファイルリスト
        list_frame = ttk.LabelFrame(self.root, text="ファイル一覧 (ダブルクリックで除外)",
                                     padding=4)
        list_frame.pack(fill=tk.BOTH, expand=True, padx=8, pady=4)
        cols = ("original", "preview", "status")
        self.tree = ttk.Treeview(list_frame, columns=cols,
                                  show="headings", selectmode="extended")
        for c, h, w in [("original", "元のファイル名", 350),
                         ("preview", "変更後", 350),
                         ("status", "状態", 80)]:
            self.tree.heading(c, text=h)
            self.tree.column(c, width=w, minwidth=80)
        sb = ttk.Scrollbar(list_frame, command=self.tree.yview)
        self.tree.configure(yscrollcommand=sb.set)
        sb.pack(side=tk.RIGHT, fill=tk.Y)
        self.tree.pack(fill=tk.BOTH, expand=True)
        self.tree.tag_configure("changed", foreground="#3776ab")
        self.tree.tag_configure("excluded", foreground="#aaa")
        self.tree.tag_configure("done", foreground="#27ae60")
        self.tree.tag_configure("error", foreground="#e74c3c")
        self.tree.bind("<Double-1>", self._toggle_exclude)

        self.status_var = tk.StringVar(value="フォルダを選択してください")
        tk.Label(self.root, textvariable=self.status_var,
                 bg="#dde", font=("Arial", 9), anchor="w", padx=8
                 ).pack(fill=tk.X, side=tk.BOTTOM)

        self._undo_map = {}
        self._excluded = set()

    def _update_rule_ui(self):
        for w in self.rule_frame2.winfo_children():
            w.destroy()
        mode = self.mode_var.get()
        bg = self.rule_frame2.cget("bg")
        if mode == "replace":
            tk.Label(self.rule_frame2, text="検索:", bg=bg).pack(side=tk.LEFT)
            self.find_var = tk.StringVar()
            ttk.Entry(self.rule_frame2, textvariable=self.find_var,
                      width=18).pack(side=tk.LEFT, padx=4)
            tk.Label(self.rule_frame2, text="置換:", bg=bg).pack(side=tk.LEFT, padx=(8, 0))
            self.replace_var = tk.StringVar()
            ttk.Entry(self.rule_frame2, textvariable=self.replace_var,
                      width=18).pack(side=tk.LEFT, padx=4)
        elif mode == "regex":
            tk.Label(self.rule_frame2, text="正規表現:", bg=bg).pack(side=tk.LEFT)
            self.regex_var = tk.StringVar()
            ttk.Entry(self.rule_frame2, textvariable=self.regex_var,
                      width=24).pack(side=tk.LEFT, padx=4)
            tk.Label(self.rule_frame2, text="置換:", bg=bg).pack(side=tk.LEFT, padx=(8, 0))
            self.repl_var = tk.StringVar()
            ttk.Entry(self.rule_frame2, textvariable=self.repl_var,
                      width=24).pack(side=tk.LEFT, padx=4)
        elif mode == "serial":
            tk.Label(self.rule_frame2, text="プレフィックス:", bg=bg).pack(side=tk.LEFT)
            self.prefix_var = tk.StringVar(value="file_")
            ttk.Entry(self.rule_frame2, textvariable=self.prefix_var,
                      width=14).pack(side=tk.LEFT, padx=4)
            tk.Label(self.rule_frame2, text="開始番号:", bg=bg).pack(side=tk.LEFT, padx=(8, 0))
            self.serial_start_var = tk.IntVar(value=1)
            ttk.Spinbox(self.rule_frame2, from_=0, to=9999,
                        textvariable=self.serial_start_var, width=6).pack(side=tk.LEFT, padx=4)
            tk.Label(self.rule_frame2, text="桁数:", bg=bg).pack(side=tk.LEFT, padx=(8, 0))
            self.digits_var = tk.IntVar(value=3)
            ttk.Spinbox(self.rule_frame2, from_=1, to=8,
                        textvariable=self.digits_var, width=4).pack(side=tk.LEFT, padx=4)
        elif mode == "datetime":
            tk.Label(self.rule_frame2, text="フォーマット:", bg=bg).pack(side=tk.LEFT)
            self.dt_var = tk.StringVar(value="%Y%m%d_%H%M%S_")
            ttk.Entry(self.rule_frame2, textvariable=self.dt_var,
                      width=22).pack(side=tk.LEFT, padx=4)
            tk.Label(self.rule_frame2,
                     text="(%Y=年 %m=月 %d=日 %H=時 %M=分)",
                     bg=bg, fg="#666").pack(side=tk.LEFT)
        elif mode == "case":
            self.case_var = tk.StringVar(value="lower")
            for val, lbl in [("lower", "小文字"), ("upper", "大文字"),
                              ("title", "タイトルケース")]:
                ttk.Radiobutton(self.rule_frame2, text=lbl,
                                variable=self.case_var, value=val).pack(
                    side=tk.LEFT, padx=6)

    def _browse_folder(self):
        path = filedialog.askdirectory()
        if path:
            self.folder_var.set(path)
            self._load_files()

    def _load_files(self):
        folder = self.folder_var.get().strip()
        if not folder or not os.path.isdir(folder):
            messagebox.showwarning("警告", "有効なフォルダを選択してください")
            return
        ext_filter = self.ext_var.get().strip().lower()
        self.files = []
        for f in sorted(os.listdir(folder)):
            fpath = os.path.join(folder, f)
            if not os.path.isfile(fpath):
                continue
            if ext_filter != "*":
                exts = [e.strip() for e in ext_filter.split(",")]
                ext = os.path.splitext(f)[1].lower().lstrip(".")
                if ext not in exts and f"*.{ext}" not in exts:
                    continue
            self.files.append(f)
        self.tree.delete(*self.tree.get_children())
        for f in self.files:
            self.tree.insert("", "end", values=(f, f, "待機中"))
        self._excluded = set()
        self.status_var.set(f"{len(self.files)} 件読込完了")

    def _get_new_name(self, fname, index):
        name, ext = os.path.splitext(fname)
        mode = self.mode_var.get()
        if mode == "replace":
            find = self.find_var.get()
            repl = self.replace_var.get()
            new_name = name.replace(find, repl) if find else name
        elif mode == "regex":
            try:
                new_name = re.sub(self.regex_var.get(), self.repl_var.get(), name)
            except re.error as e:
                return None, f"正規表現エラー: {e}"
        elif mode == "serial":
            n = self.serial_start_var.get() + index
            digits = self.digits_var.get()
            new_name = f"{self.prefix_var.get()}{n:0{digits}d}"
        elif mode == "datetime":
            fmt = datetime.now().strftime(self.dt_var.get())
            new_name = fmt + name
        elif mode == "case":
            case = self.case_var.get()
            if case == "lower":
                new_name = name.lower()
            elif case == "upper":
                new_name = name.upper()
            else:
                new_name = name.title()
        else:
            new_name = name
        return new_name + ext, None

    def _preview(self):
        if not self.files:
            return
        self.tree.delete(*self.tree.get_children())
        self._preview_map = {}
        idx = 0
        for fname in self.files:
            if fname in self._excluded:
                self.tree.insert("", "end",
                                 values=(fname, fname, "除外"),
                                 tags=("excluded",))
                continue
            new_name, err = self._get_new_name(fname, idx)
            idx += 1
            if err:
                self.tree.insert("", "end",
                                 values=(fname, f"エラー: {err}", "エラー"),
                                 tags=("error",))
            else:
                tag = "changed" if new_name != fname else ""
                self.tree.insert("", "end",
                                 values=(fname, new_name, "変更あり" if new_name != fname else "変更なし"),
                                 tags=(tag,))
                self._preview_map[fname] = new_name
        changed = sum(1 for k, v in self._preview_map.items() if k != v)
        self.status_var.set(f"プレビュー: {changed} 件変更予定")
        self.apply_btn.config(state=tk.NORMAL)

    def _apply(self):
        if not hasattr(self, "_preview_map"):
            return
        folder = self.folder_var.get()
        done, errors = 0, 0
        self._undo_map = {}
        for old_name, new_name in self._preview_map.items():
            if old_name == new_name:
                continue
            old_path = os.path.join(folder, old_name)
            new_path = os.path.join(folder, new_name)
            try:
                os.rename(old_path, new_path)
                self._undo_map[new_name] = old_name
                done += 1
            except Exception as e:
                errors += 1
        self._load_files()
        self.status_var.set(
            f"完了: {done} 件リネーム  エラー: {errors} 件")
        self.apply_btn.config(state=tk.DISABLED)

    def _undo(self):
        if not self._undo_map:
            messagebox.showinfo("情報", "元に戻す操作がありません")
            return
        folder = self.folder_var.get()
        for new_name, old_name in self._undo_map.items():
            try:
                os.rename(os.path.join(folder, new_name),
                          os.path.join(folder, old_name))
            except Exception:
                pass
        self._undo_map = {}
        self._load_files()
        self.status_var.set("元に戻しました")

    def _toggle_exclude(self, event):
        item = self.tree.identify_row(event.y)
        if item:
            fname = self.tree.item(item)["values"][0]
            if fname in self._excluded:
                self._excluded.discard(fname)
            else:
                self._excluded.add(fname)
            self._preview()


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

5. コード解説

ファイル一括リネーマーのコードを、実際に書かれている実装に沿って解説します。

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

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

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

   新しいファイルを作成して app15.py と保存します。使うのは datetime・os・re・tkinter だけなので、追加インストールは不要です。

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

   App15 クラスを定義し、__init__ と、末尾の root = tk.Tk() ～ mainloop() の最小構成を書いて、まず空のウィンドウが出ることを確認します。

3. 3
   ウィンドウを設定する

   title("ファイル一括リネーマー")・geometry("920x620")・configure(bg="#f8f9fc") をコンストラクタで設定します。

4. 4
   画面部品を並べる

   _build_ui() の中で、tk.Frame×4・tk.Label×13・ttk.Entry×8・ttk.Button×5・ttk.LabelFrame×2・ttk.Radiobutton（ループで生成）・ttk.Style・ttk.Treeview・ttk.Scrollbar・ttk.Spinbox×2 を作って配置します（掲載コードと同じ並び順で書くとレイアウトが一致します）。まず表示だけ確認しましょう。

5. 5
   イベントを接続する

   「2. 機能一覧」で挙げた各ボタンを command= で対応するメソッド（_browse_folder()・_load_files()・_preview()・_apply()・_undo()）につなぎます。bind("<Double-1>", ...) の登録も忘れずに。

6. 6
   中心になるメソッドを実装する

   アプリの本体である _preview()（27行）・_load_files()（22行）・_apply()（21行）など を実装します。

7. 7
   動作確認する

   python app15.py で起動し、各ボタンが反応すること・マウス操作（クリック・ホイールなど）が効くことを確認します。

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

基本機能を習得したら、以下のカスタマイズに挑戦してみましょう。少しずつ機能を追加することで、Pythonのスキルが飛躍的に向上します。

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

9. 練習問題

アプリの理解を深めるための練習問題です。気になるものから挑戦してみてください（課題3は定型の発展課題です）。リネームはファイル名を直接書き換える操作です。練習は、コピーして作った捨ててよいフォルダで行ってください。「↩️ 元に戻す」で戻せるのは直前の1回分だけで、戻せなかったファイルがあっても画面には出ません。追加のライブラリは要りません。

1. 課題1：変更後の名前がぶつかることをプレビューで知らせる

   いまのプレビューは、2つのファイルが同じ名前になっても何も言いません。そのまま実行すると片方が失敗するか、環境によっては黙って上書きされます。実行する前に気づけるようにしてください。

   期待結果：捨ててよいフォルダに a_1.txt と a_2.txt を置く。「正規表現」を選び、正規表現の欄に _\d、置換の欄を空にする。「🔍 プレビュー」を押すと、いまは2行とも変更後が a.txt になり帯は プレビュー: 2 件変更予定 と出る。直したあとは、ぶつかる2行が「状態」列で見分けられる。

   合格条件

   • ぶつからないときは、これまでどおり件数が出て「✅ リネーム実行」が押せる
   • ダブルクリックで除外した行は、ぶつかりの判定に入れない
   • 正規表現が誤っている行は、これまでどおり エラー と出る

   ヒント①（どこを触るか）: 触るのは _preview() の1か所です。changed = sum(...) の行の前に足します。
   ヒント②（使うもの）: self._preview_map の値だけを Counter で数えると、2件以上になった名前が拾えます。collections は未インポートなので、先頭に from collections import Counter を1行足します。行の見た目を変えるなら self.tree.insert(...) の戻り値を控えておき、self.tree.item(iid, values=..., tags=("error",)) で書き換えます。
   つまずきやすい点: _preview_map は「元の名前 → 変更後の名前」の辞書です。変更後が重なってもキーは別なので、辞書の大きさだけでは気づけません。Windows は大文字と小文字を区別しないため、A.txt と a.txt も同じ名前として扱われます。os.rename() は Windows では既存ファイルがあると失敗しますが、macOS・Linux では黙って上書きします。

2. 課題2：拡張子フィルターに .txt と書いても読み込めるようにする

   拡張子フィルターは txt や *.txt では効きますが、.txt と書くと0件になります。読み込み側がドットを外してから比べているためです。どの書き方でも同じ結果になるようにしてください。

   期待結果：テキストファイルが入ったフォルダを選び、拡張子フィルターに .txt と入れて「読込」を押す。いまは帯が 0 件読込完了 になり一覧が空になる。txt か *.txt に直すと読み込める。直したあとは .txt でも同じ件数が読み込める。

   合格条件

   • 初期値の * のときは、これまでどおり全部のファイルを読み込む
   • txt と *.txt の結果は、これまでどおり変わらない
   • txt, csv のようにカンマで並べた指定も、これまでどおり動く

   ヒント①（どこを触るか）: 触るのは _load_files() の1か所です。exts = [e.strip() for e in ext_filter.split(",")] の行だけで足ります。
   ヒント②（使うもの）: e.strip().lstrip("*.") のように、入力側からも * とドットを外してから比べます。相手は os.path.splitext(f)[1].lower().lstrip(".") で作った拡張子です。
   つまずきやすい点: lstrip("*.") は「先頭にある * とドットをまとめて外す」働きで、途中のドットには効きません。フィルターを空にすると * ではなくなるため、どの拡張子にも一致せず0件になります。拡張子の無いファイルは、* のときだけ一覧に出ます。

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

   入力値や計算結果をファイルに保存する機能を追加しましょう。jsonやcsvモジュールを使います。