🎬 TronVid

A modern, cross-platform video player

Features • Installation • Usage • Shortcuts • Building • Contributing • License

---

📸 Screenshots

Main Window

Mini Player

Audio Exctraction

Video Statistics - Chapter Loop

Video Editor

Video Editor - Export

---

🆕 What's New in v1.8.1

📋 Auto-Clipboard Detection

Copy a video URL → TronVid pops up! No browser extension needed.

What Happens
1. Copy any YouTube/Vimeo/Twitch/Dailymotion URL in your browser
2. TronVid comes to foreground automatically
3. Popup shows video icon, title (auto-fetched), and URL
4. Click "Add to Playlist" → Done!

🌐 Optional Browser Extension

For those who prefer a button on video pages:

• Chrome, Edge, Brave, Opera, Firefox supported
• Floating "Add to TronVid" button on video pages
• See Browser Extension Installation below

---

📡 Multi-Platform Streaming

Stream videos directly from popular platforms - no external tools required!

Platform	Support
🔴 YouTube	Videos, Shorts, and Playlists with quality selection (360p-4K)
🔵 Vimeo	Full video support
🟢 Dailymotion	Full video support
🟣 Twitch	VODs and Clips
📡 HLS Streams	Live streams (.m3u8)
🔗 Direct URLs	MP4, WebM, and more

✨ Streaming Features

• Quality Selection - Choose video quality before playback (YouTube)
• Auto Platform Detection - URLs are automatically recognized
• YouTube Playlist Import - Import entire playlists as saved playlists
• Demo Streams - Test HLS streaming with built-in demo streams
• Fully Integrated - All streaming libraries are bundled (no installation needed)

🛠️ Technical Details

• @distube/ytdl-core for YouTube
• @distube/ytpl for YouTube playlists
• youtube-dl-exec for Vimeo/Dailymotion/Twitch (auto-downloads yt-dlp binary)
• HLS.js for adaptive streaming

📋 See CHANGELOG.md for full version history

---

✨ Features

Core Features

• 🎥 Multi-Format Support - Play MP4, MOV, AVI, MKV, and WebM videos
• 📂 Playlist Management - Create, save, and organize multiple playlists
• 🖥️ Cross-Platform - Works on macOS, Windows, and Linux
• 🎨 5 Color Themes - Dark (default), Light, Purple, Blue, and Green
• ⌨️ Full Keyboard Control - Comprehensive shortcuts for power users

Playback Features

• 🔁 A-B Loop - Set start/end points to loop a specific section
• 🔂 Chapter Loop - Click preview thumbnails to loop video sections (press C)
• 🎚️ Speed Control - Adjust playback speed (0.25x - 2x)
• 🔀 Shuffle & Loop - Shuffle playlist or loop current video
• 🎞️ Frame-by-Frame - Navigate frame by frame with , and . keys

Security

• 🔒 Context Isolation - Secure renderer process with isolated context
• 🛡️ Content Security Policy - Strict CSP prevents XSS attacks
• 🔐 Secure IPC - Whitelist-based IPC communication

Streaming

• 📡 Multi-Platform Streaming - Stream from YouTube, Vimeo, Dailymotion, Twitch
  • No external tools required (all libraries integrated)
  • Quality selection for YouTube (360p to 4K)
  • Import YouTube playlists as saved playlists
  • HLS live stream support (.m3u8)
  • Direct URL playback (MP4, WebM)

Advanced Features

• 🔍 Video Zoom - Zoom into video preview (1x-5x magnification)
  • Mouse wheel zoom directly on video
  • Pan zoomed video by click-and-drag
  • Reset with zoom button
• 🎬 Video Editor - Cut and merge video clips with FFmpeg
  • Final Cut Pro style trimming (I/O keys, JKL navigation)
  • Frame-by-frame navigation with arrow keys
  • Draggable IN/OUT markers on timeline
  • Create clips from multiple videos
  • Export as MP4, WebM, or MOV
• 📸 Screenshot Capture - Save screenshots as PNG files
• 🎵 Audio Extraction - Extract audio as MP3, AAC, WAV, or FLAC
• 🖼️ Picture-in-Picture - Watch videos in a floating window
• 📺 Video Previews - Thumbnail strip for quick navigation
• 📊 Video Statistics - View resolution, bitrate, codec info
• 🪟 Mini Player Mode - Compact mode for multitasking
• ❓ Built-in Help - Press H for a complete feature guide

User Experience

• 🖱️ Drag & Drop - Simply drop videos to add them
• 🔊 Volume Control - Adjustable volume with mute option
• 📁 Collapsible Sidebar - More space when you need it
• 🎯 Reorderable Playlist - Drag items to reorder

📦 Installation

Download Pre-built Binaries

Download the latest release for your platform from the Releases page.

Platform	Download
macOS (Apple Silicon)	TronVid-x.x.x-arm64.dmg
Windows (64-bit)	TronVid-x.x.x-win-x64.exe
Linux (Debian)	TronVid-x.x.x-linux-amd64.deb

---

  

🛡️ Safe & Secure Downloads ✅ All binaries are virus-scanned before every release ✅ No malware, no spyware, no harmful code ✅ 100% open source ✅ Built transparently with automated CI/CD pipelines Download with confidence! TronVid is safe to install and use.

---

🚀 Quick Start

3 simple steps:

1. Download - Get TronVid for your system from Releases
2. Install - Open the downloaded file and follow the instructions
3. Play videos - Drag & Drop videos into the app or click "Files"

💡 Tip: Press H for all keyboard shortcuts!

---

📖 Usage

Adding Videos

1. Drag & Drop - Drag video files directly into the app
2. File Selection - Click "Files" to select individual videos
3. Folder Selection - Click "Folder" to add all videos from a directory

