動画ファイルを渡すと、画面のタブ譜が 1 枚の楽譜になる

7 つの段を順に進む

画面で動画ファイルを選んで「タブ譜を作る」を押すと、この 7 段が自動で進みます。途中で失敗しても、その段からやり直せます。紙の楽譜は 3 の段から流れが分かれます（下の紙の楽譜のとき）。

1. youtab動画の取り込み手元の動画ファイルを確かめて作業フォルダへadd
2. youtab画像の切り出し1 秒に 1 枚の静止画frames
3. youtab帯と線の検出タブ譜の場所と 6 本の弦の位置strip
4. youtabページ分け画面が切り替わるごとの拡大画像pages
5. AI読み取り小節ごとの楽譜データ（alphaTex）read
6. youtabタブ譜の組み立て検査して 1 枚の楽譜（HTML）にbuild
7. youtab時刻の照合動画の時刻と楽譜の時刻を比べるverify

AI が受け持つのは 5 の「読み取り」だけです。取り込み・切り出し・検出・組み立て・照合は、決まったルールで youtab が行うので、何度やっても同じ結果になります。

それぞれの段で何をしているか

楽譜にあるパートを選んでから読む

バンドスコアのように、1 ページに何本もの楽器が並んだ紙の楽譜も書き起こせます。写真・PDF・写真の ZIP、紙をめくりながら撮った動画を渡すと、AI が楽譜にあるパートを洗い出して止まります。書き起こすパートを選ぶと、その段だけを切り出して読みます。

1. youtab取り込み写真・PDF・ZIP はページの画像に。動画は 1 秒 1 枚に
2. youtab紙か画面かを見分ける動画だけ。タブが見えたフレームの割合で決める（AI は使わない）
3. AIパートの洗い出し楽譜に書かれたパート名・TAB の有無・弦数の見込み
4. あなたパートを選ぶ「パートの選択待ち」で止まるので、一覧から選ぶ
5. AI段を選ぶページの重複を除き、選んだパートの段を選ぶ
6. youtab段の補正と拡大紙の曲がりを伸ばし、線の間隔をそろえる
7. AI読み取り段の拡大画像と元のページを見て読む
8. youtabタブ譜の組み立て動画のときと同じ検査をして 1 枚の楽譜に

• 紙か画面かの見分け　画面のタブ譜はほとんどのフレームでタブが見えますが、紙をめくる動画では見えるフレームがわずかです。手元の 12 本では、画面は 24 枚中 21〜23 枚、紙は 2〜7 枚と、はっきり分かれました。境目では画面のタブ譜の側に倒し、どちらにしたかと根拠の数を段の結果欄に出します。違っていたら「やり直す」で楽譜の種類を変えられます。
• 線を確かめられた段だけ補正　TAB の線を何か所かで確かめられない段は、無理に補正せず、弦の番号の印も付けません。読み手は元のページで弦を確かめます。
• 時刻は使わない　紙をめくる時刻は演奏の時刻ではないので、テンポの推定や時刻の照合はしません。テンポの表記がなければ、再生用に仮の 120 にします。
• 撮り方で精度が変わる　ぼけ・指で隠れた所・画面の外に切れた小節は、補正しても戻りません。フル HD（1080p）以上の画質で、本をしっかり開いて撮ると読みやすくなります。

ページを分けて同時に読み、境目は重ねて読む

長い曲は、ページをいくつかのまとまりに分け、まとまりごとに AI を起動して同時に読ませます（最大 4 つ）。となり合うまとまりは境目のページを両方で読むので、2 つの答えが合うかどうかで読み違いに気づけます。

食い違いや抜けは、まとめ役の AI（つなぎ目の問題を解くために別に起動する AI）が画像を見直して解きます。決め手は、数字がどの線に乗っているか（弦の位置）と、和音として自然か（構成音・キー）です。解いた答えは最初の読み取り結果とは別に残るので、あとから見直せます。

AI は最後に短い報告（書いた小節、自信のない所、曲の構成、直した小節）を日本語で返します。画面では、この報告を読みやすく整えて表示します。

AI には、できることを絞っている

読み取りでは、youtab があなたの Claude Code / Codex を裏で起動します。普段の設定のまま動かすと何でもできてしまうので、起動のしかたで、できることを絞っています。

モデル（Claude Code / Codex の中で使う AI の種類）と推論の強さ（AI がどれだけ時間をかけて考えるか。強いほど丁寧になりやすいが、遅く、利用枠も多く使う）だけは、画面で選んだ値か、選ばなければ普段の値を使います。どちらの AI も、あなたがログインしている Claude Code / Codex の利用枠（契約プランで使える量）で動きます。詳しい説明は 安全のしくみ（docs/safety.md） にあります。

見る・鳴らす・持ち出す

できあがった楽譜は画面の中でそのまま表示・再生でき、いくつかの形式でダウンロードできます。

演奏動画 1 本（1080p）で試した結果

同じ曲を人が手で書き起こした楽譜を正解として、小節ごとに比べました。

一致しなかったのは、パームミュートの付け方と、テンポ変化を書く位置が 1 拍ずれた所だけでした。それでも読み違いがありえるので、元の動画と照らして使ってください。

画面から使う・コマンドで使う

画面を使うときも、開くまでは下のコマンド（文字で打ち込む命令）を使います。Mac の「ターミナル」というアプリで、youtab のフォルダに移ってから入力します。最初の準備（ダウンロードとセットアップ）と入力のしかたは README（youtab の説明書きのページ）にあります。

# 画面を開く（ブラウザで http://127.0.0.1:8765/ 。あなたのパソコンの中だけで動き、ネットには公開されない）
uv run youtab serve

# 画面を使わずに、同じ流れを通しで
uv run youtab run 動画.mp4

# 読み取りのモデルと推論の強さを選ぶこともできる（画面でも選べる。選ばなければ普段の設定）
uv run youtab run 動画.mp4 --model opus --effort max

# 紙の楽譜（写真・PDF・ZIP・紙を撮った動画）。パートの選択待ちで止まるので、表示された名前で続ける
uv run youtab run 楽譜.pdf
uv run youtab run ID --part 'Guitar II'

# 段ごとに動かすこともできる（ID は、取り込んだときに表示される曲ごとの名前）
uv run youtab add 動画.mp4 / frames ID / strip ID / pages ID / check ID / build ID / verify ID

曲ごとの作業フォルダには、次のファイルができます。ふだんは開かなくて構いません（できあがった楽譜は画面から見られます）。

動画・画像・楽譜は、youtab のフォルダの中の work/ に保存されます。youtab の本体とは別に置かれ、どこかへ公開されることはありません（AI には、読み取りのときに画像を見せます）。要らなくなった曲は、画面の「この曲を消す」で作業フォルダごと消せます（元に戻せません）。

詳しい使い方は README と、画面の使い方・紙の楽譜から書き起こす・読み取りのモデルと推論の強さ・コマンド にあります。