# ユーザーガイド

FileDirectorの主な機能の概要です。

---

## ファイルの登録と管理

動画・画像ファイルをDBに登録して一元管理します。

- **フォルダスキャン** — フォルダをDBに登録することで、中のファイルを一括登録。サムネイルが自動生成されます
- **サムネイル一覧** — 登録ファイルをサムネイルまたはリスト表示で確認できます
- **複数DB** — 用途に応じてDBを複数作成して切り替えられます（例：仕事用・個人用）
- **Public / Protected** — DBをPublic（外部公開可）またはProtected（個人用）に設定できます。Web UIのアクセス範囲に影響します

---

## タグ・属性による整理

タグと属性を使ってファイルを分類・絞り込みます。

### タグ

キーワードをファイルに付与して整理します。

- `Ctrl+T` でタグメニューを開く、または `Ctrl+E` でタグ入力欄にフォーカスして直接入力
- タグ名（英数字・`-`・`_`・`+`）をスペース/カンマ/セミコロン区切りで複数同時入力、Enterで確定
- ダウンロード元サイト名（`twitter`など）や変換処理名（`mp4cp`など）が自動で付与されます

### 属性（Selections）

あらかじめ定義した選択肢から値を設定するラベルです（例：`Rating=5`、`Genre=Action`）。

- DB設定で属性キーと選択肢を定義
- タグ入力欄で `KEY=VALUE` 形式で入力して設定
- ツリーのSelectionsセクションからフィルターに使用可能

### 3ステートフィルター

ツリーの各タグ・属性に対して3段階の表示条件を設定できます。

| 状態 | 動作 |
|------|------|
| **Show（✓）** | そのタグ/属性を持つファイルのみ表示 |
| **Hide（✗）** | そのタグ/属性を持つファイルを非表示 |
| **None（○）** | 条件を適用しない |

チェックボックスをクリックするたびに Show → Hide → None → Show の順で切り替わります。複数のタグを組み合わせた絞り込みが可能です。

---

## メディア再生

最大4つのメディアプレイヤーを同時に表示・操作できます。

- **動画・音声・画像**をインライン再生
- **スペクトラム表示** — 音声波形のビジュアライザー
- **チャプター機能** — 動画内に目印を追加（`Ctrl+A`）、チャプター間をジャンプ可能
- **クリップ範囲指定** — `[` / `]` キーで開始・終了位置を設定、FFmpeg連携でクリップ出力
- **Cascade Play** — 再生が終わったプレイヤーに次のファイルを自動で割り当て、リスト内のファイルを連続再生

キーボードショートカットは[リファレンス](REFERENCE.md)を参照してください。

---

## ダウンロード

yt-dlp（YouTube等）とgallery-dl（Twitter/Pixiv等）を統合したダウンロード機能です。

- **DOWNLOADボタン** をクリックするとダイアログが開きます
- URLを貼り付けてフォーマットを選択し、Downloadを実行
- ブラウザ（Chrome / Firefox / Edge等）のCookieを使用でき、ログインが必要なサイトにも対応
- ダウンロード完了後、ファイルがDBに自動登録されます
- スマホからは DOWNLOADボタンを右クリック → **Show QR Code** でQRコードが表示され、スマホブラウザからアクセスできます

対応サイト例：YouTube、ニコニコ動画、Twitter/X、Pixiv、その他1000以上のサイト

---

## 動画変換（FFmpeg）

FFmpegと連携した動画変換機能です。ファイルを右クリック → **FFMPEG** サブメニューから使用します。

主な用途：Web UIでブラウザ再生できない形式をMP4に変換する、動画から音声を抽出する、動画の向きを修正するなど。

変換完了後、出力ファイルは自動でDBに登録され、元ファイルのタグを引き継ぎます。

詳細は[FFmpegガイド](FFMPEG_GUIDE.md)を参照してください。

---

## Web UI（ブラウザ・スマホからアクセス）

内蔵WebサーバーによりPCブラウザやスマホからFileDirectorにアクセスできます。

- **Protected サーバー** — 全DBにアクセス可能。ローカルネットワーク内での個人利用向け
- **Public サーバー** — Publicに設定したDBのみアクセス可能
- スマホからは QRコードで簡単にアクセス
- Web UIでもダウンロード操作、ファイル閲覧・再生が可能

アクセス先：`http://[PCのIPアドレス]:[ポート番号]`

> Web UIで再生できない動画がある場合はFFmpegのMP4変換（Copy streams）をお試しください。

---

## AI類似検索（Feature Search）

画像・動画フレームやキーワード（テキスト）から類似ファイルを検索します。

- ツールバーの **SEARCH**（虫眼鏡）ボタンから起動
- **フレーム検索** — 現在再生中のフレームを基準に類似する動画・画像を検索（**Add Current Frame** で追加、複数フレーム指定可）
- **テキスト検索** — キーワードを入力して意味的に近いファイルを検索
- 初回実行時にPython環境を自動セットアップします（インターネット接続が必要）
- 処理状況は左側の**処理状況**パネルで確認できます

---

## ファイル整理（File Finder）

メニュー → **Open File Finder Tab** から起動します。移動・リネーム・重複ファイルの検出と整理ができます。

| モード | 内容 |
|--------|------|
| **FIND MOVED FILES** | ファイルが移動した場合にDBのパスを更新 |
| **FIND RENAMED FILES** | リネームされたファイルをDBに反映 |
| **FIND DUPLICATES** | 重複ファイルを検出・整理 |
| **FIND DUPLICATES IN ALL DBS** | 全DB横断で重複を検索 |
| **MERGE 2 DBS** | 2つのDBを統合 |
| **REMOVE NON-EXISTING FILES** | 存在しないファイルのDB登録を削除 |
| **SCAN FOLDER** | フォルダをスキャンしてDB未登録ファイルを検出 |

---

## Video Edit

複数の動画を同期再生しながら編集する機能です。

- 最大4プレイヤーを同時制御（同期再生・停止・位置調整）
- 各プレイヤーの開始位置を個別に指定
- FFmpeg連携でマルチ動画の合成出力が可能