@vestra-player/sdk 1.6.15 → 1.6.17

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 1.6.17
+
+**Who must change: nobody.** Tables follow the slim context menu (B5): a data refresh of `BUILTIN_COMMANDS`, `BUILTIN_SUBMENUS` and the test host's core commands for the player's right-click menu (player 0.7.6); no API change, `apiVersion` stays `vestra/1`. A plugin whose tests compare a path or a key against the tables sees the player's current ones.
+
+- **`BUILTIN_COMMANDS`**: the top level is now Open File…, Open ▸, Close — **Play/Pause** (`host/play-pause`, from Playback ▸), Audio Track ▸, Subtitle Track ▸, **Snapshot ▸** (`vestra.capture`, from Video ▸) — Picture…, Audio…, Subtitles…, Playback…, Playlist, **Chapter and Bookmark List…** (`vestra.marks`, from Playback ▸ Chapters and Bookmarks ▸) — Toggle Fullscreen — Vestra Player AI…, Plugin Store… — **Command Palette…** (`host/palette`, in the menu now, with an ellipsis; `Ctrl+Shift+P` unchanged), **Options…** (`vestra.preferences`, from Settings ▸), About Vestra Player… — Quit. Open ▸ gains **Search and Download Subtitles…** (`vestra.subtitle-online`, from Subtitles ▸ Online Subtitles ▸). Everything else left the menu for the command palette, with ids, keys and categories unchanged: the player's Previous and Next (PageUp, PageDown, the side mouse buttons), Volume +, Volume − and Mute (the Audio panel has their controls); the playback plugin's Reopen, Copy to Clipboard ▸, Disable Screen Saver and the seek-bar hover items; the window plugin's Hide Pointer and the whole Screen ▸ menu; Playback ▸ Playlist ▸; Resume Playback ▸; the marks plugin's bookmark, chapter and A-B Loop items; Online Subtitle Settings…; the visualizer's Show Album Cover, Show Logo When Idle, Choose Logo Image… and Reset ▸ Idle Logo; Keyboard Shortcuts…, Mouse… and Ignore Default Shortcuts; Appearance ▸ and Language ▸; Playback Info, Playback Properties… and Check for Updates…. The table in [Reference: commands](docs/reference/commands.md) follows, with the new top level, its groups and orders (Toggle Fullscreen 810, Command Palette… 829).
+- **`BUILTIN_SUBMENUS`**: Open ▸ Recently Played, Audio Track, Subtitle Track and Snapshot (a top-level submenu now) remain; the Playback, Subtitles, Screen and Settings submenus and Copy to Clipboard are gone. The built-in menus (`@playback`, `@subtitles`, `@video`, `@audio`, `@screen`, `@settings`, `@reset`) stay valid for plugins at their fixed orders and are shown only while a command is in them.
+- **`TestHost`**: the core commands carry the player's menu places: Play/Pause at the top level (`["Play/Pause"]`, order 201), Previous, Next, the volume steps and Mute outside the menu, and the seek, frame and speed actions outside the menu as the player has had them since 1.6.15 (the test host kept their Playback ▸ Seek and Speed paths until now). A plugin item at `["Playback", "Seek", …]`, `["@playback", "Speed"]` or `["Audio", …]` is therefore accepted, as the player accepts it (1.5.48 listed `Playback ▸ Speed` as an item and `Audio ▸ Mute ▸ …` as conflicts: they were, while the player's items were there); `["Play/Pause"]`, `["Close"]` and an item below either are conflicts.
+
+## 1.6.16
+
+**Who must change: nobody.** A data refresh for the player's four built-in panels (player 0.7.6) and one additive read; no API is removed, `apiVersion` stays `vestra/1`.
+
+- **`BUILTIN_COMMANDS`**: the Picture, Audio, Subtitles and Playback panels open from four top-level items, **Picture…** (`vestra.video`, `video.picture`, Alt+1), **Audio…** (`audio.workbench`, Alt+2), **Subtitles…** (`tune`, Alt+3) and **Playback…** (`vestra.playback`, `panel`, Alt+4), next to Playlist. The commands their panels hold left the menus for the command palette, with their keys and categories: Video's Pixel Shaders, Deinterlace, Aspect, Crop/Stretch, Framing, Image Processing and Rotation, the picture steps and GPU Rendering; Audio's track, channel, equalizer, preset, sync and processing items; Subtitles' show, style, secondary subtitle, sync and reload items; the playback plugin's seek steps, keyframes, Jump to Time… and speeds; the Reset items of the video, audio and subtitles plugins (the visualizer's Reset ▸ Idle Logo stays). **Subtitle Track ▸ Off** and **Audio Track ▸ No Audio Tracks** are now top-level submenus. New palette commands: Remove External Subtitle (`vestra.subtitles`, `remove`) and Picture Panel (`video.resetPanel`, a reset of the panel's values). Audio ▸ Output Device ▸ No Output Devices (`audio.device.none`) is gone.
+- **`BUILTIN_SUBMENUS`**: the Video, Audio and Subtitles submenus of these plugins are gone; **Subtitle Track** (`vestra.subtitles`) and **Audio Track** (`vestra.audio`) are new, at the top level. Online Subtitles and Snapshot stay.
+- **`plugin.commands.keys("host/<id>")`** reads the keys of the player's own commands (`host/volume-up`, `host/mute`, the ids of the `host` rows of `BUILTIN_COMMANDS`), read-only and current like a plugin's own, so a panel can show the player's key caps beside its controls; `onKeysChange` fires for their changes too. The `commands.keys` answer and event carry them as `host/<id>` entries (a local id has no `/`); player 0.7.6, like `keys` itself. A side effect: rebinding one of the player's own commands now sends `commands.keys` to every plugin listening for it, and a listener in standby is started for it (as for a change to its own keys); `onKeysChange` still fires only when a label the plugin can read changed.
+- **`TestHost`**: `commands.keys` answers the core commands as `host/<id>` too, and `rebind` takes a core command's `host/<id>`.
+
 ## 1.6.15
 
 **Who must change: nobody.** A plugin may now mount one panel per slot (player 0.7.6) instead of one panel in all; plugins with one panel work as before, and `apiVersion` stays `vestra/1`.

package/dist/commands.d.ts

@@ -208,10 +208,10 @@ export interface BuiltinSubmenu {
  * built-in plugins declare.
  *
  * @example Add an item to the built-in Snapshot submenu
- * "Copy Snapshot" appears in Video ▸ Snapshot next to the built-in capture
+ * "Copy Snapshot" appears in Snapshot ▸ next to the built-in capture
  * plugin's items. Paths merge by their English keys, so a command whose
- * path continues with the submenu's keys (`["Video", "Snapshot"]`, the menu
- * written as `@video`) lands in the same submenu whatever the interface
+ * path starts with the submenu's keys (`["Snapshot"]`, a top-level submenu
+ * since player 0.7.6) lands in the same submenu whatever the interface
  * language.
  * ```ts
  * import type { Plugin } from "@vestra-player/sdk";
@@ -223,8 +223,8 @@ export interface BuiltinSubmenu {
  * const snapshot = BUILTIN_SUBMENUS.find((menu) => menu.path.at(-1) === "Snapshot")!;
  * plugin.commands.add({
  *   id: "snapshot-to-clipboard",
- *   // ["@video", "Snapshot", "Copy Snapshot"]; @video stands for "Video".
- *   path: ["@video", ...snapshot.path.slice(1), "Copy Snapshot"],
+ *   // ["Snapshot", "Copy Snapshot"]
+ *   path: [...snapshot.path, "Copy Snapshot"],
  *   run: copySnapshot,
  * });
  * ```
@@ -348,8 +348,9 @@ export type CommandDeclaration = {
 };
 /**
  * `commands.keys` (player 0.7.6): each of the plugin's own commands, by
- * local id, with the labels of its current keys; the answer to the request
- * and the data of the event of that name.
+ * local id, and (SDK 1.6.16) each of the player's own as `host/<id>`, with
+ * the labels of its current keys; the answer to the request and the data of
+ * the event of that name.
  */
 export type CommandKeys = {
     keys: Record<string, string[]>;

package/dist/commands.js

@@ -234,10 +234,10 @@ export const BAR_BUTTON_LIMITS = {
  * built-in plugins declare.
  *
  * @example Add an item to the built-in Snapshot submenu
- * "Copy Snapshot" appears in Video ▸ Snapshot next to the built-in capture
+ * "Copy Snapshot" appears in Snapshot ▸ next to the built-in capture
  * plugin's items. Paths merge by their English keys, so a command whose
- * path continues with the submenu's keys (`["Video", "Snapshot"]`, the menu
- * written as `@video`) lands in the same submenu whatever the interface
+ * path starts with the submenu's keys (`["Snapshot"]`, a top-level submenu
+ * since player 0.7.6) lands in the same submenu whatever the interface
  * language.
  * ```ts
  * import type { Plugin } from "@vestra-player/sdk";
@@ -249,8 +249,8 @@ export const BAR_BUTTON_LIMITS = {
  * const snapshot = BUILTIN_SUBMENUS.find((menu) => menu.path.at(-1) === "Snapshot")!;
  * plugin.commands.add({
  *   id: "snapshot-to-clipboard",
- *   // ["@video", "Snapshot", "Copy Snapshot"]; @video stands for "Video".
- *   path: ["@video", ...snapshot.path.slice(1), "Copy Snapshot"],
+ *   // ["Snapshot", "Copy Snapshot"]
+ *   path: [...snapshot.path, "Copy Snapshot"],
  *   run: copySnapshot,
  * });
  * ```
