Releases: kaif11ali/Frame-Splitter
Frame Splitter
🎬 Frame Splitter v1.0.0 - Official Release
Released on: October 25, 2025
🚀 Overview
Frame Splitter is a powerful desktop application that extracts individual frames from video files with professional-grade quality. Built for developers, video editors, content creators, and AI/ML enthusiasts who need to analyze or process video frames efficiently.
Whether you're creating training datasets for machine learning, analyzing video content frame-by-frame, or extracting frames for animation projects, Frame Splitter delivers fast, reliable, and high-quality results.
✨ Key Features
🎯 Smart User Experience
- 🎞️ Drag & Drop Support – Simply drag your video file into the application
- 🟩 Visual Feedback – Upload button turns green and displays "File Selected" when a file is chosen
- 💾 Auto-Download – Extracted frames are automatically packaged and downloaded as a ZIP file
- 📊 Progress Tracking – Real-time progress bar shows extraction status
⚡ Professional Performance
- Fast Frame Extraction – Optimized processing powered by FFmpeg
- High-Quality Output – Preserves original video resolution with highest quality settings
- Batch Processing – Handle multiple videos efficiently
- Original Resolution – No quality loss, frames maintain source dimensions
💻 Multiple Interfaces
- Desktop GUI – User-friendly Electron-based interface
- Command Line – Powerful CLI for automation and scripting
- Node.js API – Programmatic access for integration into your projects
🌐 Cross-Platform Support
- ✅ Windows 10/11
- ✅ macOS 10.14+
- ✅ Linux (Ubuntu 18.04+)
📦 What's Included
Desktop Application
- Frame Splitter GUI – Full-featured Electron desktop app
- One-Click Installation – NSIS installer for Windows
- Portable Version – Run without installation
Command Line Tool
- Extract frames via terminal/command prompt
- Batch processing capabilities
- Video information and metadata viewer
Node.js Module
- Programmatic API for developers
- Integration with existing Node.js projects
- Batch conversion support
🎯 Use Cases
| Use Case | Description |
|---|---|
| 🤖 Machine Learning | Create training datasets from video sources |
| 🎬 Video Analysis | Inspect video content frame by frame |
| 🎨 Content Creation | Extract frames for video editing and animation |
| 🖼️ Thumbnail Generation | Create high-quality video previews |
| 🔍 Quality Assurance | Frame-by-frame video inspection |
| 📊 Computer Vision | Process frames for AI/CV projects |
💡 How to Use
Quick Start (Desktop App)
- Launch the Frame Splitter application
- Upload your video file:
- Click the upload area, or
- Drag and drop your video file
- Confirm – Button turns green showing "File Selected"
- Click "Split Frames" to begin extraction
- Wait – Progress bar shows real-time status
- Download – ZIP file automatically downloads when complete
Command Line Usage
# Convert a video to frames
node cli.js convert your-video.mp4
# Get video information
node cli.js info your-video.mp4
# Batch process multiple videos
node cli.js batch ./videos/ -o ./outputProgrammatic Usage
const VideoToFramesConverter = require('./VideoToFramesConverter');
const converter = new VideoToFramesConverter();
await converter.convertVideo('video.mp4', 'output-frames');🛠️ Technical Specifications
Tech Stack
- Frontend: React, HTML5, CSS3
- Backend: Node.js, Electron
- Video Processing: FFmpeg (bundled)
- Compression: JSZip
- Build System: Vite, Electron Builder
Supported Video Formats
- MP4, AVI, MOV, MKV, WMV, FLV, WebM
- Any format supported by FFmpeg
Output Specifications
- Format: PNG (highest quality)
- Frame Count: 300 evenly-spaced frames
- Resolution: Original video resolution (preserved)
- Packaging: ZIP archive with auto-download
System Requirements
- Node.js: 14.0.0 or higher
- RAM: 4GB minimum (8GB recommended)
- Storage: Sufficient space for output frames
- OS: Windows 10+, macOS 10.14+, or Linux
📥 Installation
Option 1: Download Pre-built Application (Recommended)
Download the installer or portable version from the Releases page.
Windows:
Frame-Splitter-Setup-1.0.0.exe– Installer (recommended)Frame-Splitter-1.0.0-portable.exe– Portable version
Option 2: Install from Source
# Clone the repository
git clone https://github.com/kaif11ali/Frame-Splitter.git
# Navigate to project directory
cd Frame-Splitter
# Install dependencies
npm install
# Run the application
npm run electronOption 3: Build from Source
# Clone and install
git clone https://github.com/kaif11ali/Frame-Splitter.git
cd Frame-Splitter
npm install
# Build for Windows
npm run build:win
# Build for all platforms
npm run build:all🐞 Known Issues
| Issue | Impact | Workaround |
|---|---|---|
| Large video files (>1GB) may take longer to process | Performance | Process shorter clips or upgrade system RAM |
| Very high resolution videos (4K+) require more memory | Performance | Increase Node.js memory limit |
| Network drives may slow down processing | Performance | Copy videos to local drive first |
🔮 Planned Features (Future Releases)
v1.1.0 (Coming Soon)
- ✅ Multiple export formats (PNG, JPG, WebP)
- ✅ Enhanced progress bar with time estimates
- ✅ Frame preview before extraction
- ✅ Custom frame count selection
v1.2.0
- ✅ Batch processing in GUI
- ✅ Frame range selection (extract specific segments)
- ✅ Quality presets (High, Medium, Low)
- ✅ Video trimming before extraction
v2.0.0
- ✅ Cloud processing support
- ✅ GPU acceleration for faster processing
- ✅ Video comparison tool
- ✅ Frame annotation features
🧑💻 Developer Information
Created by: Kaif Ali (KF)
Role: Full-Stack Developer & Video Processing Specialist
GitHub: @kaif11ali
Repository: Frame-Splitter
📄 License
This project is licensed under the MIT License – see the LICENSE file for details.
You are free to:
- ✅ Use commercially
- ✅ Modify and distribute
- ✅ Use privately
- ✅ Sublicense
🤝 Contributing
We welcome contributions! Here's how you can help:
- Report Bugs – Open an issue with details
- Suggest Features – Share your ideas in the Issues tab
- Submit Pull Requests – Fork, code, and PR
- Improve Documentation – Help make docs better
- Share the Project – Star ⭐ and share with others
📞 Support & Feedback
- Issues: GitHub Issues
- Discussions: GitHub Discussions
- Email: Create an issue for support inquiries
🙏 Acknowledgments
Special thanks to:
- FFmpeg Team – For the powerful video processing library
- Electron Team – For the cross-platform desktop framework
- Open Source Community – For inspiration and tools
🌟 Show Your Support
If you find Frame Splitter useful, please:
- ⭐ Star this repository
- 🐛 Report bugs through Issues
- 💡 Share feature ideas
- 📢 Spread the word on social media
- 🔗 Share with fellow developers
📊 Project Stats
- Version: 1.0.0
- Release Date: October 25, 2025
- License: MIT
- Language: JavaScript (Node.js)
- Platforms: Windows, macOS, Linux
🔗 Quick Links
Thank you for using Frame Splitter! 🎬✨
Made with ❤️ by Kaif Ali