はじめに

Media Server は、音楽と動画を自分で管理してブラウザから再生するためのセルフホスト型アプリケーションです。YouTube URL からのメディア取得、ローカルファイルのアップロード、プレイリスト管理、キュー再生を一つの UI にまとめています。

主な機能

URL をキューへ追加して、音声（m4a）と動画（mp4）を取得
ローカルの音声・動画ファイルをアップロード
ライブラリの検索、プレイリストの作成と曲の整理
シャッフル、リピート、再生キューの並べ替え
音声・動画モードを切り替えられるストリーミング再生

構成

レイヤー	使用技術	役割
フロントエンド	React / Vite / Tailwind CSS	ライブラリ、キュー、プレーヤー UI
バックエンド	Node.js / Express	REST API、メディア管理、ストリーミング
データベース	SQLite	曲、プレイリスト、関連情報
メディア処理	yt-dlp / FFmpeg	URL からの取得とメディア変換
本番運用	Docker / Kubernetes	コンテナ実行と永続ボリューム管理

必要な環境

ローカル開発には以下が必要です。

Node.js 18 以上
yt-dlp
ffmpeg

macOS では Homebrew を使ってインストールできます。

bash

brew install yt-dlp ffmpeg

続けてローカル開発の手順でアプリケーションを起動してください。