Convertify 2.0

Ultra-fast AVI to MP4 video converter with Clean Architecture

Convertify is a professional-grade video conversion tool that automatically converts AVI files to MP4 format with extreme speed optimization. Version 2.0 features a complete architectural redesign using Clean Architecture principles, direct FFmpeg integration for maximum performance, and a beautiful CLI interface.

✨ Features

🎯 Clean Architecture - Maintainable, testable, and scalable codebase
⚡ Extreme Performance - Direct FFmpeg integration (10-20x faster than frame-by-frame processing)
🚀 Speed Optimized - Ultrafast preset with audio stream copying for minimal processing time
🧠 Intelligent Caching - Scans only new/modified directories (perfect for 900+ subdirectories)
🎨 Beautiful CLI - Rich terminal interface with real-time progress tracking
📝 Hidden Logging - Comprehensive logging with automatic hidden folder creation
⚙️ Flexible Configuration - Environment-based settings with multiple speed profiles
🔄 Retry Logic - Automatic retry for failed conversions
🔒 File Lock Detection - Skips files currently in use
📊 Detailed Reports - Conversion statistics and file size comparisons
🏢 Lab Mode - UNC network paths for lab environment workflows
🖱️ One-Click Execution - Double-click exe to start conversion automatically

📋 Requirements

Python 3.12+ (for development)
Windows OS (for file lock detection and hidden folders)
FFmpeg (automatically included with imageio-ffmpeg)

🚀 Quick Start (Executable)

Download and Run

Download convertify.exe from releases
Option 1 - Double Click: Place exe in folder with AVI files and double-click
Option 2 - Command Line: Run with specific options

# Convert current directory (default)
convertify.exe

# Convert lab directories
convertify.exe --lab

# Convert specific directories
convertify.exe --dir "C:\Videos" --dir "D:\Movies"

# Show version
convertify.exe version

🏢 Lab Mode

For lab environments with predefined UNC network directories:

# Use predefined lab directories
convertify.exe convert --lab

This automatically processes:

\\TNAS-Click\Team-design\4. PREPARAR RESUMEN
\\TNAS-Click\Team-design\8. Base Datos Unica

VBS Scripts for Lab

Production Script (convertify.vbs):

' Silent execution for automated workflows
Set objShell = CreateObject("WScript.Shell")
Set objFSO = CreateObject("Scripting.FileSystemObject")
scriptDir = objFSO.GetParentFolderName(WScript.ScriptFullName)
objShell.CurrentDirectory = scriptDir
exePath = scriptDir & "\convertify.exe"
command = """" & exePath & """ convert --lab"
objShell.Run command, 0, True

Debug Script (convertify_debug.vbs):

' Shows console window for troubleshooting
objShell.Run command, 1, True  ' 1 = visible window

See VBS_SCRIPTS_GUIDE.md for detailed documentation.

🧠 Intelligent Caching System

Perfect for directories with 900+ subdirectories!

Convertify includes an intelligent caching system that dramatically speeds up scans of large directory structures:

How It Works

First Scan (e.g., 900 subdirectories):

Scans all directories: ~2-5 minutes
Caches directory modification times
Converts all found videos

Subsequent Scans (every 5 minutes):

Only scans new/modified directories: ~5-15 seconds ⚡
Ignores unchanged directories
Processes only new videos

Cache Features

Automatic - No configuration needed
Intelligent - Detects new and modified directories
Persistent - Stored in cache/directory_cache.json
Scalable - Works with 1000+ subdirectories
Safe - Falls back to full scan on errors

Cache Location

C:\services\cache\directory_cache.json

Performance Impact

Scenario	Time (900 subdirs)	Improvement
First scan	2-5 minutes	Baseline
Subsequent (no changes)	5-10 seconds	20-40x faster
Subsequent (few new dirs)	15-30 seconds	6-20x faster

💻 Development Setup

1. Clone the repository

git clone https://github.com/userlg/Convertify.git
cd Convertify

2. Create virtual environment

python -m venv .venv
.venv\Scripts\activate

3. Install dependencies

pip install -r requirements.txt

4. Configure environment

Copy .env.example to .env and customize:

# Leave empty to use current directory
CONVERSION_DIRECTORIES=

# EXTREME SPEED PROFILE (default)
VIDEO_CODEC=libx264
AUDIO_CODEC=copy
PRESET=ultrafast
CRF=30

5. Run the application

# Convert current directory
python main.py

# Convert with lab mode
python main.py --lab

# Convert specific directories
python main.py --dir "path/to/videos"

⚙️ Configuration

Speed Profiles

Convertify offers three speed profiles:

1. EXTREME SPEED (Default) ⚡

PRESET=ultrafast
CRF=30
AUDIO_CODEC=copy

Speed: 5-10 seconds per 30-second video
Quality: Good for working files
File Size: ~20% larger

2. BALANCED ⚖️

PRESET=veryfast
CRF=26
AUDIO_CODEC=aac
AUDIO_BITRATE=128k

Speed: 15-20 seconds per 30-second video
Quality: Excellent
File Size: Optimized

3. QUALITY 🎯

PRESET=medium
CRF=23
AUDIO_CODEC=aac
AUDIO_BITRATE=128k

Speed: 25-30 seconds per 30-second video
Quality: Maximum
File Size: Best compression

Environment Variables

