概要

TuneScout は、ローカル音楽コレクションを「取得・補正・整理・同期」まで一気通貫で扱えるツールを目指すプロジェクトです。多様な音源サイトから曲を取得し、メタデータやジャケット、歌詞を自動で刮削（スクレイピング／取得）して音楽ファイルを標準的なディレクトリ構成に整理します。さらにプレイリストの同期やバックグラウンドでの一括処理など、Navidrome のようなセルフホスト音楽サーバーを補完する機能を備え、Web UI で操作できる点が特徴です。

リポジトリの統計情報

スター数: 11
フォーク数: 0
ウォッチャー数: 11
コミット数: 9
ファイル数: 2
メインの言語: 未指定

主な特徴

複数ソースからの高品質音楽ダウンロード（网易云音乐、QQ 音乐、酷我、Bilibili、YouTube 等）
自動メタデータ刮削（カバー、歌詞、アーティスト、アルバム、ジャンルの補完）
ファイル・ディレクトリの自動整理と標準化、プレイリスト同期機能
Web ベースのダッシュボードでバックグラウンドジョブを管理

技術的なポイント

README の記述に基づくと、TuneScout は以下のような技術的設計方針を採っている想定です。複数の音源サイトに対応するため、サイトごとの解析ロジック（検索→候補抽出→音声取得）を備え、キーワード検索／アーティスト名や曲名、URL ベースでの精密マッチングを行うスマート解析を持つ点が特徴です。メタデータ取得は複数ソースを横断して最適候補を選ぶ集約戦略を採用しており、欠損したカバーや歌詞の一括修復をサポートします。音声抽出やフォーマット変換には FFmpeg 等の外部ツールを呼び出す形、タグ編集には mutagen や taglib といったライブラリが想定されます。バックグラウンド処理はジョブキュー（例：Redis + RQ、Celery 等）や非同期ワーカーで実装されることが多く、Web UI はフロントエンドと API を分離した構成で、Navidrome などの音楽サーバーと API 経由でプレイリストやライブラリの同期を行う設計が適合します。法的な点としては、各配信サービスの利用規約や著作権に注意する必要があります。

プロジェクトの構成

主要なファイルとディレクトリ：

README.md: file
image: dir

image ディレクトリにはダッシュボードやスクリーンショット（例：歌单榜单同步.png）が含まれており、UI のイメージを確認できます。実運用ではバックエンド、スクレイパー、メタデータ整形モジュール、ジョブ管理、Navidrome 連携モジュール、フロントエンドの各コンポーネントで構成されることが想定されますが、本リポジトリ自体は README と画像のみでコードは含まれていない点に留意してください。

まとめ

Navidrome と組み合わせることを想定した多機能な音楽ライブラリ自動化ツールの構想。

リポジトリ情報：

名前: TuneScout-v2
説明: 説明なし
スター数: 11
言語: null
URL: https://github.com/yuwancumian2009/TuneScout-v2
オーナー: yuwancumian2009
アバター: https://avatars.githubusercontent.com/u/122884773?v=4

READMEの抜粋：

🎵 TuneScout

TuneScout 是一个强大的、一体化的本地音乐库管理与自动化工具。它旨在成为 Navidrome服务器的最佳伴侣。

通过现代化的 Web 界面，您可以轻松实现音乐下载、元数据刮削、自动整理、歌单同步以及后台任务管理，让您的音乐库始终保持井井有条。

Dashboard Screenshot

✨ 核心功能

🌐 多源音乐下载
- 支持从 网易云音乐、QQ音乐、酷我音乐、Bilibili (提取音频) 及 YouTube 下载高品质音乐。
- 智能解析搜索，支持按歌手、歌名、链接进行精准匹配。
🏷️ 智能元数据刮削
- 自动补全歌曲的封面、歌词、歌手、专辑、流派等信息。
- 支持从网易云、QQ、酷我、咪咕等多个源头聚合搜索，匹配率极高。
- 支持批量修复本地缺失封面或歌词的音频文件。
📂 自动化库整理
- 标准化目录结构…

TuneScout-v2：ローカル音楽ライブラリ管理と自動化ツール