このプロジェクトについて

Freyrは、ストリーミングサービスから楽曲をダウンロードするためのコマンドラインツールです。Spotify、Apple Music、DeezerのURLまたは短縮URIを指定すると、トラックのメタデータ(タイトル、アーティスト、アルバム、トラック/ディスク番号、リリース日、ISRC、レーベル、著作権、カバーアートなど)を抽出し、YouTube Musicなどの音声ソースに問い合わせて一致する音声を探し、生ファイルをダウンロードし、設定可能なビットレート(96~320kbps、デフォルト320k)でApple AAC(.m4a)にエンコードし、メタデータとアルバムアートを埋め込み、ARTIST/ALBUM/TRACKのディレクトリ構造に出力を整理します。 対応するクエリタイプには、トラック、アルバム、アーティスト、プレイリストが含まれます。複数のクエリを引数として渡すか、入力ファイル(-i/--input)を使用することでバッチダウンロードが可能です。入力ファイルでは各行がクエリとなり、#はコメントを示します。urifyサブコマンドは、サービスURLとfreyr互換の短縮URIを相互変換します。 主なオプションには、ビットレートの選択、チャンクの並列ダウンロード(-n/--chunks)、リトライ回数、カスタム出力ディレクトリ、既存トラックの他ディレクトリ確認(-D)、カバーアートの命名とサイズ指定または無効化、ソース優先順位(youtube、yt_music、!で除外)、メタデータフィルター、ステージごとの並行処理調整(queries、tracks、trackStage、downloader、encoder、embedder)、ギャップレス再生フラグ、強制上書き、プレイリスト生成(m3u8)とそのディレクトリ・追記・エスケープ・名前空間プレフィックスのオプション、ストアフロントの国コード、ツリー整理の無効化、キャッシュディレクトリ制御、メモリキャッシュサイズ、ネットワークタイムアウト、認証とブラウザ起動の切り替え、プログレスバーのスタイル、AtomicParsleyバイナリの明示的なパスがあります。 インストールはnpm(npm install -g freyr)またはYarn、ソースから、あるいは公式Dockerイメージ(freyrcli/freyrjs)で可能で、docker runコマンドとエイリアス例が文書化されています。要件はPython >= 3.2、Node.js >= 16、AtomicParsley >= 20230114です。READMEには、生音声をYouTube Musicから取得するため、ユーザーの地域でYouTube Musicが利用可能である必要があると記載されています。このプロジェクトはライセンスされており、CIチェック、CodeFactorの評価、npmとDockerのダウンロードバッジ、寄付リンクが含まれています。