TidalDL-Web-Downloader & Player

Tidal-Web-Downloader 是一个基于 Python ( FastAPI ) 后端和原生 JavaScript 前端的 Web 应用程序。它允许用户搜索 Tidal 、在线播放以及下载无损音乐。

⚠️ 免责声明 / Disclaimer 本项目仅供学习和技术研究使用。请支持正版音乐，下载的内容请在 24 小时内删除。严禁将本项目用于任何商业用途。 This project is for educational and technical research purposes only. Please support official music services.

✨ 功能特性

• 文件下载：支持专辑或单曲下载（ Hi-Res / Atmos 需对应的 Token 支持 ）。
• 元数据写入：写入封面、歌手、专辑、歌词、ISRC 等 ID3 标签。
• Web 播放器：内置 HTML5 播放器，支持在线播放音/视频。
• 灵活搜索：支持按专辑、单曲、视频、歌手、搜索。
• 跨平台：基于 Web，支持通过浏览器（需支持 File System Access API，如：Chrome / Edge ）直接保存文件到本地。
• 本地缓存：支持断点续传和磁盘缓存。

🛠️ 目录结构

在使用前，请确保你的文件目录结构如下：

TidalDL-Web-Downloader/
├── main.py              # 后端入口文件
├── login.py             # 登录 Tidal 获取 Token 脚本
├── token.json           # (运行 login.py 授权后自动生成)
├── requirements.txt     # 依赖列表
└── static/              # 前端静态资源文件夹
    ├── index.html
    ├── css/
    │   └── style.css
    └── js/
        ├── app.js
        ├── modules/
        │   ├── api.js
        │   ├── dom.js
        │   ├── downloader.js
        │   ├── ffmpeg.js
        │   ├── player.js
        │   ├── settings.js
        │   ├── ui.js
        │   └── utils.js

🚀 安装依赖

pip3 install -r requirements.txt --break-system-packages

🔑 登录 Tidal 授权并获取 Token

• 可自行设置后台运行自动刷新 Token

python3 login.py

▶️ 运行项目

• 默认端口 8050

python3 main.py

📜 许可证 (License)

本项目采用 CC BY-NC 4.0 许可证。 您可以自由地：分享、修改、学习。 严禁用于商业用途。详情请见 LICENSE 文件。