🌈 Dynamic Theme Background

Build Your Own Wallpaper Library in Obsidian!

Make every note-taking experience visually inspiring

🇺🇸 English ｜ 🇨🇳 中文版

---

Preview

Features

• Multi-source Library — Unsplash, Pixabay, Pexels, Wallhaven + custom API & local folders
• Visual Tuning — Blur, brightness, saturation, hue adjustments; dark/light theme aware
• Smart Rotation — Time windows, interval auto-change, command palette quick switch
• Performance — Async loading, caching, minimal impact on editor responsiveness

Installation

Requires Obsidian 1.7.2 or later.

Marketplace (Pending)

Currently in Obsidian review queue. Track: obsidian-releases#7359

BRAT

1. Install BRAT
2. Add beta plugin → https://github.com/sean2077/obsidian-dynamic-theme-background
3. Enable in settings

Manual

1. Download main.js, manifest.json, styles.css from Releases
2. Create .obsidian/plugins/obsidian-dynamic-theme-background/
3. Place files inside, restart Obsidian, enable

Quick Start

1. Add Sources — Local images or API providers (Unsplash / Pixabay / Pexels / Wallhaven / Custom)
2. Set Rotation — Interval + optional time windows (morning / day / night)
3. Control — Status bar clicks or Command Palette (dtb) to switch, save & fetch

Status Bar:

• Left Click → Random wallpaper
• Middle Click → Open settings
• Right Click → Save current background

Network and Privacy

• Local images, colors, and gradients work without provider requests. Enabling a wallpaper provider, using a custom JSON endpoint, or applying/saving a remote image can contact the configured third party; that service's terms and privacy policy apply.
• Provider keys, tokens, and custom headers are stored in the plugin's data.json under the vault configuration so Obsidian 1.7.2 remains supported. This file is not encrypted: do not publish it, review vault-sync destinations, and rotate any credential that may have been exposed.
• The plugin has no telemetry or analytics. Diagnostic logging sanitizes credential-bearing URLs and headers, bounds nested data, and does not intentionally log API keys or tokens.
• Saving a remote wallpaper is an explicit action and writes only to the validated vault-relative folder selected in plugin settings.

Notes

• Optimized for dark themes; light themes may need parameter adjustments
• Uses Obsidian CSS variables — compatible with most themes
• If your theme defines custom backgrounds, choose one or the other to avoid conflicts

CSS Override Details

.dtb-enabled .workspace::before {
    background-image: var(--dtb-bg-image);
    filter: blur(var(--dtb-blur-depth)) brightness(var(--dtb-brightness)) saturate(var(--dtb-saturate));
    /* ... */
}

Roadmap

• Weather / system theme driven wallpaper sets
• Video / GIF backgrounds
• AI-generated backgrounds
• Mobile refinements
• Preset packs & collections

Contributing

• Report Bug
• Feature Request
• Star the project if it helps!

License

MIT