# Conversion Directories (comma-separated)
CONVERSION_DIRECTORIES=.

# Video Settings
VIDEO_CODEC=libx264
AUDIO_CODEC=copy
PRESET=ultrafast
CRF=30
AUDIO_BITRATE=96k
THREADS=0

# Behavior
REMOVE_SOURCE=true
SKIP_IF_EXISTS=true
MAX_RETRIES=3
RETRY_DELAY_SECONDS=1.0

# Performance
MAX_WORKERS=4

# Logging (creates hidden folder)
LOG_LEVEL=INFO
LOG_FILE=logs/convertify.log
LOG_ROTATION=10 MB
LOG_RETENTION=1 week

🎯 Usage Examples

Basic Usage

# Convert current directory (double-click or run without args)
convertify.exe

# Convert and keep source files
convertify.exe --keep-source

# Convert and overwrite existing MP4s
convertify.exe --overwrite

Lab Environment

# Use lab directories
convertify.exe --lab

# Lab mode with custom options
convertify.exe --lab --keep-source

Custom Directories

# Single directory
convertify.exe --dir "C:\Videos"

# Multiple directories
convertify.exe --dir "C:\Videos" --dir "D:\Movies" --dir "E:\Archive"

Advanced Options

# Show help
convertify.exe --help
convertify.exe convert --help

# Show version
convertify.exe version

🏗️ Architecture

Convertify follows Clean Architecture principles:

src/
├── domain/          # Business logic and entities
│   ├── entities.py      # Core data models
│   ├── interfaces.py    # Abstract interfaces
│   └── exceptions.py    # Domain exceptions
├── application/     # Use cases and services
│   ├── services/        # Business services
│   └── use_cases/       # Application use cases
├── infrastructure/  # External implementations
│   ├── video_converter.py  # Direct FFmpeg integration
│   ├── file_repository.py  # File system operations
│   └── logger.py           # Logging with hidden folders
├── config.py        # Configuration management
└── container.py     # Dependency injection

Key Design Decisions

Direct FFmpeg Integration: Replaced MoviePy frame-by-frame processing with direct FFmpeg subprocess calls for 10-20x speed improvement
Audio Stream Copying: Eliminates audio re-encoding when possible, saving 40-50% conversion time
Hidden Logs: Automatically creates hidden logs folder on Windows for cleaner directory structure
Default Convert: Exe runs convert command by default when double-clicked
Lab Mode: Predefined directories for streamlined lab workflows

🧪 Testing

Run the test suite:

# Run all tests
pytest

# Run with coverage
pytest --cov=src --cov-report=html

# Run specific test file
pytest tests/test_video_service.py -v

All 39 tests passing ✅

📦 Building Executable

Build standalone executable:

pyinstaller --onefile --icon=favicon.ico --collect-all moviepy --name convertify main.py --clean

Output: dist/convertify.exe

🚀 Performance Benchmarks

Conversion Speed (30-second 1080p video)

Configuration	Time per Video	Improvement
MoviePy (old)	~300 seconds	Baseline
FFmpeg + Medium	~25 seconds	12x faster
FFmpeg + Ultrafast + Copy Audio	~5-10 seconds	30-60x faster

Batch Performance (12 videos, ~30 seconds each)

Old Version: ~60 minutes
Current Version: 1-2 minutes 🚀

📝 Changelog

Version 2.0.0 (2026-01-09)

Major Changes:

✨ Complete architectural redesign using Clean Architecture
⚡ Replaced MoviePy with direct FFmpeg integration (10-20x faster)
🚀 Extreme speed optimization with audio stream copying
📁 Hidden logs folder creation on Windows
🖱️ One-click execution (double-click to convert)
🏢 Lab mode for predefined directory workflows
🎨 Beautiful CLI with Rich library
📊 Comprehensive test suite (39 tests)
⚙️ Flexible configuration with speed profiles
🔄 Improved retry logic and error handling

Performance:

30-60x faster than version 1.0
5-10 seconds per 30-second 1080p video
Batch processing: 12 videos in 1-2 minutes

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License.

👤 Author

userlg

🙏 Acknowledgments

MoviePy - Original video processing library
FFmpeg - Core video conversion engine
Typer - CLI framework
Rich - Terminal formatting
Loguru - Logging library
Pydantic - Configuration management

Name		Name	Last commit message	Last commit date
Latest commit History 28 Commits
cache		cache
screenshots		screenshots
src		src
tests		tests
.env		.env
.env.dist		.env.dist
.env.example		.env.example
.gitignore		.gitignore
ARCHITECTURE.md		ARCHITECTURE.md
GUIA_VELOCIDAD.md		GUIA_VELOCIDAD.md
INSTRUCCIONES_EXE.md		INSTRUCCIONES_EXE.md
LICENSE.md		LICENSE.md
Pipfile		Pipfile
README.md		README.md
VBS_SCRIPTS_GUIDE.md		VBS_SCRIPTS_GUIDE.md
conftest.py		conftest.py
convertify.spec		convertify.spec
convertify.vbs		convertify.vbs
favicon.ico		favicon.ico
main.py		main.py
pyproject.toml		pyproject.toml
requirements.txt		requirements.txt
test_lab_dirs.py		test_lab_dirs.py

License

userlg/Convertify

Folders and files

Latest commit

History

Repository files navigation