中級者向け No.065

多言語翻訳ツール

テキストを入力して複数言語に翻訳するツール。無料APIを活用し翻訳履歴とクリップボードコピー付き。

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

📋 目次

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

1. アプリ概要

テキストを入力して複数言語に翻訳するツール。無料APIを活用し翻訳履歴とクリップボードコピー付き。

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

このアプリは「ネットワーク」カテゴリです。ネットワーク連携は Python の代表的な活用領域で、I/O 待ちと UI 更新の関係や非同期処理の考え方が他の Web API 連携にも直接活きます。tkinter（標準ライブラリ） を活かして実装するこの構造は、他のアプリにも応用が効きます。

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

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

多言語翻訳ツール実行画面（Linux Mint） — 実行画面（Linux Mint）

2. 機能一覧

「⇄ 入れ替え」ボタン（_swap_langs()）・「▶ 翻訳」ボタン（_translate()）・「📋 コピー」ボタン（_copy_result()）で操作
キー <Control-Return> から _translate() を実行
キー <KeyRelease> から _update_char_count() を実行
マウス操作 <Double-1> から _load_history() を実行
ttk.Treeview による表形式の一覧表示
messagebox.showerror()・messagebox.showwarning() によるダイアログ通知
ウィンドウはタイトル「多言語翻訳ツール」・サイズ 900x841 で起動

3. 事前準備・環境

ℹ️

動作確認環境

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

このアプリはインターネット接続が必要で、入力した文章は外部の翻訳サービス（api.mymemory.translated.net）へ送信されます。

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

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

4. 完全なソースコード

💡

コードのコピー方法

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

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

app065.py

import tkinter as tk
from tkinter import ttk, messagebox
import urllib.request
import urllib.parse
import json
import threading


