No description
Find a file
2026-06-14 12:27:29 -05:00
.github/workflows chore: switch CI from pnpm to npm 2026-05-30 16:19:53 -05:00
assets working towards v1.0.0 2023-05-27 17:14:58 -04:00
.editorconfig Initial commit 2023-01-13 14:55:35 +00:00
.gitignore docs: add CONTRIBUTING guide 2026-05-31 14:18:49 -05:00
.npmrc Initial commit 2023-01-13 14:55:35 +00:00
CONTRIBUTING.md docs: add CONTRIBUTING guide 2026-05-31 14:18:49 -05:00
esbuild.config.mjs Fix Obsidian community scorecard warnings 2026-05-22 22:39:20 -05:00
eslint.config.mjs Fix Obsidian community scorecard warnings 2026-05-22 22:39:20 -05:00
LICENSE v0.0.1 2023-01-13 10:09:48 -05:00
main.ts fix: use document instead of activeDocument for hover class 2026-05-30 16:39:53 -05:00
manifest.json chore: release 1.0.9 2026-06-14 11:28:36 -05:00
package-lock.json fix: update tsconfig for TS 5.9+ 2026-06-14 10:55:32 -05:00
package.json chore: release 1.0.9 2026-06-14 11:28:36 -05:00
README.md docs: update README.md 2026-06-02 17:09:14 -05:00
release.mjs fix: Read minAppVersion from manifest.json in release script instead of hardcoding. 2026-06-14 11:28:22 -05:00
styles.css feat: add Live Preview support for inline blur syntax 2026-05-30 16:13:38 -05:00
tsconfig.json fix: update tsconfig for TS 5.9+ 2026-06-14 10:55:32 -05:00
version-bump.mjs Initial commit 2023-01-13 14:55:35 +00:00
versions.json fix: sort versions.json entries in ascending semver order 2026-06-14 12:27:29 -05:00

Blur

Light-weight Obsidian.md plugin for creating obfuscated blocks of text.

Installation

Install from community.obsidian.md

From Obsidian's settings or preferences:

  1. Community Plugins > Browse
  2. Search for "Blur"

Manually:

  1. download the latest release archive
  2. uncompress the downloaded archive
  3. move the blur folder to /path/to/vault/.obsidian/plugins/
  4. Settings > Community plugins > reload Installed plugins
  5. enable plugin

or:

  1. download main.js, manifest.json & styles.css from the latest release
  2. create a new folder /path/to/vault/.obsidian/plugins/blur
  3. move all 3 files to /path/to/vault/.obsidian/plugins/blur
  4. Settings > Community plugins > reload Installed plugins
  5. enable plugin

Usage

2 modes:

  1. inline
  2. block i.e. code fence

3 methods:

  1. blur — useful for ==obfuscating== (text preserved, reveals on hover)
  2. brick — useful for ==redacting== (text replaced with █ blocks, does not reveal)
  3. bone — useful for ==wire-framing== (text preserved, reveals on hover)

inline

blur
Alpha Bravo Charlie `~{Delta}` Echo Foxtrot Golt Hotel India Juliet `~{Kilo}` Lima Mike November Oscar `~{Papa}` Quebec Romeo Sierra Tango Uniform Victor `~{Whiskey}` Xray Yankee Zulu
brick
Alpha Bravo Charlie `~[Delta]` Echo Foxtrot Golt Hotel India Juliet `~[Kilo]` Lima Mike November Oscar `~[Papa]` Quebec Romeo Sierra Tango Uniform Victor `~[Whiskey]` Xray Yankee Zulu
bone
Alpha Bravo Charlie `~(Delta)` Echo Foxtrot Golt Hotel India Juliet `~(Kilo)` Lima Mike November Oscar `~(Papa)` Quebec Romeo Sierra Tango Uniform Victor `~(Whiskey)` Xray Yankee Zulu

block

blur
```blur
Alpha Bravo Charlie Delta Echo Foxtrot Golt Hotel India Juliet Kilo Lima Mike November Oscar Papa Quebec Romeo Sierra Tango Uniform Victor Whiskey Xray Yankee Zulu
```
brick
```blur-brick
Alpha Bravo Charliez Delta Echo Foxtrot Golt Hotel India Juliet Kilo Lima Mike November Oscar Papa Quebec Romeo Sierra Tango Uniform Victor Whiskey Xray Yankee Zulu
```
bone
```blur-bone
Alpha Bravo Charlie Delta Echo Foxtrot Golt Hotel India Juliet Kilo Lima Mike November Oscar Papa Quebec Romeo Sierra Tango Uniform Victor Whiskey Xray Yankee Zulu
```

results

screenshot of results in light mode

screenshot of results in dark mode


settings

The plugin includes a Reveal on hover toggle in Settings > Blur. When enabled, hovering over blurred or boned text will reveal the original content. Note: brick text does not reveal on hover since the original text is replaced with █ blocks.


customization

Custom CSS styles can be applied via the obsidian-style-settings plugin.

video demo

effects

  1. blurfilter
  2. brickline-height, background-color, border-radius
  3. boneline-height, background-color, border-radius

screenshot of plugin style-settings

CSS snippet for setting styles

The obsidian-style-settings plugin is required for the following.

  1. create an obsidian-blur-plugin.css snippet file with the content below

or

  1. download obsidian-blur-plugin.css

then

  1. save file to /path/to/vault/.obsidian/snippets
  2. enable snippet under Settings > Appearance > CSS snippets
/* @settings

name: Blur Plugin
id: obsidian-blur
settings:
-
  id: obsidian-blur-filter
  title: Blur filter strength
  type: variable-text
  default: 5px
-
  id: obsidian-blur-brick-color
  title: Brick color
  type: variable-themed-color
  format: hsl
  opacity: true
  default-light: 'hsla(220,19%,6%,1)'
  default-dark: 'hsla(220,100%,100%,1)'
-
  id: obsidian-blur-brick-border-radius
  title: Brick border-radius
  type: variable-text
  default: 1px
-
  id: obsidian-blur-brick-line-height
  title: Brick line-height
  type: variable-number-slider
  default: 1
  min: 1
  max: 2
  step: .05
- 
  id: obsidian-blur-bone-color
  title: Bone color
  type: variable-themed-color
  format: hsl
  opacity: true
  default-light: 'hsla(220,19%,6%,1)'
  default-dark: 'hsla(220,100%,100%,1)'
-
  id: obsidian-blur-bone-border-radius
  title: Bone border-radius
  type: variable-text
  default: 1.5em
-
  id: obsidian-blur-bone-line-height
  title: Bone line-height
  type: variable-number-slider
  default: 1
  min: 1
  max: 2
  step: .05
-
*/

development

clone this repo

cd /path/to/vault/.obsidian/plugins
git clone https://github.com/gapmiss/blur.git
cd blur

install packages and run

npm i
npm run dev

enable plugin

  1. open SettingsCommunity plugins
  2. enable the Blur plugin.