✨在 Obsidian 中打造你的专属壁纸库

Dynamic Theme Background

让每一次笔记体验都充满视觉灵感

一个高度可定制且智能的壁纸管理插件。整合多种热门源（Unsplash / Pixabay / Pexels / Wallhaven / 自定义），支持本地 + 远程图片混合，自动轮换、视觉调节与缓存优化，让你的知识空间时刻保持新鲜与专注。

⚡开始安装 📱源代码 🚀快速开始

🎬 预览

壁纸轮换预览 轮换

多源壁纸库

  • Unsplash / Pixabay / Pexels / Wallhaven
  • 本地 + 远程混合
  • 自定义 API 扩展
图片背景和渐变背景展示 背景

图片与渐变背景

  • 丰富的图片背景支持
  • 精美的渐变背景
  • 视觉参数调节
主题兼容性展示 主题

主题兼容性

  • 暗/亮模式自适应
  • 兼容各种主题
  • 主题变量驱动样式
主要功能一览
⏰时间轮换
🎨主题自适应
🚀优化加载
🖼️多源混合
🎚️实时调节
🧠缓存预取
⌨️命令面板
🔧自定义 API

✨ 主要特性

围绕"高质量壁纸 + 智能切换 + 极佳性能"打造的增强体验

🖼️多源整合

内置 Unsplash / Pixabay / Pexels / Wallhaven；支持自定义 API 与本地文件夹，集中管理。

🎨可调视觉

模糊、亮度、饱和度、色相、透明度实时调节，兼容暗/亮主题。

⚡智能轮换

支持时间段、固定间隔、命令面板、状态栏快捷触发，多场景动态切换。

🤝优秀体验

异步加载与缓存、默认示例、批量操作、快捷命令，快速高效。

🚀性能优化

按需请求 + 预取策略 + 渲染优化，降低对编辑性能的影响。

📦前瞻计划

天气联动、主题包、视频/音频/AI 背景、移动端强化等持续演进。

⬇️ 安装

选择一种方式开始使用，启用后前往 快速开始 配置轮换与源。

🛒 社区市场 审核中

  • 1 设置 → 社区插件 → 浏览
  • 2 （通过后）搜索 Dynamic Theme Background / DTB
  • 3 安装并启用
当前在官方审核队列。待通过前可使用 BRAT 或 手动 安装。跟踪 PR: obsidian-releases
需要帮助？查看 README 或提交 Issue。
🚀进入快速开始

🚀 快速开始

已安装？3 步完成基础配置。

STEP 1

🖼️添加源

添加本地图片或启用 API 源（Unsplash / Pixabay / Pexels / Wallhaven / 自定义）。

STEP 2

⏱️设置轮换

配置间隔 + 可选时间段（早 / 日 / 夜）实现上下文切换。

STEP 3

⚡控制与体验

使用状态栏或命令面板 (dtb) 切换、保存与获取。

状态栏控制截图
状态栏示例

⚡ 状态栏快速控制

  • 🖱️左键 随机壁纸
  • 🖱️中键 打开设置
  • 🖱️右键 保存当前背景
日常交互主要在此或命令面板完成。
提示：可为命令设置快捷键
完成：源 + 轮换 + 控制均已就绪。

⌨️ 命令

在命令面板输入 dtb 查找全部命令，可绑定快捷键提升效率。

切换背景core

启用 / 禁用当前背景层，不丢失状态。

下一张背景rotation

立即抓取或前进到下一张图片。

获取壁纸network

强制刷新当前启用源池。

保存当前背景utility

将当前显示图片保存到库中复用。

打开设置ui

直接跳转到插件设置面板。

测试背景debug

调试抓取与渲染流程。

🌐 支持的源

高质量壁纸平台 + 自定义拓展

🧭 发展路线图

规划中和探索性功能（可能发生变化）。通过 GitHub Issues / Milestones 跟踪开发进展。

  • 🌤️
    上下文感知
    根据天气/系统主题/专注模式驱动的壁纸组合。
  • 🎞️
    动态图像
    支持视频/微妙的电影图像和可能的 GIF 优化。
  • 🧠
    AI 背景
    按需生成（本地或 API）配合样式预设。
  • 📱
    移动端优化
    自适应性能和触摸手势支持。
  • 🎚️
    预设包
    可分享的主题+调整参数套装。
  • 🗂️
    收藏集
    用户定义的命名图片集和收藏功能。
有想法？在 GitHub 上提交功能请求。

❓ 常见问题

支持哪些壁纸源？
Unsplash、Pixabay、Pexels、Wallhaven 及自定义 API；更多源即将推出。
如何设置轮换规则？
可配置时间段、间隔自动轮换或通过命令面板手动触发。
主题和移动端支持？
是的——响应式布局以及深浅色模式的主题变量集成。
性能影响？
异步加载和智能缓存保持工作区响应流畅。
反馈与问题？
通过 Bug 报告 反馈问题或通过 功能建议 提出需求。
能否禁用动画？
可以——启用操作系统的减少动画偏好设置或切换插件动画设置（即将推出）。
配置存储在哪里？
在您的库的 .obsidian/plugins/obsidian-dynamic-theme-background/ 文件夹中（标准的 Obsidian 插件模式）。
API 使用必须遵守各提供商的服务条款。请遵守访问频率限制和必要的归属政策。