# miraclx/freyr-js

A tool for downloading songs from music streaming services like Spotify and Apple Music.

Repository: https://github.com/miraclx/freyr-js
Canonical: https://ross.abutalabs.com/products/freyr-js
Homepage: https://git.io/freyr-js
Language: JavaScript
License: Apache-2.0
License Family: permissive
Topics: spotify, spotify-api, spotify-web-api, music-streaming, music, audio, download, youtube, track, album, playlist, artist, itunes, mpeg-4, m4a, m4a-format, apple-music, album-art, nodejs, deezer
Last push: 2026-08-26T18:51:20+00:00

## Health v2 (maintenance only)
Score: 67/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 8, longevity 100
- inputs: {"age_days": 2381, "days_push": 7, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2330, forks 154 (observed 2026-08-28T04:06:37.663499+00:00)

## What it is
Freyr is a Node.js CLI tool that downloads songs from music streaming services like Spotify, Apple Music, and Deezer. It extracts track metadata, fetches the best matching audio from sources like YouTube, encodes it to AAC (.m4a) at 320kbps, embeds metadata and album art, and organizes files into a structured music library.

## Use cases
- download songs from spotify playlists
- rip apple music tracks to m4a
- download a full album with metadata and album art
- build an organized local music library from streaming urls
- convert spotify playlist to offline audio files
- download music from deezer via command line
- batch download tracks from a streaming service link

## When to choose
- you want a command-line tool to turn streaming service URLs into tagged, organized audio files
- you need metadata and album art embedded automatically
- you want cross-platform availability including Docker and npm

## When to avoid
- you need to stream or play music rather than download it
- you require lossless or original-quality audio from the streaming service itself
- downloading copyrighted music is not permitted in your jurisdiction or use case

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, audio-processing, web-scraping, file-system
- domain: media, developer-tools
- platform: cli, cross-platform
- tags: music-downloader, spotify, apple-music, deezer, youtube-audio, m4a, aac-encoding, id3-metadata, album-art, playlist-download, audio, command-line, nodejs, docker

## Member repositories
- miraclx/freyr-js (main) score 67

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:37.663499+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:38:06.450439+00:00, confidence not recorded.
  - readme: https://github.com/miraclx/freyr-js (fetched 2026-08-28T04:06:37.663499+00:00, sha e98f0be8a8ca)
  - homepage: https://git.io/freyr-js (fetched 2026-08-29T10:18:42.727023+00:00, sha 883f18a4b54c)
- Data as of 2026-08-30T08:39:29.467469+00:00.