https://github.com/gabrielschoenardie/encoder
🎬 Professional video encoder for Instagram with guaranteed zero-recompression. Hollywood-level quality meets social media optimization. Enterprise-grade reliability.
https://github.com/gabrielschoenardie/encoder
batch-script content-creation ffmpeg h264 hollywood-quality instagram professional social-media video-encoding windows zero-recompression
Last synced: about 2 months ago
JSON representation
🎬 Professional video encoder for Instagram with guaranteed zero-recompression. Hollywood-level quality meets social media optimization. Enterprise-grade reliability.
- Host: GitHub
- URL: https://github.com/gabrielschoenardie/encoder
- Owner: gabrielschoenardie
- Created: 2025-05-31T20:47:27.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-08-13T19:12:31.000Z (10 months ago)
- Last Synced: 2026-04-30T07:38:50.417Z (about 2 months ago)
- Topics: batch-script, content-creation, ffmpeg, h264, hollywood-quality, instagram, professional, social-media, video-encoding, windows, zero-recompression
- Language: Batchfile
- Homepage:
- Size: 14.1 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🎬 Instagram Encoder Framework V5.2 - Modular Edition
---
## 🤖 AI-Assisted Development
This project uses AI assistance for development acceleration. See [CLAUDE.md](docs/technical/CLAUDE.md) for complete AI collaboration context.
## 📋 Project Documentation
- [CLAUDE.md](docs/technical/CLAUDE.md) - Complete AI context and technical specifications
- [README.md](README.md) - User guide and basic setup
---
## 🚀 **Modular Architecture Edition**
Professional zero-recompression video encoder for Instagram with **modular architecture** for enhanced maintainability, extensibility, and collaborative development.
### **🏗️ Project Structure**
```
instagram-encoder/
├── 📁 src/ # Source Code
│ ├── 📁 core/ # Main encoding engine
│ │ ├── encoderV5.bat # Core encoder script
│ │ └── init.bat # Initialization script
│ ├── 📁 profiles/ # Encoding profiles and presets
│ │ ├── 📁 presets/ # Pre-configured profiles
│ │ ├── 📁 templates/ # Profile templates
│ │ └── 📁 library/ # Community profiles
│ ├── 📁 config/ # Configuration management
│ │ ├── 📁 hardware/ # Hardware-specific configs
│ │ ├── 📁 encoding/ # Encoding parameters
│ │ └── 📁 instagram/ # Platform specifications
│ ├── 📁 utils/ # Utility modules
│ │ ├── hardware_detection.bat
│ │ └── profile_manager.bat
│ └── 📁 tests/ # Test suites
│ ├── 📁 unit/ # Unit tests
│ ├── 📁 integration/ # Integration tests
│ └── 📁 performance/ # Performance tests
├── 📁 tools/ # Development tools
│ ├── 📁 benchmark/ # Performance benchmarking
│ ├── 📁 validation/ # Quality validation
│ └── 📁 automation/ # Build automation
├── 📁 docs/ # Documentation
│ ├── 📁 technical/ # Technical documentation
│ ├── 📁 user-guide/ # User guides
│ └── 📁 api/ # API documentation
├── 📁 samples/ # Sample files
│ ├── 📁 input/ # Input test samples
│ ├── 📁 output/ # Output examples
│ └── 📁 test-cases/ # Test scenarios
├── 📁 releases/ # Release packages
└── 📁 .github/ # GitHub configuration
└── 📁 ISSUE_TEMPLATE/ # Issue templates
```
---
## ⚡ **Quick Start**
### **Option 1: Direct Launch (Recommended)**
```bash
# Clone the repository
git clone https://github.com/gabrielschoenardie/encoder.git
cd encoder
# Run the modular encoder
src\core\init.bat
```
### **Option 2: Development Mode**
```bash
# For development and testing
src\core\encoderV5.bat
# Run test suite
src\tests\run_tests.bat
# Build release package
tools\build.bat
```
---
## 🏆 **Key Features**
### **🎬 Professional Quality**
- **Hollywood-Level Encoding** – Netflix/Disney+ quality standards
- **Zero-Recompression Guarantee** – 99.5% Instagram acceptance rate
- **VMAF Score 95-98** – Broadcast quality validation
- **BT.709 Color Science** – Instagram native compliance
### **🏗️ Modular Architecture**
- **Separated Concerns** – Each module has specific responsibility
- **Easy Maintenance** – Debug and update individual components
- **Parallel Development** – Multiple features can be developed simultaneously
- **Extensible Design** – Add new modules without affecting existing code
### **🧠 Intelligent Optimization**
- **Hardware Detection 2.0** – Microarchitecture-specific optimizations
- **Content-Aware Analysis** – Automatic profile selection
- **Adaptive Threading** – CPU-specific performance tuning
- **Smart Resource Management** – Optimal memory and CPU usage
### **📊 Professional Profiles**
- **📱 Reels (9:16)** – Vertical content optimization
- **📺 Feed (16:9)** – Horizontal content for feed/IGTV
- **🎬 Cinema (21:9)** – Ultra-wide cinematic quality
- **🚗 SpeedRamp Viral** – High-motion content optimization
- **⚙️ Custom Profiles** – User-defined configurations
---
## 📊 **Performance Metrics**
| Metric | Target | Typical Range |
|--------|--------|---------------|
| **Encoding Speed** | >1.5x realtime | 1.5-2.5x realtime |
| **VMAF Quality Score** | >95 | 95-98 |
| **Instagram Acceptance** | >99.5% | 99.5-99.8% |
| **File Size Efficiency** | Optimal | 15-20% smaller than competitors |
| **CPU Utilization** | 70-85% | Varies by hardware |
---
## 🛠️ **System Requirements**
### **Minimum Requirements**
- **OS:** Windows 10 (64-bit) or newer
- **CPU:** 2+ cores (Intel Core i3 / AMD Ryzen 3 or better)
- **RAM:** 4GB available memory
- **Storage:** 2GB free space (SSD recommended)
- **FFmpeg:** Version 4.0 or newer (auto-detected)
### **Recommended for Optimal Performance**
- **OS:** Windows 11 (64-bit)
- **CPU:** 6+ cores (Intel Core i5-8th gen / AMD Ryzen 5 3600 or better)
- **RAM:** 16GB+ available memory
- **Storage:** NVMe SSD with 10GB+ free space
- **Architecture:** Modern CPU (Intel 8th gen+ / AMD Zen2+)
---
## 🚀 **Advanced Features**
### **🔬 Hardware Optimization**
- **CPU Microarchitecture Detection** – AMD Zen vs Intel Core optimizations
- **Thermal Management** – Laptop vs Desktop performance profiles
- **Memory Bandwidth Optimization** – RAM speed-aware configurations
- **Multi-threading Intelligence** – Optimal core utilization
### **📈 Quality Assurance**
- **VMAF Validation** – Automated quality scoring
- **Instagram Compliance Testing** – Platform compatibility verification
- **Bitrate Accuracy** – Precise file size control
- **Visual Quality Preservation** – Perceptual optimization
### **🔧 Developer Tools**
- **Automated Testing** – Unit, integration, and performance tests
- **Build Pipeline** – Automated release packaging
- **Performance Benchmarking** – Hardware-specific optimization
- **Profile Validation** – Configuration verification
---
## 📚 **Documentation**
### **User Documentation**
- [User Guide](docs/user-guide/README.md) - Complete usage instructions
- [Profile Guide](docs/user-guide/profiles.md) - Encoding profile explanations
- [Troubleshooting](docs/user-guide/troubleshooting.md) - Common issues and solutions
### **Technical Documentation**
- [CLAUDE.md](docs/technical/CLAUDE.md) - Complete AI collaboration context
- [Architecture](docs/technical/architecture.md) - System design and decisions
- [API Reference](docs/api/) - Module interfaces and functions
### **Development Documentation**
- [Contributing Guide](docs/technical/contributing.md) - How to contribute
- [Testing Strategy](docs/technical/testing.md) - Test framework and guidelines
- [Release Process](docs/technical/release.md) - Build and deployment process
---
## 🎯 **Use Cases**
### **Content Creators**
- **Instagram Reels** – Vertical video optimization
- **Instagram Stories** – Quick story content
- **Instagram Feed** – Professional horizontal content
- **Multiple Platforms** – One encode, multiple uses
### **Professional Studios**
- **Batch Processing** – Multiple files, consistent quality
- **Custom Profiles** – Brand-specific configurations
- **Quality Control** – VMAF validation and reporting
- **Workflow Integration** – Scriptable automation
### **Developers & Integrators**
- **API Integration** – Embed encoding capabilities
- **Custom Modules** – Extend functionality
- **Performance Testing** – Benchmark different configurations
- **Research & Development** – Encoding parameter research
---
## 🤝 **Contributing**
We welcome contributions! Please follow these steps:
1. **Read Documentation** – Review [CLAUDE.md](docs/technical/CLAUDE.md) for complete project context
2. **Check Issues** – Look at existing [Issues](../../issues) and [Templates](.github/ISSUE_TEMPLATE/)
3. **Follow Architecture** – Respect modular design principles
4. **Add Tests** – Include tests for new functionality
5. **Update Documentation** – Keep docs current with changes
### **Development Workflow**
```bash
# 1. Fork and clone
git clone https://github.com/yourusername/encoder.git
# 2. Create feature branch
git checkout -b feature/your-feature-name
# 3. Develop and test
src\tests\run_tests.bat
# 4. Commit and push
git commit -m "feat: your feature description"
git push origin feature/your-feature-name
# 5. Create pull request
```
---
## 📄 **License**
This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.
### **Third-Party Software**
- **FFmpeg** - LGPL/GPL licensed (not included, requires separate installation)
- **x264** - GPL licensed (part of FFmpeg)
---
## 🙏 **Acknowledgments**
- **FFmpeg Team** – For the excellent encoding framework
- **x264 Developers** – For the superior H.264 codec implementation
- **Instagram Engineering** – For platform specifications and compatibility
- **Community Contributors** – For testing, feedback, and improvements
---
## 📞 **Support & Community**
- **📚 Documentation** – [Complete guides and references](docs/)
- **🐛 Bug Reports** – [Issue tracker with templates](.github/ISSUE_TEMPLATE/)
- **💬 Discussions** – [Community discussions](../../discussions)
- **🤖 AI Context** – [AI collaboration documentation](docs/technical/CLAUDE.md)
---
## 🎬 **Ready to Create Hollywood-Level Instagram Content?**
```bash
git clone https://github.com/gabrielschoenardie/encoder.git
cd encoder
src\core\init.bat
```
**Transform your videos with zero-recompression, guaranteed Instagram compatibility, and professional broadcast quality.**
---
⭐ **If this project helps you create amazing content, please consider giving it a star!**