README file from
GithubVideoControlsEnhancer
[!NOTE] This plugin enhances the native HTML5
<video>player used by Obsidian for local video files. It does not affect embedded third-party players (e.g. YouTube, Vimeo).
Touch-first video controls for Obsidian
VideoControlsEnhancer supercharges Obsidian's built-in video player with gesture-driven playback controls inspired by modern mobile video apps. Scrub through a clip by dragging horizontally, adjust volume by dragging vertically, jump in configurable steps with a double tap, and fast-forward by holding down. Every action is accompanied by a lightweight on-screen overlay so you always see what's happening — no precision aiming at tiny progress bars required.
It works anywhere Obsidian renders a local video: notes, Canvas, embedded previews, and fullscreen mode on both desktop and mobile.
Features
- Horizontal scrubbing — drag left/right to seek through the video, with an adjustable sensitivity slider so you can tune how far a full sweep travels.
- Vertical volume control — drag up/down anywhere on the video to change the volume; the overlay shows the current percentage and a speaker icon.
- Double tap to jump — a double tap on the right half jumps forward, on the left half jumps backward, by a configurable number of seconds (1–30).
- Long press to fast-forward — press and hold without dragging to play at an increased rate (1.5×–4×); release to return to normal speed. The trigger delay is configurable (200–1000 ms).
- On-screen overlay — each gesture shows a transient overlay (time,
+/-seconds,Nxspeed, or volume %) near the touch point. - Mobile fullscreen controls — optionally shifts the native fullscreen progress bar/controls up a little so they don't sit in the system gesture zone, and blocks touch/mouse events from leaking through to the canvas behind a fullscreen video.
- Works everywhere — applies to every
<video>element rendered by Obsidian, including dynamically inserted ones (via aMutationObserver), in notes, Canvas, and fullscreen. - Desktop and mobile — tuned to behave well with touch gestures.
- Fully configurable — every feature can be toggled on or off independently in settings.
Installation
Community plugins (recommended)
- Open Obsidian Settings → Community plugins.
- Click Browse and search for VideoControlsEnhancer.
- Click Install, then Enable.
Manual installation
- Download
main.js,manifest.json, andstyles.css(if present) from the latest GitHub release. - Copy them into:
<your-vault>/.obsidian/plugins/video-controls-enhancer/ - Reload Obsidian.
- Enable the plugin in Settings → Community plugins.
Compatibility
- Requires Obsidian 1.12.7 or newer.
- Works on desktop and mobile.
- Affects only the native HTML5 video player for local files. Embedded players such as YouTube are not modified.
Contributing
Issues and pull requests are welcome: GitHub Issues