Note: 虾米音乐已经关闭,目前此项目已无法使用, 但代码框架良好,可用于实现网易云音乐等其他平台的导出工具。
导出虾米音乐的个人数据,功能:
Clone 项目,创建 Python 3 虚拟环境,安装所有依赖
$ python -m venv venv
$ source venv/bin/activate
$ pip install -r requirements.txt
在 Chrome 中登录虾米,点击 “我的音乐”,从 URL 中获取 user_id,例如 https://www.xiami.com/user/932367
, user_id 即为 932367
.
运行 python -m xiami_exporter.cli init
,根据提示,输入配置项,其中包括刚刚获取的 user_id.
回到 Chrome “我的音乐” 页面,右键选择 “审查页面” (Inspect),点击 “网络” (Network) 并在过滤器中选择 XHR,刷新页面,在最后一条带有 _s
的网络请求上点击右键,选择 “Copy - Copy as Node.js fetch”
在项目目录下创建 fetch.py 文件,将刚才拷贝的内容粘贴进去并保存 (pbpaste > fetch.py
)
运行 python -m xiami_exporter.cli check
, 显示成功表示可以使用导出功能,否则请重试上一步,或联系开发者
根据想要导出的数据,运行相应指令,如 python -m xiami_exporter.cli export-songs
即导出收藏歌曲为 json
运行方式为 python -m xiami_exporter.cli COMMAND
, 可通过 python -m xiami_exporter.cli --help
查看指令列表。
init
初始化配置文件
check
检查 fetch.py
是否可以通过虾米 API 的验证,成功时输出如下:
test fetch() ok
recal token correct: be5bb12dbb135066f4cb282706019bc8
Success, you can now use the export commands
export <fav_type>
Previously
export-songs
导出数据为 json 文件,需要指定子命令 fav_type:
json 文件每页一个,文件名为 <fav_type>-<page_number>.json
,存放于 XiamiExports/json/<fav_type>
目录下。
对于专辑和歌单 (ALBUMS, PLAYLISTS, MY_PLAYLISTS),在完成首次导出后,需要额外使用 -c, --complete-songs
参数运行,
来获取包含歌曲的详细信息,每个专辑/歌单的详细信息 json 文件会以 <id>.json
为名存放于 XiamiExports/json/<fav_type>/details
目录下。
此指令是后续创建数据库、下载音乐的基础。
create-songs-db
将收藏歌曲导入数据库中记录,此指令是 download-music
的基础。
download-music
下载所有收藏歌曲,下载状态 (download_status) 会同步保存到数据库中。
中断后可重新运行,只会从数据库中筛选 download_status = NOT_SET 的歌曲进行下载。
注: 此指令后续会支持下载 album 和 playlist
download-covers
下载所有歌曲的专辑封面 (album cover),支持如下选项:
-f, --force
: 强制重新下载即使文件存在-l, --artist-logos
: 下载艺人图片而非专辑封面tag-music
为所有已下载的歌曲添加 ID3 tags。
若专辑封面文件存在,则会将其添加到 tags 中,因此建议先运行 download-covers
。
trim-json
对已导出的 json 文件进行修剪,去掉不必要的数据。
此命令用于维护已导出的 json 数据,若使用最新版重新导出, 则导出时已对各类数据进行自动修剪,无需之后运行此命令。
Xiami Exporter 保存的数据有如下几类:
默认在项目路径下创建 XiamiExports
目录,其文件系统结构大体如下:
XiamiExports/
db.sqlite3
json/
songs/
song-1.json
song-2.json
...
albums/
details/
ALBUM_ID.json
albums-1.json
...
playlists/
details/
PLAYLIST_ID.json
playlists-1.json
...
my_playlists/
| same as `playlists/`
artists/
music/
NUM-SONG_ID.mp3
covers/
ALBUM_ID.jpg
artist_logos/
ARTIST_ID.jpg
Development notes, check if you have interests.