Obsidian Stats logoObsidian Stats

Illuminator

by tiezjin
5
4
3
2
1
Score: 35/100
New Plugin
Install Code

Description

This plugin has not been manually reviewed by Obsidian staff. Automatically removes white backgrounds from images on paste and converts them to optimized WebP. Perfect for maintaining legibility and visual harmony in light-themed vaults.

Reviews

No reviews yet.

Stats

stars
downloads
0
forks
0
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

See all version on GitHub

README file from

Github

Illuminator

Language 🇺🇸 English | 🇨🇳 简体中文 | 🇩🇪 Deutsch

🇺🇸 English

A local, lightweight plugin to make white backgrounds transparent, convert into compact WebP format and automatically update link when you directly paste an image or right-click it in the file panel.

💡 Best Use Case

  • Optimized for Light Mode: Perfect for users who use Light Mode with custom background colors (Sepia, Grey, etc.).
  • Note: Since this removes the white background, pure black text will become harder to see if viewed in Obsidian's Dark Mode.

🛠 How it Works

  • RGB Thresholding: Pixels brighter than your chosen setting are converted to 100% transparency.
  • 100% Local: All processing happens in a Web Worker on your machine. No data ever leaves your vault.
  • ⚠️ Permanent Change: This process modifies the image data. Please keep backups of your original images if needed.

📦 Installation

  1. Download main.js and manifest.json.
  2. Create folder .obsidian/plugins/illuminator/ in your vault.
  3. Move the files there and enable in Settings > Community Plugins.

🇨🇳 简体中文

一个本地、轻量的插件。当你直接粘贴图片或在文件面板中右键点击图片时，它可以将白色背景转为透明, 转换为更小体积的 WebP 格式, 并自动更新笔记链接。

💡 最佳使用场景

  • 浅色模式优化： 非常适合在浅色模式下使用自定义背景色（如米黄、淡绿等）的用户。
  • 注意： 由于去除了白色背景，如果切换到 Obsidian 的暗黑模式，图片中的纯黑色文字会变得难以看清。

🛠 工作原理

  • RGB 阈值： 亮度高于设定值的像素将被转换为 100% 透明。
  • 100% 本地化： 所有处理均在本地 Web Worker 中完成。数据永远不会离开你的文件夹。
  • ⚠️ 永久修改： 此操作会修改图像数据且不可逆，如有需要请提前备份原始图片。

安装步骤

  • 下载 main.js 和 manifest.json 文件。
  • 在您的库 (Vault) 中创建文件夹 .obsidian/plugins/illuminator/。
  • 将下载的文件移动到该文件夹中，并在 设置 > 社区插件 中启用。

🇩🇪 Deutsch

Ein lokales, leichtgewichtiges Plugin, um weiße Hintergründe transparent zu machen, Bilder in kompaktes WebP-Format umzuwandeln und Bildlinks automatisch zu aktualisieren, wenn du ein Bild einfügst oder im Datei-Panel rechtsklickst.

💡 Beste Anwendung

  • Optimiert für den Light Mode: Perfekt für Nutzer, die den Light Mode mit benutzerdefinierten Hintergrundfarben verwenden.
  • Hinweis: Da der weiße Hintergrund entfernt wird, kann rein schwarzer Text im Dark Mode von Obsidian schwer lesbar werden.

🛠 Funktionsweise

  • RGB-Schwellenwert: Pixel, die heller als der gewählte Wert sind, werden zu 100% transparent.
  • 100% Lokal: Die Verarbeitung erfolgt vollständig in einem Web Worker auf deinem Rechner.
  • ⚠️ Permanente Änderung: Dieser Vorgang verändert die Bilddaten dauerhaft. Bitte bei Bedarf Backups der Originalbilder aufbewahren.

Installation

  • Laden Sie die Dateien main.js und manifest.json herunter.
  • Erstellen Sie in Ihrem Vault den Ordner .obsidian/plugins/illuminator/.
  • Verschieben Sie die Dateien in diesen Ordner und aktivieren Sie das Plugin unter Einstellungen > Community-Plugins.

Created with the assistance of AI to solve a problem that was bothering me.

Sponsors