# Application Comments and Annotation: Video Timestamp Comments

Video review timeline with avatar markers at comment timestamps and a list of time anchored notes with reply and mark done controls.

- Page: https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/video-timestamp-comments
- Collection: [Application](https://www.shadcn-ui-blocks.com/blocks/application-pro), Standard tier
- Group: [Comments and Annotations](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations)
- Created: 2026-07-04
- Preview image: https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/video-timestamp-comments.png

## Install

```bash
npx shadcn@latest add @shadcn-ui-blocks/application-pro-comments-annotations-video-timestamp-comments
```

Needs an API key from a Pro or Team plan: add `@shadcn-ui-blocks` to the registries in components.json with the key as an `Authorization: Bearer` header. Setup: https://www.shadcn-ui-blocks.com/docs/shadcn-cli. The MCP server installs it without the setup: https://www.shadcn-ui-blocks.com/docs/mcp.

## Depends on

- npm packages: class-variance-authority, lucide-react, radix-ui
- shadcn/ui components: avatars, badge, button
- Installs to: `@/components/blocks/application-pro/comments-annotations/video-timestamp-comments`

## About this block

Video Timestamp Comments is the Frame.io-style media review
surface: a Launch teaser v2 player strip with a scrubber,
avatar markers pinned at the frames they reference, a
playhead with a progress fill and a time readout, and a list
of time-anchored notes below. Maya Chen wants the logo hold
trimmed at 0:12, Jordan Lee (the active note) asks for take
3 at 0:38, Noah Park catches a caption mismatch at 1:04, and
Priya Nair confirms a fix at 1:21 that Maya Chen has already
marked done.

Comments are one typed array positioned on the timeline with
percentage offsets so each avatar marker lines up with its
frame. The state flag steers three branches: open notes show
Reply and Mark done, the active note tints its row, and done
notes dim, name who closed them, and offer Reopen. The footer
note explains that clicking a timestamp jumps the playhead
and that markers stay attached to the same frame across a new
cut.

## When to use

Reach for this block as the review layer of any video or
audio tool, wired to your comment endpoint and player
current time. Bind each timestamp button to a seek call and
Mark done to your thread-close mutation.

A natural flow around it on an Application Pro page:

**Before**

- [Media gallery](https://www.shadcn-ui-blocks.com/blocks/application-pro/media-gallery)

**After**

- [Comment sidebar](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations)
- [Resolved comments list](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations)

## What you can display

One strong use is the launch teaser review. Other timestamped
surfaces:

- **Podcast edit notes.** Audio markers with producer notes
  on the segments to cut.
- **Course feedback.** Lesson video markers with reviewer
  notes on the slides to rerecord.
- **Call review.** A recorded demo with markers on the
  moments a coach wants to discuss.

> Tip: the seek-on-click timestamp is what makes the note
> actionable, keep every marker bound to a real frame so a
> reviewer lands exactly where the comment applies.

## More in Application Comments and Annotations

- [Annotation Layers Rail](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/annotation-layers-rail)
- [Annotation Toolbar Blueprint](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/annotation-toolbar-blueprint)
- [Canvas Pin Comments](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/canvas-pin-comments)
- [Code Review Thread](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/code-review-thread)
- [Comment Assignments](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/comment-assignments)
- [Comment Composer](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/comment-composer)
- [Comment Notification Inbox](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/comment-notification-inbox)
- [Comment Sidebar](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/comment-sidebar)
- [Inline Annotation Thread](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/inline-annotation-thread)
- [Mention Picker Blueprint](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/mention-picker-blueprint)
- [Outdated Comments Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/outdated-comments-panel)
- [Pending Review Tray](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/pending-review-tray)
- [Reaction Bar](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/reaction-bar)
- [Resolved Comments List](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/resolved-comments-list)
- [Spreadsheet Cell Comments](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/spreadsheet-cell-comments)
- [Suggestion Review Row](https://www.shadcn-ui-blocks.com/blocks/application-pro/comments-annotations/suggestion-review-row)
