CustomTkinterのテンプレートを無料配布｜サイドバー付きのモダンなダークUI(GitHub公開)

customtkinter==6.0.0
pillow>=10.0

main.py              アプリ本体(画面の切替とサイドバー)
theme.py             色・フォント・アイコンの設定(見た目はここを編集)
components/          sidebar.py / card.py / dialog.py
views/               dashboard.py / work.py / settings.py (base.py が共通の土台)
assets/icons/        アイコンPNG(ライト用・ダーク用)
assets/app.ico       ウィンドウ左上・タスクバー用のアイコン(Windows)
assets/icons_src/    アイコンの元SVGとライセンス
tools/build_icons.py SVG から PNG を作り直すスクリプト(任意)
tools/record_demo.py GIF・動画の撮影用に、アプリを自動で操作するスクリプト(任意)

NAV_ITEMS = [
    ("dashboard", "ダッシュボード", "layout-dashboard"),
    ("work", "作業", "terminal"),
    ("settings", "設定", "settings"),
]

def icon(name: str, size: int = 22, variant: str = "") -> ctk.CTkImage:
    """
    assets/icons/ の PNG から CTkImage を作る。
    light_image(ライトモード用)と dark_image(ダークモード用)を渡しておくと、
    set_appearance_mode() の切り替えに合わせて自動で画像も切り替わる。

    variant: "" = 通常 / "accent" = オレンジ線 / "onaccent" = オレンジのボタン上用
    """
    key = (name, size, variant)
    if key not in _icon_cache:
        stem = f"{name}_{variant}" if variant else name
        _icon_cache[key] = ctk.CTkImage(
            light_image=Image.open(ICON_DIR / f"{stem}_light.png"),
            dark_image=Image.open(ICON_DIR / f"{stem}_dark.png"),
            size=(size, size),
        )
    return _icon_cache[key]

BG_BASE = ("#f6efe7", "#16130f")       # 画面全体の背景
BG_SIDEBAR = ("#efe3d5", "#100e0b")    # サイドバーの背景
BG_CARD = ("#ffffff", "#211c17")       # カードの背景
BG_INPUT = ("#fbf6f0", "#2a231c")      # 入力欄の背景
BORDER = ("#e6d5c3", "#33291f")        # カードの枠線

TEXT = ("#2b221a", "#f1e8de")          # 本文
TEXT_MUTED = ("#8a7a6a", "#a39484")    # 補足テキスト

ACCENT = ("#c05208", "#ff8a3d")        # アクセント(ブログのオレンジ)
ACCENT_HOVER = ("#a84606", "#ff9f5e")
ON_ACCENT = ("#ffffff", "#1a1209")     # アクセント色の上に載せる文字色

# 12列の等幅グリッド。uniform を同じ名前にそろえると、列幅が均等になる。
# KPIカードは3列ぶん×4枚、下段は 7列(アクティビティ)+5列(使用状況) に分ける
for col in range(12):
    body.grid_columnconfigure(col, weight=1, uniform="col")
body.grid_rowconfigure(1, weight=1)

# --- 1行目: KPIカード ---
for col, (title, value, note, icon_name, color) in enumerate(STATS):
    card = StatCard(body, title, value, note, icon_name, note_color=color)
    card.grid(row=0, column=col * 3, columnspan=3, sticky="nsew",
              padx=(0 if col == 0 else 8, 0 if col == 3 else 8), pady=(0, 16))

