吾爱破解 - 52pojie.cn

 找回密码
 注册[Register]

QQ登录

只需一步,快速开始

查看: 3203|回复: 61
收起左侧

[原创工具] FreeBird - 让你的网易云音乐「重获自由」

  [复制链接]
wjshome 发表于 2026-6-19 15:40
本帖最后由 wjshome 于 2026-6-30 11:04 编辑

🐦 FreeBird 发布啦!

让你的网易云音乐「重获自由」—— 一键变成能在任何地方播放的音乐文件 🎵

这是什么?

你有没有过这种烦恼:在网易云听了/下了一堆好歌,文件明明在硬盘里,却是一堆打不开的 .uc 缓存或 .ncm 下载文件,换个播放器就没法听了?

FreeBird 就是来解决这个问题的! 它是一个基于 .NET 10 构建的跨平台命令行工具,自包含打包、无需预装任何运行时 —— 下载解压即用 🚀。它能把这些文件变成干干净净的 MP3 / FLAC / M4A,自动命名成 歌手 - 歌名.flac,还会帮你:

  • ✅ 自动写好标题、歌手、专辑等标签
  • ✅ 校验音频完整性,确保转出来的文件没坏
  • 绝不修改你的原始文件,只读不写,安全放心
  • 📦 绿色免安装,不用装 .NET、不用配环境,下载就能跑
  • 🖥️ 全平台支持:macOS、Linux、Windows 都能用

支持两种网易云文件

类型 来源 说明
.uc / .uc! 缓存文件 在线试听时生成 FreeBird 自动从网易云抓取歌曲信息来命名和打标签
.ncm 下载文件 下载歌曲时生成 歌名、歌手、专辑、封面都已内嵌在文件里,完全离线解码、无需联网,并自动写入专辑封面 🖼️

怎么用?超简单!

下载对应系统的版本,解压,然后一条命令搞定:

# 转换一次就好:
fb scan <你的文件夹> --output ~/Music/decoded

# 或者让它一直运行,边听/边下边自动转换新文件:
fb watch <你的文件夹> --output ~/Music/decoded

<你的文件夹> 可以是网易云的在线缓存目录.uc / .uc!),也可以是你存放下载歌曲.ncm)的任意目录 —— 两种文件 FreeBird 都会自动识别处理。

还能一次传入多个文件夹,比如把「在线缓存」和「下载目录」一起转到同一个输出文件夹:

# 在 --output 前面想写几个输入文件夹都行,全部转到同一个输出目录:
fb scan ~/Music/netease-cache ~/Downloads/netease --output ~/Music/decoded

# fb watch 同样支持多个文件夹,会同时盯着它们:
fb watch ~/Music/netease-cache ~/Downloads/netease --output ~/Music/decoded

转换好的音乐就在 ~/Music/decoded 里,用你喜欢的播放器打开就行,就这么简单! 🎉

💡 在线缓存文件夹在哪?

  • macOS~/Library/Containers/com.netease.163music/Data/Caches/online_play_cache
  • WindowsC:\Users\<你>\AppData\Local\Netease\CloudMusic\Cache\Cache

🪟 想让它开机自动运行?(Windows)

把 FreeBird 装成 Windows 后台服务,开机自启、有新文件自动转换,完全不用管。服务模式通过一个 JSON 配置文件来设置输入/输出目录:

# 以管理员身份打开 PowerShell:

# 1. 生成默认配置文件(默认写到 %ProgramData%\FreeBird\config.json)
fb service init

# 2. 用记事本打开生成的 config.json,填好你的输入文件夹和输出文件夹后保存

# 3. 安装并启动服务(不带 --config 时默认读上面那个路径)
fb service install
fb service start

# 查看运行状态 / 停止:
fb service status
fb service stop

⚙️ 几个常用选项

# 指定完整性校验级别(auto 会在 Windows 上自动准备 flac 工具):
fb scan <你的文件夹> --output ~/Music/decoded --integrity auto

# 不想写入元数据标签(同时也会跳过 .ncm 的专辑封面):
fb scan <你的文件夹> --output ~/Music/decoded --no-write-tags

💡 想看全部命令和选项,运行 fb --helpfb scan --helpfb watch --help

✨ 亮点功能

  • 🎵 同时支持试听缓存与下载文件.uc / .uc! 在线缓存和 .ncm 下载文件都能转,按扩展名自动识别
  • 🖼️ .ncm 完全离线 + 自动封面:下载文件自带歌名/歌手/专辑/封面,无需联网即可解码并写入专辑封面
  • 🪟 Windows 后台服务模式:开机自动运行,有新文件自动转换,完全不用管
  • 🔄 更聪明的元数据获取.uc 在网络不好或被限流时会自动重试,等网络恢复就补上正确的歌名
  • 🔧 Windows 上 FLAC 校验开箱即用:需要时自动下载 flac 工具,无需手动安装

📦 开源地址

完全开源,欢迎 Star / Issue / PR!

