OmniDock GitHub

$ man omnidock/r2-buckets

R2 Bucket Manager, File Preview, and OCR-Ready Search

Use OmniDock as a Cloudflare R2 bucket manager for raw email, attachments, manual files, previews, uploads, downloads, deletes, path search, text search, and OCR-ready saved indexes.

Primary bucket

The primary bucket is bound as MAIL_BUCKET. It stores raw email, attachments, and manual files. The Buckets UI should expose prefix browsing, breadcrumbs, object list, preview panel, upload progress, download, delete, and search.

Preview support

  • Image preview for common image attachments and uploads.
  • PDF preview for readable PDF documents.
  • Text preview for text files and searchable document content.
  • Path search for object keys and filenames.
  • Text search for text files, searchable PDFs, and saved text indexes.

OCR-ready, not surprise AI OCR

OmniDock does not run automatic AI OCR by default. That avoids surprise billing and keeps the operator in control. For scanned PDFs or images, the user can add text through an Index text flow. OmniDock stores that text index in D1 and uses it in later search results.

Extra buckets

Add extra buckets with OMNIDOCK_EXTRA_R2_BUCKETS. Simple format uses bucket names like client-files,media-files. Advanced format can map binding names to buckets, for example R2_CLIENT_FILES:client-files.