wayper — 为 Hyprland/Wayland 打造的壁纸管理器

[God4sh]

做了个壁纸管理器，解决自己日常换壁纸的痛点，分享给大家。

核心功能：

• Wallhaven 集成 — 配置搜索偏好后自动下载，不用手动找图
• 自动匹配方向 — 竖屏显示器自动用竖屏壁纸，横屏用横屏
• 收藏与黑名单 — 喜欢/拉黑带撤销，收藏继续参与轮换
• 智能标签建议 — 分析拉黑历史，自动发现你反复拉黑的标签，一键排除。已排除的标签会自动抑制相关建议
• 跨平台 GUI — Electron 界面，全键盘操作，浏览/预览/管理壁纸集合
• AI 原生 — 内置 MCP 服务器，Claude Code 等 AI 助手可以直接控制壁纸
• JSON 输出 — 所有命令支持 --json，方便脚本集成

安装：

# Arch Linux (AUR)
paru -S wayper

# 从源码
git clone https://github.com/yuukidach/wayper.git
cd wayper && uv venv && uv pip install -e .

依赖：Python 3.12+、awww 、Hyprland （ Linux ）； macOS 也支持。

GitHub: https://github.com/yuukidach/wayper 主页: https://yuukidach.github.io/wayper/

欢迎试用，Issue 和 PR 都欢迎！