Dynamic Wallpaper壁纸不更换6类常见问题排查与配置完整指南【免费下载链接】dynamic-wallpaperA simple bash script to set wallpapers according to current time, using cron job scheduler.项目地址: https://gitcode.com/gh_mirrors/dy/dynamic-wallpaper深夜十一点你拖着疲惫的身体回到家点亮屏幕桌面上还是早上出门前那片清晨的海滩——说好按时辰换壁纸的 Dynamic Wallpaper 一整天纹丝不动。你打开终端敲一句dwall -s beach壁纸立刻乖乖切换可第二天早上再看它又睡着了。这种手动灵、自动瘫的情况几乎每个刚接触 Dynamic Wallpaper 的新手都遇到过。作为一款通过 cron 定时任务按当前小时自动设置壁纸的 bash 脚本工具dwall 本身的逻辑非常简单读当前小时数去对应风格的目录里挑一张 0~23 编号的图片换上。真正让壁纸不更换的往往是它赖以运转的环境和配置。这篇文章把常见的故障按环境 → 配置 → 使用习惯三个层次拆开讲你只需按图索骥基本能一次搞定。先对号入座常见问题速查表动手排查前先对照下表找到你的症状直接跳到对应章节省去盲目折腾现象可能原因定位章节执行报错Could not find feh/xrandr/crontab系统缺少依赖组件第一层依赖未安装命令能跑但定时从不生效cron 服务未启动或任务没配置第一层cron 服务没睡醒Wayland 会话下壁纸毫无反应oguri 守护进程没启动第一层Wayland 专属方案手动执行正常cron 一到点就失效DISPLAY 等环境变量缺失第二层环境变量三件套提示Invalid style name风格名拼错或不存在第二层风格名对不上XFCE 下壁纸铺错了显示器screen/monitor 编号不匹配第二层多显示器错位每次重启后壁纸打回原形没有设置自启动第三层重启后失效全程无报错但就是不换图缓存残留或旧进程抢占用第三层缓存与冲突第一层环境问题——先确认地基没塌这一层的故障特征是命令根本跑不起来或者跑了也没反应。它们就像水管工说的地基没打好后面修再多也白搭。依赖未安装报错其实是在提醒你补课现象执行dwall -s beach直接弹出[!] ERROR: Could not find feh, is it installed?并退出。原因简析dwall 启动时会先检查三个依赖——feh窗口管理器下设置壁纸、xrandr显示器信息工具、crontab定时任务工具。缺任何一个都会当场拒绝工作这是脚本的自我保护。修复步骤根据你的发行版三选一# Debian / Ubuntu sudo apt install feh x11-xserver-utils cron # Fedora / RHEL sudo dnf install feh xorg-x11-server-utils cronie # Arch Linux sudo pacman -S feh xorg-xrandr cronie提示pywal不在必装清单里只有你用dwall -p让壁纸联动终端配色时才需要。装完再跑一次dwall -s beach报错消失即说明地基已稳。cron 服务没睡醒定时任务的发动机熄火了现象crontab -l里明明有任务壁纸却从不按时切换。原因简析cron 只是一个调度器真正干活的是它背后的守护进程。服务没启动任务表写得再漂亮也不会执行——就像闹钟设好了但电池没装。修复步骤# 先看服务状态Debian/Ubuntu 用 cronArch 用 cronie systemctl status cron # 或 systemctl status cronie.service # 未运行则启动并设置开机自启 sudo systemctl start cron sudo systemctl enable cron # Arch 可以一步到位 sudo systemctl enable cronie.service --now提示systemctl status输出中看到active (running)才算真正生效。装完服务后顺手用crontab -l | grep dwall确认任务还在。Wayland 会话换一套接线方式现象GNOME Wayland、Sway 等环境下dwall执行成功但壁纸就是不变。原因简析Wayland 出于安全设计不允许程序直接操作桌面背景传统的feh、gsettings都失效了。dwall 为此切换到ogurictl通道但它需要 oguri 守护进程常驻才能工作。修复步骤# 1. 安装 oguriArch 可从 AUR 获取 sudo pacman -S oguri # 2. 启动守护进程 ogurictl start # 3. Sway 用户先停掉可能抢占用壁纸的 swaybg pkill swaybg # 4. 手动验证 dwall -s firewatch提示dwall 在 Wayland 下会先检查 oguri 进程没启动会直接提示oguri daemon is not running。把 oguri 加入你的会话自启动避免每次开机都要手动拉起来。第二层配置问题——地基好了看接线对不对这一层的典型特征是命令手动执行一切正常但一交给 cron 就罢工。九成是配置没对齐。环境变量三件套cron 是个失忆的小工现象dwall -s beach在终端里秒换壁纸但 crontab 里的同一行命令到点后毫无动静。原因简析cron 任务运行在一个干净的 shell 里既没有你桌面会话的DISPLAY指向哪块屏幕也没有DESKTOP_SESSION告诉脚本用哪套桌面设置器更没有DBUS_SESSION_BUS_ADDRESS。脚本找不到显示器自然瞎了。修复步骤# 1. 查清你自己的环境变量值 echo $DISPLAY echo $DESKTOP_SESSION echo $DBUS_SESSION_BUS_ADDRESS echo $XDG_RUNTIME_DIR # 2. 编辑 crontab export EDITORvim crontab -e # 3. 写入完整环境把值替换成你自己的风格也换成你喜欢的 0 * * * * env PATH/usr/local/bin:/usr/bin DISPLAY:0 DESKTOP_SESSIONgnome DBUS_SESSION_BUS_ADDRESSunix:path/run/user/1000/bus /usr/bin/dwall -s beach提示懒人方案是把环境变量包进一个包装脚本crontab 里只写一行# /usr/local/bin/dwall-wrapper.sh #!/bin/bash export DISPLAY:0 export XAUTHORITY$HOME/.Xauthority dwall -s beach写好后执行chmod x /usr/local/bin/dwall-wrapper.shcrontab 里改为0 * * * * /usr/local/bin/dwall-wrapper.sh即可。多显示器用户若:0不对以echo $DISPLAY的实际输出为准。风格名对不上Invalid style name之谜现象执行dwall -s Beach报[!] Invalid style name : Beach, exiting...。原因简析dwall 会去/usr/share/dynamic-wallpaper/images目录下逐个比对风格目录名大小写、空格、拼写差一点都算查无此风格。项目内置了 aurora、beach、bitday、cliffs、colony、desert、earth、exodus、firewatch、forest、gradient、home、island、lake、mojave、moon、mountains、sahara、street、tokyo 等二十多套风格。修复步骤# 1. 查看全部可用风格 dwall -h # 2. 或者直接看目录 ls /usr/share/dynamic-wallpaper/images # 3. 用全小写正确调用 dwall -s beach dwall -s tokyo提示想确认脚本有没有认错目录也可以检查~/.cache/dwall_current这个缓存文件里面记录了最近一次设置的壁纸绝对路径一读便知。XFCE 多显示器错位壁纸铺到了别人家现象XFCE 桌面下壁纸要么不变要么铺满主屏之外的显示器。原因简析XFCE 的壁纸属性绑定屏幕编号和监视器编号dwall 用xrandr --listactivemonitors动态获取这两个值多显示器布局一变编号可能对不上脚本的解析结果。修复步骤# 1. 查看当前显示器布局 xrandr --listactivemonitors # 2. 用监控模式观察 XFCE 实际写入的配置项 xfconf-query -c xfce4-desktop -m # 然后随便换一张壁纸终端会打印 set: 开头的属性行 # 记下 screen 与 monitor 的实际编号提示把脚本里SCREEN和MONITOR的取值与你观察到的编号比对大多数单显示器场景是screen0/monitor0接扩展屏时monitor往往变成1甚至更高。第三层使用习惯问题——别让小动作毁掉体验地基和接线都正常了剩下的多是操作习惯带来的小坑改掉即可。重启后失效给 dwall 一张常住证现象每次开机壁纸都恢复成系统默认必须手动再跑一次命令。原因简析cron 只管到点换图不管开机恢复。dwall 没有常驻进程重启后它之前设的壁纸自然被系统重置。修复步骤二选一即可。# 方案 A在 crontab 里加开机任务 reboot /usr/bin/dwall -s beach # 方案 B创建桌面自启动项 mkdir -p ~/.config/autostart在~/.config/autostart/dwall.desktop中写入[Desktop Entry] NameDynamic Wallpaper CommentSet desktop background according to current time. Exec/usr/bin/dwall -s beach TypeApplication Iconwallpaper CategoriesAccessories;提示方案 B 的好处是壁纸在桌面环境完全就绪后才设置登录界面之后无缝衔接视觉上更连贯。缓存与冲突无报错却不换图的隐藏元凶现象命令执行无任何报错日志也正常但壁纸始终保持第一张。原因简析dwall 把上次设置的图片路径写在~/.cache/dwall_current正常情况下每次运行都会刷新它但如果你的桌面环境里还开着 swaybg、nitrogen 之类的其他壁纸工具两个程序会互相覆盖。修复步骤# 1. 查看缓存里记录的路径确认脚本确实换过 cat ~/.cache/dwall_current # 2. 检查是否有其他壁纸进程在抢占 ps aux | grep -E swaybg|nitrogen|feh | grep -v grep # 3. 找到后停掉多余的进程 pkill swaybg提示如果你在 Sway 下既用 swaybg 又用 dwall壁纸会像拔河一样来回跳。记住一条铁律同一时间只留一个壁纸设置器。预防与最佳实践一次配置长期省心与其每次坏了再修不如装好的当天就把下面几步做齐之后基本零维护装齐依赖再动手feh、xrandr、crontab三件套缺一不可Wayland 用户补上 oguri。一条命令完成环境对齐先echo $DISPLAY和echo $DESKTOP_SESSION拿到真实值再写进 crontab不要凭记忆填:0。先测后挂安装目录下自带的test.sh可以在正式安装前试运行确认当前桌面环境被正确识别。自启动三件套reboot定时任务或 autostart 桌面项二选一配上常驻的 oguriWayland开机即恢复。检查清单怀疑没生效时按依赖 → cron 服务 → 环境变量 → 风格名 → 缓存的顺序排查10 分钟内准能定位。进阶玩法把 dwall 玩出花来问题都解决后这几个隐藏功能能让你把这套壁纸系统用得更顺手。pywal 联动壁纸与终端配色一起变加上-p参数dwall 会调用 pywal 根据壁纸提取配色终端、polybar、rofi 的颜色会随之自动统一dwall -p -s sahara自定义壁纸包打造你的专属时间线任何一套 0~23 编号的 jpg/png 图片都能变成新风格文件夹不够 24 张也没关系用软链接补足# 把图片命名为 0.jpg ~ 23.jpg 放入风格目录 sudo mkdir -p /usr/share/dynamic-wallpaper/images/mystyle # 不足 24 张时用 symlink 补位 ln -s /path/to/your.jpg /usr/share/dynamic-wallpaper/images/mystyle/0.jpg加密节奏不只是整点换cron 的表达式很灵活把0 * * * *改成*/15 * * * *就是每 15 分钟换一张当成定时轮播用配合reboot还能做到开机即按当前时间选图。HEIC 图片把 macOS 壁纸搬过来从壁纸站下载的.heic文件需要先转换格式# Debian/Ubuntu 安装转换器 sudo apt install libheif-examples # 批量转成 jpg for file in *.heic; do heif-convert $file ${file/%.heic/.jpg}; done转换完成后按上面的自定义壁纸包步骤放进目录即可。写在最后Dynamic Wallpaper 的壁纸不更换问题绝大多数不是脚本本身的 bug而是依赖没装齐、cron 没睡醒、环境变量没对齐这三件事没做好。照着速查表对号入座从环境、配置到使用习惯逐层排查10 分钟内基本能定位到根因。如果你按照本文的步骤操作后问题依然存在建议执行dwall -h确认版本并带上echo $DESKTOP_SESSION的输出到项目 issue 区反馈——附上这条信息维护者能最快帮你定位桌面环境的兼容问题。愿你的桌面从早到晚都有应景的风景壁纸再也不罢工。输出文章结束【免费下载链接】dynamic-wallpaperA simple bash script to set wallpapers according to current time, using cron job scheduler.项目地址: https://gitcode.com/gh_mirrors/dy/dynamic-wallpaper创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/8/15 17:46:12 · 阅读 1.2k Dynamic Wallpaper壁纸不更换？6类常见问题排查与配置完整指南
Dynamic Wallpaper壁纸不更换6类常见问题排查与配置完整指南【免费下载链接】dynamic-wallpaperA simple bash script to set wallpapers according to current time, using cron job scheduler.项目地址: https://gitcode.com/gh_mirrors/dy/dynamic-wallpaper深夜十一点你拖着疲惫的身体回到家点亮屏幕桌面上还是早上出门前那片清晨的海滩——说好按时辰换壁纸的 Dynamic Wallpaper 一整天纹丝不动。你打开终端敲一句dwall -s beach壁纸立刻乖乖切换可第二天早上再看它又睡着了。这种手动灵、自动瘫的情况几乎每个刚接触 Dynamic Wallpaper 的新手都遇到过。作为一款通过 cron 定时任务按当前小时自动设置壁纸的 bash 脚本工具dwall 本身的逻辑非常简单读当前小时数去对应风格的目录里挑一张 0~23 编号的图片换上。真正让壁纸不更换的往往是它赖以运转的环境和配置。这篇文章把常见的故障按环境 → 配置 → 使用习惯三个层次拆开讲你只需按图索骥基本能一次搞定。先对号入座常见问题速查表动手排查前先对照下表找到你的症状直接跳到对应章节省去盲目折腾现象可能原因定位章节执行报错Could not find feh/xrandr/crontab系统缺少依赖组件第一层依赖未安装命令能跑但定时从不生效cron 服务未启动或任务没配置第一层cron 服务没睡醒Wayland 会话下壁纸毫无反应oguri 守护进程没启动第一层Wayland 专属方案手动执行正常cron 一到点就失效DISPLAY 等环境变量缺失第二层环境变量三件套提示Invalid style name风格名拼错或不存在第二层风格名对不上XFCE 下壁纸铺错了显示器screen/monitor 编号不匹配第二层多显示器错位每次重启后壁纸打回原形没有设置自启动第三层重启后失效全程无报错但就是不换图缓存残留或旧进程抢占用第三层缓存与冲突第一层环境问题——先确认地基没塌这一层的故障特征是命令根本跑不起来或者跑了也没反应。它们就像水管工说的地基没打好后面修再多也白搭。依赖未安装报错其实是在提醒你补课现象执行dwall -s beach直接弹出[!] ERROR: Could not find feh, is it installed?并退出。原因简析dwall 启动时会先检查三个依赖——feh窗口管理器下设置壁纸、xrandr显示器信息工具、crontab定时任务工具。缺任何一个都会当场拒绝工作这是脚本的自我保护。修复步骤根据你的发行版三选一# Debian / Ubuntu sudo apt install feh x11-xserver-utils cron # Fedora / RHEL sudo dnf install feh xorg-x11-server-utils cronie # Arch Linux sudo pacman -S feh xorg-xrandr cronie提示pywal不在必装清单里只有你用dwall -p让壁纸联动终端配色时才需要。装完再跑一次dwall -s beach报错消失即说明地基已稳。cron 服务没睡醒定时任务的发动机熄火了现象crontab -l里明明有任务壁纸却从不按时切换。原因简析cron 只是一个调度器真正干活的是它背后的守护进程。服务没启动任务表写得再漂亮也不会执行——就像闹钟设好了但电池没装。修复步骤# 先看服务状态Debian/Ubuntu 用 cronArch 用 cronie systemctl status cron # 或 systemctl status cronie.service # 未运行则启动并设置开机自启 sudo systemctl start cron sudo systemctl enable cron # Arch 可以一步到位 sudo systemctl enable cronie.service --now提示systemctl status输出中看到active (running)才算真正生效。装完服务后顺手用crontab -l | grep dwall确认任务还在。Wayland 会话换一套接线方式现象GNOME Wayland、Sway 等环境下dwall执行成功但壁纸就是不变。原因简析Wayland 出于安全设计不允许程序直接操作桌面背景传统的feh、gsettings都失效了。dwall 为此切换到ogurictl通道但它需要 oguri 守护进程常驻才能工作。修复步骤# 1. 安装 oguriArch 可从 AUR 获取 sudo pacman -S oguri # 2. 启动守护进程 ogurictl start # 3. Sway 用户先停掉可能抢占用壁纸的 swaybg pkill swaybg # 4. 手动验证 dwall -s firewatch提示dwall 在 Wayland 下会先检查 oguri 进程没启动会直接提示oguri daemon is not running。把 oguri 加入你的会话自启动避免每次开机都要手动拉起来。第二层配置问题——地基好了看接线对不对这一层的典型特征是命令手动执行一切正常但一交给 cron 就罢工。九成是配置没对齐。环境变量三件套cron 是个失忆的小工现象dwall -s beach在终端里秒换壁纸但 crontab 里的同一行命令到点后毫无动静。原因简析cron 任务运行在一个干净的 shell 里既没有你桌面会话的DISPLAY指向哪块屏幕也没有DESKTOP_SESSION告诉脚本用哪套桌面设置器更没有DBUS_SESSION_BUS_ADDRESS。脚本找不到显示器自然瞎了。修复步骤# 1. 查清你自己的环境变量值 echo $DISPLAY echo $DESKTOP_SESSION echo $DBUS_SESSION_BUS_ADDRESS echo $XDG_RUNTIME_DIR # 2. 编辑 crontab export EDITORvim crontab -e # 3. 写入完整环境把值替换成你自己的风格也换成你喜欢的 0 * * * * env PATH/usr/local/bin:/usr/bin DISPLAY:0 DESKTOP_SESSIONgnome DBUS_SESSION_BUS_ADDRESSunix:path/run/user/1000/bus /usr/bin/dwall -s beach提示懒人方案是把环境变量包进一个包装脚本crontab 里只写一行# /usr/local/bin/dwall-wrapper.sh #!/bin/bash export DISPLAY:0 export XAUTHORITY$HOME/.Xauthority dwall -s beach写好后执行chmod x /usr/local/bin/dwall-wrapper.shcrontab 里改为0 * * * * /usr/local/bin/dwall-wrapper.sh即可。多显示器用户若:0不对以echo $DISPLAY的实际输出为准。风格名对不上Invalid style name之谜现象执行dwall -s Beach报[!] Invalid style name : Beach, exiting...。原因简析dwall 会去/usr/share/dynamic-wallpaper/images目录下逐个比对风格目录名大小写、空格、拼写差一点都算查无此风格。项目内置了 aurora、beach、bitday、cliffs、colony、desert、earth、exodus、firewatch、forest、gradient、home、island、lake、mojave、moon、mountains、sahara、street、tokyo 等二十多套风格。修复步骤# 1. 查看全部可用风格 dwall -h # 2. 或者直接看目录 ls /usr/share/dynamic-wallpaper/images # 3. 用全小写正确调用 dwall -s beach dwall -s tokyo提示想确认脚本有没有认错目录也可以检查~/.cache/dwall_current这个缓存文件里面记录了最近一次设置的壁纸绝对路径一读便知。XFCE 多显示器错位壁纸铺到了别人家现象XFCE 桌面下壁纸要么不变要么铺满主屏之外的显示器。原因简析XFCE 的壁纸属性绑定屏幕编号和监视器编号dwall 用xrandr --listactivemonitors动态获取这两个值多显示器布局一变编号可能对不上脚本的解析结果。修复步骤# 1. 查看当前显示器布局 xrandr --listactivemonitors # 2. 用监控模式观察 XFCE 实际写入的配置项 xfconf-query -c xfce4-desktop -m # 然后随便换一张壁纸终端会打印 set: 开头的属性行 # 记下 screen 与 monitor 的实际编号提示把脚本里SCREEN和MONITOR的取值与你观察到的编号比对大多数单显示器场景是screen0/monitor0接扩展屏时monitor往往变成1甚至更高。第三层使用习惯问题——别让小动作毁掉体验地基和接线都正常了剩下的多是操作习惯带来的小坑改掉即可。重启后失效给 dwall 一张常住证现象每次开机壁纸都恢复成系统默认必须手动再跑一次命令。原因简析cron 只管到点换图不管开机恢复。dwall 没有常驻进程重启后它之前设的壁纸自然被系统重置。修复步骤二选一即可。# 方案 A在 crontab 里加开机任务 reboot /usr/bin/dwall -s beach # 方案 B创建桌面自启动项 mkdir -p ~/.config/autostart在~/.config/autostart/dwall.desktop中写入[Desktop Entry] NameDynamic Wallpaper CommentSet desktop background according to current time. Exec/usr/bin/dwall -s beach TypeApplication Iconwallpaper CategoriesAccessories;提示方案 B 的好处是壁纸在桌面环境完全就绪后才设置登录界面之后无缝衔接视觉上更连贯。缓存与冲突无报错却不换图的隐藏元凶现象命令执行无任何报错日志也正常但壁纸始终保持第一张。原因简析dwall 把上次设置的图片路径写在~/.cache/dwall_current正常情况下每次运行都会刷新它但如果你的桌面环境里还开着 swaybg、nitrogen 之类的其他壁纸工具两个程序会互相覆盖。修复步骤# 1. 查看缓存里记录的路径确认脚本确实换过 cat ~/.cache/dwall_current # 2. 检查是否有其他壁纸进程在抢占 ps aux | grep -E swaybg|nitrogen|feh | grep -v grep # 3. 找到后停掉多余的进程 pkill swaybg提示如果你在 Sway 下既用 swaybg 又用 dwall壁纸会像拔河一样来回跳。记住一条铁律同一时间只留一个壁纸设置器。预防与最佳实践一次配置长期省心与其每次坏了再修不如装好的当天就把下面几步做齐之后基本零维护装齐依赖再动手feh、xrandr、crontab三件套缺一不可Wayland 用户补上 oguri。一条命令完成环境对齐先echo $DISPLAY和echo $DESKTOP_SESSION拿到真实值再写进 crontab不要凭记忆填:0。先测后挂安装目录下自带的test.sh可以在正式安装前试运行确认当前桌面环境被正确识别。自启动三件套reboot定时任务或 autostart 桌面项二选一配上常驻的 oguriWayland开机即恢复。检查清单怀疑没生效时按依赖 → cron 服务 → 环境变量 → 风格名 → 缓存的顺序排查10 分钟内准能定位。进阶玩法把 dwall 玩出花来问题都解决后这几个隐藏功能能让你把这套壁纸系统用得更顺手。pywal 联动壁纸与终端配色一起变加上-p参数dwall 会调用 pywal 根据壁纸提取配色终端、polybar、rofi 的颜色会随之自动统一dwall -p -s sahara自定义壁纸包打造你的专属时间线任何一套 0~23 编号的 jpg/png 图片都能变成新风格文件夹不够 24 张也没关系用软链接补足# 把图片命名为 0.jpg ~ 23.jpg 放入风格目录 sudo mkdir -p /usr/share/dynamic-wallpaper/images/mystyle # 不足 24 张时用 symlink 补位 ln -s /path/to/your.jpg /usr/share/dynamic-wallpaper/images/mystyle/0.jpg加密节奏不只是整点换cron 的表达式很灵活把0 * * * *改成*/15 * * * *就是每 15 分钟换一张当成定时轮播用配合reboot还能做到开机即按当前时间选图。HEIC 图片把 macOS 壁纸搬过来从壁纸站下载的.heic文件需要先转换格式# Debian/Ubuntu 安装转换器 sudo apt install libheif-examples # 批量转成 jpg for file in *.heic; do heif-convert $file ${file/%.heic/.jpg}; done转换完成后按上面的自定义壁纸包步骤放进目录即可。写在最后Dynamic Wallpaper 的壁纸不更换问题绝大多数不是脚本本身的 bug而是依赖没装齐、cron 没睡醒、环境变量没对齐这三件事没做好。照着速查表对号入座从环境、配置到使用习惯逐层排查10 分钟内基本能定位到根因。如果你按照本文的步骤操作后问题依然存在建议执行dwall -h确认版本并带上echo $DESKTOP_SESSION的输出到项目 issue 区反馈——附上这条信息维护者能最快帮你定位桌面环境的兼容问题。愿你的桌面从早到晚都有应景的风景壁纸再也不罢工。输出文章结束【免费下载链接】dynamic-wallpaperA simple bash script to set wallpapers according to current time, using cron job scheduler.项目地址: https://gitcode.com/gh_mirrors/dy/dynamic-wallpaper创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考