1. これは何？／開き方
- 目的：練習を「記録」して「続ける」ことで上達する。ソロギター向け（難所のテンポアップ／曲の仕上げ）に特化。
- 形：
solo_guitar フォルダの中で完結する、1枚のWebアプリ＋小さなローカルサーバー。
開き方（ここが大事）
アプリは http://localhost:8765/ から開きます。ショートカット
ソロギター練習アプリ（起動）.vbs をダブルクリックすれば、サーバーが止まっていても起動してから開きます。
パソコンにログオンすると、サーバーは自動で立ち上がります（画面には何も出ません）。
⚠️ ソロギター練習アプリ.html を直接ダブルクリックしないでください。
その開き方（file://）だと、記録がブラウザごとの別データになってしまい、
さらに録音・チューナー・音でタイマー自動スタートが使えません（ブラウザがマイクを許可しないため）。
かならず localhost から開いてください。
2. 画面と機能
下のタブで切り替え。右上に ❓ヘルプ と ⚙️設定・ログ。
🏠 ホーム
- 🔥 連続練習日数（ストリーク）／今週の練習分数／総練習時間
- 練習中の曲、レッスン動画へのボタン、この1週間のグラフ
⏱️ 練習・メトロ（1つの画面にまとまっています）
- ① 曲を選ぶ（または基礎練習）。曲を選ぶと、その曲のテンポと拍子が自動でセットされます。
- ② メトロノーム：BPMは30〜240。−5／＋5、タップでテンポ入力。拍が数字のマスで光ります（通常＝アンバー／アクセント＝赤）。
拍子は 1/4・2/4・3/4・4/4・6/8。1/4は4拍すべて強い音になります。
- ⭐ よく使うテンポ（初期は 50・70。「今のテンポを登録」で追加、✕で削除）
- ③ タイマー：スタート／一時停止／終了して記録。
🎤 音が鳴ったら自動でタイマー開始が既定でオンです（最初の1回だけマイクの許可を聞かれます）。
- 下部のメトロバー：どの画面にいても出ます。練習時間・拍表示・開始/停止・♪のみ・BPM・● 録音ボタン。
左端の ⠿ をドラッグすると好きな場所に移動できます（タブ譜と重なるときなどに）。位置は記憶され、⠿ をダブルクリックで元の位置に戻ります。
「▶ メトロ開始」はスクロールと連動（タブ譜が開いていれば一緒に流れる・止まる）。
「♪のみ」はスクロールに触りません——スクロールを流したままメトロだけ止める、スクロール無しでメトロだけ鳴らす、という使い分けができます。
- 録音：自分の演奏とメトロノームのクリックを混ぜて録音します。あとから聴くと、走った／もたついた箇所が分かります。
🎼 音合わせ（チューナー）
- マイクで音程を検出します。合っている弦（E・A・D・G・B・E）が緑になります。
- 静かな場所で、1本ずつゆっくり鳴らしてください。
🎸 曲（レパートリー）
- 曲名・アーティスト・現在テンポ／目標テンポ・拍子・状態（練習中／仕上げ中／完成）・難所メモ
- タブ譜：PDF・画像をアップロードして登録（フォルダに手で置く必要はありません）。文字タブの貼り付けも可。
- 目標テンポへの到達度がバーで見えます。
- 並び替え：曲名の左の ⠿ を上下にドラッグすると、好きな順番に並べ替えられます。
よく練習する曲を上に置いてください。ホームや練習画面の曲の並びも同じ順番になります。
- ゴミ箱：曲を消しても、いったんゴミ箱に入るだけです。元に戻すか完全に削除かを後から選べます。
📅 記録（カレンダー＋履歴）
- カレンダー：練習した日=／レッスン日=
- 日付をクリック→その日の詳細（レッスン動画・メモ・その日の練習・合計時間）。あとから練習を手入力で追加もできます。
- 🔍 検索（曲名・メモ・日付）、練習履歴の一覧、CSV書き出し
⚙️ 歯車（設定・処理ログ）
- レッスン一覧の最終更新日時と自動更新スケジュール、更新ログ
- 全データのバックアップ／復元（JSON）、練習記録のCSV書き出し
3. タブ譜の使い方（自動スクロール・リピート・書き込み）
曲の画面またはメトロ画面の 🎼 タブ譜を見る で開きます。
右下の角をドラッグするとウィンドウの大きさを変えられます（大きさは次回も覚えています）。
▶ 自動スクロール
- ▶ 自動スクロール で一定の速さで流れます。−＋で速度調整（5〜300）。
- メトロノームを開始すると、一緒に流れ出します（停止すると止まります）。
- ※ 音符に1つずつ同期しているわけではなく、一定速度で流れる仕組みです。
🔁 リピート（同じところを繰り返す）
「最後まで行ってから、セーニョまで戻ってもう一度」「難所だけ5回」といった練習ができます。
まず「区間」を作ります。🔁 リピートを押すと道具バーが開き、
譜面に オレンジの点線（基準線）が出ます。
この線に来ている場所が記録されます。
- 繰り返したい部分の始まりが基準線に来るまでスクロールして、📍 ここが始め。
→ 譜面に 緑の線「▼ 始め」が引かれます。
- 終わりが基準線に来るまでスクロールして、📍 ここが終わり。
→ 青の線「▲ 終わり」が引かれ、間が薄く塗られます。
- ＋ 区間を登録 を押す。
→ A という名前が自動で付き、譜面の左端に帯とA／A終のラベルが出ます。
同じ手順で B・C… と増やせます。区間名をクリックするとその場所へ飛びます。×で削除。
次に「メニュー」を組みます。区間を登録しただけでは動きません。
並べた順番どおりに流れる練習メニューを作ります。
- 区間 A の ＋ を押す → メニューに
A×2 が入る
- −＋ で回数を調整（1〜99回）
- 続けたい区間の ＋ も押す →
A×2 → C×1 のように並ぶ
- ▶ メニュー再生、またはメトロノームを開始
再生中は、いま流れている区間の帯が太く光り、🔁 A 2回目 / 2 次は C と表示されます。
メトロ開始を押したときは、メニューがあればメニュー再生／無ければ普通の自動スクロールに自動で切り替わります。
停止するとリピートは解除され、次は普通のスクロールに戻ります。
💡 使い方の例
・ダル・セーニョ：A＝最初から最後まで、B＝セーニョから最後まで。メニューを A×1 → B×1 にすると、
最後まで流れてからセーニョに戻り、もう一度最後まで流れます。
・難所だけ反復：難所をひとつの区間にして ×10。手を止めずに10回繰り返せます。
・ページの切れ目を飛ばす：各ページの最初の段〜最後の段を区間にして
1p×1 → 2p×1 → 3p×1 と並べると、ページ下の余白を飛ばして譜面だけが途切れなく流れます。
💡 コツ：「終わり」は最後の音符の少し下で押してください。ちょうど音符の高さで押すと、
その音を弾いている最中にジャンプしてしまいます。
✏️ 書き込み（マーカー・ペン）
- ✏️ 書き込みを押すと、譜面に直接書けます。
🖍 マーカー（半透明）／🖊 ペン（細い）／🧽 消しゴム、色は5種類。
- ↶ ひとつ戻すで直前の1本を取り消し、全部消すでその曲の書き込みを全部消します。
- 元のPDF・画像は書き換えません。線の情報だけを別に保存しているので、いつでも消せますし、元のファイルは無傷です。
- ウィンドウの大きさを変えても、書き込みの位置はずれません。
※ リピートのバーと書き込みのバーは同時に開きません（譜面が狭くなるため、片方を開くともう片方が閉じます）。
4. 毎日の流れ
- アプリを開く（
localhost から）→ 曲を選ぶ
- タイマースタート（音を出せば自動で始まります）
- タブ譜を開いて、難所をリピートで繰り返す。弾けるテンポまで落として正確に3回 → BPMを2〜5だけ上げる
- 最後に通しを1回。必要なら録音して聴き返す
- 終了して記録 → 気づき・到達テンポをメモ
- 「📅 記録」のカレンダーで、続いている実感＆振り返り
💡 練習が3秒未満のときは記録されません（押し間違い防止）。
💡 タイマーは時計を見て計算しているので、別のタブに切り替えても練習時間は正確です。
ただし1分以上まったく動きがなかった時間（離席・PCのスリープ）は練習時間に入りません。
一時停止を押し忘れて席を立っても、その分は記録されないので安心してください。
5. レッスン動画の仕組み
- Zoomの録画（「勇川様オンラインレッスン」）は 元の場所（
OneDrive\Documents\Zoom）に置いたまま参照します（コピー・移動しません）。
- カレンダーのの日、または「レッスン動画一覧」からブラウザでそのまま再生できます（途中送りも可）。
- 各レッスンにメモ（習った内容・注意点・宿題）を残せます。
- 一覧の 📁 場所をコピー を押すと、その録画が入っているフォルダの場所をコピーします。
エクスプローラーのアドレス欄に貼り付けて開いてください（ブラウザから直接フォルダは開けない決まりのためです）。
- 自動更新：毎月末9:00にWindowsタスク
SoloGuitar_LessonList が動き、Zoomフォルダを読んで一覧を最新化します（PCが消えていた場合は次回起動時に追いつきます）。
6. データの保存とバックアップ
- 練習記録・曲・メモ・タブ譜への書き込み・リピートの区間は、すべて
solo_guitar\data\data.json に保存されます。
- このPCの中なら、どのブラウザで開いても同じデータです（Chrome でも Edge でも同じ）。
- 録音は
recordings、タブ譜は tabs フォルダに保存されます。
- バックアップ：⚙️ →「🔽 全データをバックアップ」でJSONファイルを書き出せます。
「🔼 復元」で読み込むと、同じ記録は上書き・無い記録は追加され、いまある記録は消えません。
- 練習記録だけをExcelで見たいときは CSV書き出しを使ってください。
⚠️ ソロギター練習アプリ.html を直接ダブルクリックして開いた場合だけは、
昔ながらのブラウザ内保存になり、上のデータとは別物になります。かならず localhost から開いてください。
7. ファイル構成（solo_guitar フォルダ）
| ファイル | 役割 |
|---|
ソロギター練習アプリ.html | 本体（直接開かず、localhost から開く） |
server.py | ローカルサーバー。アプリの配信とデータの読み書き |
ソロギター練習アプリ（起動）.vbs | これで起動。サーバーが止まっていても立ち上げてから開く |
data\data.json | 全データ（記録・曲・メモ・書き込み・区間） |
recordings\ / tabs\ | 録音ファイル／タブ譜（PDF・画像） |
ヘルプ.html | このヘルプページ |
レッスン動画一覧.html | Zoomレッスン動画の一覧ページ |
lessons_data.js | レッスン動画の一覧データ（毎月末に自動更新） |
update_lesson_list.ps1 | Zoomフォルダを読んで一覧を更新するスクリプト |
update_history.js / .csv | 自動更新の実行ログ |
pdf.min.js / pdf.worker.min.js | PDFのタブ譜を表示するための部品 |
背景.jpg | 背景写真（好きな写真をこの名前で置くと背景になります。任意） |
8. 困ったとき
- 録音・チューナー・音での自動スタートが使えない：
localhost ではなくファイルを直接開いていませんか。
ソロギター練習アプリ（起動）.vbs から開き直してください。
- 記録が消えた／見えない：同じく、開き方が違う可能性が高いです。データは消えていません。
- 動画が再生されない：一覧の更新後にZoom側で録画を移動・削除していませんか。フォルダ名が変わると見つけられません。
- リピートで何も起きない：メニューが空ではありませんか。区間を作っただけでは動きません。
区間の ＋ でメニューに追加してください。
- 区間の位置がずれている気がする：区間は基準線（オレンジの点線）の位置で記録されます。
画面のいちばん上ではありません。作り直すときは点線に合わせてください。
- PDFが表示されない：まれに読み込みに失敗して通常表示になります。この場合は自動スクロールと書き込みが使えません。開き直してみてください。
- 新しいレッスンが一覧に無い：自動更新は毎月末です。すぐ反映したいときは手動更新を依頼してください。
- 背景が出ない：ファイル名が
背景.jpg か確認（PNGでは表示されません）。
これから「直したい・増やしたい」が出たら、その内容を伝えてください。