Skip to content
Go to file


Failed to load latest commit information.
Latest commit message
Commit time

⚠️ This tool no longer works since Xiami changed their web player API. This tool utilizes the old API, which may cause your IP to be banned for some time. To be updated.

⚠️ 由于虾米修改了播放器接口,此工具目前已失效。使用此工具访问原接口可能造成 IP 被暂时屏蔽。待更新。

Xiami Music Preview Downloader

MIT license made-with-python

A simple tool for downloading music previews from

Note: this script uses Python 2. Python 3 support is still in progress.


  • Optionally depends on mutagen module for ID3 tag support.


python -m xiami_downloader.cli [options]

# or, install via pip (Currently not on PyPI, so you have to download this first)
pip install .    # Install
xiami [options]  # Run


  • -a <album id> Adds all songs in an album to download list.
  • -p <playlist id> Adds all songs in a playlist to download list.
  • -s <song id> Adds a single song to download list.
  • -f Force mode: overwrite existing files without prompting.
  • -t urllib2|wget Change the download tool.
  • -h Displays usage.
  • --no-tag Do not add ID3 tags to the downloaded files.
  • --directory Specifies the download directory.
  • --name-template Path for the filename template file.
  • --no-lrc-timetag Do not add the timetag in lyrics.
  • -un <email> Vip account email.
  • -pw <password> Vip account password.

<song id>, <playlist id> and <album id> can be retrived from URLs of Xiami.

For downloading on Windows, this script will use the built-in urllib2-library. On all other OSes, it will use wget.

The default template for the filename is set to {id} - {title} - {artist}. The arguments are:

  • {id} ID
  • {title} Title of the track
  • {artist} Artist of the track

If you have a Vip account, the script will download tracks in 320K. Remember to set the -un and -pw arguments accordingly. Note that Xiami has a limits the downloads. If you are downloading lots of tracks, make sure to pause between downloads.


To download the album Mahōtsukai no Yoru OST, first checkout the album's ID from the url. The url you're visiting may be in one of the two forms:

Numeric ID can be used directly, to download the album:

python -m xiami_downloader.cli -a 511682

If the ID is alphanumeric, click the "立即播放" button in the page and a new player window will pop up. The corresponding numeric ID should be in the url of that window:


This software is distributed under the MIT License.


MIT license made-with-python


注:这是一个 Python 2 脚本。Python 3 支持工作仍在进行。


  • 可选择依赖于 mutagen 模块,由其提供 ID3 支持。


python -m xiami_downloader.cli [options]

# 或者,使用 pip 安装(尚未提交 PyPI,所以需要先手动下载源码)
pip install .    # 安装
xiami [options]  # 运行


  • -a <专辑ID> 下载该专辑中的所有歌曲。
  • -p <精选集ID> 下载该精选集中的所有歌曲。
  • -s <歌曲ID> 下载该歌曲。
  • -f 强制模式:不经确认直接覆盖重名文件。
  • -t urllib2|wget 修改下载工具。
  • -h 显示用法。
  • --no-tag 不添加 ID3 Tag。
  • --directory 将下载到的文件放入该文件夹中。
  • --name-template 文件名模版。
  • --no-lrc-timetag 去除歌词中的时间标签。
  • -un <email> Vip账号。
  • -pw <password> Vip账号密码。

<歌曲ID><精选集ID><专辑ID> 都可以从对应虾米页面的 URL 中找出。

默认下载工具在 Windows 上是内置的 urllib2,其它平台则是 wget。

文件名模版默认值为 {id} - {title} - {artist},可选参数如下:

  • {id} 编号
  • {title} 该音轨的标题
  • {artist} 该音轨的作者

如果有VIP账号,可以下载高品质320K的歌曲 虾米有高音质音乐下载限制,所以不要短时间内下一大堆歌


例如要下载专辑《魔法使いの夜 オリジナルサウンドトラック》,首先检查 URL 中的专辑 ID。你可能会看到两种形式的 URL:

数字 ID 可以直接使用,下载该专辑只需执行:

python -m xiami_downloader.cli -a 511682

如果 ID 包含字母,那么需要先点击页面中的「立即播放」按钮打开新的播放器窗口。对应的数字 ID 可以在该窗口的 URL 中找到:


Xiami Music Preview Downloader 使用 MIT License 发布。


A simple tool for downloading music previews from Xiami.




No packages published


You can’t perform that action at this time.