ZWPlayer Keyboard Shortcuts User Guide

ZWPlayer provides rich keyboard shortcut functionality, allowing you to control video playback more conveniently.

Shortcut Cheat Sheet

Basic Playback Control

Play/Pause

• Space Bar or Media Play Key - Play/Pause video
• Shortcut: Space / MediaKey

Stop and Restart

• 0 - Replay video (Jump to beginning)
• Shortcut: 0

Note: If the segment selection feature is enabled, pressing the 0 key will jump to the start of the segment, not the beginning of the video.

Progress Control

Fast Forward/Rewind

• → (Right Arrow) - Fast forward 5 seconds on single press, long press for speed playback
• ← (Left Arrow) - Rewind 5 seconds, long press for continuous operation
• Shortcut: → / ←

Frame-by-Frame Playback

Frame-by-frame playback is ideal for scenarios that require precise visual inspection, such as video editing or instructional content analysis.

• . (Period) - Step forward one frame (approximately 1/30 second)
• , (Comma) - Step backward one frame (approximately 1/30 second)

Usage Notes:

• Pressing a frame step shortcut automatically pauses the video and jumps to the corresponding frame
• The player displays a timestamp toast notification
• Frame-by-frame playback is only available when the video is loaded (readyState ≥ 2) and not a live stream
• Supports rapid consecutive key presses for continuous frame stepping

Volume Control

Volume Adjustment

• ↑ (Up Arrow) - Volume up 5%
• ↓ (Down Arrow) - Volume down 5%
• Shortcut: ↑ / ↓

Mute Control

• M - Toggle mute on/off
• Shortcut: M (Case-insensitive)

Playback Speed Control

Variable Speed Playback

• Shift + 1 - 1x speed (Normal speed)
• Shift + 2 - 2x speed playback
• Shortcut: Shift + 1 / Shift + 2

Video Display Control

Fullscreen Control

• F - Enter/Exit fullscreen mode
• Esc - Close menu / Exit fullscreen
• Shortcut: F / Esc

Lighting Effect

• L - Toggle lighting effect on/off
• Shortcut: L (Case-insensitive)

Magnifier

• Z - Toggle magnifier/loupe mode
• Shortcut: Z (Case-insensitive)

Usage Notes:

• Requires the zoomButton configuration option to be enabled for the shortcut to work
• When the magnifier is active, hover the mouse over the video to view enlarged details
• Press Esc to close the magnifier

Playlist

When the player has a playlist loaded, the following shortcuts can be used to quickly switch between items:

• Q - Toggle the playlist panel visibility
• ] (Right bracket) - Play the next item
• [ (Left bracket) - Play the previous item

Usage Notes:

• Playlist shortcuts are only available when the player is configured with playlist data
• A toast notification showing “Next” or “Previous” is displayed when switching items

Danmaku Function

Danmaku Control

• D - Toggle Danmaku display on/off
• Enter - Send Danmaku (Requires that the Danmaku input box is not focused)
• Shortcut: D (Case-insensitive) / Enter

Attention: When the Danmaku input box is focused, all shortcuts except the Esc key will be disabled to avoid input conflicts.

Recording Function

Recording Control

• R - Start/Stop video recording
• Shortcut: R (Case-insensitive)

Special Function Description

Smart Progress Control

• The right arrow key supports two modes:
  • Single Click: Fast forward 5 seconds
  • Long Press: Enter speed playback mode

Segment Selection Mode

• When the segment selection feature is enabled, the 0 key will jump to the start position of the current segment
• In segment playback mode, the behavior of some shortcuts may be adjusted

Input Box Focus Detection

• The player automatically detects if the current focus is within an input box
• When the focus is in a text input area such as the Danmaku input box, shortcuts are automatically disabled
• Only the Esc key remains available when the input box is focused, used to close the current operation

Shortcut State Management

ZWPlayer uses a state management system to handle keyboard events:

• Prevents duplicate key triggers
• Supports long press for continuous operations
• Smart focus detection to avoid input conflicts

Compatibility Notes

• Supports all modern browsers
• Supports playback control keys on media keyboards
• Automatically adapts to different keyboard layouts

Version Info: Applicable to ZWPlayer v3.2.0+

Update Date: November 01, 2025