Sobre o projeto
## Visão geral
Tachikaze é uma ferramenta que faz corte de CM sem reencode em arquivos de gravação já convertidos para mp4. Fortemente influenciada pelo Amatsukaze, foi criada com a motivação de aplicar posteriormente o corte de CM no estilo Amatsukaze a gravações já convertidas em mp4 e de rodar processamento do mesmo tipo em macOS / Linux.
O corpo da ferramenta cuida principalmente da etapa lista de Trim para recorte mp4 sem perdas, e a própria detecção de CM é delegada a ferramentas existentes (chapter_exe, depois join_logo_scp).
## Uso
Exemplo mínimo de execução:
$ tachikaze auto IN.mp4 -o OUT.mp4
auto executa prepare, analyze, gate, cut e remap-subs sem interação. Se o gate julgar suspeito, encerra sem cortar, e isso pode ser ignorado com --ignore-gate. analyze e auto habilitam a detecção de logo por padrão e estimam automaticamente o retângulo do logo a partir da entrada (desabilitável com --no-logo).
Se quiser inserir julgamento, também é possível usar em duas etapas: analyze gera a lista de Trim e cut faz o recorte. O processamento de múltiplos arquivos é deixado a cargo de loops do shell, e há exemplo de fixar o nome de saída como *_CMcut.mp4 para evitar recaptura pelo glob.
## Dependências
Além do corpo principal, as seguintes ferramentas externas são necessárias no PATH.
- chapter_exe: detecção de silêncio e mudança de cena
- join_logo_scp: julgamento de CM (geração de Trim)
- dtvindex: índice de números de quadro comuns
- ffmpeg / ffprobe: prepare, verificação etc.
Build com cargo build --release --locked, instalação com make install (padrão /usr/local, PREFIX alterável). Também há procedimentos de toolchain para macOS e documentação de Docker (o Dockerfile é público, mas não há distribuição de imagens pré-compiladas em registry).
## Limitações conhecidas
- Ambientes verificados: macOS (Apple Silicon) e Linux (arm64, Docker). Windows não suportado
- Vídeo em H.264, áudio em Codec reconhecido pelo mp4-atom (exemplos típicos: Opus / AAC)
- Como o GOP é arredondado para limites de keyframe, permanecem em média 2,1 a 2,5 segundos de CM ao redor das fronteiras de corte (política de tolerância)
- Um processo lida com uma entrada
## Licença e atribuição
O corpo principal é MIT (Copyright (c) 2026 Masayuki Mizuno). O corpo do Amatsukaze não foi portado, sendo tratado como fonte de referência e inspiração de algoritmos e pipeline. Parte da detecção de logo (src/logo/score.rs, src/logo/interval.rs) é porte de código MIT originado do Amatsukaze, mantendo os avisos de copyright conforme o original. Código derivado de delogo com licença desconhecida não foi portado, tendo sido reescrito a partir das fórmulas. As ferramentas externas chamadas em tempo de execução (chapter_exe / join_logo_scp / dtvindex / ffmpeg) são em sua maioria GPL, mas são apenas iniciadas como processos separados, sem linkagem ou compartilhamento do mesmo espaço de endereço, e a troca se dá apenas por arquivos e argumentos de linha de comando.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.