Skip to content

Review comments

Review comments are shot notes that live on the work itself. Pin a note to a frame, draw on the picture, and anyone on the project can go straight to that moment, answer it and mark it done. That includes a client on a phone and an agent doing the fixes.

A comment holds your text, an optional name, its time and frame, its status (open or resolved), its replies and your drawing. Kitlig also saves a flattened picture of the frame with the drawing on top, so everyone looks at exactly what you saw.

There are no accounts. Your name is whatever you type, and Kitlig remembers it on that device.

Comment on a timeline

  1. Open a sequence in Video mode and click Comments in the toolbar.
  2. Park the playhead on the frame.
  3. Click into Leave a comment…, or pick a drawing tool. The player pauses and the note locks to that time, so scrubbing away won't move it.
  4. Draw if you want to: Pen, Arrow, Rectangle or Ellipse, in any of the five colours. Undo takes back the last shape.
  5. Click Comment, or press Ctrl+Enter.

To mark a stretch rather than a moment, move the playhead to the end of it and click End here. Use playhead moves the start of the note to wherever the playhead is now.

Kitlig records which clip and source file were under the note. That matters later, because of how pins behave.

Pins stay where you left them

A note stays at its timecode when you re-edit. If an earlier cut shifts a shot from 1:57 to 1:42, the pin stays at 1:57, and the note tells you This shot now plays at 1:42. It also says when the moment has been trimmed out or the clip has gone from the timeline.

Add Padding is the one exception. You are asking for room at a point in the cut, so the notes after it move with the shots they are about, and undoing the padding puts them back.

Comment on a file

Select any asset in Sandbox and click the comment button at the left of the viewer toolbar. Video works like the timeline. A still sits fitted to the pane while the panel is open, so you can draw on it, and goes back to the zooming preview when you close the panel. Audio takes a time and text but has no picture to draw on.

Formats a browser can't show, such as EXR, take written comments but no drawing.

Work through the notes

Comments appear in playback order, and each one is a diamond on the seek bar. Grey means resolved.

  • Click a note or a pin to go to that frame. The drawing shows while the playhead is on that frame and goes away when you move.
  • Open a note to read its replies and see the saved picture.
  • Reply answers it. Resolve marks it done, and Reopen brings it back.
  • The menu at the top of the panel shows All, Open or Resolved.
  • The trash button deletes the thread, its replies and its picture for everyone.

Review on a phone or in a browser

Kitlig Web shows the same comments, and people need the same pairing or login they use for anything else there.

To review a cut, open the project and tap Review. Each sequence is listed with its latest export and whether the timeline has changed since. Tap one to watch it.

  1. Pins stand on the seek bar under the picture. Tap one to jump there and see the drawing.
  2. Tap Comments to read the list, answer a note or resolve it.
  3. Tap Add a comment. The video pauses and the picture moves up to make room.
  4. Draw with your finger using Pen, Arrow, Box or Circle.
  5. Type your note and tap Comment.

The same Comments button is on any image, video or audio file you open.

Pins too close together for a thumb share one marker with a number on it. Each tap on that marker goes to the next note in the group.

Favourite and rate

Under the picture, tap the heart to favourite a file and a star to rate it. Each phone gets one heart and one rating, and you can change them: tap the heart again, or your own star again, to take them back. Next to the stars you can see the average and how many people have rated.

The Review screen lists these beside each cut, along with what you gave it. In Kitlig the same counts show on the asset's card and in the Inspector. They're kept apart from your own stars and heart, so a reviewer can never change those.

Move around the video

Videos and exports play with Kitlig's own controls under the picture, so nothing sits on top of the frame or your drawing. Turn the phone on its side and the controls move beside the picture. If they don't all fit, scroll that column.

  • Tap the picture, or the yellow button, to play and pause.
  • Drag along the seek bar to scrub. The time under it reads minutes, seconds and frames.
  • −1f and +1f step one frame and pause the video.
  • −1s, −5s, −30s, +1s, +5s and +30s jump by that many seconds.
  • The start button goes back to the beginning of the cut, and the comment buttons jump to the previous or next comment.
  • The camera button saves the frame you're on, without any drawing on it.
  • The speaker button mutes the video, and the corner arrows go fullscreen. In fullscreen the picture fills the screen. Tap it to bring the controls back; they leave again a few seconds into playback.

All of these keep working while you write a note. Step to the frame you mean, then tap Use current time, or tap End here to mark a stretch.

Audio files keep the browser's own player.

Save a screenshot

On an iPhone or iPad, the camera button opens the share sheet over https, where Save Image puts the frame in Photos. Over plain http, Safari downloads it to Files instead. On Android and on a computer the frame lands in your downloads.

If the phone refuses both, Kitlig shows you the picture. Press and hold it to save it. When a frame can't be captured at all, a message under the picture tells you why. On an iPhone that hasn't played the video yet, press play first so there's a frame to take.

Note

Frame steps need the video's frame rate. Kitlig reads it from the comments on the file, so a file with no timed comments yet steps at 29.97 frames per second. On a video at another rate, a step can repeat or skip a frame until the first comment goes on, and the frame number under the seek bar counts at that rate too.

Note

An iPhone can only go fullscreen in Apple's own player, so you'll see its controls there instead of Kitlig's. Leave fullscreen to get back to your comments. Android phones, iPads and computers keep Kitlig's controls in fullscreen.

A note left on an export belongs to its sequence, so it shows up in the Edit player too. If the export covered only an in/out range, Kitlig maps the time back to the timeline for you. The note also remembers which clips were in that render, even if the timeline has changed since.

Note

Deleting a comment is only possible in the app. With no accounts, Kitlig can't tell whose note is whose.

Note

A server running with KITLIG_WEB_READ_ONLY=1 still takes comments, replies and resolves. That's so a client can give notes without being able to start jobs or change files.

Let an agent work through the notes

Agents read the same comments, from the Assistant or through the MCP server. Ask for something like "go through the open notes on this sequence".

An agent can list the notes, look at the saved picture of each one, reply and resolve. It can't start a note of its own or delete one. Its replies are labelled as coming from an agent, so you can see who did what.

Comments on Kitlig Asset variations are a separate, simpler thing: short notes on a candidate, with no time or drawing. Agents don't see those.