Omni Viewer

Obsidian port of the vscode-omni-viewer extension. View (and in some cases edit) a wide range of file formats directly inside Obsidian.

Supported formats

Features carried over from the vscode extension

• Audio player with waveform/spectrogram (WASM-accelerated analysis for large files), regions, and region export.
• Image viewer/editor with filters and annotation tools; filtered images can be saved into the vault.
• PDF editor: text, stamps, signatures, page reorder, merge with another PDF, save / save-as.
• CSV editor: cell editing writes back to the file.
• LaTeX structure and math preview: outline, source editing, tables, theorem blocks, KaTeX formulas, and vault-backed \\input/\\include resolution. It is a partial preview, not a TeX compiler or typeset PDF.
• Content-signature rerouting: files whose content doesn't match their extension are opened with the right viewer automatically.
• Share: upload a copy of the selected file to Omni Viewer's external share service (max 10 MB, 5-minute expiry) and copy the share link; open a shared link to download it into the omni-viewer-shared vault folder. See the Privacy Policy for details.
• Refresh command to re-render the active viewer.

How viewers are activated

Obsidian core already handles some extensions (md, pdf, images, audio, video, …). For those, this plugin cannot take over the default view; use the file context menu → Open with … Viewer instead. All other extensions (csv, zip, parquet, dbc, hwp, xlsx, …) open with Omni Viewer by default.

Commands (Cmd/Ctrl-P):

• Omni Viewer: Refresh viewer
• Omni Viewer: Share current file
• Omni Viewer: Open shared link

Installation (manual / development)

npm install
npm run build

Then copy the following into <vault>/.obsidian/plugins/omni-viewer/:

• main.js
• manifest.json
• styles.css

The viewer templates, bundled JavaScript, and WASM assets are embedded into main.js during npm run build, so no extra asset folders are required.

Enable Omni Viewer in Settings → Community plugins. The same bundle runs on desktop, Android, and iOS.

Mobile support

On Obsidian mobile, Omni Viewer uses vault APIs instead of local filesystem paths. Mobile currently supports:

• ZIP/JAR/APK, audio/image/browser-native video, CSV, PDF, Safetensors, JSON/JSONL, YAML, TOML, DBC
• Markdown, LaTeX, Mermaid, PlantUML, Protocol Buffer schemas
• XLS/XLSX, DOCX, HWP/HWPX, PPT/PPTX

Files created by Save As, PDF merge selection, and archive extraction stay inside the current vault. Desktop-only native helpers are intentionally unavailable on mobile: RAR/7z/DMG/system-tar extraction, ffmpeg transcoding, LibreOffice PDF fallback, and legacy DOC rendering. Browser codec support can differ between Android and iOS.

Architecture notes

Each viewer is a FileView hosting a sandboxed iframe that renders the same self-contained HTML templates as the vscode extension. A small bridge shim emulates acquireVsCodeApi() inside the iframe, so template code runs unmodified; messages (saveChanges, savePdf, loadMoreParquet, …) are handled with Obsidian/vault APIs. vscode --vscode-* CSS variables are mapped to the active Obsidian theme at render time.

License

MIT