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
- Open a video: drop it on the window, or press Command O.
- 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.
- Press Shift Command C (Copy Comments) and paste into ChatGPT, Claude or any AI.
Getting started on iPhone, iPad and Apple Vision Pro
- Tap + and add a video from Photos or Files. The app keeps its own copy, so the original is never changed.
- 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.
- 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.