@@ -261,54 +261,9 @@ export const BAR_BUTTON_LIMITS = {
  */
 export const BUILTIN_SUBMENUS = Object.freeze([
     { path: ["Open", "Recently Played"], plugins: ["vestra.history"] },
-    { path: ["Playback", "A-B Loop"], plugins: ["vestra.marks"] },
-    { path: ["Playback", "A-B Loop", "Loop Count"], plugins: ["vestra.marks"] },
-    { path: ["Playback", "Chapters and Bookmarks"], plugins: ["vestra.marks"] },
-    { path: ["Playback", "Playlist"], plugins: ["vestra.playlist"] },
-    { path: ["Playback", "Playlist", "Repeat"], plugins: ["vestra.playlist"] },
-    {
-        path: ["Playback", "Playlist", "When Opening a File"],
-        plugins: ["vestra.playlist"],
-    },
-    { path: ["Playback", "Resume Playback"], plugins: ["vestra.history"] },
-    {
-        path: ["Subtitles", "Online Subtitles"],
-        plugins: ["vestra.subtitle-online"],
-    },
-    { path: ["Subtitles", "Secondary Subtitle"], plugins: ["vestra.subtitles"] },
-    {
-        path: ["Subtitles", "Secondary Subtitle", "Position"],
-        plugins: ["vestra.subtitles"],
-    },
-    { path: ["Subtitles", "Subtitle Style"], plugins: ["vestra.subtitles"] },
-    { path: ["Subtitles", "Subtitle Track"], plugins: ["vestra.subtitles"] },
-    { path: ["Subtitles", "Sync"], plugins: ["vestra.subtitles"] },
-    { path: ["Video", "Aspect"], plugins: ["vestra.video"] },
-    { path: ["Video", "Crop/Stretch"], plugins: ["vestra.video"] },
-    { path: ["Video", "Deinterlace"], plugins: ["vestra.video"] },
-    { path: ["Video", "Deinterlace", "Output"], plugins: ["vestra.video"] },
-    { path: ["Video", "Framing"], plugins: ["vestra.video"] },
-    { path: ["Video", "Image Processing"], plugins: ["vestra.video"] },
-    { path: ["Video", "Pixel Shaders"], plugins: ["vestra.video"] },
-    {
-        path: ["Video", "Pixel Shaders", "HDR Tone Mapping"],
-        plugins: ["vestra.video"],
-    },
-    { path: ["Video", "Rotation"], plugins: ["vestra.video"] },
-    { path: ["Video", "Snapshot"], plugins: ["vestra.capture"] },
-    { path: ["Audio", "Audio Sync"], plugins: ["vestra.audio"] },
-    { path: ["Audio", "Audio Track"], plugins: ["vestra.audio"] },
-    { path: ["Audio", "Output Device"], plugins: ["vestra.audio"] },
-    { path: ["Audio", "Preset"], plugins: ["vestra.audio"] },
-    { path: ["Audio", "Processing"], plugins: ["vestra.audio"] },
-    { path: ["Screen", "Always on Top"], plugins: ["vestra.window"] },
-    { path: ["Screen", "When Playback Starts"], plugins: ["vestra.window"] },
-    {
-        path: ["Settings", "Appearance"],
-        plugins: ["vestra.preferences", "vestra.visualizer"],
-    },
-    { path: ["Settings", "Language"], plugins: ["vestra.preferences"] },
-    { path: ["Copy to Clipboard"], plugins: ["vestra.playback"] },
+    { path: ["Audio Track"], plugins: ["vestra.audio"] },
+    { path: ["Subtitle Track"], plugins: ["vestra.subtitles"] },
+    { path: ["Snapshot"], plugins: ["vestra.capture"] },
 ]);
 /** owner | id | key path, or (title) outside the menu | bindings | panel */
 const BUILTIN_COMMAND_TABLE = `
@@ -316,277 +271,44 @@ vestra.playback | open | Open File… | Ctrl+O, F3
 vestra.playback | open-url | Open ▸ Open URL… | Ctrl+U
 vestra.playlist | playlist.open-folder | Open ▸ Open Folder… | F2
 vestra.subtitles | load | Open ▸ Open Subtitle… | Alt+O
+vestra.subtitles | load-secondary | Open ▸ Add Secondary Subtitle…
 vestra.audio | audio.load | Open ▸ Load External Audio…
+vestra.subtitle-online | search | Open ▸ Search and Download Subtitles…
 vestra.history | recent.empty | Open ▸ Recently Played ▸ (No Entries)
 vestra.history | recent.prune | Open ▸ Recently Played ▸ Remove Invalid Entries
 vestra.history | recent.clear | Open ▸ Recently Played ▸ Clear Entries
 vestra.history | recent.enabled | Open ▸ Recently Played ▸ Record Playback History
-vestra.subtitles | load-secondary | Open ▸ Add Secondary Subtitle…
 host | stop | Close | F4
-vestra.playback | reopen | Reopen Current/Last File | Ctrl+Y
-vestra.playback | copy-name | Copy to Clipboard ▸ File Name
-vestra.playback | copy-folder | Copy to Clipboard ▸ Folder Path
-vestra.playback | copy-path | Copy to Clipboard ▸ Full Path
-host | play-pause | Playback ▸ Play/Pause | Space, Mouse:LeftClick
-host | previous | Playback ▸ Previous | PageUp, Mouse:X2
-host | next | Playback ▸ Next | PageDown, Mouse:X1
-vestra.playback | keyframe-back | Playback ▸ Seek ▸ Previous Keyframe | Ctrl+Shift+ArrowLeft
-vestra.playback | keyframe-forward | Playback ▸ Seek ▸ Next Keyframe | Ctrl+Shift+ArrowRight
-vestra.playback | backward-2 | Playback ▸ Seek ▸ Back 30 s | Ctrl+ArrowLeft
-vestra.playback | forward-2 | Playback ▸ Seek ▸ Forward 30 s | Ctrl+ArrowRight
-vestra.playback | backward-3 | Playback ▸ Seek ▸ Back 60 s | Shift+ArrowLeft
-vestra.playback | forward-3 | Playback ▸ Seek ▸ Forward 60 s | Shift+ArrowRight
-vestra.playback | backward-4 | Playback ▸ Seek ▸ Back 300 s | Ctrl+Alt+ArrowLeft
-vestra.playback | forward-4 | Playback ▸ Seek ▸ Forward 300 s | Ctrl+Alt+ArrowRight
-vestra.subtitles | dialogue-previous | Playback ▸ Seek ▸ Previous Dialogue | Home
-vestra.subtitles | dialogue-next | Playback ▸ Seek ▸ Next Dialogue | End
-vestra.subtitles | dialogue-current | Playback ▸ Seek ▸ Current Subtitle Start | Ctrl+Home
-vestra.playback | jump-start | Playback ▸ Seek ▸ Jump to Start | Backspace
-vestra.playback | time-jump | Playback ▸ Seek ▸ Seek Steps…
-vestra.playback | jump | Playback ▸ Jump to Time… | G
-vestra.playback | rate-05 | Playback ▸ Speed ▸ 0.5×
-vestra.playback | rate-15 | Playback ▸ Speed ▸ 1.5×
-vestra.playback | rate-20 | Playback ▸ Speed ▸ 2×
-vestra.playback | rate-custom | Playback ▸ Speed ▸ Custom…
-vestra.playlist | playlist.add | Playback ▸ Playlist ▸ Add Files…
-vestra.playlist | playlist.link | Playback ▸ Playlist ▸ Add Link…
-vestra.playlist | playlist.add-folder | Playback ▸ Playlist ▸ Add Folder…
-vestra.playlist | playlist.repeat-none | Playback ▸ Playlist ▸ Repeat ▸ Off
-vestra.playlist | playlist.repeat-all | Playback ▸ Playlist ▸ Repeat ▸ All
-vestra.playlist | playlist.repeat-one | Playback ▸ Playlist ▸ Repeat ▸ One
-vestra.playlist | playlist.shuffle | Playback ▸ Playlist ▸ Shuffle
-vestra.playlist | playlist.open-list | Playback ▸ Playlist ▸ Open List File…
-vestra.playlist | playlist.save-list | Playback ▸ Playlist ▸ Save List…
-vestra.playlist | playlist.open-mode-only | Playback ▸ Playlist ▸ When Opening a File ▸ Open Only That File
-vestra.playlist | playlist.open-mode-similar | Playback ▸ Playlist ▸ When Opening a File ▸ Add Similar Files
-vestra.playlist | playlist.open-mode-folder | Playback ▸ Playlist ▸ When Opening a File ▸ Add All Files in the Folder
-vestra.playlist | playlist.fast-advance | Playback ▸ Playlist ▸ Fast Advance to Next
-vestra.playlist | playlist.remember | Playback ▸ Playlist ▸ Remember List
-vestra.playlist | playlist.confirm-clear | Playback ▸ Playlist ▸ Confirm Before Removing All
-vestra.playback | prevent-sleep | Playback ▸ Disable Screen Saver While Playing
-vestra.window | hide-cursor | Playback ▸ Hide Pointer While Playing
-vestra.playback | hover-time | Playback ▸ Show Time on Seek Bar Hover
-vestra.playback | hover-thumbnail | Playback ▸ Show Thumbnail on Seek Bar Hover
-vestra.history | resume.off | Playback ▸ Resume Playback ▸ Don't Resume
-vestra.history | resume.auto | Playback ▸ Resume Playback ▸ Resume Automatically
-vestra.history | resume.ask | Playback ▸ Resume Playback ▸ Ask Every Time
-vestra.history | resume.audio | Playback ▸ Resume Playback ▸ Also Remember Audio Files
-vestra.history | resume.clear | Playback ▸ Resume Playback ▸ Clear All Saved Positions
-vestra.marks | marks.list | Playback ▸ Chapters and Bookmarks ▸ Chapter and Bookmark List… | H
-vestra.marks | marks.add | Playback ▸ Chapters and Bookmarks ▸ Add Bookmark | P
-vestra.marks | marks.previous | Playback ▸ Chapters and Bookmarks ▸ Previous Bookmark or Chapter | Shift+PageUp
-vestra.marks | marks.next | Playback ▸ Chapters and Bookmarks ▸ Next Bookmark or Chapter | Shift+PageDown
-vestra.marks | marks.previous-chapter | Playback ▸ Chapters and Bookmarks ▸ Previous Chapter | Ctrl+PageUp
-vestra.marks | marks.next-chapter | Playback ▸ Chapters and Bookmarks ▸ Next Chapter | Ctrl+PageDown
-vestra.marks | marks.seekbar | Playback ▸ Chapters and Bookmarks ▸ Show Marks on Seek Bar
-vestra.marks | ab.set-a | Playback ▸ A-B Loop ▸ Set Start Point | [
-vestra.marks | ab.clear-a | Playback ▸ A-B Loop ▸ Clear Start Point | {
-vestra.marks | ab.a-back | Playback ▸ A-B Loop ▸ Start Point Back 0.1 s | Ctrl+[
-vestra.marks | ab.a-forward | Playback ▸ A-B Loop ▸ Start Point Forward 0.1 s | Alt+[
-vestra.marks | ab.set-b | Playback ▸ A-B Loop ▸ Set End Point | ]
-vestra.marks | ab.clear-b | Playback ▸ A-B Loop ▸ Clear End Point | }
-vestra.marks | ab.b-back | Playback ▸ A-B Loop ▸ End Point Back 0.1 s | Ctrl+]
-vestra.marks | ab.b-forward | Playback ▸ A-B Loop ▸ End Point Forward 0.1 s | Alt+]
-vestra.marks | ab.back | Playback ▸ A-B Loop ▸ Move Range Back 0.1 s | Ctrl+Alt+[
-vestra.marks | ab.forward | Playback ▸ A-B Loop ▸ Move Range Forward 0.1 s | Ctrl+Alt+]
-vestra.marks | ab.segment | Playback ▸ A-B Loop ▸ Loop Current Chapter or Bookmark Range | Alt+\\
-vestra.marks | ab.toggle | Playback ▸ A-B Loop ▸ A-B Loop On/Off | \\
-vestra.marks | ab.count.endless | Playback ▸ A-B Loop ▸ Loop Count ▸ Endless
-vestra.marks | ab.count.1 | Playback ▸ A-B Loop ▸ Loop Count ▸ Once
-vestra.marks | ab.count.2 | Playback ▸ A-B Loop ▸ Loop Count ▸ 2 Times
-vestra.marks | ab.count.3 | Playback ▸ A-B Loop ▸ Loop Count ▸ 3 Times
-vestra.marks | ab.count.5 | Playback ▸ A-B Loop ▸ Loop Count ▸ 5 Times
-vestra.marks | ab.count.10 | Playback ▸ A-B Loop ▸ Loop Count ▸ 10 Times
-vestra.subtitles | show | Subtitles ▸ Show Subtitles | Alt+H
-vestra.subtitles | track-off | Subtitles ▸ Subtitle Track ▸ Off
-vestra.subtitles | track-cycle | Subtitles ▸ Subtitle Track ▸ Cycle | Alt+L
-vestra.subtitles | second-off | Subtitles ▸ Secondary Subtitle ▸ Off
-vestra.subtitles | second-position-top | Subtitles ▸ Secondary Subtitle ▸ Position ▸ Top
-vestra.subtitles | second-position-aboveMain | Subtitles ▸ Secondary Subtitle ▸ Position ▸ Above Main Subtitle
-vestra.subtitles | bold | Subtitles ▸ Subtitle Style ▸ Bold | Alt+B
-vestra.subtitles | size-up | Subtitles ▸ Subtitle Style ▸ Size + | Alt+PageUp
-vestra.subtitles | size-down | Subtitles ▸ Subtitle Style ▸ Size − | Alt+PageDown
-vestra.subtitles | move-up | Subtitles ▸ Subtitle Style ▸ Move Up
-vestra.subtitles | move-down | Subtitles ▸ Subtitle Style ▸ Move Down
-vestra.subtitles | shadow | Subtitles ▸ Subtitle Style ▸ Shadow
-vestra.subtitles | box | Subtitles ▸ Subtitle Style ▸ Opaque Box
-vestra.subtitles | ass-original | Subtitles ▸ Original ASS/SSA Styles
-vestra.subtitles | sync-earlier | Subtitles ▸ Sync ▸ Earlier 0.5 s | .
-vestra.subtitles | sync-later | Subtitles ▸ Sync ▸ Later 0.5 s | ,
-vestra.subtitles | sync-input | Subtitles ▸ Sync ▸ Adjust Sync…
-vestra.subtitle-online | search | Subtitles ▸ Online Subtitles ▸ Search and Download Subtitles…
-vestra.subtitle-online | settings | Subtitles ▸ Online Subtitles ▸ Online Subtitle Settings…
-vestra.subtitles | reload | Subtitles ▸ Reload Subtitles | Ctrl+Alt+Y
-vestra.subtitles | refresh | Subtitles ▸ Refresh Subtitle Tracks
-vestra.subtitles | tune | Subtitles ▸ Subtitle Tuning…
-vestra.subtitles | settings | Subtitles ▸ Subtitle Settings…
-vestra.video | video.shader.use | Video ▸ Pixel Shaders ▸ Use Shaders | Shift+P
-vestra.video | video.shader.list | Video ▸ Pixel Shaders ▸ Shader List…
-vestra.video | video.shader.folder | Video ▸ Pixel Shaders ▸ Open Shader Folder
-vestra.video | video.shader.reload | Video ▸ Pixel Shaders ▸ Reload Shaders
-vestra.video | video.hdr.auto | Video ▸ Pixel Shaders ▸ HDR Tone Mapping ▸ Auto
-vestra.video | video.hdr.off | Video ▸ Pixel Shaders ▸ HDR Tone Mapping ▸ Off
-vestra.video | video.hdr.bt.2390 | Video ▸ Pixel Shaders ▸ HDR Tone Mapping ▸ BT.2390
-vestra.video | video.hdr.hable | Video ▸ Pixel Shaders ▸ HDR Tone Mapping ▸ Hable
-vestra.video | video.hdr.mobius | Video ▸ Pixel Shaders ▸ HDR Tone Mapping ▸ Mobius
-vestra.video | video.hdr.reinhard | Video ▸ Pixel Shaders ▸ HDR Tone Mapping ▸ Reinhard
-vestra.video | video.hdr.clip | Video ▸ Pixel Shaders ▸ HDR Tone Mapping ▸ Clip
-vestra.video | video.hdr.peak | Video ▸ Pixel Shaders ▸ HDR Tone Mapping ▸ Dynamic Peak Detection
-vestra.video | video.hdr.settings | Video ▸ Pixel Shaders ▸ HDR Settings…
-vestra.video | video.deinterlace.cycle | Video ▸ Deinterlace ▸ Cycle | Ctrl+I
-vestra.video | video.deinterlace.auto | Video ▸ Deinterlace ▸ Auto
-vestra.video | video.deinterlace.on | Video ▸ Deinterlace ▸ Always
-vestra.video | video.deinterlace.off | Video ▸ Deinterlace ▸ Never
-vestra.video | video.deinterlace.output.frame | Video ▸ Deinterlace ▸ Output ▸ By Frame
-vestra.video | video.deinterlace.output.field | Video ▸ Deinterlace ▸ Output ▸ By Field (Double Rate)
-vestra.video | video.fit.keep | Video ▸ Aspect ▸ Keep Aspect Ratio
-vestra.video | video.fit.stretch | Video ▸ Aspect ▸ Ignore Aspect Ratio
-vestra.video | video.fit.fill | Video ▸ Aspect ▸ Fill Window (Crop Excess)
-vestra.video | video.aspect.cycle | Video ▸ Aspect ▸ Cycle Aspect Ratio | Shift+F6
-vestra.video | video.aspect.default | Video ▸ Aspect ▸ Default (Source)
-vestra.video | video.aspect.0 | Video ▸ Aspect ▸ 4:3
-vestra.video | video.aspect.1 | Video ▸ Aspect ▸ 16:9
-vestra.video | video.aspect.2 | Video ▸ Aspect ▸ 16:10
-vestra.video | video.aspect.3 | Video ▸ Aspect ▸ 1.85:1
-vestra.video | video.aspect.4 | Video ▸ Aspect ▸ 2.35:1
-vestra.video | video.aspect.custom | Video ▸ Aspect ▸ Custom (x:y)
-vestra.video | video.aspect.edit | Video ▸ Aspect ▸ Custom Aspect Ratio…
-vestra.video | video.reframe.none | Video ▸ Crop/Stretch ▸ None
-vestra.video | video.reframe.pad.0 | Video ▸ Crop/Stretch ▸ Stretch to 4:3
-vestra.video | video.reframe.pad.1 | Video ▸ Crop/Stretch ▸ Stretch to 16:9
-vestra.video | video.reframe.pad.2 | Video ▸ Crop/Stretch ▸ Stretch to 16:10
-vestra.video | video.reframe.pad.3 | Video ▸ Crop/Stretch ▸ Stretch to 1.85:1
-vestra.video | video.reframe.pad.4 | Video ▸ Crop/Stretch ▸ Stretch to 2.35:1
-vestra.video | video.reframe.crop.0 | Video ▸ Crop/Stretch ▸ Crop to 4:3
-vestra.video | video.reframe.crop.1 | Video ▸ Crop/Stretch ▸ Crop to 16:9
-vestra.video | video.reframe.crop.2 | Video ▸ Crop/Stretch ▸ Crop to 16:10
-vestra.video | video.reframe.crop.3 | Video ▸ Crop/Stretch ▸ Crop to 1.85:1
-vestra.video | video.reframe.crop.4 | Video ▸ Crop/Stretch ▸ Crop to 2.35:1
-vestra.video | video.reframe.left | Video ▸ Crop/Stretch ▸ Move Left
-vestra.video | video.reframe.right | Video ▸ Crop/Stretch ▸ Move Right
-vestra.video | video.reframe.up | Video ▸ Crop/Stretch ▸ Move Up
-vestra.video | video.reframe.down | Video ▸ Crop/Stretch ▸ Move Down
-vestra.video | video.frame.zoom-in | Video ▸ Framing ▸ Zoom In | Numpad9, Alt+Plus
-vestra.video | video.frame.zoom-out | Video ▸ Framing ▸ Zoom Out | Numpad1, Alt+-
-vestra.video | video.frame.right | Video ▸ Framing ▸ Pan → | Ctrl+Numpad6, Alt+ArrowRight
-vestra.video | video.frame.left | Video ▸ Framing ▸ Pan ← | Ctrl+Numpad4, Alt+ArrowLeft
-vestra.video | video.frame.up | Video ▸ Framing ▸ Pan ↑ | Ctrl+Numpad8, Alt+ArrowUp
-vestra.video | video.frame.down | Video ▸ Framing ▸ Pan ↓ | Ctrl+Numpad2, Alt+ArrowDown
-vestra.video | video.frame.centre | Video ▸ Framing ▸ Center Frame | Ctrl+Numpad5
-vestra.video | video.flip.vertical | Video ▸ Image Processing ▸ Flip Vertically | Ctrl+P
-vestra.video | video.flip.horizontal | Video ▸ Image Processing ▸ Flip Horizontally | Ctrl+Z
-vestra.video | video.gaussian | Video ▸ Image Processing ▸ Gaussian Blur | Ctrl+B
-vestra.video | video.sharpen | Video ▸ Image Processing ▸ Sharpen | Ctrl+R
-vestra.video | video.edge | Video ▸ Image Processing ▸ Edge Sharpen
-vestra.video | video.deblock | Video ▸ Image Processing ▸ Deblock | Ctrl+H
-vestra.video | video.deband | Video ▸ Image Processing ▸ Deband
-vestra.video | video.denoise.d3 | Video ▸ Image Processing ▸ 3D Denoise | Ctrl+N
-vestra.video | video.denoise.gradual | Video ▸ Image Processing ▸ Gradual Denoise
-vestra.video | video.denoise.temporal | Video ▸ Image Processing ▸ Temporal Denoise | Ctrl+M
-vestra.video | video.frame-blend | Video ▸ Image Processing ▸ Frame Doubling
-vestra.video | video.interpolation | Video ▸ Image Processing ▸ Motion Interpolation
-vestra.video | video.rotate.cycle | Video ▸ Rotation ▸ Cycle | Alt+K
-vestra.video | video.rotate.0 | Video ▸ Rotation ▸ No Rotation
-vestra.video | video.rotate.90 | Video ▸ Rotation ▸ 90°
-vestra.video | video.rotate.180 | Video ▸ Rotation ▸ 180°
-vestra.video | video.rotate.270 | Video ▸ Rotation ▸ 270°
-vestra.capture | capture.save | Video ▸ Snapshot ▸ Save Current Frame | Ctrl+E
-vestra.capture | capture.panel | Video ▸ Snapshot ▸ Capture… | Alt+S
-vestra.capture | capture.copy | Video ▸ Snapshot ▸ Copy Current Frame | Ctrl+C
-vestra.capture | capture.burst | Video ▸ Snapshot ▸ Burst… | Ctrl+G
-vestra.capture | capture.clip | Video ▸ Snapshot ▸ Export Clip…
-vestra.video | video.picture | Video ▸ Picture Adjustments…
-vestra.video | video.brightness.down | Video ▸ Brightness -1% | W
-vestra.video | video.brightness.up | Video ▸ Brightness +1% | E
-vestra.video | video.contrast.down | Video ▸ Contrast -1% | R
-vestra.video | video.contrast.up | Video ▸ Contrast +1% | T
-vestra.video | video.saturation.down | Video ▸ Saturation -1% | Y
-vestra.video | video.saturation.up | Video ▸ Saturation +1% | U
-vestra.video | video.hue.down | Video ▸ Hue -1% | I
-vestra.video | video.hue.up | Video ▸ Hue +1% | O
-vestra.video | video.gpu-rendering | Video ▸ GPU Rendering (Experimental)
-host | volume-up | Audio ▸ Volume + | ArrowUp, Mouse:WheelUp
-host | volume-down | Audio ▸ Volume − | ArrowDown, Mouse:WheelDown
-host | mute | Audio ▸ Mute | M
-vestra.audio | audio.workbench | Audio ▸ Audio Workbench…
-vestra.audio | audio.track.none | Audio ▸ Audio Track ▸ No Audio Tracks
-vestra.audio | audio.track.cycle | Audio ▸ Audio Track ▸ Cycle Tracks | Alt+A
-vestra.audio | audio.channels.stereo | Audio ▸ Audio Track ▸ Stereo
-vestra.audio | audio.channels.left | Audio ▸ Audio Track ▸ Left Channel
-vestra.audio | audio.channels.right | Audio ▸ Audio Track ▸ Right Channel
-vestra.audio | audio.channels.mono | Audio ▸ Audio Track ▸ Mono Mix
-vestra.audio | audio.channels.swap | Audio ▸ Audio Track ▸ Swap Left and Right
-vestra.audio | audio.device.none | Audio ▸ Output Device ▸ No Output Devices
-vestra.audio | audio.equalizer | Audio ▸ Equalizer | Shift+E
-vestra.audio | audio.preset.0 | Audio ▸ Preset ▸ Flat
-vestra.audio | audio.preset.1 | Audio ▸ Preset ▸ Voice
-vestra.audio | audio.preset.2 | Audio ▸ Preset ▸ Music
-vestra.audio | audio.preset.3 | Audio ▸ Preset ▸ Cinema
-vestra.audio | audio.sync.earlier | Audio ▸ Audio Sync ▸ 50 ms Earlier | >
-vestra.audio | audio.sync.later | Audio ▸ Audio Sync ▸ 50 ms Later | <
-vestra.audio | audio.sync.keep.none | Audio ▸ Audio Sync ▸ Don't Keep
-vestra.audio | audio.sync.keep.session | Audio ▸ Audio Sync ▸ Keep for This Run
-vestra.audio | audio.sync.keep.always | Audio ▸ Audio Sync ▸ Always Keep
-vestra.audio | audio.normalize | Audio ▸ Processing ▸ Normalize | Shift+N
-vestra.audio | audio.clarity | Audio ▸ Processing ▸ Crystalizer | Shift+C
-vestra.visualizer | audio-cover | Audio ▸ Show Album Cover for Audio Only
-host | fullscreen | Toggle Fullscreen | Escape
-vestra.window | pip | Screen ▸ Picture-in-Picture
-vestra.window | mini | Screen ▸ Mini Size | \`
-vestra.window | size.0.5 | Screen ▸ 0.5× | 1
-vestra.window | size.1 | Screen ▸ 1× | 2
-vestra.window | size.1.5 | Screen ▸ 1.5× | 3
-vestra.window | size.2 | Screen ▸ 2× | 4
-vestra.window | fit | Screen ▸ Fit to Video Aspect Ratio | 8
-vestra.window | auto.off | Screen ▸ When Playback Starts ▸ Don't Resize
-vestra.window | auto.0.5 | Screen ▸ When Playback Starts ▸ 0.5×
-vestra.window | auto.1 | Screen ▸ When Playback Starts ▸ 1×
-vestra.window | auto.1.5 | Screen ▸ When Playback Starts ▸ 1.5×
-vestra.window | auto.2 | Screen ▸ When Playback Starts ▸ 2×
-vestra.window | auto.fit | Screen ▸ When Playback Starts ▸ Fit to Video Aspect Ratio
-vestra.window | auto.once | Screen ▸ When Playback Starts ▸ Only Once
-vestra.window | top.cycle | Screen ▸ Always on Top ▸ Cycle Mode | Ctrl+T
-vestra.window | top.never | Screen ▸ Always on Top ▸ Never
-vestra.window | top.always | Screen ▸ Always on Top ▸ Always
-vestra.window | top.playing | Screen ▸ Always on Top ▸ While Playing
-vestra.window | top.fullscreen | Screen ▸ Always on Top ▸ While Playing in Fullscreen
+host | play-pause | Play/Pause | Space, Mouse:LeftClick
+vestra.audio | audio.track.none | Audio Track ▸ No Audio Tracks
+vestra.subtitles | track-off | Subtitle Track ▸ Off
+vestra.capture | capture.save | Snapshot ▸ Save Current Frame | Ctrl+E
+vestra.capture | capture.copy | Snapshot ▸ Copy Current Frame | Ctrl+C
+vestra.capture | capture.burst | Snapshot ▸ Burst… | Ctrl+G
+vestra.capture | capture.clip | Snapshot ▸ Export Clip…
+vestra.capture | capture.panel | Snapshot ▸ Capture… | Alt+S
+vestra.video | video.picture | Picture… | Alt+1
+vestra.audio | audio.workbench | Audio… | Alt+2
+vestra.subtitles | tune | Subtitles… | Alt+3
+vestra.playback | panel | Playback… | Alt+4
 vestra.playlist | playlist.visibility | Playlist | F6
-vestra.info | info.toggle | Playback Info | Tab
-vestra.info | info.properties | Playback Properties… | Ctrl+F1
+vestra.marks | marks.list | Chapter and Bookmark List… | H
+host | fullscreen | Toggle Fullscreen | Escape
 vestra.workshop | workshop.open | Vestra Player AI…
 vestra.store | open | Plugin Store…
-vestra.preferences | options | Settings ▸ Options… | F5
-vestra.hotkeys | keys | Settings ▸ Keyboard Shortcuts…
-vestra.hotkeys | mouse | Settings ▸ Mouse…
-vestra.hotkeys | ignore-defaults | Settings ▸ Ignore Default Shortcuts
-vestra.preferences | theme.vestra | Settings ▸ Appearance ▸ Vestra Dark
-vestra.preferences | theme.vestra-light | Settings ▸ Appearance ▸ Vestra Light
-vestra.visualizer | idle-logo | Settings ▸ Appearance ▸ Show Logo When Idle
-vestra.visualizer | choose-logo | Settings ▸ Appearance ▸ Choose Logo Image…
-vestra.preferences | language.system | Settings ▸ Language ▸ Follow System
-vestra.preferences | language.en | Settings ▸ Language ▸ English
-vestra.preferences | language.zh-Hans | Settings ▸ Language ▸ 简体中文
-vestra.preferences | language.ja | Settings ▸ Language ▸ 日本語
-vestra.preferences | language.ko | Settings ▸ Language ▸ 한국어
-vestra.preferences | language.de | Settings ▸ Language ▸ Deutsch
-vestra.preferences | language.fr | Settings ▸ Language ▸ Français
-vestra.preferences | language.es | Settings ▸ Language ▸ Español
-vestra.subtitles | move-reset | Reset ▸ Subtitle Position | Alt+Home
-vestra.subtitles | sync-reset | Reset ▸ Subtitle Sync | /
-vestra.video | video.reset | Reset ▸ Picture | Q
-vestra.video | video.frame.reset | Reset ▸ Framing | Numpad5, Alt+Backspace
-vestra.video | video.reframe.reset | Reset ▸ Crop Position
-vestra.audio | audio.sync.reset | Reset ▸ Audio Sync | ?
-vestra.audio | audio.reset | Reset ▸ Audio Processing
-vestra.visualizer | reset-logo | Reset ▸ Idle Logo
+host | palette | Command Palette… | Ctrl+Shift+P
+vestra.preferences | options | Options… | F5
 vestra.info | info.about | About Vestra Player… | F1
-vestra.info | info.update | Check for Updates…
 host | quit | Quit | Cmd+Q
+host | previous | (Previous) | PageUp, Mouse:X2
+host | next | (Next) | PageDown, Mouse:X1
 host | enter-fullscreen | (Enter Fullscreen)
 host | exit-fullscreen | (Leave Fullscreen)
 host | sidebar | (Toggle Sidebar)
-host | palette | (Command Palette) | Ctrl+Shift+P
 host | adjust | (Adjust)
+host | volume-up | (Volume +) | ArrowUp, Mouse:WheelUp
+host | volume-down | (Volume −) | ArrowDown, Mouse:WheelDown
+host | mute | (Mute) | M
 host | frame-back | (Previous Frame) | D
 host | frame-forward | (Next Frame) | F
 host | seek-backward | (Back 5 s) | ArrowLeft
@@ -594,6 +316,118 @@ host | seek-forward | (Forward 5 s) | ArrowRight
 host | rate-normal | (Normal) | Z
 host | rate-down | (Slower 0.1) | X
 host | rate-up | (Faster 0.1) | C
+vestra.playback | reopen | (Reopen Current/Last File) | Ctrl+Y
+vestra.playback | copy-name | (File Name)
+vestra.playback | copy-folder | (Folder Path)
+vestra.playback | copy-path | (Full Path)
+vestra.playback | prevent-sleep | (Disable Screen Saver While Playing)
+vestra.playback | hover-time | (Show Time on Seek Bar Hover)
+vestra.playback | hover-thumbnail | (Show Thumbnail on Seek Bar Hover)
+vestra.window | hide-cursor | (Hide Pointer While Playing)
+vestra.window | pip | (Picture-in-Picture)
+vestra.window | mini | (Mini Size) | \`
+vestra.window | size.0.5 | (0.5×) | 1
+vestra.window | size.1 | (1×) | 2
+vestra.window | size.1.5 | (1.5×) | 3
+vestra.window | size.2 | (2×) | 4
+vestra.window | fit | (Fit to Video Aspect Ratio) | 8
+vestra.window | auto.off | (Don't Resize)
+vestra.window | auto.0.5 | (0.5×)
+vestra.window | auto.1 | (1×)
+vestra.window | auto.1.5 | (1.5×)
+vestra.window | auto.2 | (2×)
+vestra.window | auto.fit | (Fit to Video Aspect Ratio)
+vestra.window | auto.once | (Only Once)
+vestra.window | top.cycle | (Cycle Mode) | Ctrl+T
+vestra.window | top.never | (Never)
+vestra.window | top.always | (Always)
+vestra.window | top.playing | (While Playing)
+vestra.window | top.fullscreen | (While Playing in Fullscreen)
+vestra.playlist | playlist.add | (Add Files…)
+vestra.playlist | playlist.link | (Add Link…)
+vestra.playlist | playlist.add-folder | (Add Folder…)
+vestra.playlist | playlist.repeat-none | (Off)
+vestra.playlist | playlist.repeat-all | (All)
+vestra.playlist | playlist.repeat-one | (One)
+vestra.playlist | playlist.shuffle | (Shuffle)
+vestra.playlist | playlist.open-list | (Open List File…)
+vestra.playlist | playlist.save-list | (Save List…)
+vestra.playlist | playlist.open-mode-only | (Open Only That File)
+vestra.playlist | playlist.open-mode-similar | (Add Similar Files)
+vestra.playlist | playlist.open-mode-folder | (Add All Files in the Folder)
+vestra.playlist | playlist.fast-advance | (Fast Advance to Next)
+vestra.playlist | playlist.remember | (Remember List)
+vestra.playlist | playlist.confirm-clear | (Confirm Before Removing All)
+vestra.history | resume.off | (Don't Resume)
+vestra.history | resume.auto | (Resume Automatically)
+vestra.history | resume.ask | (Ask Every Time)
+vestra.history | resume.audio | (Also Remember Audio Files)
+vestra.history | resume.clear | (Clear All Saved Positions)
+vestra.marks | marks.add | (Add Bookmark) | P
+vestra.marks | marks.previous | (Previous Bookmark or Chapter) | Shift+PageUp
+vestra.marks | marks.next | (Next Bookmark or Chapter) | Shift+PageDown
+vestra.marks | marks.previous-chapter | (Previous Chapter) | Ctrl+PageUp
+vestra.marks | marks.next-chapter | (Next Chapter) | Ctrl+PageDown
+vestra.marks | marks.seekbar | (Show Marks on Seek Bar)
+vestra.marks | ab.set-a | (Set Start Point) | [
+vestra.marks | ab.clear-a | (Clear Start Point) | {
+vestra.marks | ab.a-back | (Start Point Back 0.1 s) | Ctrl+[
+vestra.marks | ab.a-forward | (Start Point Forward 0.1 s) | Alt+[
+vestra.marks | ab.set-b | (Set End Point) | ]
+vestra.marks | ab.clear-b | (Clear End Point) | }
+vestra.marks | ab.b-back | (End Point Back 0.1 s) | Ctrl+]
+vestra.marks | ab.b-forward | (End Point Forward 0.1 s) | Alt+]
+vestra.marks | ab.back | (Move Range Back 0.1 s) | Ctrl+Alt+[
+vestra.marks | ab.forward | (Move Range Forward 0.1 s) | Ctrl+Alt+]
+vestra.marks | ab.segment | (Loop Current Chapter or Bookmark Range) | Alt+\\
+vestra.marks | ab.toggle | (A-B Loop On/Off) | \\
+vestra.marks | ab.count.endless | (Endless)
+vestra.marks | ab.count.1 | (Once)
+vestra.marks | ab.count.2 | (2 Times)
+vestra.marks | ab.count.3 | (3 Times)
+vestra.marks | ab.count.5 | (5 Times)
+vestra.marks | ab.count.10 | (10 Times)
+vestra.subtitle-online | settings | (Online Subtitle Settings…)
+vestra.visualizer | audio-cover | (Show Album Cover for Audio Only)
+vestra.visualizer | idle-logo | (Show Logo When Idle)
+vestra.visualizer | choose-logo | (Choose Logo Image…)
+vestra.visualizer | reset-logo | (Idle Logo)
+vestra.hotkeys | keys | (Keyboard Shortcuts…)
+vestra.hotkeys | mouse | (Mouse…)
+vestra.hotkeys | ignore-defaults | (Ignore Default Shortcuts)
+vestra.preferences | theme.vestra | (Vestra Dark)
+vestra.preferences | theme.vestra-light | (Vestra Light)
+vestra.preferences | language.system | (Follow System)
+vestra.preferences | language.en | (English)
+vestra.preferences | language.zh-Hans | (简体中文)
+vestra.preferences | language.ja | (日本語)
+vestra.preferences | language.ko | (한국어)
+vestra.preferences | language.de | (Deutsch)
+vestra.preferences | language.fr | (Français)
+vestra.preferences | language.es | (Español)
+vestra.info | info.toggle | (Playback Info) | Tab
+vestra.info | info.properties | (Playback Properties…) | Ctrl+F1
+vestra.info | info.update | (Check for Updates…)
+vestra.audio | audio.track.cycle | (Cycle Tracks) | Alt+A
+vestra.audio | audio.channels.stereo | (Stereo)
+vestra.audio | audio.channels.left | (Left Channel)
+vestra.audio | audio.channels.right | (Right Channel)
+vestra.audio | audio.channels.mono | (Mono Mix)
+vestra.audio | audio.channels.swap | (Swap Left and Right)
+vestra.audio | audio.equalizer | (Equalizer) | Shift+E
+vestra.audio | audio.preset.0 | (Flat)
+vestra.audio | audio.preset.1 | (Voice)
+vestra.audio | audio.preset.2 | (Music)
+vestra.audio | audio.preset.3 | (Cinema)
+vestra.audio | audio.sync.earlier | (50 ms Earlier) | >
+vestra.audio | audio.sync.later | (50 ms Later) | <
+vestra.audio | audio.sync.reset | (Reset) | ?
+vestra.audio | audio.sync.keep.none | (Don't Keep)
+vestra.audio | audio.sync.keep.session | (Keep for This Run)
+vestra.audio | audio.sync.keep.always | (Always Keep)
+vestra.audio | audio.normalize | (Normalize) | Shift+N
+vestra.audio | audio.clarity | (Crystalizer) | Shift+C
+vestra.audio | audio.reset | (Reset)
 vestra.capture | capture.clipExport | (Export Clip Range) | Ctrl+Shift+E
 vestra.capture | capture.saveAs | (Save Current Frame As…)
 vestra.capture | capture.saveScreen | (Save Rendered Frame) | Ctrl+Alt+E
@@ -615,6 +449,21 @@ vestra.capture | capture.clipStart | (Set Clip Start)
 vestra.capture | capture.clipEnd | (Set Clip End)
 vestra.capture | capture.last30 | (Export Last 30 Seconds) | Ctrl+Shift+R
 vestra.info | info.brief | (Brief Info) | Shift+Tab
+vestra.playback | keyframe-back | (Previous Keyframe) | Ctrl+Shift+ArrowLeft
+vestra.playback | keyframe-forward | (Next Keyframe) | Ctrl+Shift+ArrowRight
+vestra.playback | jump | (Jump to Time…) | G
+vestra.playback | jump-start | (Jump to Start) | Backspace
+vestra.playback | time-jump | (Seek Steps…)
+vestra.playback | rate-05 | (0.5×)
+vestra.playback | rate-15 | (1.5×)
+vestra.playback | rate-20 | (2×)
+vestra.playback | rate-custom | (Custom…)
+vestra.playback | backward-2 | (Back 30 s) | Ctrl+ArrowLeft
+vestra.playback | forward-2 | (Forward 30 s) | Ctrl+ArrowRight
+vestra.playback | backward-3 | (Back 60 s) | Shift+ArrowLeft
+vestra.playback | forward-3 | (Forward 60 s) | Shift+ArrowRight
+vestra.playback | backward-4 | (Back 300 s) | Ctrl+Alt+ArrowLeft
+vestra.playback | forward-4 | (Forward 300 s) | Ctrl+Alt+ArrowRight
 vestra.playlist | playlist.play | (Play) | Enter, P | panel
 vestra.playlist | playlist.list-add | (Add Files…) | Ctrl+I | panel
 vestra.playlist | playlist.list-add-folder | (Add Folder…) | Ctrl+O | panel
@@ -646,6 +495,114 @@ vestra.playlist | playlist.list-open-list | (Open List File…) | F3 | panel
 vestra.playlist | playlist.list-save-list | (Save List…) | F2 | panel
 vestra.playlist | playlist.close | (Close List) | F6 | panel
 vestra.playlist | playlist.settings | (Playlist Settings…) | F5 | panel
+vestra.subtitles | show | (Show Subtitles) | Alt+H
+vestra.subtitles | second-off | (Off)
+vestra.subtitles | second-position-top | (Top)
+vestra.subtitles | second-position-aboveMain | (Above Main Subtitle)
+vestra.subtitles | track-cycle | (Cycle) | Alt+L
+vestra.subtitles | size-up | (Size +) | Alt+PageUp
+vestra.subtitles | size-down | (Size −) | Alt+PageDown
+vestra.subtitles | move-up | (Move Up)
+vestra.subtitles | move-down | (Move Down)
+vestra.subtitles | move-reset | (Subtitle Position) | Alt+Home
+vestra.subtitles | bold | (Bold) | Alt+B
+vestra.subtitles | shadow | (Shadow)
+vestra.subtitles | box | (Opaque Box)
+vestra.subtitles | ass-original | (Original ASS/SSA Styles)
+vestra.subtitles | dialogue-previous | (Previous Dialogue) | Home
+vestra.subtitles | dialogue-next | (Next Dialogue) | End
+vestra.subtitles | dialogue-current | (Current Subtitle Start) | Ctrl+Home
+vestra.subtitles | sync-reset | (Subtitle Sync) | /
+vestra.subtitles | sync-input | (Adjust Sync…)
+vestra.subtitles | reload | (Reload Subtitles) | Ctrl+Alt+Y
+vestra.subtitles | refresh | (Refresh Subtitle Tracks)
+vestra.subtitles | remove | (Remove External Subtitle)
+vestra.subtitles | settings | (Subtitle Settings…)
+vestra.subtitles | sync-earlier | (Earlier 0.5 s) | .
+vestra.subtitles | sync-later | (Later 0.5 s) | ,
+vestra.video | video.shader.use | (Use Shaders) | Shift+P
+vestra.video | video.shader.list | (Shader List…)
+vestra.video | video.shader.folder | (Open Shader Folder)
+vestra.video | video.shader.reload | (Reload Shaders)
+vestra.video | video.hdr.auto | (Auto)
+vestra.video | video.hdr.off | (Off)
+vestra.video | video.hdr.bt.2390 | (BT.2390)
+vestra.video | video.hdr.hable | (Hable)
+vestra.video | video.hdr.mobius | (Mobius)
+vestra.video | video.hdr.reinhard | (Reinhard)
+vestra.video | video.hdr.clip | (Clip)
+vestra.video | video.hdr.peak | (Dynamic Peak Detection)
+vestra.video | video.hdr.settings | (HDR Settings…)
+vestra.video | video.deinterlace.cycle | (Cycle) | Ctrl+I
+vestra.video | video.deinterlace.auto | (Auto)
+vestra.video | video.deinterlace.on | (Always)
+vestra.video | video.deinterlace.off | (Never)
+vestra.video | video.deinterlace.output.frame | (By Frame)
+vestra.video | video.deinterlace.output.field | (By Field (Double Rate))
+vestra.video | video.fit.keep | (Keep Aspect Ratio)
+vestra.video | video.fit.stretch | (Ignore Aspect Ratio)
+vestra.video | video.fit.fill | (Fill Window (Crop Excess))
+vestra.video | video.aspect.cycle | (Cycle Aspect Ratio) | Shift+F6
+vestra.video | video.aspect.default | (Default (Source))
+vestra.video | video.aspect.0 | (4:3)
+vestra.video | video.aspect.1 | (16:9)
+vestra.video | video.aspect.2 | (16:10)
+vestra.video | video.aspect.3 | (1.85:1)
+vestra.video | video.aspect.4 | (2.35:1)
+vestra.video | video.aspect.custom | (Custom (x:y))
+vestra.video | video.aspect.edit | (Custom Aspect Ratio…)
+vestra.video | video.reframe.none | (None)
+vestra.video | video.reframe.pad.0 | (Stretch to 4:3)
+vestra.video | video.reframe.pad.1 | (Stretch to 16:9)
+vestra.video | video.reframe.pad.2 | (Stretch to 16:10)
+vestra.video | video.reframe.pad.3 | (Stretch to 1.85:1)
+vestra.video | video.reframe.pad.4 | (Stretch to 2.35:1)
+vestra.video | video.reframe.crop.0 | (Crop to 4:3)
+vestra.video | video.reframe.crop.1 | (Crop to 16:9)
+vestra.video | video.reframe.crop.2 | (Crop to 16:10)
+vestra.video | video.reframe.crop.3 | (Crop to 1.85:1)
+vestra.video | video.reframe.crop.4 | (Crop to 2.35:1)
+vestra.video | video.reframe.left | (Move Left)
+vestra.video | video.reframe.right | (Move Right)
+vestra.video | video.reframe.up | (Move Up)
+vestra.video | video.reframe.down | (Move Down)
+vestra.video | video.reframe.reset | (Crop Position)
+vestra.video | video.frame.zoom-in | (Zoom In) | Alt+Plus, Numpad9
+vestra.video | video.frame.zoom-out | (Zoom Out) | Alt+-, Numpad1
+vestra.video | video.frame.right | (Pan →) | Alt+ArrowRight, Ctrl+Numpad6
+vestra.video | video.frame.left | (Pan ←) | Alt+ArrowLeft, Ctrl+Numpad4
+vestra.video | video.frame.up | (Pan ↑) | Alt+ArrowUp, Ctrl+Numpad8
+vestra.video | video.frame.down | (Pan ↓) | Alt+ArrowDown, Ctrl+Numpad2
+vestra.video | video.frame.centre | (Center Frame) | Ctrl+Numpad5
+vestra.video | video.frame.reset | (Framing) | Alt+Backspace, Numpad5
+vestra.video | video.flip.vertical | (Flip Vertically) | Ctrl+P
+vestra.video | video.flip.horizontal | (Flip Horizontally) | Ctrl+Z
+vestra.video | video.gaussian | (Gaussian Blur) | Ctrl+B
+vestra.video | video.sharpen | (Sharpen) | Ctrl+R
+vestra.video | video.edge | (Edge Sharpen)
+vestra.video | video.deblock | (Deblock) | Ctrl+H
+vestra.video | video.deband | (Deband)
+vestra.video | video.denoise.d3 | (3D Denoise) | Ctrl+N
+vestra.video | video.denoise.gradual | (Gradual Denoise)
+vestra.video | video.denoise.temporal | (Temporal Denoise) | Ctrl+M
+vestra.video | video.frame-blend | (Frame Doubling)
+vestra.video | video.interpolation | (Motion Interpolation)
+vestra.video | video.rotate.cycle | (Cycle) | Alt+K
+vestra.video | video.rotate.0 | (No Rotation)
+vestra.video | video.rotate.90 | (90°)
+vestra.video | video.rotate.180 | (180°)
+vestra.video | video.rotate.270 | (270°)
+vestra.video | video.reset | (Picture) | Q
+vestra.video | video.resetPanel | (Picture Panel)
+vestra.video | video.brightness.down | (Brightness -1%) | W
+vestra.video | video.brightness.up | (Brightness +1%) | E
+vestra.video | video.contrast.down | (Contrast -1%) | R
+vestra.video | video.contrast.up | (Contrast +1%) | T
+vestra.video | video.saturation.down | (Saturation -1%) | Y
+vestra.video | video.saturation.up | (Saturation +1%) | U
+vestra.video | video.hue.down | (Hue -1%) | I
+vestra.video | video.hue.up | (Hue +1%) | O
+vestra.video | video.gpu-rendering | (GPU Rendering (Experimental))
 `;
 /**
  * The commands the player and its built-in plugins register when the

package/dist/plugin/runtime.js

@@ -13,7 +13,9 @@ const SDK_DIRECTORY = fileURLToPath(new URL("..", import.meta.url));
 export const WAKE_EVENTS = [
     "packages.changed",
     "bindings.changed",
-    // Player 0.7.6: sent only to the plugin whose own keys changed.
+    // Player 0.7.6: sent to a plugin whose own keys changed and, from SDK
+    // 1.6.16, to every listener when a player command (`host/<id>`) is
+    // rebound, which wakes each parked listener.
     "commands.keys",
     "appearance.changed",
     "resolvers.fileTypes",

package/dist/plugin/testing.d.ts

@@ -2557,8 +2557,9 @@ export declare class TestHost implements Transport {
      */
     get conflicts(): string[][];
     /**
-     * Change the keys of one of the plugin's commands as the user does in
-     * Keyboard Shortcuts (SDK 1.6.6): `inputs` replaces its keys (`[]`
+     * Change the keys of one of the plugin's commands, or of one of the
+     * player's core commands by its `host/<id>` (SDK 1.6.16), as the user
+     * does in Keyboard Shortcuts (SDK 1.6.6): `inputs` replaces its keys (`[]`
      * clears them, as Ignore Default Shortcuts does for every default),
      * `null` gives it its own defaults back. It writes
      * {@link TestHost.bindings | bindings.overlay}, and the plugin hears it
@@ -2580,7 +2581,8 @@ export declare class TestHost implements Transport {
      * ```
      *
      * @capability None.
-     * @throws `Error` `command` is not a command of the plugin.
+     * @throws `Error` `command` is neither a command of the plugin nor a
+     *   core command.
      * @since 1.6.6
      */
     rebind(command: string, inputs: readonly string[] | null): void;

package/dist/plugin/testing.js

@@ -2524,109 +2524,54 @@ export class TestHost {
         return { enabled, checked, busy: false, reason: enabled ? null : reason };
     }
     #registerCoreActions() {
+        // As the player declares them (host/src/core_actions.rs `declarations`,
+        // player 0.7.6): title, menu path (empty: the command palette only), order,
+        // group, default bindings, repeat, radio. Close and Play/Pause are in the
+        // menu; the rest left it for the panels and the command palette (seek,
+        // frame and speed with the playback plugin's panel, volume and mute with
+        // the audio plugin's, Previous and Next with the slim menu).
         const table = [
-            ["stop", ["Close"], 120, "open", ["F4"], false],
+            ["stop", "Close", ["Close"], 120, "open", ["F4"], false],
             [
                 "play-pause",
-                ["Playback", "Play/Pause"],
+                "Play/Pause",
+                ["Play/Pause"],
                 201,
                 "domain",
                 ["Space", "Mouse:LeftClick"],
                 false,
             ],
-            [
-                "previous",
-                ["Playback", "Previous"],
-                202,
-                "domain",
-                ["PageUp", "Mouse:X2"],
-                false,
-            ],
-            [
-                "next",
-                ["Playback", "Next"],
-                203,
-                "domain",
-                ["PageDown", "Mouse:X1"],
-                false,
-            ],
-            [
-                "frame-back",
-                ["Playback", "Seek", "Previous Frame"],
-                204,
-                "frame",
-                ["D"],
-                true,
-            ],
-            [
-                "frame-forward",
-                ["Playback", "Seek", "Next Frame"],
-                205,
-                "frame",
-                ["F"],
-                true,
-            ],
-            [
-                "seek-backward",
-                ["Playback", "Seek", "Back 5 s"],
-                210,
-                "step",
-                ["ArrowLeft"],
-                true,
-            ],
-            [
-                "seek-forward",
-                ["Playback", "Seek", "Forward 5 s"],
-                211,
-                "step",
-                ["ArrowRight"],
-                true,
-            ],
-            [
-                "rate-normal",
-                ["Playback", "Speed", "Normal"],
-                220,
-                "domain",
-                ["Z"],
-                false,
-                true,
-            ],
-            [
-                "rate-down",
-                ["Playback", "Speed", "Slower 0.1"],
-                221,
-                "domain",
-                ["X"],
-                false,
-            ],
-            [
-                "rate-up",
-                ["Playback", "Speed", "Faster 0.1"],
-                222,
-                "domain",
-                ["C"],
-                false,
-            ],
+            ["previous", "Previous", [], 0, "domain", ["PageUp", "Mouse:X2"], false],
+            ["next", "Next", [], 0, "domain", ["PageDown", "Mouse:X1"], false],
+            ["frame-back", "Previous Frame", [], 0, "domain", ["D"], true],
+            ["frame-forward", "Next Frame", [], 0, "domain", ["F"], true],
+            ["seek-backward", "Back 5 s", [], 0, "domain", ["ArrowLeft"], true],
+            ["seek-forward", "Forward 5 s", [], 0, "domain", ["ArrowRight"], true],
+            ["rate-normal", "Normal", [], 0, "domain", ["Z"], false, true],
+            ["rate-down", "Slower 0.1", [], 0, "domain", ["X"], false],
+            ["rate-up", "Faster 0.1", [], 0, "domain", ["C"], false],
             [
                 "volume-up",
-                ["Audio", "Volume +"],
-                501,
+                "Volume +",
+                [],
+                0,
                 "domain",
                 ["ArrowUp", "Mouse:WheelUp"],
                 true,
             ],
             [
                 "volume-down",
-                ["Audio", "Volume −"],
-                502,
+                "Volume −",
+                [],
+                0,
                 "domain",
                 ["ArrowDown", "Mouse:WheelDown"],
                 true,
             ],
-            ["mute", ["Audio", "Mute"], 503, "domain", ["M"], false],
+            ["mute", "Mute", [], 0, "domain", ["M"], false],
         ];
         const host = this;
-        for (const [id, fixed, order, group, bindings, repeat, radio] of table) {
+        for (const [id, fixed, path, order, group, bindings, repeat, radio,] of table) {
             // The seek items carry the step (`setStepSeek`): the player
             // registers them again when it changes (core_actions.rs `seek_title`).
             const seek = id === "seek-forward"
@@ -2634,13 +2579,11 @@ export class TestHost {
                 : id === "seek-backward"
                     ? "Back"
                     : null;
-            const pathOf = () => seek === null
+            const titleOf = () => seek === null
                 ? fixed
-                : [
-                    ...fixed.slice(0, -1),
-                    `${seek} ${String(Math.round(host.stepSeek * 1000) / 1000)} s`,
-                ];
+                : `${seek} ${String(Math.round(host.stepSeek * 1000) / 1000)} s`;
             const declaration = {
+                path,
                 order,
                 group,
                 radio: radio ?? false,
@@ -2648,22 +2591,22 @@ export class TestHost {
                 repeat,
             };
             Object.defineProperties(declaration, {
-                title: { get: () => pathOf().at(-1), enumerable: true },
-                path: { get: pathOf, enumerable: true },
+                title: { get: titleOf, enumerable: true },
             });
             const command = {
                 declaration,
                 // The player's own words in the player's language.
                 get display() {
-                    const path = pathOf();
-                    const leaf = path.at(-1);
+                    const leaf = titleOf();
                     const step = /^(Back|Forward) (\S+) s$/.exec(leaf);
                     const title = step
                         ? host.#hostText(`${step[1]} {} s`, [step[2]])
                         : host.#hostText(leaf);
                     return {
                         title,
-                        path: [...path.slice(0, -1).map((s) => host.#hostText(s)), title],
+                        path: path.length
+                            ? [...path.slice(0, -1).map((s) => host.#hostText(s)), title]
+                            : [],
                     };
                 },
                 get state() {
@@ -3244,8 +3187,9 @@ export class TestHost {
         return this.coreCommands.has(id) ? id : `${this.manifestId}/${id}`;
     }
     /**
-     * Change the keys of one of the plugin's commands as the user does in
-     * Keyboard Shortcuts (SDK 1.6.6): `inputs` replaces its keys (`[]`
+     * Change the keys of one of the plugin's commands, or of one of the
+     * player's core commands by its `host/<id>` (SDK 1.6.16), as the user
+     * does in Keyboard Shortcuts (SDK 1.6.6): `inputs` replaces its keys (`[]`
      * clears them, as Ignore Default Shortcuts does for every default),
      * `null` gives it its own defaults back. It writes
      * {@link TestHost.bindings | bindings.overlay}, and the plugin hears it
@@ -3267,11 +3211,12 @@ export class TestHost {
      * ```
      *
      * @capability None.
-     * @throws `Error` `command` is not a command of the plugin.
+     * @throws `Error` `command` is neither a command of the plugin nor a
+     *   core command.
      * @since 1.6.6
      */
     rebind(command, inputs) {
-        if (!this.commands.has(command))
+        if (!this.commands.has(command) && !this.coreCommands.has(command))
             throw new Error(`test host: no command ${command}`);
         const key = this.#bindingKey(command);
         if (inputs === null)
@@ -3287,15 +3232,19 @@ export class TestHost {
     #keysRevision = 0;
     /**
      * `commands.keys` as the player answers it: each of the plugin's own
-     * commands with the labels of the keys it holds now (the overlay, else
-     * its defaults; not a key an earlier command holds), as menus write
-     * them on `systemInfo.os`.
+     * commands, and the player's core commands as `host/<id>` (SDK 1.6.16),
+     * with the labels of the keys it holds now (the overlay, else its
+     * defaults; not a key an earlier command holds), as menus write them on
+     * `systemInfo.os`.
      */
     #keys() {
         const claims = this.#claims();
         const mac = this.systemInfo.os === "macos";
         const keys = {};
-        for (const [id, { declaration }] of this.commands) {
+        for (const [id, { declaration }] of [
+            ...this.commands,
+            ...this.coreCommands,
+        ]) {
             const scope = declaration.focus ? "panel" : "global";
             const current = this.bindings.overlay.get(this.#bindingKey(id)) ??
                 declaration.bindings ??
@@ -4397,8 +4346,9 @@ export class TestHost {
             if (this.commands.has(id))
                 throw commandConflict("owner/localId already registered");
             // The player's own commands beside the core actions (host/actions.rs
-            // `host_declarations`: Toggle Fullscreen, Quit and three outside the
-            // menu), which take part in conflicts and the total like any other.
+            // `host_declarations`: Toggle Fullscreen, Command Palette…, Quit and
+            // four outside the menu), which take part in conflicts and the total
+            // like any other.
             const hostOnly = BUILTIN_COMMANDS.filter((row) => row.owner === "host" && !this.coreCommands.has(`host/${row.id}`));
             // A path may not repeat another command's (the player's own
             // included) nor be a submenu of one, or one of its submenus.

package/dist/plugin/types.d.ts

@@ -1470,8 +1470,11 @@ export interface Commands {
      * player, and until its answer arrives (a few milliseconds) every
      * command reads `[]`; a binding that read it runs again then.
      *
-     * Only the plugin's own commands: an id the plugin has not added (or
-     * another plugin's) reads `[]`. Needs nothing beyond `commands`, not
+     * The plugin's own commands, and the player's own as `host/<id>` (SDK
+     * 1.6.16; `host/volume-up`, `host/mute`: the ids of
+     * {@link "@vestra-player/sdk/testing"!BUILTIN_COMMANDS | BUILTIN_COMMANDS} rows owned by `host`), for a panel that
+     * shows the player's keys beside its own controls; an id the plugin has
+     * not added (or another plugin's) reads `[]`. Needs nothing beyond `commands`, not
      * `bindings.manage` (the whole binding table, every plugin's, is
      * {@link Bindings.list}). Without the `commands` capability every
      * command reads `[]`. Players before 0.7.6 have no `keys` (the player

package/llms.txt

@@ -1,6 +1,6 @@
 # Vestra Player SDK
 
-> @vestra-player/sdk 1.6.15: write plugins for Vestra Player in TypeScript (plugin API `vestra/1`). A plugin is a folder with `manifest.json` and an entry module whose default export `activate(plugin)` the player calls. The documentation is a tree of short pages read by path, like `go doc`: the same pages and API as https://vestrasys.github.io/vestra-player-sdk/.
+> @vestra-player/sdk 1.6.17: write plugins for Vestra Player in TypeScript (plugin API `vestra/1`). A plugin is a folder with `manifest.json` and an entry module whose default export `activate(plugin)` the player calls. The documentation is a tree of short pages read by path, like `go doc`: the same pages and API as https://vestrasys.github.io/vestra-player-sdk/.
 
 ## Read the documentation
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vestra-player/sdk",
-  "version": "1.6.15",
+  "version": "1.6.17",
   "description": "Plugin API types, test host and plugin CLI for Vestra Player (apiVersion vestra/1)",
   "license": "Apache-2.0",
   "repository": {