Managing Your Library
Organize lectures into folders, understand status indicators, and keep your library tidy as it grows.
The Library Sidebar
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:
- Add to Processing Queue — for a lecture that hasn't been processed, or whose processing failed.
- Process Next, Move Up in Queue, Move Down in Queue — change the order.
- Remove from Queue — take a waiting lecture out of line.
- Stop Processing — stop the lecture that's running; the queue moves on to the next one.
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.
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.
- Click the New Folder (📁+) button in the sidebar header.
- Type a name for the folder and press Return.
- 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:
- Drag and drop — Drag the lecture row in the sidebar onto a folder name. The folder highlights when the drop target is active.
- Right-click menu — Right-click the lecture → Move to Folder → select the destination from the submenu.
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:
- Rename — The folder name becomes editable in-place. Press Return to confirm or Escape to cancel.
- Delete — A confirmation dialog appears with two choices: Delete folder only (keep lectures) or Delete folder and all lectures inside. The first option moves all lectures in the folder to the top level; the second deletes both the folder and all lectures inside it from the library.
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:
- Delete All — Removes every lecture from the library.
- Delete Unprocessed — Removes every lecture that isn't complete.
Library Stats Bar
The bottom of the sidebar shows a row of aggregate statistics for your entire library:
- Lecture count — Total number of lectures.
- Total duration — Sum of all lecture durations (H:MM:SS).
- Total word count — Sum of all transcript word counts (processed lectures only).
- Screenshot count — Total screenshots across all lectures.
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
- If you moved the export folder, put it back in your export location. Harvestry checks the export folder regularly and switches the lecture back to Complete on its own once the folder turns up again.
- If it was deleted, select the lecture and click Begin Processing to regenerate everything. This re-runs the whole pipeline.
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.
- Lectures imported from a URL: click Re-download Video on the player. This restores the video file only. Your transcript, screenshots, notes, and annotations are kept, and nothing is reprocessed. See Re-download a missing video file.
- Any lecture: click Locate Video… on the player (or choose Lecture → Locate Video…) and pick the file where it is now. Your transcript, screenshots, notes, and annotations stay as they are. If the file you choose isn't the same length as the lecture, Harvestry asks before using it, in case it's a different video. Reconnecting the drive also works.