DeviantArt Downloader
语言 / Language: 中文 · English
一个可靠、聚焦的 DeviantArt 下载 / 归档命令行工具。
快速开始
需要 Python 3.10 或更高版本。
python -m pip install -U devart-dl
# 单张作品（也支持 fav.me 短链、裸 artwork id）
devart-dl https://www.deviantart.com/username/art/title-123456
# 画廊 / 作者全集
devart-dl https://www.deviantart.com/username/gallery
# 收藏夹 / 标签
devart-dl https://www.deviantart.com/username/favourites
devart-dl https://www.deviantart.com/tag/landscape
# 解析为 JSON 描述（不下载文件）
devart-dl resolve https://www.deviantart.com/username/art/title-123456
首次下载前建议使用 OAuth 登录：
devart-dl login oauth --client-id 你的_PUBLIC_CLIENT_ID
devart-dl whoami
不会注册 OAuth 应用也可以使用 Cookie。最简单的是一键浏览器登录（本机装 Chrome + Node ≥ 22）：
devart-dl login browser # 打开你的 Chrome 登录，自动保存 Cookie，无需 F12 复制
下载或 resolve 遇到 401/403 时，工具会用同一代理与浏览器 UA 核对网页会话， 区分会话已过期、证据暂不可用和已登录但作品访问被拒。网络失败或页面结构变化 不会当作登出，也不会清除 Cookie；只有明确的未登录证据才提示刷新登录。 这一步只诊断错误，不自动重试下载，也不保证已登录账号有权访问所有作品。
完整图文式步骤见 登录与认证教程。
普通用户无需手动下载 GitHub Release 里的
.whl、.tar.gz或 Source code，运行上面的pip install即可。文件区别和 SHA256 校验方法见完整文档。
功能
- 官方 API（OAuth）优先：登录一次即可下载原图，无需导出 Cookie，也无需防封延时。
- URL 优先：直接粘贴作品 / 画廊 / 收藏夹 / 标签链接即可下载。
- 文本作品：文学 / 日志型 deviation 在响应内直接提取正文，保存为 UTF-8
.txt；媒体与文本自动分流。 - 下载可靠：HTTP Range 断点续传、自动重试、429 退避、原子落盘。
- 下载档案：
--archive用 SQLite 记住已下载，跨会话自动跳过。 - 路径模板 + 元数据 sidecar：
--directory/--filename模板与--write-info-json。 - 代理与降级：支持
--proxy；未登录 OAuth 时自动回退 Cookie。 - Resolve 模式：
devart-dl resolve URL输出ResolvedDeviation/MediaAsset的 JSON 契约，不写文件。 - 付费/订阅锁定识别：官方 API 返回
premium_folder_data/tier_access，或网页端非成熟作品的模糊主图（blur_），都会识别为「需要订阅/购买」：网页通道跳过，官方通道明确报错，不再把打码图当原图保存。
文档
| 你想做什么 | 文档 |
|---|---|
| 下载安装包 | 下载页 |
| 登录与认证 | 登录与认证 |
| 命令、配置与 Python 调用 | 文档站 |
致谢
- requests：HTTP 客户端。
- 登录与归档目录的实现与 gallery-dl 交叉核对过。
许可证与免责声明
本项目基于 MIT License 开源。
注意：本工具仅供个人学习和研究使用。使用者应遵守 DeviantArt 服务条款及版权规定，请勿用于商业用途或大规模抓取导致服务器过载。作者不对任何滥用后果负责。
2 maintainers
Metadata
2 maintainers
Release files for devart-dl 4.4.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| devart_dl-4.4.2.tar.gz | 66.1 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| devart_dl-4.4.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 117.9 kB
Release files / devart_dl-4.4.2.tar.gz
| Download URL | devart_dl-4.4.2.tar.gz |
|---|---|
| Size | 66.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
800ae6382e804b3e59dde88e6ab2c534fd7561aa1df0a34c34eeaf62b28d8aca
|
|
BLAKE2b-256 checksum How to use checksums |
91a278284e8d8374253728b09a77ed0a7319dcfb319c56928466d2e8afc992f2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logRelease files / devart_dl-4.4.2-py3-none-any.whl
| Download URL | devart_dl-4.4.2-py3-none-any.whl |
|---|---|
| Size | 51.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
47cc6eaf763e309573c23a1d2a3910b355551e739f0db25c8965165d36f6694b
|
|
BLAKE2b-256 checksum How to use checksums |
da2c0a952a48d74ebcb6200522609c36a91d96b7aab7006d1905e3cddf800ae6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logSecurity for devart-dl 4.4.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for devart_dl-4.4.2.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 13, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