class App065:
    """多言語翻訳ツール"""

    # MyMemory API (無料・登録不要)
    API_URL = "https://api.mymemory.translated.net/get"

    LANGUAGES = {
        "日本語": "ja",
        "英語": "en",
        "中国語(簡体)": "zh-CN",
        "韓国語": "ko",
        "フランス語": "fr",
        "ドイツ語": "de",
        "スペイン語": "es",
        "イタリア語": "it",
        "ポルトガル語": "pt",
        "ロシア語": "ru",
        "アラビア語": "ar",
        "ヒンディー語": "hi",
    }

    def __init__(self, root):
        self.root = root
        self.root.title("多言語翻訳ツール")
        self.root.geometry("900x841")
        self.root.minsize(900, 841)
        self.root.configure(bg="#1e1e1e")
        self._history = []
        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(header, text="※ MyMemory翻訳API使用",
                 bg="#252526", fg="#555", font=("Arial", 8)).pack(
            side=tk.LEFT, padx=4)

        # 言語選択
        lang_f = tk.Frame(self.root, bg="#2d2d2d", pady=6)
        lang_f.pack(fill=tk.X, padx=8, pady=4)
        lang_names = list(self.LANGUAGES.keys())

        tk.Label(lang_f, text="翻訳元:", bg="#2d2d2d", fg="#ccc",
                 font=("Arial", 9)).pack(side=tk.LEFT, padx=4)
        self.src_lang_var = tk.StringVar(value="日本語")
        ttk.Combobox(lang_f, textvariable=self.src_lang_var,
                     values=lang_names, state="readonly",
                     width=14).pack(side=tk.LEFT)
        ttk.Button(lang_f, text="⇄ 入れ替え",
                   command=self._swap_langs).pack(side=tk.LEFT, padx=8)
        tk.Label(lang_f, text="翻訳先:", bg="#2d2d2d", fg="#ccc",
                 font=("Arial", 9)).pack(side=tk.LEFT)
        self.dst_lang_var = tk.StringVar(value="英語")
        ttk.Combobox(lang_f, textvariable=self.dst_lang_var,
                     values=lang_names, state="readonly",
                     width=14).pack(side=tk.LEFT)
        ttk.Button(lang_f, text="▶ 翻訳",
                   command=self._translate).pack(side=tk.LEFT, padx=12)

        # テキストエリア
        text_f = tk.Frame(self.root, bg="#1e1e1e")
        text_f.pack(fill=tk.BOTH, expand=True, padx=8, pady=4)

        # 入力
        left = tk.Frame(text_f, bg="#1e1e1e")
        left.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)
        tk.Label(left, text="入力テキスト", bg="#1e1e1e", fg="#888",
                 font=("Arial", 9)).pack(anchor="w")
        self.input_text = tk.Text(left, bg="#0d1117", fg="#d4d4d4",
                                   font=("Noto Sans JP", 11), relief=tk.FLAT,
                                   wrap=tk.WORD, insertbackground="#fff",
                                   undo=True)
        self.input_text.pack(fill=tk.BOTH, expand=True)
        self.input_text.bind("<Control-Return>",
                              lambda e: self._translate())
        self.char_lbl = tk.Label(left, text="0 文字", bg="#1e1e1e",
                                  fg="#555", font=("Arial", 8))
        self.char_lbl.pack(anchor="e")
        self.input_text.bind("<KeyRelease>", self._update_char_count)

        ttk.Separator(text_f, orient=tk.VERTICAL).pack(
            side=tk.LEFT, fill=tk.Y, padx=4)

        # 出力
        right = tk.Frame(text_f, bg="#1e1e1e")
        right.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)
        tk.Label(right, text="翻訳結果", bg="#1e1e1e", fg="#888",
                 font=("Arial", 9)).pack(anchor="w")
        self.output_text = tk.Text(right, bg="#0d1117", fg="#4fc3f7",
                                    font=("Noto Sans JP", 11), relief=tk.FLAT,
                                    wrap=tk.WORD, state=tk.DISABLED)
        self.output_text.pack(fill=tk.BOTH, expand=True)
        copy_f = tk.Frame(right, bg="#1e1e1e")
        copy_f.pack(fill=tk.X)
        ttk.Button(copy_f, text="📋 コピー",
                   command=self._copy_result).pack(side=tk.RIGHT)

        # 履歴
        hist_f = tk.LabelFrame(self.root, text="翻訳履歴",
                                bg="#1e1e1e", fg="#888", font=("Arial", 9),
                                padx=4, pady=4)
        hist_f.pack(fill=tk.X, padx=8, pady=(0, 4))
        self.hist_tree = ttk.Treeview(hist_f,
                                       columns=("src_lang", "dst_lang", "src", "dst"),
                                       show="headings", height=4,
                                       selectmode="browse")
        self.hist_tree.heading("src_lang", text="元言語")
        self.hist_tree.heading("dst_lang", text="先言語")
        self.hist_tree.heading("src",      text="元テキスト")
        self.hist_tree.heading("dst",      text="翻訳テキスト")
        self.hist_tree.column("src_lang", width=70,  anchor="center")
        self.hist_tree.column("dst_lang", width=70,  anchor="center")
        self.hist_tree.column("src",      width=300, anchor="w")
        self.hist_tree.column("dst",      width=300, anchor="w")
        hsb = ttk.Scrollbar(hist_f, command=self.hist_tree.yview)
        self.hist_tree.configure(yscrollcommand=hsb.set)
        hsb.pack(side=tk.RIGHT, fill=tk.Y)
        self.hist_tree.pack(fill=tk.X)
        self.hist_tree.bind("<Double-1>", self._load_history)

        self.status_var = tk.StringVar(value="テキストを入力して翻訳してください (Ctrl+Enter)")
        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)

        self.progress = ttk.Progressbar(self.root, mode="indeterminate")
        self.progress.pack(fill=tk.X, padx=8, side=tk.BOTTOM)

    def _swap_langs(self):
        src = self.src_lang_var.get()
        dst = self.dst_lang_var.get()
        self.src_lang_var.set(dst)
        self.dst_lang_var.set(src)
        # テキストも入れ替え
        src_txt = self.input_text.get("1.0", tk.END).strip()
        dst_txt = self.output_text.get("1.0", tk.END).strip()
        self.input_text.delete("1.0", tk.END)
        self.input_text.insert("1.0", dst_txt)
        self.output_text.configure(state=tk.NORMAL)
        self.output_text.delete("1.0", tk.END)
        self.output_text.insert("1.0", src_txt)
        self.output_text.configure(state=tk.DISABLED)

    def _translate(self):
        text = self.input_text.get("1.0", tk.END).strip()
        if not text:
            messagebox.showwarning("警告", "翻訳するテキストを入力してください")
            return
        src_code = self.LANGUAGES.get(self.src_lang_var.get(), "ja")
        dst_code = self.LANGUAGES.get(self.dst_lang_var.get(), "en")
        self.progress.start()
        self.status_var.set("翻訳中...")
        threading.Thread(target=self._do_translate,
                          args=(text, src_code, dst_code),
                          daemon=True).start()

    def _do_translate(self, text, src_code, dst_code):
        try:
            # 2000文字制限のため分割
            chunks = [text[i:i+400] for i in range(0, len(text), 400)]
            results = []
            for chunk in chunks:
                params = urllib.parse.urlencode({
                    "q": chunk,
                    "langpair": f"{src_code}|{dst_code}",
                })
                url = f"{self.API_URL}?{params}"
                req = urllib.request.Request(
                    url, headers={"User-Agent": "Mozilla/5.0"})
                with urllib.request.urlopen(req, timeout=10) as resp:
                    data = json.loads(resp.read().decode("utf-8"))
                translated = data["responseData"]["translatedText"]
                results.append(translated)
            result = " ".join(results)
            self.root.after(0, self._show_result, result, text)
        except Exception as e:
            self.root.after(0, self._show_error, str(e))

    def _show_result(self, result, src_text):
        self.progress.stop()
        self.output_text.configure(state=tk.NORMAL)
        self.output_text.delete("1.0", tk.END)
        self.output_text.insert("1.0", result)
        self.output_text.configure(state=tk.DISABLED)
        self.status_var.set("翻訳完了")
        # 履歴
        src_lang = self.src_lang_var.get()
        dst_lang = self.dst_lang_var.get()
        self._history.insert(0, (src_lang, dst_lang, src_text, result))
        self.hist_tree.insert("", 0,
                               values=(src_lang, dst_lang,
                                       src_text[:50], result[:50]))

    def _show_error(self, msg):
        self.progress.stop()
        messagebox.showerror("エラー", f"翻訳に失敗しました:\n{msg}")
        self.status_var.set("エラーが発生しました")

    def _copy_result(self):
        text = self.output_text.get("1.0", tk.END).strip()
        if text:
            self.root.clipboard_clear()
            self.root.clipboard_append(text)
            self.status_var.set("クリップボードにコピーしました")

    def _update_char_count(self, event=None):
        n = len(self.input_text.get("1.0", tk.END).strip())
        self.char_lbl.config(text=f"{n} 文字")

    def _load_history(self, event=None):
        sel = self.hist_tree.selection()
        if not sel:
            return
        idx = self.hist_tree.index(sel[0])
        if idx >= len(self._history):
            return
        src_lang, dst_lang, src, dst = self._history[idx]
        self.src_lang_var.set(src_lang)
        self.dst_lang_var.set(dst_lang)
        self.input_text.delete("1.0", tk.END)
        self.input_text.insert("1.0", src)
        self.output_text.configure(state=tk.NORMAL)
        self.output_text.delete("1.0", tk.END)
        self.output_text.insert("1.0", dst)
        self.output_text.configure(state=tk.DISABLED)


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

5. コード解説

多言語翻訳ツールのコードを、実際に書かれている実装に沿って解説します。

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

App065 クラスにアプリの全機能をまとめています（メソッド10個・全242行）。__init__ ではタイトル「多言語翻訳ツール」とウィンドウサイズ 900x841 を設定します。最後に _build_ui() で画面を組み立てます。