SRT-Refiner
AI字幕リマスターツール ご利用ガイド
はじめに：AIで字幕制作を劇的に効率化する
この度は、AI字幕リマスターツール「SRT-Refiner」をご利用いただき、誠にありがとうございます。
このガイドでは、プロの開発現場で標準的に使われているバージョン管理システム「Git」と、そのプラットフォームである「GitHub」を導入し、今後のツールアップデートをコマンド一行で完了できる環境を構築します。一度設定すれば、制作の効率が飛躍的に向上しますので、ぜひこの機会に、プロのワークフローを体験してみましょう。
Git/GitHubを導入する3つのメリット
- アップデートが劇的に楽になる：ツール更新時、コマンド1行で瞬時に最新版にできます。Zip再ダウンロードや設定ファイル（APIキー等）の手動移行は不要になります。
- 安全な設定管理：あなたが編集したAPIキーなどの個人設定ファイルは、アップデートで上書きされない仕組みで保護されます。
- プロのスキルが身につく：Git/GitHubは現代のIT業界で必須のスキルです。この手順を通じて、その基本操作を自然と学べます。
1. PCへの導入手順（初回のみ）
GitHubからの招待を承認する
本ツールはアクセスが制限されたプライベートなリポジトリで提供されています。利用申請後、ご自身のGitHubアカウント宛に開発チームからの招待メールが届きますので、まず、この招待を承認してください。
- メールボックスを確認し、「[GitHub] okihiro-ai-creative has invited you to collaborate」という件名のメールを開きます。
- メール本文にある緑色の「View invitation」ボタンをクリックし、開いたページで招待を承認します。
Gitをインストールする
次に、ツールをPCにダウンロードしたり、最新版にアップデートするために必要なコマンドラインツール「Git」をインストールします。
SSHキーを設定する (強く推奨)
プライベートなツール保管場所（リポジトリ）に安全かつパスワード入力なしで接続するため、お使いのPCとGitHubアカウントを連携させる「SSHキー」の設定を行います。
Step A: SSHキーの作成
PCのターミナル（WindowsならGit Bashやコマンドプロンプト）を開き、以下のコマンドを実行します。"your_email@example.com" の部分は、ご自身のGitHub登録メールアドレスに書き換えてください。
ssh-keygen -t ed25519 -C "your_email@example.com"
途中でファイルの保存場所と、パスワード（passphrase）を2回聞かれますが、すべて何も入力せずにEnterキーを押してください（合計3回）。これでパスワードなしのキーが作成されます。
Step B: GitHubへの公開鍵の登録
- PCの
C:\Users\（あなたのユーザー名）\.sshフォルダ（Macの場合は~/.ssh）の中にあるid_ed25519.pubというファイルをテキストエディタで開きます。 - ファイルの中身の文字列（
ssh-ed25519から始まる全てのテキスト）をコピーします。 - GitHubのSSHキー設定ページにアクセスし、「
New SSH key」ボタンをクリックします。 - 「Title」にはPCの名前など分かりやすい名前を付け、「Key type」はデフォルトの「Authentication Key」のままで問題ありません。「Key」の欄に先ほどコピーした文字列を貼り付け、「
Add SSH key」ボタンを押して登録完了です。
ツールをダウンロード＆更新する
いよいよツール本体をPCにダウンロードします。コマンドプロンプト（Windows）またはターミナル（Mac）を開き、以下のコマンドを実行してください。
A. 初回ダウンロード (Clone)
PCの作業したいフォルダへ移動してから（例: cd Desktop）、以下のコマンドをコピーして実行します。SRT-Refinerというフォルダが作成され、ツールがダウンロードされます。
git clone git@github.com:okihiro-ai-creative/SRT-Refiner.git
B. 今後のアップデート方法 (Pull)
今後ツールが更新された際は、ダウンロードしたSRT-Refinerフォルダ内で以下のコマンドを実行するだけで、常に最新版を利用できます。
git pull
2. ツールの使い方
ツールの初回セットアップ
ダウンロードしたSRT-Refinerフォルダ内で、お使いのOSに合わせたセットアップスクリプトを一度だけ実行します。これにより、ツールに必要なライブラリが自動でインストールされます。
- Windows:
_setup.batをダブルクリックします。 - macOS: ターミナルで
sh _setup.shを実行します。
完了後、systemフォルダにapi_keys_gemini.txtが生成されます。このファイルを開き、ご自身のGemini APIキーを貼り付けて保存してください。
入力ファイルの準備
inputフォルダにある original.srt に、修正したいSRTファイルの内容を貼り付けて保存します。
ツールの起動と実行
お使いのOSに合わせて、_run_guiスクリプトを実行してGUIランチャーを起動します。
- Windows:
_run_gui.batをダブルクリックします。 - macOS: ターミナルで
sh _run_gui.shを実行します。
起動したGUIのボタンから、目的に合った機能を選択して実行します。
[SRTをリマスター (自動)]
AIが字幕の結合、タイミング調整、整形を全自動で行います。
[手動モード (APIエラー時)]
Google AI Studioなどで直接実行するためのプロンプトを生成します。APIが不調な際にご利用ください。
結果の確認
処理が完了すると、outputフォルダに結果がファイルとして保存されます。自動モードではrefined.srtが、手動モードではprompt_for_manual.txtなどが生成されます。
3. 困ったときは (サポートについて)
- 導入や操作でエラーが出た場合は、まずこのガイドページをもう一度よくお読みください。多くの場合、手順の見落としやコマンドの入力ミスが原因です。
- それでも解決しない導入に関するトラブルに限り、LINE公式アカウントにてサポートを承ります。その際は、どのステップで問題が発生したか、エラーメッセージなどを添えてご連絡いただくと、スムーズな対応が可能です。