喜马拉雅音频下载器

自动下载喜马拉雅专辑最新音频，支持语音转文字。

快速开始

pip install requests

用法

# 下载专辑最新 3 条音频（已下载的自动跳过）
python main.py download https://www.ximalaya.com/album/ALBUM_ID

# 下载单曲
python main.py download https://www.ximalaya.com/sound/SOUND_ID

# 下载并转文字
python main.py download https://www.ximalaya.com/album/ALBUM_ID -c

# 查看最新音频
python main.py query https://www.ximalaya.com/album/ALBUM_ID

# 自动模式（读 config.json 中的专辑，定时任务用这个）
python main.py auto

# 指定下载数量
python main.py download https://www.ximalaya.com/album/ALBUM_ID -n 5

# 音频转文字
python main.py convert ./ximalaya_audio/xxx.m4a

配置

复制示例配置并编辑：

cp config.example.json config.json

{
  "album_url": "https://www.ximalaya.com/album/你的专辑ID",
  "asr_server_url": "http://your-asr-server:8888",
  "download_dir": "./ximalaya_audio",
  "max_retries": 3,
  "download_timeout": 30
}

定时任务（Windows）

任务计划程序 -> 创建基本任务 -> 操作：powershell.exe 参数：-File "D:\workspace\python\ximalaya_downloader\run_daily.ps1"

项目结构

ximalaya_downloader/
├── main.py                  # 主入口
├── config.json              # 运行时配置
├── run_daily.ps1            # 定时任务脚本
├── src/
│   ├── api_client.py        # API 客户端
│   ├── downloader.py        # 下载器
│   └── speech_to_text.py    # 语音转文字
├── config/settings.py       # 配置管理
├── utils/
│   ├── helpers.py           # 辅助函数
│   └── log_manager.py       # 下载日志
├── tests/                   # 测试用例
└── ximalaya_audio/          # 下载输出目录

免责声明

本工具仅供个人学习与研究使用。使用者应自行确保其行为符合喜马拉雅平台的服务条款及适用法律法规。

• 本工具不存储、不传播、不售卖任何音频内容
• 下载的音频文件仅供离线个人收听，禁止二次分发
• 作者不对使用本工具产生的任何法律后果承担责任
• 如喜马拉雅平台提出异议，本项目将立即下架

License

MIT