Back to home@Hoemr

dsh-quicklook

QuickLook-style space-key large preview for DSH better-sidebar: press Space on the active file tab for an instant image/PDF/text overlay

Stars
0
Language
TypeScript
Created
Aug 24, 2026
Updated
Aug 24, 2026
GitHub repo

Introduction

dsh-quicklook

QuickLook-style space-key large preview for dsh-better-sidebar: press Space on the active file tab for an instant image / PDF / text overlay.

How it works

active file tab (dsh-better-sidebar) ── Space ──▶ large overlay preview
                                                    ├── images / PDF  → sidebar media route
                                                    └── text-like     → fs.read
Space / Escape ──▶ close overlay
  • client-only plugin: the host half is a dormant stub; all behavior lives in the browser half (src/client/lib/client.js).
  • Space outside any input opens the overlay for the sidebar's active file tab; pressing it again (or Escape) closes it.
  • Zoom scale is remembered across sessions via localStorage (dsh-quicklook:size).
  • Optional peer contract: without dsh-better-sidebar mounted, the plugin contributes nothing (hot-pluggable, either activation order works).

Install

dsh plugin --profile desktop add dsh-better-sidebar@0.13.1   # or @0.14+ on DSH rc.8
dsh plugin --profile desktop add dsh-quicklook@0.1.0
# then restart the app so bundles mount; hard-refresh the web view

# dev flow:
# dsh plugin --profile desktop add link:D:/Coding/dsh-quicklook

Config

None — the bundle patch simply mounts the client-only plugin:

- insert:
    - id: quicklook
      name: 'dsh-quicklook'

Development

pnpm install
pnpm build       # tsc -b && tsdown
pnpm test        # vitest run
pnpm typecheck

License

MIT