código aberto (MIT) · 100% offline · voz em português
Qualquer PDF vira audiolivro.
narrar transforma PDF, Markdown e texto em áudio com voz pt-BR natural — e faz isso inteiro na sua máquina. Sem chave de API, sem mensalidade, sem limite de caracteres e sem um byte saindo do computador.
narrar-linux.tar.gz · 315 MB · grátis para sempre
$ narrar capitulo.pdf$ narrar --tudo$ narrar -v dora --ia capitulo.pdf$ echo "lembrar de entregar amanhã" | narrar -o nota.mp30
chamadas de API
~25x
mais rápido que o tempo real
6
vozes pt-BR
3
formatos de entrada
// recursos
Tudo o que um leitor de texto em voz alta deveria ter
Nove decisões de projeto que separam “gerou um mp3” de “dá para ouvir um livro inteiro sem cansar”.
100% offline, de verdade
A síntese roda na sua máquina. Nenhuma chamada de API, nenhuma chave, nenhum arquivo enviado para servidor nenhum. Funciona com o wi-fi desligado.
Janela e terminal
A mesma ferramenta em dois modos: uma janela para clicar e um menu de terminal para quem vive no shell. Os dois chamam o mesmo código, então nunca divergem.
PDF que soa como texto corrido
Remonta parágrafos quebrados pela diagramação, junta palavra hifenizada e descarta cabeçalho e número de página solto. Sem isso, a leitura sai picada a cada oito palavras.
Markdown limpo antes de falar
Frontmatter, bloco de código, tabela, bullet e sintaxe de link ficam de fora. O texto dos links continua. Ninguém precisa ouvir uma cerquilha.
Duas engines de voz
piper, a ~25x o tempo real, para atravessar um livro inteiro. Ou a voz de IA kokoro, que soa mais natural e respeita a pontuação. Seis vozes pt-BR no total.
Ritmo de audiolivro
Pausa proporcional à pontuação: parágrafo respira mais que ponto, ponto mais que vírgula. Três ritmos entre 145 e 168 palavras por minuto — nenhum TTS faz isso sozinho.
Dicionário de pronúncia
Um JSON simples ensina como falar sigla e nome próprio que a voz erra. O relatório de cada narração mostra quantas trocas foram aplicadas.
Nunca apaga seu arquivo
Se já existe um arquivo com aquele nome, você escolhe: sobrescrever, salvar com índice ou cancelar. Num lote, a resposta vale para os próximos — oito capítulos não viram dezesseis perguntas.
Grátis e aberto, sem pegadinha
Sem plano, sem limite de caracteres, sem marca d'água, sem conta. Licença MIT: use, modifique e redistribua à vontade, inclusive em projeto comercial. O repositório fica aberto para novas implementações.
// como funciona
Do PDF ao mp3 em quatro passos
O mesmo caminho na janela e no terminal — escolha o que for mais confortável.
Jogue o arquivo em entrada/
PDF, Markdown ou TXT. Pela janela, o botão “Adicionar arquivo…” copia de qualquer lugar do disco — você não precisa mexer em pasta na mão.
Escolha a voz e o formato
Seis vozes pt-BR, mp3 ou wav. “Ouvir amostra” gera uma frase curta na voz marcada, para comparar antes de processar um capítulo inteiro.
Diga onde salvar
O app pergunta antes de gravar qualquer coisa: seletor de arquivo na janela, caminho sugerido no terminal. O enter aceita.
Ouça
O texto limpo fica em texto/ e o áudio em saida/. O botão “Tocar último áudio” toca o que acabou de sair, sem abrir gerenciador de arquivos.
velocidade × naturalidade
Duas engines, para dois usos diferentes
| engine | vozes | velocidade | quando usar |
|---|---|---|---|
| piper | faber, cadu, jeff | ~25x tempo real | livro inteiro, já vem instalado |
| kokoro | alex, santa, dora | ~4x tempo real | quando a naturalidade importa mais |
O modelo da voz de IA tem 338 MB e não vem no pacote: é baixado na primeira vez que você a usa, e o app pergunta antes.
por baixo do capô
Tudo software livre
- Python 3.13o app inteiro
- piper-ttssíntese local rápida
- kokoro-onnxa voz de IA
- pypdf + popplerextração do PDF
- ffmpegwav → mp3
- tkintera janela
// baixar
Três jeitos de instalar
Baixe o pacote pronto aqui mesmo, cole um comando no terminal ou vá direto às releases no repositório.
01download direto
Baixar o app pronto
O pacote já vem com as três vozes pt-BR do piper embutidas. Nada de instalar Python, nada de compilar.
- versão
- v0.3.0
- tamanho
- 315 MB
- publicado
- 09 de setembro de 2026
- sistema
- Linux x86_64
Grátis, sem conta e sem cadastro. O arquivo vem direto da release oficial publicada no GitHub.
02pelo terminal
Baixar e instalar por CLI
Um comando só, sempre apontando para a release mais recente — não precisa trocar a versão na URL.
$ curl -L -o narrar-linux.tar.gz https://github.com/RafaelProfMgz/conversor_texto_audio/releases/latest/download/narrar-linux.tar.gz$ tar -xzf narrar-linux.tar.gz$ cd narrar && ./narrarPrefere wget? Troque curl -L -o narrar-linux.tar.gz por wget. Para abrir a janela em vez do menu: ./narrar-ui.
03repositório
Ou vá direto ao Git
Notas de cada versão, releases anteriores e o código-fonte completo.
Precisa de outra versão, das notas da release ou dos requisitos do sistema? A página de download tem tudo.
// contribuir
O repositório fica aberto para novas implementações
Não é código aberto só de nome: a arquitetura foi desenhada para receber contribuição sem que você precise entender o app inteiro.
Um módulo por responsabilidade
Para plugar outro formato de entrada, o único arquivo a mexer é extrair.py. Para somar um motor de voz, é um módulo novo ao lado de vozes_ia.py mais um ramo em falar.py — o resto do app não muda.
Nada de regra de negócio na interface
A janela e o terminal são duas cascas sobre os mesmos módulos. É por isso que os dois modos nunca divergem, e é por isso que dá para mexer em um sem quebrar o outro.
Pontos abertos agora
Releases oficiais para Windows e macOS, mais vozes pt-BR, suporte a EPUB e DOCX, aceleração por GPU para a voz de IA, e leitura de dialogo com entonação diferente da narração.
$ git clone https://github.com/RafaelProfMgz/conversor_texto_audio.git$ cd conversor_texto_audio$ uv pip install -r requirements.txt$ ./narrarTem uma ideia? Abra uma issue
Bug, pedido de recurso, uma voz que erra a pronúncia de uma palavra — tudo vale. Pull request de gente que nunca contribuiu antes é bem-vindo.
// faq
Perguntas frequentes
O que as pessoas costumam perguntar antes de baixar.
O narrar é realmente gratuito?
É. Não existe plano pago, limite de caracteres, marca d'água nem versão “pro”. O código é aberto sob licença MIT e está inteiro no GitHub — você pode ler, modificar, redistribuir e até usar em projeto comercial, bastando manter o aviso de copyright.
Meus arquivos são enviados para algum servidor?
Não. A síntese acontece na sua máquina e não existe chamada de API em nenhum ponto do código. A internet é usada em exatamente dois momentos, os dois opcionais: procurar versão nova (dá para desligar nos ajustes) e baixar o modelo da voz de IA na primeira vez que você a usa.
Quais formatos de arquivo ele aceita?
PDF, Markdown (.md) e texto puro (.txt). Também dá para mandar texto por pipe no terminal. A saída é mp3 ou wav, e o texto limpo fica salvo em .md para você conferir antes de ouvir.
Quanto tempo leva para converter um livro?
Com o piper, cerca de 25 vezes mais rápido que o tempo real — um capítulo de 25 minutos de áudio sai em torno de um minuto. Com a voz de IA kokoro, que soa mais natural, o processamento fica em torno de 4x o tempo real na CPU.
Funciona no Windows ou no macOS?
A release pronta é para Linux x86_64. O app é Python puro, então roda em outros sistemas a partir do código-fonte — há um build.bat no repositório para Windows. Empacotar releases oficiais para essas plataformas é justamente um dos pontos abertos para contribuição.
Preciso instalar Python ou compilar alguma coisa?
Não para usar a release pronta: o pacote traz o binário e as três vozes do piper embutidas. Extraia e rode. Instalar as dependências só é necessário se você quiser rodar a partir do código-fonte.
A voz soa robótica?
É TTS neural, bem acima do espeak, mas não é voz humana. A voz é neutra e não interpreta diálogo: fala com travessão sai no mesmo tom da narração. Para leitura de estudo, artigo e livro técnico, resolve muito bem.
Dá para doar para o projeto?
Dá, e é opcional. Há uma página de apoio com QR Code e chave Pix. Doar não muda nada no app: não existe versão paga, recurso reservado a doador nem suporte prioritário — a licença MIT vale igual para quem doa e para quem não doa.
Posso contribuir com o projeto?
Pode, e é bem-vindo. O repositório fica aberto para issues, pull requests e ideias. A arquitetura é modular de propósito: para plugar um novo formato de entrada mexe-se num arquivo só, e um motor de voz novo é um módulo ao lado dos que já existem.
Sua pilha de PDFs não vai se ler sozinha.
Baixe, extraia, rode. Em menos de um minuto o primeiro capítulo está tocando — e nenhum arquivo seu saiu do computador.