winget install --id=walterfr.USKMaker -e USKMaker generates complete UltraStar Deluxe karaoke packages from a YouTube link or local audio file. It downloads/prepares the audio, separates vocals, aligns your provided lyrics to the singing using local AI (WhisperX + forced alignment), detects pitch and BPM, and writes a ready-to-play UltraStar .txt package - entirely offline after setup, no cloud APIs.
Gerador de pacotes de karaokê UltraStar a partir de um link do YouTube ou de um arquivo de áudio local, com sincronização de letra, extração de pitch, detecção de BPM e metadados (capa, ano, gênero) automáticos.
O diferencial em relação a ferramentas como o UltraSinger é que o USKMaker parte da letra que o usuário já fornece. O problema passa a ser de forced alignment (alinhar uma letra conhecida ao áudio), não de transcrição do zero — o que resulta em sincronização bem mais precisa, especialmente em português.
Todo o processamento é local: não depende de APIs pagas nem envia áudio para serviços externos. As únicas consultas de rede são a bancos abertos e gratuitos (MusicBrainz/Cover Art Archive, iTunes, Deezer e — opcionalmente, com token pessoal — Discogs) para enriquecer metadados, e o download do YouTube quando solicitado.
O pipeline tem seis etapas:
yt-dlp) ou normaliza um arquivo local para WAV. Opcionalmente baixa também o vídeo, para fundo animado no jogo.htdemucs)..lrc) ou de arquivo aprovado, os tempos de início de linha entram como âncoras fixas. Letras em alfabetos não latinos mantêm o alinhamento via WhisperX automaticamente.LASTFM_API_KEY com uma chave gratuita) → Discogs (opcional: defina DISCOGS_TOKEN com um token pessoal gratuito). As fontes opcionais são puladas quando a variável correspondente não existe. Para a imagem de fundo (#BACKGROUND, 16:9): se FANARTTV_API_KEY estiver definida (chave pessoal gratuita em fanart.tv), busca um artist background real; sem a chave ou sem arte, o fundo reaproveita a capa como [BG].jpg — assim todo pacote com capa tem #BACKGROUND.*, bônus de pontuação, ~5% das notas — padrão calibrado em charts feitos à mão) e monta o arquivo .txt no formato UltraStar, com áudio convertido para .ogg ou .mp3.rust-core, crate uskmaker_core)song_data.json) e o Rust é quem escreve o .txt final a partir dele.libvorbis (para gerar .ogg). Pelo instalador do Windows (Opção A) ele é baixado automaticamente pelo setup-sidecar.ps1; no Linux ele vem da distribuição (o .deb/.rpm já o instalam); no modo desenvolvimento, tenha-o no PATH.Instale direto pelo terminal via Windows Package Manager (WinGet):
winget install walterfr.USKMaker
Ou baixe o instalador manualmente:
USKMaker_x.y.z_x64-setup.exe) na página de Releases e instale normalmente.uv), um ffmpeg embutido (com libvorbis) e as bibliotecas de IA automaticamente, com progresso ao vivo (≈ 10–15 min na primeira vez, ~2 GB, requer internet).Requisitos: Windows 10/11 e (opcional, mas muito recomendado) GPU NVIDIA — sem ela o processamento roda em CPU, ~10 min por música. Python e ffmpeg não precisam ser instalados à mão — o botão cuida disso.
> Usuários avançados (setup manual): o botão não é obrigatório. Você pode configurar o ambiente você mesmo de duas formas: (a) rodar o setup-sidecar.ps1 da pasta de instalação diretamente (clique-direito → "Executar com PowerShell" — faz o mesmo que o botão, pelo terminal); ou (b) montar tudo à mão com o seu próprio Python, como na Opção B abaixo (crie o venv em %LOCALAPPDATA%\USKMaker\venv). O app também respeita um ffmpeg já presente no PATH e um venv que você tenha criado manualmente.
sudo apt install ./USKMaker_x.y.z_amd64.debsudo dnf install ./USKMaker-x.y.z-1.x86_64.rpm.AppImage — chmod +x USKMaker_x.y.z_amd64.AppImage e execute..deb/.rpm já trazem o ffmpeg). O compilador monta uma das bibliotecas de IA durante o setup.
sudo dnf install gcc ffmpeg-free (o ffmpeg-free do próprio Fedora basta — ele tem libvorbis)sudo apt install build-essential ffmpegsudo pacman -S base-devel ffmpegsetup-sidecar.sh, que baixa o Python 3.12 (via uv) e as bibliotecas de IA em ~/.local/share/USKMaker — nada é instalado no sistema e ele nunca pede sudo. Ele escolhe o PyTorch da sua GPU: CUDA na NVIDIA, ROCm na AMD (exige /dev/kfd, ou seja, o driver amdgpu), CPU nos demais casos.O script confere o compilador e o ffmpeg antes de tudo e, se faltar algum, mostra o comando de instalação da sua distribuição. Para rodá-lo num terminal em vez do botão: bash /usr/lib/USKMaker/_up_/scripts/setup-sidecar.sh (.deb/.rpm), ou bash scripts/setup-sidecar.sh a partir do repositório.
cd python-sidecar
python -m venv venv
.\venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
pip install torch torchaudio torchvision --index-url https://download.pytorch.org/whl/cu126
pip install -r requirements.txt
python -c "import torch; print('CUDA:', torch.cuda.is_available())"
Se CUDA retornar False, revise o driver/versão CUDA antes de continuar (o pipeline foi pensado para rodar em GPU).
> Nota: o WhisperX baixa modelos na primeira execução e pode pedir um token do Hugging Face. Configure-o via variável de ambiente HF_TOKEN ou pelo login do huggingface-cli. Nunca coloque o token dentro do código.
No Linux os passos são os mesmos, com python3.12 -m venv venv e source venv/bin/activate; escolha o índice do PyTorch da sua GPU — cu126 para NVIDIA, rocm6.4 para AMD, cpu sem GPU.
npm install
npm run tauri dev
#VIDEO) — o áudio do pacote continua sendo o seu arquivo (útil para coleções ripadas de CD, com qualidade melhor que a do YouTube). Informe o link do clipe ou deixe em branco para busca automática por artista + título; se nenhum vídeo for encontrado, o pacote sai só com a capa.P1:, P2: ou P1&P2: (quando cantam juntos). Uma linha sem tag continua com o cantor da anterior. O pacote sai no formato de dueto da comunidade: headers #P1/#P2 (nomes derivados do artista, ex.: "Elton John & Kiki Dee"), corpo em dois blocos P1/P2 e sufixo [DUET] no arquivo.Artista - Título (padrão das coleções UltraStar; aponte para a pasta Songs do jogo e pronto). Para processar várias músicas de uma vez, use + Adicionar à fila e depois Gerar fila: elas são processadas em série sem reabrir o app, com os modelos de IA já carregados (da 2ª música em diante o alinhamento é bem mais rápido). Marque "Deixar só o essencial" para que, ao fim da fila, os arquivos auxiliares (.lrc, .log, .json) sejam apagados de cada pasta — o pacote fica enxuto, mas sem a tela de revisão (o song_data.json, que ela lê, é removido).O pacote resultante contém o .txt UltraStar, o áudio .ogg/.mp3, a capa [CO].jpg (quando encontrada) e, se solicitado, o vídeo .mp4. Pode ser carregado no UltraStar Deluxe, UltraStar Play ou Vocaluxe.
Vídeo de karaokê (opcional): marque Gerar vídeo de karaokê (.mp4) para sair também um Artista - Título (Karaoke).mp4 — a letra preenchendo sílaba a sílaba por cima do fundo, exatamente no tempo que o alinhamento já mediu. Toca em qualquer TV, celular ou pendrive, sem o jogo instalado. O fundo é o vídeo do pacote (quando há), senão a arte de fundo ou a capa; o áudio é o mesmo do pacote, então Backtrack (instrumental) e transposição valem automaticamente. A renderização roda por último e não é fatal: se falhar, o pacote UltraStar continua completo. O arquivo de legenda usado fica na pasta como _karaoke_subs.ass, então dá para mexer no visual e re-renderizar em segundos pela tela de revisão sem rodar a IA de novo.
M) para desenhar sua voz em tempo real sobre as notas e testar a afinação na hora..bak automático.Funcional de ponta a ponta pela interface gráfica. Todas as etapas de escopo estão concluídas:
.txt com saída idêntica à do protótipo Python, coberta por testes.#BACKGROUND (fanart.tv opcional, com fallback da capa) e vídeo do YouTube opcional no pacote..deb/.rpm/AppImage no Linux, mais o setup assistido do ambiente de IA (setup-sidecar.ps1 / setup-sidecar.sh).song_data.json e regenera o .txt pelo núcleo Rust.O USKMaker é gratuito e de código aberto. Se ele te ajudou, considere apoiar o desenvolvimento — qualquer contribuição ajuda a manter e melhorar o projeto:
Escaneie o QR code no app do seu banco, ou use a chave copia e cola abaixo:
00020101021126400014br.gov.bcb.pix0118walterfr@gmail.com5204000053039865802BR5915WALTER REBOUCAS6009FORTALEZA62070503***63045603
O que mudou em cada versão está no CHANGELOG. Os instaladores ficam em Releases.
MIT. Veja o arquivo LICENSE.
Apoia-se em: WhisperX, Demucs, librosa, SwiftF0, yt-dlp, Tauri, MusicBrainz, Cover Art Archive, iTunes Search API, Deezer API, Last.fm e Discogs. Inspiração de fluxo: UltraSinger.
Made with ♥ in Fortaleza-CE, Brazil by @prof.walterfr