======================================================
 Video Tag Browser - 爆速・軽量ローカル動画管理ツール
======================================================

この度は『Video Tag Browser』をご利用いただき、誠にありがとうございます。
PCや外付けドライブに散らばった大量の動画ファイルを、直感的なUIで
爆速で管理・タグ付け・検索できるローカル専用ツールです。

【 ⚠️ 最初に必ずご確認ください（重要） 】
本ソフトは設定ファイル（app.db）をソフトと同じフォルダ内に作成します。
そのため、「Program Files」などのWindowsのシステム保護フォルダ内では
正常に動作しません。
解凍先は必ず「ドキュメント」「デスクトップ」や、任意のドライブ
（C:\ や D:\Tools 等）に指定してください。

------------------------------------------------------
■ ★ v1.3 の新機能
------------------------------------------------------
・🔍 発見モード（新ページ）
　ヘッダーの「🔍発見」ボタンで、整理用の画面とは別の新しいページに切り替わります。
　配信サイトのように、タググループ別・ランダムタグ・ミックスの3方式で
　「行（シェルフ）」を自動生成し、タグごとにおすすめ動画を横スクロールで
　眺められます。動画の並びは「再生回数が少ない順」「ランダム」
　「最終アクセスが古い順」から選べるので、大量の動画の中から
　忘れていた動画を掘り返す発見に使えます。
　・「タググループで絞込」で特定のタググループだけに絞り込み可能
　・左のタグリストと連携：グループをクリックするとその絞り込みに、
　　個別タグをクリックするとそのタグ1本だけの行を表示
　・「▶️自動スクロール」ボタンで、行が少しずつ自動で流れる表示に切替可能
　・整理モードでおなじみのサムネ数(1/3/5)・拡大縮小バーもそのまま使えます
・◀▶ タグリストの表示/非表示をワンボタンで切替可能に（整理・発見の両モード共通）

------------------------------------------------------
■ 過去バージョンの新機能
------------------------------------------------------
【v1.2】
・🔎 除外（マイナス）検索
　検索欄で「-文字」のように先頭に「-」を付けると、その言葉を含む動画を
　除外して絞り込めます。スペース区切りのAND検索とも組み合わせ可能です。
・🏷️ 未タグのみ表示
　上部の「🏷️ 未タグ」ボタンで、まだタグが付いていない動画だけを抽出。
　整理のやり残しがすぐわかります。
・🎨 タグの色分け
　タグ／グループの「✏️」から色を設定できます。グループに色を付けると
　配下のタグにも反映されます。
・📊 統計ダッシュボード
　上部の「📊 統計」ボタンで、総本数・総再生時間・総容量・タグ別TOP20などを
　まとめて確認できます。
・⚡ タグのドラッグ操作を大幅に高速化し、起動の安定性も改善しました。

------------------------------------------------------
■ 1. 使い方（初期設定）
------------------------------------------------------
1. フォルダ内の「VideoTagBrowser.exe」をダブルクリックして起動します。
2. 初回起動時は画面中央に「動画がありません」と表示されます。
3. 画面の指示に従い、動画が保存されているメインのフォルダを選択します。
4. 画面右上の「📥 新着を読み込む」をクリックすると、指定したフォルダ内を
   爆速でスキャンし、ブラウザ上に動画が一覧表示されます。

※複数のフォルダを管理したい場合：
右上の「⚙️設定」から、「管理対象フォルダ」の入力欄に新しいフォルダパスを
1行に1つずつ追記して保存してください。

------------------------------------------------------
■ 2. 便利な機能と操作のコツ
------------------------------------------------------
【🔍 発見モード】
ヘッダーの「🔍発見」ボタンを押すと、タグ別のおすすめ動画を横スクロールで
眺められる発見ページに切り替わります。「📁整理へ戻る」でいつでも通常画面に
戻れます。行の生成方法・並び順はページ上部のメニューから変更できます。

【⌨️ 神ショートカット機能（フルキーボード対応）】
本ツールはキーボード操作に完全対応しています。
画面上で「 ? 」（Shift + /）キーを押すと、ショートカット一覧画面が開きます。
矢印キーでの動画選択、Spaceキーでの再生、Tキーでのタグ付けなど、
マウスを使わずにサクサク整理が可能です。

