AddThisFeature

Audio Chapter Markers

Break a long recording into named chapters listeners can see and jump between.

moderate User Experience

What it adds

Named, timestamped chapters on long audio or video, shown in a list and on the scrubber, each addressable by its own link.

What your agent is told to do

5
  1. 1

    Store chapters as an ordered list of start times and titles attached to the existing media record, and render them both as a list beside the player and as markers on the scrubber.

  2. 2

    Let an author add, rename, reorder by moving start times, and delete chapters in the player itself, with the current playback position offered as the default start time for a new chapter.

  3. 3

    If chapters are generated automatically, treat the generated set as a first draft. The author's edits must win and must survive the next generation run.

  4. 4

    Make each chapter linkable through the app's existing shareable deep link mechanism, so opening the link starts playback at that chapter rather than at the beginning.

  5. 5

    Do not build a separate chapter editing screen away from the player. Editing a boundary without hearing what is at that boundary produces chapters that start one sentence late.

Edge cases it handles

8
  • Authors must be able to override both generated titles and generated boundaries. Automatic segmentation reliably names a chapter after the first thing said in it, which is often the end of the previous topic.
  • Chapters only a few seconds long turn the scrubber into a picket fence. Enforce a minimum duration, and either merge or refuse to display markers that would collide at the current scrubber width.
  • Re-encoding or trimming the media invalidates absolute marker positions. Detect that the source duration changed, and either remap the markers or flag them as needing review rather than silently seeking to the wrong place.
  • Each chapter needs a deep link that starts playback at that point, and that link must still land somewhere sensible if the chapter has since been deleted.
  • A recording with a single chapter should render as an ordinary recording with no chapter list, not as a list with one entry and an empty scrubber.
  • Chapter titles travel further than the player: they land in the episode description and in any feed the audio is syndicated to, where the app cannot edit them afterwards. Limit their length so they do not overflow the scrubber, and screen them before the recording is published.
  • A chapter start time beyond the end of the media, or two chapters starting at the same second, must be rejected at save time with a clear message.
  • The chapter list must be keyboard navigable and announce the current chapter, and marker positions must not be the only indication of where a chapter begins.

Definition of done

9
  • Chapters appear as a list beside the player and as markers on the scrubber.
  • Authors can add, rename, and delete chapters from the player, with the current position as the default start.
  • Author edits survive a regeneration of automatic chapters.
  • Each chapter has a deep link that starts playback at its start time.
  • Chapters below the minimum duration are prevented, and overlapping or out-of-range start times are rejected on save.
  • A single-chapter recording renders without chapter chrome.
  • The chapter list is keyboard navigable and announces the active chapter.
  • The feature matches the existing design system.
  • No existing functionality is broken.

Related features

How it works

  1. 1

    Copy the link

    Grab the Markdown instruction URL for this feature.

  2. 2

    Give it to your AI

    Paste it into Claude Code, Cursor, v0, Lovable — whatever you build with.

  3. 3

    It inspects, then implements

    Your agent reads your existing app first, then adds the feature to fit it.

Works with your stack

These instructions are written to adapt. They tell the agent to detect your framework, match your existing design system, and reuse what you already have — rather than assuming a particular stack.

Need it tighter than that? Customize the feature and tell it exactly what you're running.