ローカル開発

セットアップ

リポジトリを取得したら、バックエンドとフロントエンドの依存関係をそれぞれインストールします。

cd backend && npm install
cd ../frontend && npm install

yt-dlp と ffmpeg はバックエンドが PATH から実行します。事前にインストール済みであることを確認してください。

yt-dlp --version
ffmpeg -version

起動

バックエンドとフロントエンドは別々のターミナルで起動します。

# terminal 1
cd backend
npm run dev

# terminal 2
cd frontend
npm run dev

フロントエンドは http://localhost:3000、バックエンドは既定でポート 5001 を使用します。Vite の開発サーバーは /api リクエストをバックエンドへプロキシします。

テストと静的検査

# バックエンドのテスト
cd backend && npm test

# フロントエンドの lint と本番ビルド
cd frontend && npm run lint && npm run build

データの保存先

既定では SQLite データベースを backend/media-server.db に、取得済みメディアをリポジトリ直下の downloads/ に保存します。どちらも Git 管理対象外です。

環境変数	既定値	用途
PORT	5001	バックエンドの待受ポート
DB_PATH	バックエンド既定値	SQLite ファイルの場所
DOWNLOADS_DIR	リポジトリ内の downloads/	メディア保存先
VITE_API_URL	/api	フロントエンドが接続する API のベース URL

ドキュメントサイトのローカル確認

cd docs
npm install
npm run docs:dev

本番成果物を確認する場合は npm run docs:build の後に npm run docs:preview を実行します。