{"id":28799686,"url":"https://github.com/gabrielschoenardie/encoder","last_synced_at":"2026-04-30T07:39:38.789Z","repository":{"id":297152057,"uuid":"993932923","full_name":"gabrielschoenardie/encoder","owner":"gabrielschoenardie","description":"🎬 Professional video encoder for Instagram with guaranteed zero-recompression.  Hollywood-level quality meets social media optimization. Enterprise-grade reliability.","archived":false,"fork":false,"pushed_at":"2025-08-13T19:12:31.000Z","size":14742,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-30T07:38:50.417Z","etag":null,"topics":["batch-script","content-creation","ffmpeg","h264","hollywood-quality","instagram","professional","social-media","video-encoding","windows","zero-recompression"],"latest_commit_sha":null,"homepage":"","language":"Batchfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gabrielschoenardie.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-31T20:47:27.000Z","updated_at":"2026-04-18T22:48:18.000Z","dependencies_parsed_at":"2025-06-04T10:23:11.103Z","dependency_job_id":"8e7ee1bf-09dc-46d6-ac2e-41e9d56661e6","html_url":"https://github.com/gabrielschoenardie/encoder","commit_stats":null,"previous_names":["gabrielschoenardie/encoder"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/gabrielschoenardie/encoder","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabrielschoenardie%2Fencoder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabrielschoenardie%2Fencoder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabrielschoenardie%2Fencoder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabrielschoenardie%2Fencoder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gabrielschoenardie","download_url":"https://codeload.github.com/gabrielschoenardie/encoder/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gabrielschoenardie%2Fencoder/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32458237,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T22:27:22.272Z","status":"online","status_checked_at":"2026-04-30T02:00:05.929Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["batch-script","content-creation","ffmpeg","h264","hollywood-quality","instagram","professional","social-media","video-encoding","windows","zero-recompression"],"created_at":"2025-06-18T07:00:15.152Z","updated_at":"2026-04-30T07:39:38.784Z","avatar_url":"https://github.com/gabrielschoenardie.png","language":"Batchfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎬 Instagram Encoder Framework V5.2 - Modular Edition\n\n![FFmpeg](https://img.shields.io/badge/FFmpeg-Enabled-brightgreen.svg)\n![Version](https://img.shields.io/badge/version-5.2--modular-blue.svg)\n![Platform](https://img.shields.io/badge/platform-Windows-lightgrey.svg)\n![License](https://img.shields.io/badge/license-MIT-green.svg)\n![Quality](https://img.shields.io/badge/quality-Hollywood%20Level-gold.svg)\n![Instagram](https://img.shields.io/badge/Instagram-Zero%20Recompression-ff69b4.svg)\n\n---\n\n## 🤖 AI-Assisted Development\nThis project uses AI assistance for development acceleration. See [CLAUDE.md](docs/technical/CLAUDE.md) for complete AI collaboration context.\n\n## 📋 Project Documentation\n- [CLAUDE.md](docs/technical/CLAUDE.md) - Complete AI context and technical specifications\n- [README.md](README.md) - User guide and basic setup\n\n---\n\n## 🚀 **Modular Architecture Edition**\n\nProfessional zero-recompression video encoder for Instagram with **modular architecture** for enhanced maintainability, extensibility, and collaborative development.\n\n### **🏗️ Project Structure**\n\n```\ninstagram-encoder/\n├── 📁 src/                     # Source Code\n│   ├── 📁 core/                # Main encoding engine\n│   │   ├── encoderV5.bat       # Core encoder script\n│   │   └── init.bat            # Initialization script\n│   ├── 📁 profiles/            # Encoding profiles and presets\n│   │   ├── 📁 presets/         # Pre-configured profiles\n│   │   ├── 📁 templates/       # Profile templates\n│   │   └── 📁 library/         # Community profiles\n│   ├── 📁 config/              # Configuration management\n│   │   ├── 📁 hardware/        # Hardware-specific configs\n│   │   ├── 📁 encoding/        # Encoding parameters\n│   │   └── 📁 instagram/       # Platform specifications\n│   ├── 📁 utils/               # Utility modules\n│   │   ├── hardware_detection.bat\n│   │   └── profile_manager.bat\n│   └── 📁 tests/               # Test suites\n│       ├── 📁 unit/            # Unit tests\n│       ├── 📁 integration/     # Integration tests\n│       └── 📁 performance/     # Performance tests\n├── 📁 tools/                   # Development tools\n│   ├── 📁 benchmark/           # Performance benchmarking\n│   ├── 📁 validation/          # Quality validation\n│   └── 📁 automation/          # Build automation\n├── 📁 docs/                    # Documentation\n│   ├── 📁 technical/           # Technical documentation\n│   ├── 📁 user-guide/          # User guides\n│   └── 📁 api/                 # API documentation\n├── 📁 samples/                 # Sample files\n│   ├── 📁 input/               # Input test samples\n│   ├── 📁 output/              # Output examples\n│   └── 📁 test-cases/          # Test scenarios\n├── 📁 releases/                # Release packages\n└── 📁 .github/                 # GitHub configuration\n    └── 📁 ISSUE_TEMPLATE/      # Issue templates\n```\n\n---\n\n## ⚡ **Quick Start**\n\n### **Option 1: Direct Launch (Recommended)**\n```bash\n# Clone the repository\ngit clone https://github.com/gabrielschoenardie/encoder.git\ncd encoder\n\n# Run the modular encoder\nsrc\\core\\init.bat\n```\n\n### **Option 2: Development Mode**\n```bash\n# For development and testing\nsrc\\core\\encoderV5.bat\n\n# Run test suite\nsrc\\tests\\run_tests.bat\n\n# Build release package\ntools\\build.bat\n```\n\n---\n\n## 🏆 **Key Features**\n\n### **🎬 Professional Quality**\n- **Hollywood-Level Encoding** – Netflix/Disney+ quality standards\n- **Zero-Recompression Guarantee** – 99.5% Instagram acceptance rate\n- **VMAF Score 95-98** – Broadcast quality validation\n- **BT.709 Color Science** – Instagram native compliance\n\n### **🏗️ Modular Architecture**\n- **Separated Concerns** – Each module has specific responsibility\n- **Easy Maintenance** – Debug and update individual components\n- **Parallel Development** – Multiple features can be developed simultaneously\n- **Extensible Design** – Add new modules without affecting existing code\n\n### **🧠 Intelligent Optimization**\n- **Hardware Detection 2.0** – Microarchitecture-specific optimizations\n- **Content-Aware Analysis** – Automatic profile selection\n- **Adaptive Threading** – CPU-specific performance tuning\n- **Smart Resource Management** – Optimal memory and CPU usage\n\n### **📊 Professional Profiles**\n- **📱 Reels (9:16)** – Vertical content optimization\n- **📺 Feed (16:9)** – Horizontal content for feed/IGTV\n- **🎬 Cinema (21:9)** – Ultra-wide cinematic quality\n- **🚗 SpeedRamp Viral** – High-motion content optimization\n- **⚙️ Custom Profiles** – User-defined configurations\n\n---\n\n## 📊 **Performance Metrics**\n\n| Metric | Target | Typical Range |\n|--------|--------|---------------|\n| **Encoding Speed** | \u003e1.5x realtime | 1.5-2.5x realtime |\n| **VMAF Quality Score** | \u003e95 | 95-98 |\n| **Instagram Acceptance** | \u003e99.5% | 99.5-99.8% |\n| **File Size Efficiency** | Optimal | 15-20% smaller than competitors |\n| **CPU Utilization** | 70-85% | Varies by hardware |\n\n---\n\n## 🛠️ **System Requirements**\n\n### **Minimum Requirements**\n- **OS:** Windows 10 (64-bit) or newer\n- **CPU:** 2+ cores (Intel Core i3 / AMD Ryzen 3 or better)\n- **RAM:** 4GB available memory\n- **Storage:** 2GB free space (SSD recommended)\n- **FFmpeg:** Version 4.0 or newer (auto-detected)\n\n### **Recommended for Optimal Performance**\n- **OS:** Windows 11 (64-bit)\n- **CPU:** 6+ cores (Intel Core i5-8th gen / AMD Ryzen 5 3600 or better)\n- **RAM:** 16GB+ available memory\n- **Storage:** NVMe SSD with 10GB+ free space\n- **Architecture:** Modern CPU (Intel 8th gen+ / AMD Zen2+)\n\n---\n\n## 🚀 **Advanced Features**\n\n### **🔬 Hardware Optimization**\n- **CPU Microarchitecture Detection** – AMD Zen vs Intel Core optimizations\n- **Thermal Management** – Laptop vs Desktop performance profiles\n- **Memory Bandwidth Optimization** – RAM speed-aware configurations\n- **Multi-threading Intelligence** – Optimal core utilization\n\n### **📈 Quality Assurance**\n- **VMAF Validation** – Automated quality scoring\n- **Instagram Compliance Testing** – Platform compatibility verification\n- **Bitrate Accuracy** – Precise file size control\n- **Visual Quality Preservation** – Perceptual optimization\n\n### **🔧 Developer Tools**\n- **Automated Testing** – Unit, integration, and performance tests\n- **Build Pipeline** – Automated release packaging\n- **Performance Benchmarking** – Hardware-specific optimization\n- **Profile Validation** – Configuration verification\n\n---\n\n## 📚 **Documentation**\n\n### **User Documentation**\n- [User Guide](docs/user-guide/README.md) - Complete usage instructions\n- [Profile Guide](docs/user-guide/profiles.md) - Encoding profile explanations\n- [Troubleshooting](docs/user-guide/troubleshooting.md) - Common issues and solutions\n\n### **Technical Documentation**\n- [CLAUDE.md](docs/technical/CLAUDE.md) - Complete AI collaboration context\n- [Architecture](docs/technical/architecture.md) - System design and decisions\n- [API Reference](docs/api/) - Module interfaces and functions\n\n### **Development Documentation**\n- [Contributing Guide](docs/technical/contributing.md) - How to contribute\n- [Testing Strategy](docs/technical/testing.md) - Test framework and guidelines\n- [Release Process](docs/technical/release.md) - Build and deployment process\n\n---\n\n## 🎯 **Use Cases**\n\n### **Content Creators**\n- **Instagram Reels** – Vertical video optimization\n- **Instagram Stories** – Quick story content\n- **Instagram Feed** – Professional horizontal content\n- **Multiple Platforms** – One encode, multiple uses\n\n### **Professional Studios**\n- **Batch Processing** – Multiple files, consistent quality\n- **Custom Profiles** – Brand-specific configurations\n- **Quality Control** – VMAF validation and reporting\n- **Workflow Integration** – Scriptable automation\n\n### **Developers \u0026 Integrators**\n- **API Integration** – Embed encoding capabilities\n- **Custom Modules** – Extend functionality\n- **Performance Testing** – Benchmark different configurations\n- **Research \u0026 Development** – Encoding parameter research\n\n---\n\n## 🤝 **Contributing**\n\nWe welcome contributions! Please follow these steps:\n\n1. **Read Documentation** – Review [CLAUDE.md](docs/technical/CLAUDE.md) for complete project context\n2. **Check Issues** – Look at existing [Issues](../../issues) and [Templates](.github/ISSUE_TEMPLATE/)\n3. **Follow Architecture** – Respect modular design principles\n4. **Add Tests** – Include tests for new functionality\n5. **Update Documentation** – Keep docs current with changes\n\n### **Development Workflow**\n```bash\n# 1. Fork and clone\ngit clone https://github.com/yourusername/encoder.git\n\n# 2. Create feature branch\ngit checkout -b feature/your-feature-name\n\n# 3. Develop and test\nsrc\\tests\\run_tests.bat\n\n# 4. Commit and push\ngit commit -m \"feat: your feature description\"\ngit push origin feature/your-feature-name\n\n# 5. Create pull request\n```\n\n---\n\n## 📄 **License**\n\nThis project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.\n\n### **Third-Party Software**\n- **FFmpeg** - LGPL/GPL licensed (not included, requires separate installation)\n- **x264** - GPL licensed (part of FFmpeg)\n\n---\n\n## 🙏 **Acknowledgments**\n\n- **FFmpeg Team** – For the excellent encoding framework\n- **x264 Developers** – For the superior H.264 codec implementation\n- **Instagram Engineering** – For platform specifications and compatibility\n- **Community Contributors** – For testing, feedback, and improvements\n\n---\n\n## 📞 **Support \u0026 Community**\n\n- **📚 Documentation** – [Complete guides and references](docs/)\n- **🐛 Bug Reports** – [Issue tracker with templates](.github/ISSUE_TEMPLATE/)\n- **💬 Discussions** – [Community discussions](../../discussions)\n- **🤖 AI Context** – [AI collaboration documentation](docs/technical/CLAUDE.md)\n\n---\n\n## 🎬 **Ready to Create Hollywood-Level Instagram Content?**\n\n```bash\ngit clone https://github.com/gabrielschoenardie/encoder.git\ncd encoder\nsrc\\core\\init.bat\n```\n\n**Transform your videos with zero-recompression, guaranteed Instagram compatibility, and professional broadcast quality.**\n\n---\n\n⭐ **If this project helps you create amazing content, please consider giving it a star!**","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgabrielschoenardie%2Fencoder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgabrielschoenardie%2Fencoder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgabrielschoenardie%2Fencoder/lists"}