Convertify 2.0 (Background Service Edition)

Instantaneous AVI to MP4 background converter for Windows

Convertify is a streamlined, zero-configuration background service designed to automatically monitor network directories and instantly wrap .avi files into .mp4 containers.

---

✨ Features

• 🎯 Clean Architecture - Maintainable, testable, and scalable codebase.
• ⚡ Instant Conversion (Stream Copy) - Bypasses slow re-encoding completely by copying the video and audio streams directly into an MP4 container.
• 🏢 Hardcoded Network Paths - Direct IP-based UNC paths (\\192.168.1.200) prevent DNS resolution drops in background services.
• 👻 Zero-Argument Background Execution - No CLI, no menus, no prompts. The executable is built to run silently in the background.
• 🧠 Intelligent Caching - Scans only new/modified directories to handle massive network structures in seconds.
• 📝 Hidden Logging - Comprehensive standard logging with automatic hidden folder creation.
• 🔒 File Lock Detection - Safely skips files currently in use by other processes.

---

📋 Requirements

• Python 3.13+ (for development)
• Windows OS (designed specifically for Windows environments and services)

---

🚀 Execution

The tool is designed to be executed as a compiled executable (.exe). Since it takes zero arguments, it can be launched directly or invoked via a silent .vbs wrapper.

VBS 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"
' No arguments needed
objShell.Run """" & exePath & """", 0, True

This automatically processes the predefined directories:

• \\192.168.1.200\Team-design\4. PREPARAR RESUMEN
• \\192.168.1.200\Team-design\8. Base Datos Unica

---

💻 Development Setup

1. Clone & Setup

git clone https://github.com/userlg/Convertify.git
cd Convertify
python -m venv .venv
.\.venv\Scripts\activate

2. Install Dependencies

# Install with development tools
pip install -e .[dev]

---

🏗️ Architecture

Convertify follows Clean Architecture principles:

src/
├── domain/          # Entities, value objects, exceptions, interfaces (contratos)
├── application/     # Use cases + services (orquestación de conversión)
├── infrastructure/  # Implementaciones concretas (FFmpeg, File System, Logger, caching, etc.)

La composición (dependency injection) se realiza en src/container.py, y el flujo principal se ejecuta desde main.py.

Key Design Decisions (V2 Background Service)

1. Instant Stream Copy: El default usa codec="copy" para envolver AVI en MP4 sin recodificar (stream copy).
2. Rutas de red hardcodeadas por UNC IP: El proceso trabaja con \\192.168.1.200\... para evitar problemas de servicios en background.
3. Logging silencioso/robusto: Se usa LoguruLogger (src/infrastructure/logger.py) y se escriben logs en logs/convertify.log.
4. Cero CLI: No hay interacción por consola; el ejecutable corre sin argumentos (compatibilidad con un .vbs silencioso).

---

🧪 Testing y cobertura

# Run all tests
python -m pytest

# Coverage (en src/)
python -m pytest --cov=src --cov-report=term-missing

Actualmente el proyecto mantiene 36/36 tests pasando y una cobertura total ~89%.

---

📦 Building Executable

Para generar el ejecutable standalone en Windows:

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

Salida:

• dist/convertify.exe

---

📄 License

This project is licensed under the MIT License.

👤 Author

userlg