Video Commenter support

Video Commenter is for leaving notes on a video for an AI to act on, on Mac, iPhone, iPad and Apple Vision Pro. A short tutorial shows the first time you open it, and any time from Settings. Email leonfigueira@gmail.com with any question.

Getting started on a Mac

  1. Open a video: drop it on the window, or press Command O.
  2. Click the video where something should change, and write what you want. Press N for a note at that moment with no spot, or Command M to speak it. Return saves.
  3. Press Shift Command C (Copy Comments) and paste into ChatGPT, Claude or any AI.

Getting started on iPhone, iPad and Apple Vision Pro

  1. Tap + and add a video from Photos or Files. The app keeps its own copy, so the original is never changed.
  2. Tap the video where something should change and type what you want, or tap the microphone to say it. Pinch the video to zoom in on the exact spot. Note adds one at that moment with no spot.
  3. Tap Send to share every note, each with a still of its frame, to ChatGPT, Claude or any AI app. When it answers, copy the answer and tap Paste AI Reply: each part goes under its note.

Common questions

How does Talk Through work?
Press Talk Through (Talk on iPhone) and review out loud while you watch, scrub, pause and go back. Tap or click the video while you talk to point at what you mean. When you pause or stop, each stretch of talking becomes its own note at the moment you were watching; a pause in your voice starts a new note. While you talk the notes list stays as it is, with one line of the words it hears so you know it is listening. Your recording is always saved, so if anything goes wrong its notes can be made again. Wear headphones, such as AirPods, so the video's sound isn't recorded with your voice.

Can I see a video from my Mac on my iPhone?
Yes, with iCloud sync. Turn it on in Settings on each device, then choose Move to iCloud in a video's menu: it shows on your other devices with its notes. Only the videos you move go to iCloud, and they count towards your iCloud storage. Turning sync off removes nothing.

Where are my notes saved?
On iPhone, iPad and Apple Vision Pro, with the video inside the app (you can see them in the Files app, On My iPhone, Video Commenter). On a Mac, next to the video, in a folder with its name and ".notes" on the end ("My Clip.notes" for "My Clip.mp4"). Inside are the notes themselves (notes.json), a still of each frame you clicked, your voice recordings, and a short README that tells an AI how to read them. Keep the video and its notes folder together and you can move them anywhere; if you move them to a folder you have not allowed yet, the app asks for it.

The notes panel says my notes are kept inside the app.
macOS only lets an app use folders you choose. Click Allow Folder and choose the video's folder, or a folder above it such as Movies to cover every video inside. The notes you already made move next to the video.

How do I give my notes to an AI?
Copy Comments (Shift Command C) copies one prompt with your open notes, each with its time and the spot you clicked. Paste it into any AI chat. To include a still of each frame, use Export Comments (Shift Command E), which saves the prompt and every frame into a folder, already selected in Finder, ready to drag into the chat. An AI that works with your files, such as Claude Code, can read the notes folder directly and reply on each note; you will see its replies appear.

Does it work with Claude?
Yes, and with any other AI. For Claude, Help, Install Claude Skill adds a skill that knows the notes format: choose "For Claude Code" or "For the Claude App" (which saves a file to upload in Claude's settings, under Skills).

I moved the playhead after clicking. Which time does the note keep?
While a note is open and the video is paused, moving the playhead moves the note too, so it keeps the moment you end on.

I closed the app halfway through a note.
It is kept. The next time you open that video, the note comes back with what you had written.

Can I undo?
Yes. Command Z undoes deleting a note, rewording it, or changing its status.

Voice notes or Talk Through are not working.
Make sure Video Commenter is allowed to use the microphone: on a Mac in System Settings, Privacy and Security, Microphone; on iPhone and iPad in Settings, Apps, Video Commenter. The first time may take a moment while your device gets its speech model for your language.

What do the three choices under "When your AI reads these notes" do?
They tell an AI that works on your files how to handle your notes. Ask me first: it replies to each note with its plan and waits for your go-ahead. Make the changes and explain: it makes a new version of the video next to the old one (for example "My Clip v2.mp4"), opens it in Video Commenter and replies on each note with what it changed. Just make the changes: the same, without replies, ready for your next round of notes.

Why do I see notes from an earlier version?
When your AI opens its new version, the notes from the version before show underneath, marked "Earlier version", with what it changed. Their times and spots refer to that version. If a change is not right yet, pick the note and reply; it goes back to your AI with your next Copy Comments. Hide them with the switch in the notes panel's menu.

How much does it cost?
Video Commenter is free to download. Start 14 free days to try everything; nothing is charged, now or when they end. Then one payment keeps it for good. There is no subscription. After the free days, your notes and videos stay open and readable; new notes, replies and copying them need the one payment.

I bought it on another device, or reinstalled.
One purchase covers Mac, iPhone, iPad and Apple Vision Pro. Open Settings (Command , on a Mac) and choose Restore a Previous Purchase, signed in with the same Apple Account.

What are notices?
Short messages from me about known problems and fixes, shown at the top of the window. Turn them off in Settings, Notices.

Keyboard shortcuts

Press ? in the app, or choose Help, Keyboard Shortcuts, for the full list. The ones you will use most: Space play and pause, arrows step a frame, N new note, ] and [ next and previous note, Delete delete the picked note, 1 to 5 set its status, Command T new tab.

Privacy

Video Commenter collects nothing. Send Feedback in Settings opens an email to me. Read the privacy policy.