Managing Playlists

• Save Playlist - Click the 💾 icon to save your current playlist
• Load Playlist - Click on any saved playlist to load it
• Create Playlist - Click the ➕ icon to create a new empty playlist
• Delete Playlist - Click the ✕ button on any playlist to delete it
• Clear Playlist - Click "Clear Playlist" to remove all videos
• Reorder - Drag playlist items to change order

💡 How Playlists Work:
TronVid stores only the file paths to your videos, not the actual video files. This means:

• ✅ No disk space is wasted on duplicates
• ✅ Playlists load instantly
• ✅ Original files stay in their original location
• ⚠️ If you move or delete a video file, the playlist entry won't work anymore

Playlists are saved locally in your user data folder and persist between sessions.

📁 Data Storage Locations

Playlists

Playlists are stored as a JSON file in the app's user data directory:

Platform	Location
macOS	~/Library/Application Support/TronVid/playlists.json
Windows	%APPDATA%/TronVid/playlists.json
Linux	~/.config/TronVid/playlists.json

Screenshots

Screenshots are saved as PNG files in a dedicated folder inside your Pictures directory:

Platform	Location
macOS	~/Pictures/TronVid Screenshots/
Windows	%USERPROFILE%/Pictures/TronVid Screenshots/
Linux	~/Pictures/TronVid Screenshots/

Audio Extraction

Audio files are saved as mp3, aac, wav or flac files in a dedicated folder inside your music directory:

Platform	Location
macOS	~/Music/TronVid Audio/
Windows	%USERPROFILE%/Music/TronVid Audio/
Linux	~/Music/TronVid Audio/

A-B Loop

Repeat a specific section of the video:

1. Press [ to set the start point (A)
2. Press ] to set the end point (B) - loop starts automatically
3. Press L to toggle the loop on/off
4. Press \ or double-click the A-B button to clear

Themes

Press T to cycle through 5 color themes:

• Dark (default)
• Light
• Purple
• Blue
• Green

⌨️ Keyboard Shortcuts

Playback

Shortcut	Action
Space	Play / Pause
N	Next video
P	Previous video
←	Rewind 10 seconds
→	Fast forward 10 seconds
,	Previous frame (fine control)
.	Next frame (fine control)

Volume

Shortcut	Action
↑	Volume up (+10%)
↓	Volume down (-10%)
M	Mute / Unmute

A-B Loop

Shortcut	Action
[	Set loop start point (A)
]	Set loop end point (B)
\	Clear A-B loop
L	Toggle A-B loop on/off

Chapter Loop

Shortcut	Action
C	Toggle chapter loop mode
Click Preview	Loop that section (when mode active)

View & Window

Shortcut	Action
F	Toggle fullscreen
Ctrl/Cmd + B	Toggle sidebar
Ctrl/Cmd + W	Mini player mode
I	Toggle video statistics
T	Change theme
H	Open help modal

Other

Shortcut	Action
S	Take screenshot
E	Extract audio

🌐 Browser Extension

Add videos from YouTube, Vimeo, Twitch, and Dailymotion directly to TronVid with one click!

Supported Browsers

Browser	Support	Manifest
✅ Chrome	Full	v3
✅ Edge	Full	v3
✅ Brave	Full	v3
✅ Opera	Full	v3
✅ Firefox	Full	v2
❌ Safari	Not supported	-

Installation Chrome / Edge / Brave / Opera

1. Open your browser's extension page:
   • Chrome: chrome://extensions/
   • Edge: edge://extensions/
   • Brave: brave://extensions/
   • Opera: opera://extensions/
2. Enable "Developer mode" (toggle in top-right corner)
3. Click "Load unpacked"
4. Navigate to the TronVid folder and select the browser-extension subfolder
5. Done! The extension icon appears in your toolbar

Installation Firefox

Option 1: Temporary Install (for testing)

1. Open about:debugging#/runtime/this-firefox
2. Click "Load Temporary Add-on"
3. Navigate to the browser-extension folder
4. Select manifest-firefox.json

Option 2: Permanent Install

1. In the browser-extension folder:
   • Rename manifest-firefox.json → manifest.json
   • Rename background-firefox.js → background.js
2. Select all files in the folder and create a ZIP archive
3. Open about:addons in Firefox
4. Click the gear icon ⚙️ → "Install Add-on From File"
5. Select the ZIP file you created

How to Use

1. Install TronVid on your computer (run it at least once)
2. Install the browser extension (see above)
3. Navigate to a video page (YouTube, Vimeo, Twitch, or Dailymotion)
4. A floating "Add to TronVid" button appears on the page
5. Click the button → TronVid opens and adds the video to your playlist!

Supported Platforms

Platform	URL Patterns
🔴 YouTube	youtube.com/watch, youtu.be/
🔵 Vimeo	vimeo.com/123456
🟣 Twitch	twitch.tv/videos/, clips.twitch.tv
🟢 Dailymotion	dailymotion.com/video/, dai.ly/

Troubleshooting

Problem	Solution
Extension not working	Make sure TronVid is installed and has been run at least once
Button doesn't appear	Reload the page or reinstall the extension
TronVid doesn't open	Run TronVid once to register the URL protocol

💡 Note: The extension uses the tronvid:// URL protocol to communicate with the app. This protocol is registered automatically when TronVid is installed.

---

📄 License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.

👨‍💻 Author

tron4x

• GitHub: @tron4x

🙏 Acknowledgments

• Built with Electron
• Icons and design inspired by modern media players

---

Made with ❤️ by tron4x

TronVid is developed and maintained by tron4x. While we strive for quality,
bugs may occur. We actively monitor and address reported issues.
Your feedback helps make TronVid better! 🚀

Thank you for your support and feedback! 🙏

Report Bug · Request Feature