English | 中文
Web video enhancer - PiP, speed control (0.25x-16x), screenshot, web fullscreen. Works on all major video platforms.
Most video platforms lock you into their built-in player with limited controls. Video Companion breaks those limits and puts you in charge:
- Watch Your Way — Speed up lectures to 16x, slow down tutorials to 0.25x, or find your perfect pace with fine-grained speed control.
- Multitask with Picture-in-Picture — Pop any video out of the browser tab and keep watching while you work, browse, or take notes.
- Save What Matters — Screenshot any frame instantly or save videos (including HLS/m3u8 streams) for offline viewing.
- Play Any Video Link — Paste an m3u8, mp4, or webm URL and play it directly in the browser. No extra software needed.
- Distraction-Free Viewing — Web fullscreen fills your browser without entering system fullscreen, and you can hide native controls for a cleaner experience.
- Lightweight & Privacy-Friendly — No account required. No data collection. No ads. Runs entirely in your browser.
| Control Panel (Default) | Control Panel (Clean) |
|---|---|
 |
 |
| Context Menu | Custom Player |
|---|---|
 |
 |
| Play by Link |
|---|
 |
| Feature | Description |
|---|---|
| Picture-in-Picture | Float video above other windows |
| Fullscreen | Native fullscreen mode |
| Web Fullscreen | Fill browser window without system fullscreen |
| Speed Control | 0.25x - 16x playback speed |
| Loop | Toggle video loop |
| Mute | Quick mute toggle |
| Feature | Description |
|---|---|
| Screenshot | Capture current frame as PNG |
| Save | Save video, supports HLS (m3u8) streaming |
| Play by Link | Play any video URL (m3u8, mp4, webm, etc.) |
| Stream Detection | Auto-detect m3u8 streaming sources |
| Hide Controls | Hide native video controls |
- Auto Detection - Recognizes major video platforms and custom players
- Context Menu - Enhanced right-click menu for all videos
- Control Panel - Floating panel for native video elements
- Popup Panel - Click extension icon to toggle control panel and context menu
- Language Switch - Switch between Chinese and English in popup panel
- State Memory - Remember panel state for each video
- Draggable - Drag control panel to any position
Right-click on any video to access:
- Play/Pause
- Speed Control (submenu)
- Loop ✓
- Mute ✓
- Picture-in-Picture
- Fullscreen / Exit Fullscreen
- Web Fullscreen
- Screenshot
- Save Video
- Play by Link
For native video elements, a floating control panel appears at the bottom:
- Shows on hover, auto-hides when mouse leaves
- Draggable to any position
- Click close button to hide
- Re-open via context menu
Click extension icon in browser toolbar:
- Control Panel Toggle - Enable/disable floating control panel
- Context Menu Toggle - Enable/disable enhanced context menu
- Language Switch - Switch between Chinese and English
- Video Detection - Shows number of videos detected on current page
| Feature | Shortcut |
|---|---|
| Picture-in-Picture | Alt + P |
- Clone repository
git clone https://github.com/wh131462/video-companion-extension.git
cd video-companion-extension- Install dependencies
npm install- Build extension
npm run build- Load extension
- Open Chrome, visit
chrome://extensions/ - Enable "Developer mode"
- Click "Load unpacked"
- Select the
distdirectory
- Open Chrome, visit
# Development mode (hot reload)
npm run dev
# Build production version
npm run build
# Build and package zip (for release)
npm run build:zip
# Run tests
npm test
# Test coverage
npm run test:coverage
# Type check
npm run type-check
# Lint
npm run lintsrc/
├── background/ # Service Worker
│ ├── handlers/ # Message and command handlers
│ └── services/ # Storage service
├── content/ # Content scripts
│ ├── core/ # Core logic (video scanner, enhancer)
│ ├── features/ # Feature modules (speed, screenshot, download, etc.)
│ ├── handlers/ # Event handlers
│ ├── hls/ # HLS streaming (player, downloader, interceptor)
│ ├── styles/ # Styles
│ ├── ui/ # UI components (control panel, context menu, toast)
│ └── utils/ # Utilities
└── shared/ # Shared code (types, constants, utils)
- TypeScript - Type-safe JavaScript
- Vite - Modern build tool
- Chrome Extension Manifest V3 - Latest extension standard
- Vitest - Unit testing framework
Extension auto-detects custom players on these sites (context menu only):
| Platform | URL |
|---|---|
| YouTube | youtube.com |
| Bilibili | bilibili.com |
| Tencent Video | v.qq.com |
| iQIYI | iqiyi.com |
| Youku | youku.com |
| Xigua Video | ixigua.com |
For other sites using native <video> elements, both control panel and context menu are available.
| Browser | Minimum Version |
|---|---|
| Chrome | 122+ |
| Edge (Chromium) | 122+ |
If you encounter issues or have feature suggestions, feel free to submit an Issue or Pull Request.