💡 缘起

  • 云音乐的播放器不支持源码输出到我的音频解码器 DAC,我的初衷就是用 Foobar2000 直接播放 FLAC 然后无损输出到解码器达到 HIFI 的目的。又可以通过 USB 拷贝音频文件到车上播放,从而脱离云播放器。希望你喜欢。:)

让你的音乐自由飞翔吧 🕊️

image.png

免费评分

参与人数 14吾爱币 +18 热心值 +13 收起 理由
pdc9911 + 1 + 1 谢谢@Thanks!
YQYKL + 1 我很赞同!
白逸轩 + 1 + 1 用心讨论,共获提升!
funlink + 1 + 1 谢谢@Thanks!
dfvips + 1 + 1 谢谢@Thanks!
catoo1 + 1 谢谢@Thanks!
cxt + 1 + 1 谢谢@Thanks!
17yl + 1 + 1 感谢发布原创作品,吾爱破解论坛因你更精彩!
piziniude + 1 + 1 希望这个软件能存活的时间久一点
一萬只草泥马 + 1 + 1 我很赞同!
confiant + 1 感谢发布原创作品,吾爱破解论坛因你更精彩!
a85401234 + 1 + 1 谢谢@Thanks!
Lushness6726 + 1 + 1 谢谢@Thanks!
风之暇想 + 7 + 1 感谢发布原创作品,吾爱破解论坛因你更精彩!

查看全部评分

发帖前要善用论坛搜索功能,那里可能会有你要找的答案或者已经有人发布过相同内容了,请勿重复发帖。

 楼主| wjshome 发表于 2026-7-12 18:38
renyishujia 发表于 2026-7-12 15:50
怎么修改命名规则为歌名-歌手

--naming-template(命名模板)

控制成功解码后输出文件名的格式

  • 适用命令: fb scanfb watch
  • 默认值: {artist} - {title} → 例如 周杰伦 - 稻香.flac
  • 扩展名.mp3 / .flac / .m4a)会自动追加。

占位符(Tokens)

占位符 含义 缺失时回退值
{artist} 艺术家;多位用 & 连接 unknown-artist
{title} 歌曲标题 unknown-title
{album} 专辑名 unknown-album
{musicId} 从文件名解析出的网易云音乐 ID 解析失败则为 0

无法识别的占位符(如 {genre})会原样保留在文件名中。

示例


fb scan ./in -o ./out --naming-template "{title}"
# → 稻香.flac

fb scan ./in -o ./out --naming-template "{artist} - {title} [{musicId}]"
# → 周杰伦 - 稻香 [186016].flac

免费评分

参与人数 1吾爱币 +1 热心值 +1 收起 理由
renyishujia + 1 + 1 谢谢@Thanks!

查看全部评分

 楼主| wjshome 发表于 2026-6-21 15:10
本帖最后由 wjshome 于 2026-6-30 23:09 编辑

v3.6.1 更新内容(watch 日志降噪 + 默认轮询调整)

  • 🤫 fb watch 不再刷屏「Previous cycle still running」 —— 这条「上个周期还在跑」的提示本来是设计成「提醒一次就安静」的,但之前计数器在每个周期结束时都会清零,导致在持续繁忙(一首接一首地解码大文件)时几乎每次轮询都重新冒一条警告。现在这条提示在整段繁忙期只出现一次,等真正处理完积压、闲下来之后,下次再堵才会重新提醒。
  • ⏱️ 默认轮询间隔 5秒30秒 —— 对于大文件库(尤其是 .ncm / FLAC 配合 L3 完整性校验),单个文件解码远超 5 秒,5 秒的默认轮询太频繁、只会一直撞上「上个周期还在跑」。30 秒是更合理的默认值;需要的话仍可用 --poll-interval 自行调整。

v3.6.0 更新内容(新增 .ncm 下载文件支持)

  • 🎵 现在能转换「下载」的歌曲了(.ncm 文件) —— 以前 FreeBird 只能处理在线试听时产生的 .uc / .uc! 缓存文件;现在你下载歌曲生成的 .ncm 文件也能直接转换了。fb scanfb watch 会自动识别这两种文件,命令不变、无需加任何参数。
  • 📡 .ncm 完全离线解码,不联网 —— 和缓存文件不同,.ncm 文件本身就内嵌了歌名、歌手、专辑和封面,所以转换时不会请求网易云接口,没网也能转,又快又稳。
    • 🏷️ 自动命名 + 标签:直接读取文件内嵌的歌名/歌手/专辑,输出命名为 歌手 - 歌名.flac(多位歌手用 & 连接);万一文件里没有这些信息,则回退使用原文件名。
    • 🖼️ 自动写入专辑封面.ncm 里自带的封面会一并写进输出文件(FLAC 用 metaflac 写入并保留 PCM-MD5,MP3/M4A 用 TagLibSharp)。加上 --no-write-tags 可同时关闭标签和封面。
    • 🛡️ .uc 一样安全可靠:原子写入、完整性校验(off / l1 / l3 / auto)、损坏文件自动隔离并附带说明文件;fb watch 借助转换记录确保每个 .ncm 只转一次、之后自动跳过。全程绝不修改你的原始文件。

