HTML Export

What Gets Exported

Each processed lecture exports to a folder containing four items:

• index.html — The study document. Self-contained; works offline once exported.
• styles.css — The stylesheet. Must remain in the same folder as index.html.
• audio.m4a — The audio track, extracted from the source video using AVAssetExportSession. Used by the in-page audio player.
• images/ — A directory of JPEG screenshots, named {index}_{timestamp}.jpg (e.g., 0001_30.50.jpg).

The folder is fully portable. You can zip it, email it, put it on a USB drive, or host it on any web server. No external resources are required.

Export Location

Each lecture exports to a folder named YYYY-MM-DD Title/ inside your export root. The date prefix keeps lectures sorted chronologically when browsed in Finder.

iCloud Drive vs. local storage

When you are signed in to iCloud, Harvestry saves exports to your iCloud Drive by default — inside the Harvestry/exports/ folder in iCloud Drive. Exports saved there sync automatically to every Mac on the same Apple ID, so your study documents are available on all your machines without any manual copying.

If you prefer to keep exports on this Mac only, go to Settings → General and turn off Save exports to iCloud Drive. Exports will then go to ~/HarvestryLibrary/ on the local disk. A note below the toggle reminds you that local exports do not sync.

If iCloud is not set up on your Mac, exports always go to ~/HarvestryLibrary/ regardless of the setting.

Seeing where an export is stored

Each lecture row in the sidebar shows a small icon after the status text indicating where its export lives:

• iCloud icon — export is in iCloud Drive and will sync.
• Hard drive icon — export is stored locally on this Mac only.
• No icon — the lecture has not been exported yet.

Moving an export between iCloud and local

You can move individual lecture exports at any time without re-running the pipeline. Right-click (or Control-click) a lecture in the sidebar and choose:

• Move Export to iCloud Drive — moves the export folder from ~/HarvestryLibrary/ to iCloud Drive.
• Move Export to Local Storage — moves the export folder from iCloud Drive to ~/HarvestryLibrary/.

The option shown depends on where the export currently lives. If the export does not exist yet, neither option appears. The storage badge on the library row updates immediately after the move.

Opening Your Export

From the lecture detail view, two buttons appear after processing completes:

• Open in Browser — Opens index.html directly in your default browser.
• Show in Finder — Reveals the export folder in Finder so you can navigate its contents, share the folder, or open it in a different browser.

The HTML Page Layout

The exported page uses a typography-focused editorial design:

• Page header — Full-bleed warm-gray background (#767670) with the lecture title, date, and audio player.
• Content column — Centered at 940px max-width on a warm-white background. No card gutter — the content area blends with the page background.
• Typography — Instrument Sans for headings and UI chrome; Newsreader (with font-optical-sizing: auto) for body text. Font size is user-adjustable.
• Tab control (if consolidated notes exist) — A two-tab switcher at the top of the content column: Transcript and Consolidated Notes.

Audio Sync

The exported page includes a standalone audio player in the page header. Each word in the transcript is wrapped in a <span data-s data-e> element containing its start and end timestamp. A small JavaScript snippet advances through these spans as the audio plays, applying a highlight class to the currently playing word.

You can also click any word in the transcript to seek the audio player to that exact moment. This makes the exported page function as an interactive study tool — you can read a section, hear it spoken in context, and jump around at will.

Screenshots in the Export

Screenshots are embedded inline in the transcript flow, positioned at the timestamp they were captured. Layout rules:

• Single screenshot — Floats right with text wrapping around it (.shot--float).
• Two or more consecutive screenshots — Rendered as a horizontal flex strip (.shot-row) at full column width.
• Click to lightbox — Clicking any screenshot in the exported page opens it in a full-screen lightbox with previous/next navigation.

Screenshots are saved as JPEG at 95% quality using CGImageDestination. This preserves full Retina resolution. Using NSBitmapImageRep (the older approach) would halve Retina dimensions, which is why Harvestry specifically avoids it.

Your Annotations in the Export

All annotations added in the transcript panel are included in the export:

• Highlights — Rendered as <mark data-hl="color"> elements. Baked directly into the HTML by the app — visible to anyone who opens the file.
• Margin notes — Rendered as <aside class="margin-note"> elements floating in the page gutter, vertically aligned with their anchor phrase.
• Inline notes — Rendered as <div class="user-note"> callout cards between content blocks.

Font Size Control

The exported page includes a font-size slider in the top-right corner of the content column. The range is 14–24px with a default of 19px. The selected size is persisted to localStorage and restored on every subsequent visit to that page.

Dark Mode

A dark mode toggle is available in the page header. Activating it switches the page to a dark color scheme. The preference is persisted in localStorage. A small inline script restores the theme before first paint to prevent a flash of unstyled content.

Re-exporting

Whenever you modify a completed lecture — by adding annotations, manually adding a screenshot, editing consolidated notes, or changing export settings — a "Modified, re-export needed" badge appears on the lecture in the sidebar and on the detail view toolbar.

Click the Reexport button to regenerate the HTML folder. Only Step 4 of the pipeline runs during a reexport. Transcription and screenshot capture are not repeated.

Reexport is always safe to run. All annotations are preserved — they are stored in Harvestry's database and written into the HTML fresh each time you export.

Finding Old Exports

If you need to locate an export from a lecture that's no longer in the Harvestry library, or if you've forgotten where exports go:

• Use the Show in Finder button on any lecture to reveal its export folder.
• For iCloud exports, open Finder and navigate to iCloud Drive → Harvestry → exports.
• For local exports, navigate directly to ~/HarvestryLibrary/ in Finder.
• In Finder, use ⌘ Space → Spotlight and search for index.html to find any export regardless of location.