ASMR.one 下载器

从 ASMR.one 下载音频作品，自动压缩，支持收藏管理。

完整工作流

配置环境 → 验证环境 → 搜索/推荐 → 下载压缩 → 收藏记录
无网络时 → 导入本地音频 → 压缩 → 收藏

快速安装

# 1. 安装依赖
pip3 install requests

# 2. 安装 ffmpeg（用于压缩）
# Ubuntu/Debian:
sudo apt install ffmpeg
# macOS:
brew install ffmpeg

# 3. 配置初始化
python3 asmr_tool.py config init

环境验证

python3 asmr_tool.py check

输出示例：

  [Python]    ✅ 3.12.3
  [requests]  ✅ 2.31.0
  [ffmpeg]    ✅ ffmpeg version 6.1.1
  [ffprobe]   ✅ ffprobe version 6.1.1
  [网络]
   外网: ✅
   ASMR.one: ✅
  [配置]      ✅ 配置文件已存在

网络检查会同时检测外网连通性和 ASMR.one 服务状态。外网不通时，搜索下载功能不可用，但可以通过 import 命令使用本地文件。

常用命令

配置项说明

配置优先级： CLI 参数 > 环境变量 > 配置文件 > 默认值

示例

# 初始化配置
python3 asmr_tool.py config init

# 验证环境
python3 asmr_tool.py check

# 搜索作品
python3 asmr_tool.py search "陽向葵ゅか"

# 查看作品详情
python3 asmr_tool.py info RJ01377478

# 下载，语音模式（默认，压缩至 QQ 兼容格式）
python3 asmr_tool.py download RJ01377478

# 下载，文件模式（不压缩，保持原始质量）
python3 asmr_tool.py download RJ01377478 --mode file

# 指定代理（覆盖配置文件）
python3 asmr_tool.py search "关键词" --proxy http://127.0.0.1:7890

# 从本地目录导入音频（无需网络）
python3 asmr_tool.py import RJ01230165 /path/to/audio/files --title "作品标题" --cv "CV名"

下载选项

自动降码率（voice 模式）： 超过 20MB 的文件会自动降码率到 64k。 file 模式： 跳过所有压缩和降码率，直接保存原始文件。

本地导入（无网络场景）

当无法访问外网或 ASMR.one 时，可以将本地已有的音频文件导入管理：

python3 asmr_tool.py import RJ01230165 ./my_audio_folder --title "作品名" --cv "CV名"

导入功能：

• 自动复制音频文件到输出目录
• 超过 20MB 的非 MP3 文件自动压缩
• 生成封面文件并记录到收藏
• 不需要网络连接

搜索限制

• API 搜索仅覆盖最新作品（约 600 个以内）
• 老作品或小众作品请用已知 RJ 编号直接查 info RJxxxx
• 也可以通过浏览器在 ASMR.one 网站上搜索

安全说明

配置文件权限默认设为 600（仅本用户可读），不要分享配置文件。

收藏功能

下载或导入完成后自动记录。配置文件存储在 ~/.config/asmr-tool/collection.json。

python3 asmr_tool.py collection          # 列表
python3 asmr_tool.py collection --detail # 详细信息

目录结构

~/.config/asmr-tool/          # 配置文件目录
├── config.json               # 代理、输出目录等配置（权限 600）
└── collection.json           # 收藏记录

~/asmr_downloads/             # 默认下载目录
└── RJxxxxxx/
    ├── RJxxxxxx_001_音轨.mp3
    ├── RJxxxxxx_002_音轨.mp3
    ├── raw/                   # 原始文件（压缩后保留）
    └── manifest.json         # 下载清单

文件说明