#api-key #wallpaper #api-access #api #image #search-query #api-bindings

app wallhaven

完整的 WallHaven API 命令行客户端,支持壁纸下载

2 个不稳定版本

0.2.0 2024 年 4 月 19 日
0.1.0 2022 年 8 月 25 日

#2321 in 命令行工具

MIT 许可证

33KB
692 代码行

github crates

WallHaven API 命令行客户端,用于获取原始/json 响应和下载壁纸,根据偏好进行下载,支持使用 API 密钥使用账户偏好和访问 NSFW 壁纸。

用法

通过查询和额外参数搜索壁纸

wallhaven search --query "+cat +funny" -s VIEWS -c 110 --atleast 1920x1080 --path ~/wallpapers/

通过查询和额外参数搜索壁纸并保存壁纸

wallhaven search --query "anime +funny" -s VIEWS --atleast 1920x1080 --path ~/wallpapers/

按颜色搜索壁纸

wallhaven search --colors 722f37 

搜索随机壁纸

wallhaven search --query "" -s RANDOM

使用种子搜索随机壁纸

wallhaven search --query "" -s RANDOM --seed YmdCUP

使用 API 密钥搜索

# One time api access with api key
WALLHAVEN_API_KEY="your_api_key" wallhaven search --query "anime +cats" --purity 111 -s TOPLIST --path ~/wallpapers/
# Or
# Use api key always
export WALLHAVEN_API_KEY="your_api_key"
wallhaven search --query "anime +cats" --path ~/wallpapers/

通过 ID 获取壁纸信息

wallhaven wallpaper-info 856dlk

通过 ID 获取标签信息

wallhaven tag-info 15

获取用户设置 需要 API 密钥

wallhaven user-settings

获取用户设置

# Get your own collections ** requieres API key **
wallhaven user-collections

# Get user public collections
wallhaven user-collections --username "some_username"

安装

Cargo

您可以直接安装二进制包

cargo install wallhaven 

手动安装

您可以将 wallhaven 仓库克隆并本地构建

git clone https://github.com/dax99993/wallhaven
cd wallhaven 
cargo install --path .

功能

  • API 密钥支持
  • 异步
  • 下载壁纸
  • 下载进度条

注意

许可证

MIT

依赖

~10–23MB
~339K SLoC