历史版本回顾

🟢 v3.x 系列 —— 从「能用」到「省心」

这一系列是 FreeBird 的成熟阶段,重点是元数据、标签、稳定性和后台运行

  • 智能命名与标签:输出文件不再是冷冰冰的 歌曲ID.flac,而是自动从网易云抓取信息,命名为 歌手 - 歌名.flac,并写入标题/歌手/专辑标签。可用 --offline 保留旧的纯 ID 命名。
  • 多文件夹支持fb scanfb watch 都支持一次传入多个输入文件夹,全部转到同一个输出目录。
  • 更聪明的元数据获取:网络不好或被网易云限流时会自动按指数退避重试,等网络恢复后补上正确歌名;并能正确区分「限流」和「真的查无此歌」,避免误判。
  • 可靠性修复:重启 / 开机后不再对所有已转换文件重复请求接口(杜绝「API 风暴」与一屏报错);离线临时命名的 歌曲ID.flac 在补全为正式文件后会被自动清理。
  • Windows 后台服务模式fb service 命令族,可把 FreeBird 注册成开机自启的 Windows 服务,配合 JSON 配置文件、Windows 事件日志和每日滚动日志,听完歌自动转换、完全不用管。
  • Windows FLAC 校验开箱即用:需要时自动从官方源下载 flac 工具,无需手动安装。
  • 开源协议改为 MIT,README 面向普通用户重写。

🔵 v2.0 —— 持续监听模式

  • 新增 fb watch 子命令:持续盯着缓存目录,有新文件就自动转换。
  • 用文件系统中的「旁车记录」标记永久失败的文件,避免反复重试。

⚪ v1.0 —— 初版

  • 一次性批量解码 .uc / .uc! 文件(XOR 0xA3)。
  • 按魔术字节识别格式(MP3 / FLAC / M4A)。
  • 四级音频完整性校验(auto / l1 / l3 / off)。
  • 通过「暂存 + 重命名」实现原子写入。
  • 失败文件自动隔离,并附带 .txt 说明文件。

让你的音乐自由飞翔吧 🕊️

xlcxyn 发表于 2026-6-22 11:38
a85401234 发表于 2026-6-22 19:24
感谢楼主分享。真不错
cxt 发表于 2026-6-22 20:51
本帖最后由 cxt 于 2026-6-22 20:52 编辑

不能使用

PS C:\WINDOWS\system32> fb watch D:\Program Files (x86)\CloudMusic\NetEase\CloudMusic\Cache\Cache --output ~/Music/decoded
x86 : 无法将“x86”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称的拼写,如果包括路径,请确保路径正确,
然后再试一次。
所在位置 行:1 字符: 28
+ fb watch D:\Program Files (x86)\CloudMusic\NetEase\CloudMusic\Cache\C ...
+                            ~~~
    + CategoryInfo          : ObjectNotFound: (x86:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException
zhu791023529 发表于 2026-6-23 10:05
cxt 发表于 2026-6-22 20:51
不能使用

PS C:\WINDOWS\system32> fb watch D:\Program Files (x86)\CloudMusic\NetEase\CloudMusic\Ca ...

一样,好像是环境的问题,让UP来解决下
 楼主| wjshome 发表于 2026-6-23 11:20
本帖最后由 wjshome 于 2026-6-23 11:21 编辑
cxt 发表于 2026-6-22 20:51
不能使用

PS C:\WINDOWS\system32> fb watch D:\Program Files (x86)\CloudMusic\NetEase\CloudMusic\Ca ...

你的路径需要用引号包括起来。
C:\windows\system32不是fb的软件目录吧。
假设你下载了解压到c:\fb,那么你先要

cd c:\fb

然后运行,用引号填入你的路径,因为路径中包含空格,你可以在网易云中改变缓存的路径。

PS C:\fb> fb watch "D:\Program Files (x86)\CloudMusic\NetEase\CloudMusic\Ca......" --output "c:\Songs"

这样他会输出到 c:\Songs 目录.

wodeai5244 发表于 2026-6-23 11:43
喜玛拉雅的缓存可以吗?
xol2008 发表于 2026-6-23 15:22
又有了可以白嫖的神器,适合屌丝群体
hack81 发表于 2026-6-24 00:42
这不是下载歌曲的神器吗!
您需要登录后才可以回帖 登录 | 注册[Register]

本版积分规则

返回列表

RSS订阅|小黑屋|处罚记录|联系我们|吾爱破解 - 52pojie.cn ( 京ICP备16042023号 | 京公网安备 11010502030087号 )

GMT+8, 2026-7-22 10:01

Powered by Discuz!

Copyright © 2001-2020, Tencent Cloud.

快速回复 返回顶部 返回列表