Harvestry › Documentation › Managing Your Library

Managing Your Library

Organize lectures into folders, understand status indicators, and keep your library tidy as it grows.

The left panel of the Harvestry window is the library sidebar. It lists all lectures, grouped by folder if you've created any. The sidebar is the primary navigation surface — clicking a lecture selects it and shows its detail view on the right.

Lectures are listed newest first by default. Dragging a lecture onto a folder moves it into that folder; dragging video files in from Finder imports them (see Adding Videos by Drag and Drop). The arrow keys move through the list, and Harvestry reopens the lecture you were last reading.

Searching the Library

Click the Search Library field in the toolbar, or press ⌘F, and type. The sidebar narrows to lectures whose titles match, and to folders whose names match; folders open by themselves to show their matching lectures. Press Esc to clear the search. (Folders can't be reordered while a search is active.)

You can also find lectures from anywhere on your Mac with Spotlight (⌘ Space). Harvestry adds each lecture's title and transcript to Spotlight, so searching for something that was said in a lecture brings it up — choose it to open that lecture in Harvestry.

Sorting

Click the ⋯ button at the top of the sidebar and choose Sort by Date Added (newest first) or Sort by Title (A–Z); a checkmark shows the current order. Title sorting is natural, so numbers sort the way you'd expect — "Lecture 2" comes before "Lecture 10". The sort applies inside every folder and to Unfiled lectures, and Harvestry remembers your choice.

Folders keep the order you give them. Drag a folder up or down the list — a line shows where it will land — or right-click a folder and choose Move Up or Move Down. (Dragging a lecture onto a folder highlights the folder instead, because the lecture goes into it.) The order syncs to your other Macs. New folders take their alphabetical place while your folders are still in A–Z order; once you've arranged them yourself, new folders are added at the bottom.

Adding Videos by Drag and Drop

Drag one or more .mp4, .mov, or .m4v files from Finder onto the sidebar to import them. The sidebar is outlined while a drop will be accepted. Drop them onto a folder to file them there, or anywhere else in the sidebar to add them as Unfiled lectures. Files already in your library are skipped rather than imported twice, and other file types are ignored.

Dropped videos join the processing queue automatically.

The Processing Queue

Harvestry processes one lecture at a time. Every new import — dropped, picked in the Import sheet, or downloaded from a URL — joins the end of a queue, and lectures start in turn as each one finishes. Each lecture already keeps the Neural Engine and the video decoder fully busy, so running two at once wouldn't finish either one sooner; it would only slow both down.

A waiting lecture shows Queued · #N in place of its status, where N is its place in line. Right-click a lecture to manage the queue:

The ⋯ menu adds Process All Unprocessed, which queues every lecture you haven't processed yet, and Clear Queue, which empties the waiting list without stopping the running lecture. Clicking Begin Processing on a lecture while another is running adds it to the queue instead. The queue belongs to this Mac and starts empty each time Harvestry launches.

Harvestry library showing completed lectures organized in folders in the sidebar

Lecture Status Icons

Each lecture row in the sidebar shows a small status indicator dot next to the title:

Status Icon Meaning
Ready Gray dot ⬤ Imported but not yet processed. New imports are queued automatically; right-click → Add to Processing Queue for any others.
Transcribing Amber pulsing dot WhisperKit is actively transcribing the audio.
Capturing Amber pulsing dot Screenshot scan and capture phase is running (alongside transcription).
Consolidating Amber pulsing dot LLM consolidation is in progress (Claude, ChatGPT, or Ollama).
Exporting Amber pulsing dot HTML is being generated and written to disk.
Complete Green dot ⬤ All pipeline steps finished successfully. Export is ready.
Failed Red dot ⬤ One or more steps failed. Select the lecture to see the error in the log.
Missing Warning triangle ▲ The lecture's exported study document can no longer be found on disk, usually because its export folder was deleted or moved. The transcript and screenshots are still in the library. See What "Missing" Status Means.

Creating Folders

Group related lectures into folders to keep your library organized by course, topic, or date.

  1. Click the New Folder (📁+) button in the sidebar header.
  2. Type a name for the folder and press Return.
  3. The folder appears in the sidebar. Drag lectures onto it to move them in.

Folders can be collapsed or expanded by clicking the disclosure triangle to the left of the folder name. The collapse state is persisted between app launches.

Moving Lectures to Folders

Two ways to move a lecture:

To move a lecture out of a folder back to the top level, right-click → Move to Folder → None (top level).

Renaming and Deleting Folders

Right-click any folder name for these options:

⚠️
Deleting lectures does not delete export folders. When you delete a lecture from the library, its exported HTML folder on disk is not touched. You can still open the HTML page directly. To delete the export, remove it from Finder manually.

Deleting Lectures

To delete a single lecture, right-click it in the sidebar → Delete Lecture, or select it and press Delete. Harvestry always asks first: deleting removes the lecture's study page and notes on all your Macs, along with the video if Harvestry downloaded it, and it can't be undone.

Bulk delete options are available from the sidebar header menu (⋯ button), and they ask first too:

Library Stats Bar

The bottom of the sidebar shows a row of aggregate statistics for your entire library:

What "Missing" Status Means

A lecture shows Missing when it was fully processed but Harvestry can no longer find its exported study document — the export folder holding index.html, the audio, and the images. Usually that means the export folder was deleted or moved outside Harvestry.

The transcript, screenshots, notes, and annotations are all still in your library. Only the exported files are gone.

Restoring a Missing lecture

📝
Why a synced lecture isn't marked Missing. A lecture only becomes Missing on the Mac where its video file lives. On a second Mac that received the lecture through iCloud, a missing export more likely means iCloud Drive hasn't finished downloading it yet, so Harvestry leaves the lecture as Complete instead of hiding its transcript.

When the Video File Is Missing

This is a separate situation from the Missing status. Harvestry keeps track of each video you import, so if you move or rename it on the same disk, the lecture simply follows it — nothing to do. If the video has been deleted, copied elsewhere, or sits on an external drive that isn't connected, the lecture keeps its status and the player shows Source video not found. The transcript panel and the exported HTML still work, but the in-app player and actions that need the video don't. Re-transcribe and Reprocess everything are disabled until the video is back.