【🖼️ サムネイルの生成と切り替え】
動画を追加した直後はサムネイルがありません。上部の「🖼️ サムネ生成」ボタンを
押すと、バックグラウンドで自動的にサムネイルが作成されます。
画面左上の数字（1・3・5）を切り替えると、動画のシーンをパラパラ漫画のように
複数枚で確認できます（発見モードでも同じ設定が反映されます）。

【🏷️ 最強のタグ付け・整理機能】
・マウスで一括付与：動画を複数選択して左側のタグ名をクリックするだけで一括付与。
・フォルダ構造タグ：上部の「📁 フォルダ名でタグ付け」を押すと、Windowsの
　フォルダ構成（例: 旅行\沖縄）をそのまま階層タグとして自動付与します。
・タグの階層化：左側のタグリストで、タグを「タググループ（📁）」に
　ドラッグ＆ドロップすると、簡単に階層化（グループ分け）して整理できます。
・タグの色分け：タグ／グループの「✏️」から好きな色を設定できます。
・グループの編集／削除：左側のタググループにマウスを乗せると、グループ名の
　一括変更（✏️）や、グループの削除・階層解除（✖️）がいつでも可能です。
・タグリストは「◀タグ」ボタンでいつでも表示/非表示を切り替えられます。

【⭐ スター（評価）の一括付与】
動画を選択した状態で、キーボードの「1〜5」を押すと一瞬で評価を付与できます。
「0」を押すと評価をクリアします。

------------------------------------------------------
■ 3. データの保守とバックアップ
------------------------------------------------------
あなたが一生懸命付けたタグや星のデータ、作成したタググループや
お気に入り設定は、すべて「app.db」という1つのファイルに保存されています。

【PCを買い替える場合（データ移行）】
古いPCのフォルダ内にある「app.db」を、新しいPCの同じ場所に
上書きコピーするだけで、完全に元の状態を引き継ぐことができます。
※右上の「⚙️ 設定」画面から、定期的にDBバックアップを保存しておくことを
　強く推奨します。

------------------------------------------------------
■ 4. よくある質問 (FAQ)
------------------------------------------------------
Q. エラーで画面が真っ暗になってしまった/起動しない
A. 一度右上の「⏻終了」または黒い画面（起動していれば）を閉じ、数秒待ってから
　 再度「VideoTagBrowser.exe」を起動し直してください。

Q. 新しく追加した動画に再生時間が表示されない
A. スキャン速度を優先しているため、初期状態では時間は取得されません。
　 画面上部の「⏱️ 再生時間を取得」ボタンを押すとバックグラウンドで解析が始まります。

------------------------------------------------------
■ 5. アンインストール方法
------------------------------------------------------
レジストリなどは一切使用していません。環境を汚さないポータブル仕様です。
不要になった場合は、このフォルダごとゴミ箱に捨てるだけで完全に削除されます。

------------------------------------------------------
■ 上位版「VideoTagBrowser2」のご案内
------------------------------------------------------
本ソフトをRust製エンジンで全面リライトした上位版を公開しています。
無料版の全機能に加えて:
・シーン一覧 … 動画を10〜30分割でサムネイル一覧表示し、クリックした
　場面からそのまま再生（対応プレイヤー: PotPlayer / VLC / MPC-HC / mpv）
・WhiteBrowser（.wb）からの移行インポート（タグ・点数・再生回数を引き継ぎ）
・動画ファイルのドラッグ＆ドロップ取り出し／メモ検索／
　ショートカットの完全カスタマイズ／削除はごみ箱経由 など
・数万件規模でもさらに軽快に動作します

詳細・入手はこちら:
https://tekuteku1000.booth.pm/items/8644970
開発情報（X）: https://x.com/tekuteku_vtb

------------------------------------------------------
■ 免責事項
------------------------------------------------------
本ソフトの利用により発生したいかなる損害（データ消失など）についても、
開発者は一切の責任を負わないものとします。自己責任にてご利用ください。

------------------------------------------------------
■ オープンソースライセンス表記
------------------------------------------------------
本ソフトウェアは、以下のオープンソースライセンスを利用して開発されています。
- FastAPI, Uvicorn, SQLAlchemy (MIT / BSD License)
- OpenCV-Python (Apache 2.0 License)
- Vue.js, Tailwind CSS (MIT License)

Copyright (c) 2026 TEKUTEKU1000
======================================================
