Tenacity Stems Plugin

Plugin para Tenacity que separa músicas em 6 stems (vocals, drums, bass, piano, guitar, other) usando Demucs e importa automaticamente como novas tracks no Tenacity.

O que é

O tenacity-stems é uma ferramenta CLI que usa o modelo Demucs (htdemucs_6s) para separar qualquer arquivo de áudio em 6 stems independentes e importá-los diretamente como novas tracks no Tenacity via mod-script-pipe.

Pré-requisitos

• Python 3.10+
• uv (gerenciador de pacotes)
• Tenacity com mod-script-pipe habilitado

Instalação

bash install.sh

Na primeira execução, o modelo Demucs (~52MB) será baixado automaticamente.

Uso

uv run python -m tenacity_stems minha_musica.mp3

Opções:

• --output-dir ./separated — diretório de saída dos stems

Como habilitar mod-script-pipe no Tenacity

1. Abra o Tenacity
2. Vá em Editar > Preferências
3. Selecione Módulos
4. Encontre mod-script-pipe e marque Ativar
5. Clique OK e reinicie o Tenacity

Editar → Preferências → Módulos → Ativar mod-script-pipe → OK → Reiniciar

Troubleshooting

"Tenacity não está rodando"

O Tenacity precisa estar aberto com mod-script-pipe habilitado. Abra o Tenacity e siga as instruções acima.

"Não foi possível conectar ao Tenacity"

Verifique se mod-script-pipe está habilitado. Se o erro persistir, reinicie o Tenacity.

"Formato não suportado"

Use arquivos .wav, .mp3 ou .flac.

"Arquivo muito longo"

Máximo suportado: 1 hora. Arquivos maiores podem causar erro de memória.

"Modelo não encontrado"

Na primeira execução, o modelo é baixado automaticamente. Verifique sua conexão com a internet.

Limitações conhecidas

• Piano stem: O modelo htdemucs_6s pode ter artifacts no stem de piano
• Primeira execução: Pode demorar para baixar o modelo (~52MB)
• CPU only: Processamento é ~1.5x a duração do áudio em CPU
• RAM: Necesita ~7GB de RAM para arquivos de 1 hora