MiCompress

Shrink the attachments in your vault — images, PDFs, audio, video, Office documents and archives — without leaving Obsidian. Large screenshots and scanned PDFs are the usual reason a vault grows to gigabytes and syncs slowly; MiCompress typically makes them 50–95% smaller.

Features

• Right-click any attachment in the file explorer → Compress with MiCompress. Select several files to compress them in one go.
• Command: Compress attachments in current note — compresses every image, PDF or other file embedded in the open note.
• Command: Compress current file — when an image, PDF or other attachment is open.
• Links keep working. The compressed file replaces the original in place. If the real format differs from the extension (for example a JPEG saved as .png), the file is renamed through Obsidian, which updates every link to it.
• Optional: keep the original and write a -min copy instead.
• Three levels: lossless (same quality), recommended (default) and extreme (smallest file), plus an optional maximum width for images.
• Works on desktop and mobile.

Supported formats include JPG, PNG, WebP, GIF, HEIC, AVIF, TIFF, camera RAW, PSD, PDF, MP3, WAV, M4A, FLAC, MP4, MOV, MKV, DOCX, XLSX, PPTX, EPUB, ZIP and more — the plugin asks the service for the current list.

Network use and privacy

This plugin needs an internet connection. When you compress a file, the file is uploaded over HTTPS to micompress.com, compressed there, and the smaller version is downloaded back into your vault. Nothing is sent until you run a compress command, and only the files you choose are sent — never your notes or other vault content.

On micompress.com, uploaded originals are deleted within about 10 minutes and compressed results within 24 hours. A record of each compression (file name, sizes, time, IP address) is kept, as described in the privacy policy. The plugin collects no telemetry of its own.

Account and limits

No account is needed. Anonymous use has per-type size limits (for example 20 MB for images and 30 MB for documents). For larger files, create a free API key at micompress.com/account and paste it in Settings → MiCompress → API key. Paid plans raise the limits further.

Installation

From Obsidian: Settings → Community plugins → Browse, search for MiCompress.

Manual: download main.js and manifest.json from the latest release into <vault>/.obsidian/plugins/micompress/, then enable the plugin.

Development

npm install
npm run build      # type-check and bundle main.js
npm test           # live test of the API client against micompress.com

Support

[email protected] · issues

License

MIT