HTML Export
A self-contained study document: full transcript, screenshots, synchronized audio, highlights, and dark mode — all in a single folder you can open in any browser.
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.
Harvestry Pro can also save a lecture as a printable PDF document — see PDF Documents. The page's footer, like the end of every PDF, carries a short reminder not to share copies without the rights holder's permission.
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 → Export Location and turn off Save exports to iCloud Drive. New exports then go to ~/HarvestryLibrary/ on the local disk.
If iCloud Drive isn't available 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.htmldirectly 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. From there you can step through every screenshot — see below.
Slideshow in the export
The Slides button in the page's controls (top right, next to the theme toggle) starts a slideshow from the first screenshot and, where the browser allows it, goes full screen. Clicking any screenshot opens the same viewer at that slide.
- →, ↓, Space, a click on the slide, or the › button — next slide
- ←, ↑, or the ‹ button — previous slide
- Esc, or a click outside the slide — close. Leaving full screen also ends the slideshow.
A counter shows your place (for example, 3 / 42). The slideshow steps through the screenshots of whichever view is showing — Transcript or Consolidated Notes. It's part of the page itself, so it works for anyone you share the export with, with nothing to install; the Slides button is hidden on pages without screenshots.
Harvestry Pro can also turn a lecture's slides into a printable PDF — see PDF Handouts.
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.
PDF Documents Pro
Harvestry Pro can save a lecture as a PDF document laid out for reading and printing. Under the video, choose Export → PDF Document… (or Lecture → Export PDF Document…, ⌥⌘E), pick where to save it, and it opens when it's ready. Export → PDF Document (Text Only)… leaves the slides out, for a shorter file.
- Page one opens like the study page: the title, presenter, a link to the source video, and the date, length and word count.
- The transcript is set in two columns, each passage marked with its timestamp. Slides sit at the width of a column, captioned with their time; one that won't fit at the foot of a column moves to the top of the next, and the text flows up to fill the space, so there are no half-empty pages.
- Your annotations come with it: highlights in their colours, margin notes under the passage they belong to, and your own notes where you placed them.
- The consolidated notes, if the lecture has them, start on a new page — headings, lists and tables included.
Pages are US Letter if your Mac's region uses it and A4 everywhere else, with page numbers, the lecture's title at the top of each page, and a small "Made with Harvestry" mark. In Preview, the sidebar's table of contents jumps to the transcript (every five minutes of the lecture) and to each section of the notes.
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.htmlto find any export regardless of location.