MPV Timestamp Navigator

A small MPV Lua script that lets you paste a list of timestamps into the MPV console (~) during playback, then jump between them with hotkeys. Supports multiple timestamp formats, sorting, and a global jump offset.

---

Features

• Paste timestamps during playback via MPV console (~)
• Timestamp separators: spaces, commas, or newlines
• Automatically sorts timestamps in ascending order
• Jump to next / previous timestamp (no wrap; if past the last timestamp, “next” does nothing)
• OSD messages when jumping
• List all timestamps on screen with the active one highlighted
• Global jump offset adjustable in ±0.25s steps (jump slightly before/after your cues)
• Timestamp formats supported:
  • mm:ss (e.g., 00:45)
  • seconds.decimal (e.g., 104.756)
  • raw milliseconds (e.g., 260223 → interpreted as 260.223 seconds)

Note: You said you won’t mix formats within a single pasted list — that’s perfect.

---

Install

1) Put the script in the MPV scripts folder

Name the file exactly: timestamp_navigator.lua

macOS / Linux

• Script: ~/.config/mpv/scripts/timestamp_navigator.lua

Create folders if needed:

mkdir -p ~/.config/mpv/scripts