Redacted Background

unlisted

by Sonophage

Point-and-click local wallpapers for the Bureau theme. Sets Bureau's background layer to a vault image via a live resource path — no base64, no manual editing.

Updated 2mo ago
View on GitHub

Redacted Background

A tiny companion plugin for the Bureau Obsidian theme: point-and-click local wallpapers and new-tab images, no base64, no manual file editing.

Why it exists

Bureau can show a wallpaper behind the workspace and an image on the New Tab / empty pane, fed by the CSS variables --bu-wallpaper-snippet and --bu-new-tab-image. Pure CSS, though, can't point at a vault file by path — Obsidian serves vault files over a per-install app://<token>/… URL that only JavaScript can mint, the legacy app://local/… shortcut no longer resolves, and relative paths don't resolve inside injected snippet styles. The no-plugin workaround is to embed the image as a base64 data URI, which most people won't want to do by hand.

This plugin does it for you, for both of Bureau's image slots — the workspace wallpaper and the new-tab / empty-pane image. Pick any image in your vault and it sets the matching variable (--bu-wallpaper-snippet / --bu-new-tab-image) to a live resource path (getResourcePath()), re-minted every session — so there's no encoding step and nothing breaks when the token rotates.

Requires the Bureau theme (it sets a variable Bureau reads). Bureau works fine without this plugin — this is an optional convenience.

Use

  • Right-click any image in the file explorer → Set as Redacted Background or Set as new-tab image, or
  • Command palette → Pick wallpaper image / Pick new-tab image (and Clear wallpaper / Clear new-tab image), or
  • Settings → Redacted Background → Pick image (or the clear button) for either slot.

Dimming, frosted glass, and new-tab image size stay in Style Settings → Bureau. This plugin only chooses the images.

Each slot has a Show … layer toggle (on by default) that adds Bureau's class (bu-wallpaper / bu-new-tab) so the image displays. Turn it off to flip the matching toggle in Style Settings yourself.

Install (BRAT)

Not in the community store — install via BRAT:

  1. Install & enable BRAT.
  2. BRAT → Add beta plugin → Sonophage/Redacted-Background.
  3. Enable Redacted Background in Community plugins.

Changelog

See CHANGELOG.md.

License

MIT

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.