SourceShelf

Support

Need help with SourceShelf? Email support@sourceshelf.app.

Contact

support@sourceshelf.app

Getting started

  1. Install SourceShelf.
  2. Open the app once.
  3. Choose or confirm an output folder.
  4. Enable the Safari extension in Safari Settings.
  5. Capture web pages or drag files/folders into the app.
  6. Select sources, review Pack Health, then export an AI Reference Pack when ready.

Safari extension help

The extension can save entire pages, main content, selected text, or selected visible areas. Captures are routed through the SourceShelf app for local saving. When Safari can access browser-local images in authenticated web apps, SourceShelf can preserve those images with the captured Markdown.

AI Reference Pack export

Selected captures and documents can be exported as structured ZIPs for AI tools, long-term archives, and reuse, including OKF-compatible bundles based on Google's Open Knowledge Format (OKF) specification.

  • Each selected source becomes its own Markdown page.
  • OKF-compatible exports organize content as Markdown concept documents with metadata for agent-friendly browsing.
  • Other pack exports include a clear index, manifest, and combined Markdown file.
  • Images that were captured or archived locally can travel with the Markdown.

Pack Health

Pack Health shows whether selected content is ready, has warnings, or needs attention before export.

  • Flags missing Markdown, broken local image links, missing archived images, and duplicate page names.
  • Calls out remote images, skipped media, and linked documents that remain links instead of bundled files.

Documentation imports

Drop in an exported HTML documentation folder and SourceShelf focuses on the actual pages instead of every icon, screenshot, or support file. Confluence-style exports can become clean Markdown pages with relevant images attached to the right page.

Supported formats

  • Safari captures
  • PDFs with selectable text
  • Scanned PDFs via local OCR
  • TXT
  • Markdown
  • HTML
  • Exported HTML documentation folders
  • Confluence-style HTML exports
  • RTF
  • PNG
  • JPEG
  • TIFF
  • HEIC/HEIF where supported
  • DOCX
  • PPTX
  • XLSX
  • Folders containing supported files

Common issues

Safari extension does not appear

Enable it in Safari Settings and reopen Safari.

Captures are queued

Open SourceShelf and authorize the output folder.

OCR quality varies

OCR is local and best effort. Use clear/high-resolution scans.

Legacy Office files

Save as .docx, .pptx, or .xlsx first.

Missing files in Recent

The generated Markdown file may have been moved or deleted.

Pack Health shows warnings

Review missing Markdown, broken image links, missing archived images, duplicate page names, skipped media, and linked documents before export.

Remote images are not bundled

Remote images may remain links unless they were captured or archived locally first.

Documentation export includes extra files

Use the documentation import flow so SourceShelf can focus on actual pages and attach relevant images to the right Markdown file.

Local storage is growing

Use the Local Privacy page to review archived web assets, storage usage, and careful cleanup for truly orphaned files only.

Known limitations

  • Legacy Office files .doc, .ppt, .xls are not currently supported.
  • OCR is best effort.
  • Complex document layout may not be preserved perfectly.
  • Remote images and linked documents may remain links if they were not captured or archived locally.
  • Folder structure mirroring and folder watching are not currently included.