Featherweight Local Wallpaper

0-overhead background wallpaper plugin => Obsidian. Supports drag & drop to set local images without a local web-server (+ file-nav wallpaper). Rendered directly via GPU-accelerated CSS variables.

Features

• Local & Remote Support: Use local images on your system. (e.g., ~/Downloads/wallpaper.png) or external web URLs (https://...).

• Zero-Overhead Architecture: Uses native Obsidian resource paths and pure CSS custom properties (var(--...)). Rendering, scaling, and opacity are offloaded directly to Chromium's GPU compositor.

• Visual Fine-Tuning:

  • Adjustable opacity ($0\text{–}100%$)
  • Native Gaussian blur slider ($0\text{–}40\text{ px}$)
  • Translucent contrast overlay for text legibility
  • Darkness overlay slider for high-brightness images
  • (etc. Maybe add text-colour later)

Usage

1. Settings -> Featherweight Local Wallpaper

2. Drag & drop your wallpaper into the box.

Installation

From Community Plugins (Recommended)

1. Open Obsidian Settings → Community plugins.
2. Turn off Restricted mode.
3. Search for Featherweight Local Wallpaper and click Install, then Enable.

Manual Installation

1. Download manifest.json, main.js, and styles.css from the latest GitHub Release.

2. Create a folder named featherweight-local-wallpaper inside your vault's plugin folder:

   <your-vault>/.obsidian/plugins/featherweight-local-wallpaper/
   

3. Move the three downloaded files into that folder (manifest.json, styles.css, main.js)

4. Reload Obsidian and enable the plugin in Community plugins.

Personal Note

3yrs ago, this was my first "real" programming project. I called it "Hoshikawa Version 1" or something like that. Anyway, I never put it onto obsidian community plugins because I was frustrated that I couldn't get local images to work and because I wanted way more customization like a colour picker (struggling to make a colour picker is what drew me further into programming). . . And all the important parts were 100% vibe coded or stolen.

I greatly regret that I didn't just go a little harder and published it as is but oh well? I got my friends to use it anyway.