MusicGrabber

你是否经历过这样的时刻：

在广播或播客里听到一首惊艳的单曲，只想立刻把它加入自己的音乐库。但当你打开 Lidarr 时，却发现需要层层导航、搜索艺术家、等待整个专辑甚至作品集的抓取……

“我只想要这一首歌，不想要整个负担。”

这正是 Music Grabber 诞生的初衷。作为一个轻量级、自托管的音乐获取服务，它专注于一个核心场景：快速、高质量地获取单曲。现在，随着 v2.1.2 的发布，它更是引入了 Monochrome (Tidal) 无损源支持，让你的本地音乐库瞬间提升至 Hi-Res 级别。

核心定位：做减法，只为“那一首歌”

Music Grabber 有意保持功能狭窄，它不是：

• ❌ 完整的音乐管理器（替代不了 Lidarr/Navidrome）。
• ❌ 专辑/全集自动化工具（没有“抓取作者所有作品”的功能）。
• ❌ 流媒体服务器（它只负责下载，不负责播放）。
• ❌ 推荐引擎（没有算法猜你喜欢什么）。

它就是：

• ✅ 单曲猎手：听到 -> 搜索 -> 点击下载 -> 入库。全程只需几秒钟。
• ✅ 画质党福音：优先提供最高音质，支持真正的无损 FLAC。
• ✅ 自托管利器：数据完全掌握在自己手中，隐私安全。

v2.1 重磅更新：无损音质的飞跃

本次更新最大的亮点是集成了 Monochrome API，彻底改变了音质格局。

True Lossless from Tidal

• 真实无损：不再是从 YouTube 转码的“假 FLAC”。Music Grabber 现在可以直接从 Tidal CDN 流式传输真正的无损 FLAC 文件。
• 完美元数据：直接嵌入 Tidal 官方目录的封面艺术、艺术家信息、专辑名称等，无需后期手动修正。
• 智能排序：搜索结果中，无损曲目会自动置顶，并带有“Lossless”或“Hi-Res”徽章。只有当 Tidal 上没有时，才会回退到 YouTube 或 SoundCloud。

性能提升

• 绕过 yt-dlp：Monochrome 下载完全绕过复杂的 yt-dlp 流程，速度更快，稳定性更高。
• 预览功能：支持 Monochrome 曲目的 AAC 流预览，无需启动后端子进程，体验丝滑。

功能全景：小而美，却五脏俱全

除了核心的无损下载，Music Grabber 还拥有一系列贴心功能：

快速部署：Docker 一键启动

Music Grabber 部署极其简单，推荐使用 Docker Compose。

📝 步骤 1：创建 docker-compose.yml

services:
  music-grabber:
    image: g33kphr33k/musicgrabber:latest
    container_name: music-grabber
    restart: unless-stopped
    # Required for Spotify playlists over 100 tracks (headless browser)
    shm_size: '2gb'
    ports:
      - "38274:8080"
    volumes:
      - /path/to/your/music:/music
      - ./data:/data
    environment:
      - MUSIC_DIR=/music
      - DB_PATH=/data/music_grabber.db
      - ENABLE_MUSICBRAINZ=true
      - DEFAULT_CONVERT_TO_FLAC=true
      # Optional: Run as specific user (like *arr stack) for correct file permissions
      # - PUID=1000
      # - PGID=1000
      # Optional: Navidrome auto-rescan
      # - NAVIDROME_URL=http://navidrome:4533
      # - NAVIDROME_USER=admin
      # - NAVIDROME_PASS=yourpassword
      # Optional: Jellyfin auto-rescan
      # - JELLYFIN_URL=http://jellyfin:8096
      # - JELLYFIN_API_KEY=your-jellyfin-api-key
      # Optional: Notifications
      # - NOTIFY_ON=playlists,bulk,errors
      # - TELEGRAM_WEBHOOK_URL=https://api.telegram.org/bot{token}/sendMessage?chat_id={chat_id}
      # - WEBHOOK_URL=https://your-webhook-endpoint.com/hook
      # - SMTP_HOST=smtp.example.com
      # - SMTP_PORT=587
      # - SMTP_USER=user@example.com
      # - SMTP_PASS=password
      # - SMTP_TO=you@example.com
      # Optional: Use a Monochrome mirror instead of the default instance
      # - MONOCHROME_API_URL=https://api.monochrome.tf

🚀 步骤 2：启动服务

docker compose up -d

🌐 步骤 3：开始使用

访问 http://your-server-ip:38274，即可在浏览器或手机端开始搜索下载。

• 设置：所有配置（如 API Key、Cookie、整理规则）均可在 Web UI 的“Settings”标签页完成，无需修改配置文件。
• 持久化：设置保存在数据库中，重启容器不丢失。

常见问题

Q: YouTube 下载的 FLAC 是真的无损吗？

A: 对于 YouTube 和 SoundCloud 源，FLAC 主要是为了标准化格式和标签，音频质量受限于源（通常是有损的）。但对于 Monochrome (Tidal) 源，下载的是真正的无损 FLAC，直接从 Tidal CDN 获取，音质有保障。

Q: 它可以替代 Lidarr 吗？

A: 不能也不建议。Lidarr 适合管理庞大的艺术家全集和自动追踪新专辑；Music Grabber 适合即时获取单曲和特定播放列表。两者可以互补共存。

Q: 支持批量下载吗？

A: 支持！你可以粘贴歌曲列表文本，或直接导入播放链接，系统会并行搜索并排队下载所有曲目。