obsidian-plugin/sean2077_obsidian-dynamic-theme-background
1
0
Fork 0
mirror of https://github.com/sean2077/obsidian-dynamic-theme-background.git synced 2026-07-22 06:44:57 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
No description
188 commits 4 branches 46 tags 86 MiB
TypeScript 77.1%
Python 9.1%
CSS 6.3%
Shell 4.4%
JavaScript 3.1%
Find a file
semantic-release-bot 198e3d2e56 chore(release): 2.8.7 [skip ci] 
## [2.8.7](https://github.com/sean2077/obsidian-dynamic-theme-background/compare/2.8.6...2.8.7) (2026-01-21)

### Fixes

* enable sentence-case eslint rules and fix 36 UI text violations ([27ea8c8](27ea8c8e54))
2026-01-21 02:02:11 +00:00
.github Revert "ci: add GitHub Actions workflow for deploying to CloudBase Static Hosting" 2025-12-05 23:10:04 +08:00
docs docs: update hero section with new descriptions and styles 2025-12-06 14:54:35 +08:00
src chore(release): 2.8.7 [skip ci] 2026-01-21 02:02:11 +00:00
.all-contributorsrc chore: Update readme badges & add all-contributors to manage contributors 2025-08-10 00:22:39 +08:00
.editorconfig ci: 添加 EditorConfig 和发布配置文件 2025-08-01 21:01:47 +08:00
.gitignore fix: apply sentence case to UI text for Obsidian plugin validation 2026-01-05 10:42:05 +08:00
.npmrc Initial commit 2025-07-30 16:06:33 +08:00
.prettierrc.json feat: Major Update: Added wallpaper API support; integrated Wallhaven API; optimized project structure and several other features. 2025-08-06 03:22:59 +08:00
.releaserc.yml fix: Update release notes generator configuration 2025-08-10 14:52:16 +08:00
.stylelintrc.json fix: Update stylelint configuration and improve CSS variable definitions 2025-09-16 08:48:54 +08:00
CHANGELOG.md chore(release): 2.8.7 [skip ci] 2026-01-21 02:02:11 +00:00
CONTRIBUTING.md docs: Create CONTRIBUTING.md 2025-08-10 16:24:06 +08:00
esbuild.config.mjs feat: Major Update: Added wallpaper API support; integrated Wallhaven API; optimized project structure and several other features. 2025-08-06 03:22:59 +08:00
eslint.config.js fix: enable sentence-case eslint rules and fix 36 UI text violations 2026-01-21 10:00:43 +08:00
LICENSE chore: Update LICENSE to MIT License and revise copyright information 2025-08-09 06:39:52 +08:00
manifest.json chore(release): 2.8.7 [skip ci] 2026-01-21 02:02:11 +00:00
package-lock.json chore(release): 2.8.7 [skip ci] 2026-01-21 02:02:11 +00:00
package.json chore(release): 2.8.7 [skip ci] 2026-01-21 02:02:11 +00:00
README.md docs: fix formatting in README and README.zh.md for better readability 2025-12-06 15:00:45 +08:00
README.zh.md docs: fix formatting in README and README.zh.md for better readability 2025-12-06 15:00:45 +08:00
styles.css fix: Update stylelint configuration and improve CSS variable definitions 2025-09-16 08:48:54 +08:00
tsconfig.json feat: Add language supportings for English and Chinese translations 2025-08-02 00:59:10 +08:00

README.md

🌈 Dynamic Theme Background

Build Your Own Wallpaper Library in Obsidian!

Make every note-taking experience visually inspiring

🇺🇸 English ｜ 🇨🇳 中文版

Obsidian Plugin Latest Release GitHub Downloads GitHub Stars Build Status License

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
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

License

MIT