tachikaze

## Resumen Tachikaze es una herramienta que permite **cortar comerciales (CM)** de archivos de grabación ya convertidos a mp4, **sin necesidad de reencodificar**. Está fuertemente inspirada en Amatsukaze y nació del deseo de aplicar el método de corte de CM al estilo de Amatsukaze a grabaciones que ya se habían convertido a mp4, así como de ejecutar este tipo de procesamiento en macOS y Linux. La herramienta se encarga principalmente de transformar una lista de recortes ("Trim list") en un corte libre de pérdidas del archivo mp4, mientras que la detección de comerciales queda en manos de herramientas existentes (chapter_exe → join_logo_scp). ## Uso Ejemplo mínimo: ```console $ tachikaze auto IN.mp4 -o OUT.mp4 ``` `auto` ejecuta `prepare` → `analyze` → gate → `cut` → `remap-subs` de forma no interactiva. Si `gate` considera dudoso algún segmento, omite el corte y finaliza; puede forzarse con `--ignore-gate`. `analyze`/`auto` activan la detección de logotipos por defecto e infieren automáticamente los rectángulos de logo (`--no-logo` para desactivarlo). Si se desea intercalar una fase de revisión, existe el uso en dos pasos: primero `analyze` para generar la lista de recortes y luego `cut` para realizar el corte. Para procesar varios archivos se sugiere usar bucles del shell, fijando el nombre de salida como `*_CMcut.mp4` para evitar la reelaboración por globbing. ## Dependencias Además de la herramienta principal, se requieren las siguientes herramientas externas en el `PATH`: - chapter_exe — detección de silencios y cambios de escena - join_logo_scp — detección de CM (generación de Trim) - dtvindex — índice de números de fotograma comunes - ffmpeg / ffprobe — prepare, validación, etc. Compilación: `cargo build --release --locked`. Instalación: `make install` (prefijo por defecto /usr/local, modificable con PREFIX). También hay documentación sobre los pasos de configuración de herramientas en macOS y sobre Docker (el Dockerfile está disponible, pero no se distribuyen imágenes precompiladas en ningún registro). ## Limitaciones conocidas - Entornos probados: macOS (Apple Silicon) y Linux (arm64, Docker). No hay soporte para Windows. - Vídeo en H.264 y audio cuyo códec reconozca el atom mp4 (ejemplos típicos: Opus / AAC). - Debido al redondeo de GOP a límites de fotogramas clave, pueden quedar aproximadamente 2,1–2,5 s de CM en los bordes de corte (comportamiento aceptado). - Un proceso solo puede tomar un archivo de entrada. ## Licencia y atribuciones El núcleo está bajo licencia MIT (Copyright (c) 2026 Masayuki Mizuno). La implementación de Amatsukaze original no se ha portado; se ha usado como referencia algorítmica y fuente de inspiración del pipeline. Algunas partes de la detección de logos (src/logo/score.rs, src/logo/interval.rs) provienen de código MIT de Amatsukaze con la indicación de copyright original. El código derivado de delogo, cuyo tipo de licencia es desconocida, no se ha portado y ha sido reescrito desde cero a partir de las fórmulas. Las herramientas externas invocadas en tiempo de ejecución (chapter_exe, join_logo_scp, dtvindex, ffmpeg) son mayoritariamente de licencias GPL, pero se lanzan como procesos independientes sin enlace ni compartición en el mismo espacio de direcciones; la comunicación se limita a archivos y argumentos de línea de comandos.