批量下载wallhaven壁纸

此软件实现了：批量下载wallhaven壁纸，支持搜索结果下载，支持指定页面下载，支持按条件筛选后下载，多线程下载，速度很快

推荐另一个项目，无需安装软件，在浏览器页面实现每张图片的快速下载：https://github.com/lthero-big/WallHaven-One-Click-Download

功能

• 支持按搜索结果或标签下载：需要您提前在wallhaven页面搜索或选择标签，并复制搜索结果的链接到程序里面，并点击“开始从此页面下载”
• 支持按条件筛选下载：无需在浏览器操作，只要在程序下半部分，选择好条件，再点击“开始按条件下载”

特点

• 多线程下载，速度较快

使用说明

先选择文件夹 ！

使用 uv 运行

uv sync
uv run python index-withUI.py

UI 中可点击“桌面Wallhaven”按钮，自动将下载目录设置为桌面上的 Wallhaven 文件夹。 UI 默认只启用 General 和 SFW，更适合日常浏览场景。 UI 默认并发数为 4，如果遇到失败较多可以调低，想加快下载可以适当调高。 如果仍有图片下载失败，失败详情会写入下载目录中的 download_failures.txt。

无界面版本暂时保留为下载逻辑测试入口：

uv run python index-withoutUI.py

也可以使用新的命令行入口：

uv run python -m wallhaven_downloader --url https://wallhaven.cc/hot -o downloads --pages 3
uv run python -m wallhaven_downloader -o downloads --sorting toplist --top-range 1M --pages 3

运行核心逻辑测试：

uv run python -m unittest discover -s tests

构建 Windows GUI 版本：

uv run pyinstaller --noconfirm --windowed --onefile --name Wallhaven-Downloader index-withUI.py

构建完成后双击运行：

dist\Wallhaven-Downloader.exe

如需访问需要登录状态的 Wallhaven 内容，可通过环境变量提供 Cookie：

$env:WALLHAVEN_COOKIE="your-cookie"

• 可以复制一个网址，从指定网址（可以是搜索结果页面，或标签页面）下载几页的内容

如复制网址：https://wallhaven.cc/hot 并选择下载3页 ，点“开始从此页面下载”即可

• 可以不复制网址，选择好要下载的内容，点“开始按条件”即可

版本说明

• 程序分为有界面、无界面、上传到阿里云 三个版本

有界面

• 有界面的版本使用PYQT实现，名称为 index-withUI.py
• 无需安装环境，win10、win11下可用
• 打包程序可直接运行：蓝奏:https://wwa.lanzoui.com/b00uisw1a 密码:e5f2

无界面

• 无界面的版本纯python代码，名称为 index-withoutUI.py
• 需要运行代码后，输入命令再下载

上传版本

• 上传到阿里云版本，名称为 upload version
• 功能：直接将壁纸下载到阿里云的OSS中，满足一些特定场景下需求
• 需要通过环境变量配置阿里云 OSS：

$env:ALIYUN_ACCESS_KEY_ID="your-access-key-id"
$env:ALIYUN_ACCESS_KEY_SECRET="your-access-key-secret"
$env:ALIYUN_OSS_BUCKET="your-bucket"
$env:ALIYUN_OSS_ENDPOINT="http://oss-cn-beijing.aliyuncs.com"