def run_job(folder: str, output_name: str, mode: str, log, progress) -> None:
    """
    ★ここを自分の処理に差し替えます★

    「実行」ボタンを押して確認ダイアログで「はい」を選ぶと、この関数が別スレッドで呼ばれます。
    時間のかかる処理を書いても、画面は固まりません。

      folder       : 「参照」で選んだフォルダ
      output_name  : 「出力ファイル名」の欄の文字
      mode         : 「処理モード」で選んだ項目
      log("文字")   : ログ欄に1行追加する
      progress(0.5): 進捗バーを更新する(0.0 〜 1.0)

    注意: この中から CTkLabel などの画面の部品を直接さわらないでください
    (必ず log() / progress() を通します)。エラーは raise すれば、エラーダイアログが出ます。

    いまはデモです。フォルダの中身は見ませんし、ファイルも作りません。
    """
    steps = ["ファイルを読み込み中", "データを整形中", "集計中", "結果を書き出し中"]
    for i, step in enumerate(steps, start=1):
        log(f"({i}/{len(steps)}) {step}…")
        time.sleep(0.5)  # ← 本物の処理に置き換える
        progress(i / len(steps))
    log("完了(デモ): 実際のファイル処理は行っていません。")

from pathlib import Path


def run_job(folder, output_name, mode, log, progress):
    files = list(Path(folder).glob("*.xlsx"))
    if not files:
        raise ValueError("フォルダに .xlsx ファイルがありません。")
    log(f"{len(files)} 件のファイルを処理します")
    for i, f in enumerate(files, start=1):
        log(f"処理中: {f.name}")
        # ここに1ファイルぶんの処理を書く
        progress(i / len(files))
    log("完了")

def _on_run(self):
    if self._running:
        return
    folder = self.folder_entry.get().strip()
    if not folder:
        show_warning(self.winfo_toplevel(), "入力フォルダを選択してください。")
        return
    # はい/いいえの戻り値(bool)で、処理を進めるか止めるかを分岐する
    if not ask_yes_no(self.winfo_toplevel(), f"次のフォルダを処理します。\n{folder}\n\n実行しますか？"):
        self._log("キャンセルされました。")
        return
    self._start_job(folder)

# 幅だけ最小値を決める細い見えない枠。高さは中身(メッセージの行数)に合わせて自動で伸びる。
# (高さを固定すると、パスが長いメッセージでボタンが見切れる)
ctk.CTkFrame(self, width=_W, height=1, fg_color="transparent").pack()

def apply_window_icon(window) -> None:
    """
    CustomTkinter 標準の青いアイコンを、このアプリのアイコンに置き換える(Windows用)。

    CustomTkinter は、ウィンドウを作った約200ミリ秒後に標準アイコンを設定します。
    ただし iconbitmap() を自分で先に呼んでおくと、そちらが優先されます。
    なので、ウィンドウの __init__ の中でこの関数を呼びます。
    Windows以外では .ico が使えないため、何もしません。
    """
    if sys.platform != "win32" or not APP_ICO.exists():
        return
    try:
        window.iconbitmap(str(APP_ICO))
    except Exception:
        pass

APP_ID = "py-vbalab.ctk-app-shell"  # 自分のアプリにするときは、ほかと重ならない名前に変える


def set_windows_app_id() -> None:
    """
    タスクバーに、Pythonのアイコンではなくこのアプリのアイコンを出す(Windows用)。

    python main.py で起動すると、Windowsはこのアプリを python.exe の一部として扱うため、
    タスクバーにはPythonのアイコンが出ます。アプリ専用の ID(AppUserModelID)を付けると、
    別のアプリとして扱われ、ウィンドウのアイコン(app.ico)がタスクバーにも出ます。
    最初のウィンドウを作る「前」に呼ぶ必要があります。Windows以外では何もしません。
    """
    if sys.platform != "win32":
        return
    try:
        import ctypes

        ctypes.windll.shell32.SetCurrentProcessExplicitAppUserModelID(APP_ID)
    except Exception:
        pass

if __name__ == "__main__":
    theme.set_windows_app_id()  # タスクバーのアイコンを app.ico にする(ウィンドウを作る前に呼ぶ)
    app = App()
    app.mainloop()

for view in self.views.values():
    view.grid(row=0, column=0, sticky="nsew")
self.show_view("dashboard")

def show_view(self, key: str):
    """指定した画面を一番上に出し、サイドバーの選択表示も合わせる。"""
    self.views[key].tkraise()
    self.sidebar.set_active(key)