# Image Dither - Obsidian Plugin
Intercepts images pasted or dropped into notes so you can aestehtically dither and resize them, saving storage space
## Features
### Major storage savings!
### Dithering algorithms
Original (2.8MB)
Photo by SwapnIl Dwivedi on Unsplash
| Visual Example | Algorithm | Description |
| :--------------------------------------------------------------------------------------------------------------------------------------- | :------------------ | :---------------------------------------------------------------------------------------- |
| 
272KB | **Floyd-Steinberg** | Error-diffusion; best tonal quality |
| 
161KB | **Blue Noise** | Interleaved gradient noise; organic, film-grain-like pattern with no repetition artifacts |
| 
190KB | **Ordered (Bayer)** | Matrix-based; structured pattern |
| 
82KB | **Threshold** | Hard cutoff; most aggressive |
| 
690KB | **Grayscale** | Smooth grayscale conversion; no dithering |
### Controls (per image)
- **Threshold** — black/white cut point (0–255)
- **Sharpness** — error spread amount (0–100%)
- **Brightness / Contrast** — pre-dither adjustments (−100 to +100%)
- **Resize** — output scale (10–100% of original dimensions)
- **Invert colors** — flip output black/white
### Presets
- **Natural Dither** — Floyd-Steinberg at full size; best default
- **High Contrast** — Threshold algorithm at full size; bold black/white
- **Blue Noise** — Interleaved gradient noise at full size; organic grain
- **Grayscale** — Smooth grayscale conversion at full size
- **Auto (max compression)** — tests all presets and picks the one with the smallest output
### Transparency support
The alpha channel is never modified. Transparent PNGs remain transparent after dithering.
### Compression feedback
- Live size display for original and dithered output (e.g. `1.2 MB → 48.3 KB`)
- Percentage saved with color-coded indicator (good / warn / danger)
- Running total of bytes saved across all uses, shown in Settings
### Output filename
The dithered filename is pre-filled in the modal using a configurable template and can be edited before saving. Supported tokens:
| Token | Replaced with |
| ------------- | --------------------------------------- |
| `{original}` | Original filename without extension |
| `{algo}` | Algorithm name (e.g. `floyd-steinberg`) |
| `{resize}` | Resize percentage (e.g. `75`) |
| `{timestamp}` | ISO timestamp at time of save |
Filenames are automatically deduplicated. If the target name already exists in the folder, a numeric suffix is appended.
## Settings
| Setting | Default | Description |
| -------------------------- | ------------------- | -------------------------------------------------------------------------------------- |
| Enabled | On | Toggle paste/drop interception |
| Default preset | Natural Dither | Preset applied when the modal opens |
| Default output width (px) | 700 | Snaps resize % to the closest value for each image; leave blank to keep original width |
| Dithered filename template | `{original}-dither` | Tokens: `{original}`, `{algo}`, `{resize}`, `{timestamp}` |
## Commands
- **Image Dither: Enable** — turn interception on
- **Image Dither: Disable** — turn interception off
The ribbon icon also toggles the plugin on/off.
## Output format
Images are always saved as **PNG** to the attachment location in specified in your Obsidian preferences > Files and links.
## More examples
