✨Build Your Own Wallpaper Library in Obsidian

Dynamic Theme Background

Make every note-taking experience visually inspiring

A highly customizable and intelligent wallpaper management solution. Integrates multiple popular sources (Unsplash, Pixabay, Pexels, Wallhaven & custom). Supports local + remote image mixing so your knowledge space stays fresh and motivating.

⚡Install Now 📱Source Code 🚀Quick Start

🎬 Preview

Wallpaper switching preview Switching

Multi‑source Library

  • Unsplash / Pixabay / Pexels / Wallhaven
  • Local & remote images combined
  • Custom API extensibility
Image backgrounds and gradient backgrounds Backgrounds

Image & Gradient Backgrounds

  • Rich image backgrounds support
  • Beautiful gradient backgrounds
  • Visual parameter adjustments
Theme compatibility showcase Themes

Theme Compatibility

  • Dark & light mode adaptive
  • Works with various themes
  • Theme variable driven styling
Key capabilities at a glance
⏰Time Rotation
🎨Theme Adaptive
🚀Optimized Loading
🧩Multi-Source Mix
🎚️Live Tuning
🧠Caching & Prefetch
⌨️Command Palette
🔧Custom API

✨ Key Features

An elevated wallpaper experience crafted for Obsidian

🖼️Multi-source Library

Unsplash, Pixabay, Pexels, Wallhaven + custom API & local folders—flexibly combine and curate.

🎨Visual Tuning

Adjust blur, brightness, saturation, hue & more—theme-friendly and dark/light aware.

⚡Smart Rotation

Time windows, interval auto-change, command palette quick switch, minute-level scheduling.

🤝Great UX

Async loading, caching, default presets, batch ops & shortcut commands for fast workflows.

🚀Performance Minded

Optimized rendering & caching for minimal impact on editor responsiveness.

📦Roadmap

Weather integration, theme packs, video / audio / AI backgrounds, mobile refinements.

⬇️ Installation

Pick a method below. Once enabled, jump to Quick Start to configure rotation & sources.

🛒 Community Marketplace Pending Review

  • 1 Settings → Community plugins → Browse
  • 2 (After approval) Search Dynamic Theme Background / DTB
  • 3 Install & enable
Currently in Obsidian review queue. Until approved, use BRAT or Manual. Track PR in obsidian-releases.
Need help? See the README or report an issue.
🚀Go to Quick Start

🚀 Quick Start

Already installed? In three short steps you'll have smart rotation running.

STEP 1

🖼️Add Sources

Add local images or enable API providers (Unsplash / Pixabay / Pexels / Wallhaven / Custom).

STEP 2

⏱️Set Rotation

Choose interval + optional time windows (morning / day / night) for contextual change.

STEP 3

⚡Control & Enjoy

Use status bar clicks or Command Palette (dtb) to switch, save & fetch.

Status bar controls screenshot
Status Bar Snapshot

⚡ Status Bar Quick Control

  • 🖱️Left Click Random wallpaper
  • 🖱️Middle Click Open settings tab
  • 🖱️Right Click Save current background
Daily interaction happens here or via the command palette.
Tip: assign hotkeys for even faster switching
You're set: sources + rotation + controls active.

⌨️ Commands

Access via Command Palette. Assign hotkeys for instant control.

Toggle Backgroundcore

Enable/disable the current wallpaper layer without losing state.

Next Backgroundrotation

Immediately fetch or advance to the next image.

Fetch Wallpapernetwork

Force-refresh from active provider pool.

Save Current Backgroundutility

Persist the displayed image to your vault for reuse.

Open Settingsui

Jump directly to DTB settings pane.

Test Backgrounddebug

Diagnostic fetch & render for troubleshooting.

🌐 Supported Sources

High quality wallpaper platforms + custom endpoints

🧭 Roadmap

Planned & exploratory ideas (subject to change). Track progress on GitHub Issues / Milestones.

  • 🌤️
    Context Aware
    Weather / system theme / focus mode driven wallpaper sets.
  • 🎞️
    Animated Media
    Video / subtle cinemagraph & possible GIF optimization.
  • 🧠
    AI Backgrounds
    On-demand generation (local or API) with style presets.
  • 📱
    Mobile Refinements
    Adaptive performance & touch gestures.
  • 🎚️
    Preset Packs
    Shareable theme + adjustment bundles.
  • 🗂️
    Collections
    User-defined named image sets & pinning.
Have an idea? Open a feature request on GitHub.

❓ FAQ

Which wallpaper sources are supported?
Unsplash, Pixabay, Pexels, Wallhaven plus custom APIs; more incoming.
How do I set rotation rules?
Configure time slots, interval auto-rotate or trigger manually via the command palette.
Theme & mobile support?
Yes—responsive layout and theme variable integration for dark & light modes.
Performance impact?
Async loading + smart caching keeps the workspace responsive.
Feedback & issues?
Report bugs via Bug Report or suggest features via Feature Request.
Can I disable animations?
Yes—enable your OS reduced motion preference or toggle plugin animation settings (coming soon).
Where is configuration stored?
Inside your vault .obsidian/plugins/obsidian-dynamic-theme-background/ folder (standard Obsidian plugin pattern).
API usage must comply with each provider's Terms of Service. Respect rate limits & attribution policies where required.