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

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

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

.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