Obsidian Stats logoObsidian Stats

Veil

by lunarch
5
4
3
2
1
Score: 50/100
Install Code

Description

Reviews

No reviews yet.

Stats

0
stars
273
downloads
0
forks
21
days
7
days
7
days
3
total PRs
0
open PRs
1
closed PRs
2
merged PRs
0
total issues
0
open issues
0
closed issues
14
commits

Latest Version

1.7.0
8 days ago

Changelog

Highlights

  • Make Veil noticeably lighter during everyday use by coalescing rapid Settings slider changes, caching document context, Scene/Automation resolution, and wallpaper source lookups, and replacing repeated workspace leaf scans with a live document registry.
  • Redesign Wallpaper Pool configuration around an explicit Wallpaper folder, optional Include subfolders, and automatic Change interval rotation while preserving the previously selected wallpaper file and Wallpaper Library state when the pool is enabled.
  • Keep old pool configurations compatible by deriving the new folder from the existing wallpaper path when needed, including Scene pools, without discarding legacy data.
  • Simplify Settings into four primary tabs: Wallpaper, Appearance, Automation, and Data. Behavior is folded into Wallpaper; Scenes and Routing are grouped under Automation; Data & recovery gets its own dedicated tab.
  • Preserve existing Scenes, Routing rules, opacity exclusions, Wallpaper Library data, import/export data, and persisted settings while reorganizing the UI.
  • Improve pool rotation efficiency with one-shot scheduling so idle Veil does not poll continuously and only documents using a due pool context are refreshed.
  • Extend development profiling with context-build, Scene-resolution, and source-lookup counters and make npm run perf compare directly against the released 1.6.0 baseline.
  • Retain the full 1.6 stability contract: unchanged media is reused, unrelated events stay scoped, idle work remains minimal, and persisted migrations remain deterministic.

Full Changelog: https://github.com/llocphann/Veil/compare/1.6.0...1.7.0

See all version on GitHub

README file from

Github

Veil

Veil adds vault-local image, animated GIF, and video wallpapers to Obsidian. It can change the complete look of your workspace automatically with reusable Scenes, note-aware Routing, wallpaper pools, and visual effects.

Veil is desktop-only. Wallpaper media stays inside your vault after selection.

Highlights

  • Use images, animated GIFs, or videos stored in the current vault.
  • Search and import SFW wallpapers from Wallhaven directly from the Wallpaper Library.
  • Create Scenes that save wallpaper, framing, opacity, effects, transitions, and video behavior together.
  • Route a wallpaper or Scene by note name, path, folder, tag, frontmatter, theme, day, or time.
  • Build wallpaper pools from a folder, optionally include subfolders, and rotate wallpapers automatically on a configurable interval.
  • Browse vault media in the Wallpaper Library with search, Favorites, Recent, filters, sorting, and random selection.
  • Adjust focal point, zoom, display mode, wallpaper opacity, pane opacity, vignette, blur, dim, color overlay, and effect presets.
  • Use Veil in the main window and Obsidian pop-out windows, with each window resolving its own context.

Installation

Obsidian Community Plugins

If Veil is available in the Community Plugins directory, open Settings → Community plugins → Browse, search for Veil, then install and enable it.

GitHub release

  1. Download main.js, manifest.json, and styles.css from the latest Veil release.
  2. Place the three files in <vault>/.obsidian/plugins/veil/.
  3. Reload Obsidian and enable Veil under Community plugins.

Quick start

  1. Open Settings → Community plugins → Veil.
  2. In Wallpaper, choose a vault image, GIF, or video, open Wallpaper Library → Wallhaven to import an SFW wallpaper, or configure a wallpaper pool.
  3. Use Appearance to adjust framing, opacity, transitions, and effects.
  4. Open Automation to create reusable Scenes and configure Routing rules for different notes or contexts.
  5. Use Data for backup, restore, import/export, and recovery tools.

Veil also adds these commands to the Command Palette: Reload wallpaper, Shuffle wallpaper pool, Open wallpaper library, and Switch scene.

Documentation

The detailed user guide is in the Veil Wiki.

Start with:

Version-specific changes are documented in GitHub Releases and CHANGELOG.md.

Privacy

Veil reads vault-local wallpaper media and Obsidian metadata needed by your configured rules. Normal wallpaper playback does not require the network, and Veil does not collect telemetry or run analytics.

Veil connects to Wallhaven only when you use the optional Wallhaven browser in Wallpaper Library. Search terms and selected filters are sent to wallhaven.cc; result thumbnails load from Wallhaven, and the full image is downloaded only when you explicitly select it. Imported wallpapers are saved inside your vault under Wallpapers/Wallhaven/ and are used locally afterward. Veil does not send note contents or vault metadata to Wallhaven.

The built-in Wallhaven browser is SFW-only and does not use or store a Wallhaven API key.

☕ Support Veil

If Veil has made your Obsidian workspace more enjoyable, you can support its continued development here.

Your support helps me keep refining Veil, improving wallpaper workflows, routing, visual effects, and documentation.

License

GNU General Public License v3.0

Sponsors