salvai

✨ O que ele faz

• Cole e pronto. Colou um link, ele entra na lista na hora, com miniatura, título e canal. Copiou um link fora do app? Ao voltar para o Salvaí ele já está preenchido — é só clicar no +.
• Cada link com a sua configuração. Um vídeo em MP4 1080p, outro em MP3 320 kbps, na mesma leva. Dá para trocar depois pelo selo de cada link.
• Qualidade máxima por padrão. Até 4K em vídeo; em áudio, o melhor disponível convertido para MP3 com capa e título embutidos.
• Fila com prioridade. Segure e arraste um card para mudar a ordem. Se o que estava baixando sair do primeiro lugar, ele pausa e continua depois de onde parou.
• Qualquer site. YouTube, Instagram (reels, posts, stories), TikTok, X, Facebook, Vimeo, Twitch e muito mais.
• Contas conectadas. Stories, perfis privados e posts sensíveis exigem login: você entra pela página oficial do site, dentro do app, e o Salvaí cuida do resto.
• Mensagens claras. Quando algo não dá certo, o app explica o porquê (perfil privado, precisa de login, conteúdo removido, site bloqueou…) e o que fazer.
• Armazenamento transparente. Veja quanto espaço o app usa, o que é cada coisa e limpe o que quiser com um clique.
• Tema claro e escuro, com uma transição suave.
• Salvaí no celular. Ligue o modo celular, aponte a câmera para o QR code e peça downloads pelo celular — depois salve os arquivos direto nele. E o caminho inverso: Enviar para o PC manda fotos, vídeos e arquivos do celular para o computador pelo Wi-Fi. Transferência interrompida continua de onde parou.
• Sala de troca. Troque arquivos e pastas de qualquer tamanho com um amigo em outra rede, nos dois sentidos. Ele entra pelo navegador do celular ou do PC, sem instalar nada. É só arrastar os arquivos para a janela; fotos e vídeos aparecem com miniatura antes de baixar e abrem dentro do app depois de recebidos.
• Continua trabalhando na bandeja. Fechou a janela com downloads em andamento, com o modo celular ligado ou com uma sala de troca aberta? O Salvaí vai para a bandeja, avisa com uma notificação e segue trabalhando.
• Funciona com o Claude. Peça para o Claude buscar e baixar vídeos e músicas por você, já organizados em pastas.

📸 Telas

⬇️ Instalação

1. Baixe o Salvai.exe na página de releases.
2. Coloque em uma pasta fixa, por exemplo C:\Users\<você>\AppData\Local\Programs\Salvai\.
3. Dê dois cliques. Pronto — não precisa instalar Python nem nada.

Na primeira vez o app pode levar alguns segundos a mais: ele prepara o ffmpeg e, se o seu PC não tiver Node.js ou Deno, baixa o Deno uma única vez (o YouTube exige um motor JavaScript para liberar as qualidades mais altas).

🛡️ O Windows disse que é vírus?

Não é. Isso acontece porque o Salvaí não tem uma assinatura digital paga (um certificado de assinatura de código custa caro por ano) e porque apps empacotados em um único .exe costumam ser confundidos por antivírus. O código é aberto: está tudo aqui no repositório, e cada release é gerada automaticamente pelo GitHub a partir dele.

"O Windows protegeu o computador" (SmartScreen)

1. Clique em Mais informações.
2. Clique em Executar assim mesmo.

Isso só aparece na primeira vez.

O Windows Defender apagou ou bloqueou o arquivo

1. Abra Segurança do Windows → Proteção contra vírus e ameaças → Histórico de proteção.
2. Encontre o item do Salvai.exe e clique em Ações → Permitir no dispositivo (ou Restaurar).
3. Se quiser evitar que aconteça de novo: Proteção contra vírus e ameaças → Gerenciar configurações → Exclusões → Adicionar uma exclusão → Pasta e escolha a pasta onde está o Salvaí.

O arquivo não abre (bloqueado por ter vindo da internet)

Clique com o botão direito no Salvai.exe → Propriedades → marque Desbloquear → OK.

Quero conferir se o arquivo é o original

Cada release traz um SHA256SUMS.txt. No PowerShell, na pasta do arquivo:

Get-FileHash .\Salvai.exe -Algorithm SHA256

O código exibido precisa ser igual ao do SHA256SUMS.txt. Você também pode enviar o arquivo ao VirusTotal ou gerar o executável você mesmo.

🔐 Contas conectadas

Alguns conteúdos só aparecem para quem está logado: stories do Instagram (sempre, mesmo de perfis públicos), perfis privados (a conta precisa seguir o perfil), posts sensíveis do X e vídeos de grupos do Facebook.

No app, clique no ícone de pessoa → Contas → Entrar. Abre a página oficial do site; você entra normalmente e a janela fecha sozinha.

• O Salvaí nunca vê sua senha — quem recebe é o próprio site.
• A sessão fica só neste PC, criptografada pela proteção de dados do Windows.
• Já está logado no navegador? Dá para importar de lá (funciona melhor com o navegador fechado).
• Use com moderação: baixar muita coisa de uma vez pode fazer o site pedir uma verificação na sua conta.

📱 Salvaí no celular

[!IMPORTANT] O celular precisa estar no mesmo Wi-Fi do computador. Se o computador estiver no cabo, conecte o celular ao Wi-Fi do mesmo roteador.

1. No app, toque no ícone de celular e ligue o Modo celular.
2. Aponte a câmera do celular para o QR code.
3. Pronto: cole links para baixar no PC, acompanhe o progresso e toque em Salvar para levar o arquivo para o celular.
4. Para mandar do celular para o PC, toque em Enviar para o PC e escolha fotos, vídeos ou arquivos.

Quer mandar o acesso para outra pessoa da casa? Toque em WhatsApp, ao lado do link: o Salvaí abre o WhatsApp (o app do PC ou o WhatsApp Web) com uma mensagem pronta, com o link e o nome do Wi-Fi. É só escolher o contato.

• Não precisa instalar nada no celular — abre no navegador (Android e iPhone).
• Assistir sem baixar: em Arquivos no PC, toque no ▶ para ver o vídeo ou ouvir a música direto do computador, podendo avançar e voltar. Se o vídeo estiver num formato que o celular não toca (MKV, WebM, HEVC, AV1…), o PC converte na hora enquanto você assiste.
• A aba Arquivos no PC mostra só o que o Salvaí baixou — nada das outras pastas e arquivos do seu computador.
• No ⋯ de cada arquivo dá para tirar da lista (o arquivo continua no PC) ou apagar do computador: depois de confirmar, ele vai para a Lixeira do Windows e pode ser recuperado. Limpar lista esvazia a lista sem apagar nada.
• Se o download para o celular for interrompido (o Wi-Fi caiu, a tela bloqueou…), ele continua de onde parou.
• Enviar para o PC: o que você escolher no celular vai pela rede local, sem passar pela internet, para a pasta Do celular dentro da sua pasta de downloads. O celular mostra o progresso de cada arquivo, e o PC lista o que chegou na aba Recebidos (com Mostrar na pasta) e avisa com uma notificação. Se a conexão cair no meio, o envio continua de onde parou — e se a página fechar, é só escolher o mesmo arquivo de novo. Deixe a tela do celular aberta até terminar.
• No iPhone, os arquivos vão para Arquivos → Downloads; para colocar na galeria, abra o vídeo e toque em Compartilhar → Salvar vídeo.
• Funciona com cabo ou Wi-Fi no computador, em redes IPv4 e IPv6.
• Quem está conectado: na aba Aparelhos, você vê cada celular conectado e o histórico, e pode desconectar qualquer um — o código do QR muda para ele não conseguir voltar, e os outros continuam conectados.
• Segurança: o modo celular vem desligado. Só aparelhos da sua rede local com o código do QR entram, e o código muda toda vez que você liga. O celular só enxerga e só apaga arquivos que o próprio Salvaí baixou, e o que ele envia fica só na pasta Do celular.

• Confira se o celular está no mesmo Wi-Fi (e não nos dados móveis).
• Na primeira vez, o Windows pergunta se o Salvaí pode usar a rede: permita.
• Se o Windows marcou sua rede como Pública, o app avisa e oferece dois caminhos: marcar a rede como Privada (Configurações → Rede e Internet) ou o botão Liberar no firewall.
• Redes de visitantes de alguns roteadores isolam os aparelhos entre si; nesse caso use a rede principal.

🔁 Sala de troca

Mande e receba arquivos e pastas com quem está em outra rede — outra casa, outra cidade, no 4G. Sem cadastro, sem limite de tamanho e sem subir nada para a nuvem: o arquivo vai direto de um computador para o outro.

1. No app, clique no ícone de duas setas e em Criar sala.
2. Toque em WhatsApp (ou Copiar) para mandar o link e o código da sala.
3. Quando a pessoa entrar, aparece um aviso: clique em Deixar entrar.
4. Cada um adiciona os arquivos e pastas que quer mandar (pelos botões ou arrastando para a janela) e escolhe o que quer baixar — ou Baixar tudo.

• Quem recebe não precisa instalar nada: a sala abre no navegador do celular ou do PC. Se a pessoa também tiver o Salvaí, ela entra por Sala de troca → Entrar numa sala, colando o link e o código.
• Nos dois sentidos: você vê o que cada convidado adicionou e baixa para a pasta que escolher; os convidados veem e baixam o que você adicionou.
• Só sai o que for pedido: os arquivos ficam no aparelho de quem adicionou até alguém clicar em baixar.
• Veja antes de baixar: fotos e vídeos aparecem com miniatura. Depois de recebidos, clique em Ver para abrir a foto ou assistir ao vídeo dentro do app, ou em Mostrar para achar o arquivo na pasta.
• Progresso de verdade: cada item mostra quanto já chegou, a velocidade e o tempo que falta; nas pastas, quantos arquivos já foram.
• Pastas inteiras: no Salvaí, a pasta chega com a mesma estrutura. No navegador do PC (Chrome e Edge), a pessoa escolhe uma pasta e recebe tudo do mesmo jeito; nos outros navegadores e no celular, a pasta chega num .zip.
• Continua de onde parou: se a conexão cair, o download continua de onde parou. No navegador, quem está enviando precisa deixar a aba aberta; se fechar, basta adicionar o mesmo arquivo de novo para continuar.
• Pode fechar a janela: a sala continua aberta na bandeja, junto com os downloads normais.
• Programas pedem confirmação: arquivos como .exe, .bat, .msi e .ps1 aparecem marcados e só são baixados depois de você confirmar.

[!NOTE] A velocidade depende da internet de quem envia. O link passa por um túnel gratuito da Cloudflare (o Salvaí baixa o conector oficial na primeira vez, conferido pelo SHA-256), que não tem garantia de estabilidade. A sala fecha quando você clica em Fechar sala, quando o Salvaí é fechado ou depois de 30 minutos sem uso.

🤖 Usando com o Claude

O Salvaí traz um conector MCP que deixa o Claude buscar, baixar e organizar vídeos e músicas para você. Exemplo:

"Estou estudando estequiometria para o vestibular. Encontra 3 boas aulas no YouTube, baixa em 720p na pasta Vestibular/Química e uma playlist lo-fi em MP3 para eu ouvir estudando."

Os downloads aparecem na fila do app com o selo ✦ Claude, cada um na pasta que ele escolheu.

Como conectar

No Claude Desktop é automático. Ao abrir, o Salvaí baixa o conector (conferido pelo SHA-256 oficial) e se registra no Claude Desktop sozinho. Quando aparecer o aviso "Salvaí conectado ao Claude", feche e abra o Claude Desktop — pronto. Se você remover o Salvaí da configuração do Claude, ele não é adicionado de novo.

O conector fica em %APPDATA%\Salvai\mcp\salvai-mcp.exe e se atualiza junto com o app.

claude mcp add --scope user salvai -- "$env:APPDATA\Salvai\mcp\salvai-mcp.exe"

Qualquer app que aceite servidores MCP locais (stdio) funciona: aponte o comando para %APPDATA%\Salvai\mcp\salvai-mcp.exe.

O que o Claude consegue fazer

Ferramenta	Para que serve
search_media	Busca no YouTube ou no SoundCloud
download_media	Baixa um ou vários links, cada um com formato, qualidade e pasta
list_downloads	Acompanha o progresso e espera terminar
list_files	Lista o que já foi salvo
move_file	Reorganiza arquivos entre pastas (só dentro da pasta de downloads)
salvai_status	Mostra a pasta de downloads, as contas conectadas e o estado da fila

Se o Salvaí estiver fechado, o conector abre o app sozinho. A comunicação acontece só dentro do seu PC (127.0.0.1), protegida por um token que muda a cada abertura. O Claude nunca recebe suas senhas e não consegue apagar nem sair da sua pasta de downloads.

🔄 Atualizações

Ao abrir, o Salvaí confere se há novidades:

• Nova versão do Salvaí — aparece um aviso com Atualizar agora: o app baixa a versão nova da página de releases (e o conector do Claude, se você usa), confere a assinatura SHA-256, troca os arquivos e reabre sozinho. Se algo der errado no meio, a versão atual continua intacta.
• Motor de download — os sites mudam o tempo todo, então o motor (yt-dlp) também é atualizado direto pelo app, sem precisar de uma versão nova do Salvaí.

Clicou em Depois? O aviso daquela versão não aparece mais; uma versão mais nova avisa de novo.

🧹 Armazenamento

No ícone de banco de dados você vê quanto o app ocupa e o que é cada parte: cache da interface, dados do YouTube, sobras de aberturas que foram fechadas à força e componentes baixados (Deno e atualizações do motor). Marque o que quiser e limpe — suas configurações e os vídeos baixados nunca são apagados.

Os vídeos não passam pelo cache: vão direto para a pasta escolhida, e os pedaços temporários do download são apagados assim que o arquivo fica pronto. As sobras de aberturas fechadas à força são limpas sozinhas na próxima abertura. O que sempre fica é essencial: o ffmpeg (~90 MB), que junta vídeo e áudio e converte para MP3, e o conector do Claude (~25 MB). Por isso eles aparecem travados na lista.

❓ Perguntas frequentes

Um download falhou dizendo que precisa de login. Conecte a conta do site em Contas e tente de novo — o app refaz sozinho o que falhou por esse motivo.

Perfil privado. Só funciona se a conta conectada seguir o perfil. É a mesma regra do site: o Salvaí baixa apenas o que você já consegue ver.

Um site parou de funcionar. Os sites mudam com frequência. Atualize para a versão mais recente do Salvaí, que traz o motor de download atualizado.

Onde ficam os dados do app? Em %APPDATA%\Salvai (configurações, contas criptografadas e componentes).

🔒 Segurança e privacidade

• Sem telemetria: nada sobre o seu uso sai do seu PC.
• Contas criptografadas pelo Windows, e o app nunca vê sua senha.
• Modo celular protegido: desligado por padrão, desliga sozinho após 30 minutos sem uso, só aceita aparelhos da sua rede com o código do QR e só entrega arquivos de mídia.
• Sala de troca protegida: só entra quem tem o código e é aprovado por você, só aparece o que for adicionado à sala e ela fecha sozinha após 30 minutos sem uso.
• Atualizações conferidas: cada arquivo baixado (app, motor de download, Deno e conector da Cloudflare) é verificado pelo SHA-256 oficial antes de ser usado.

Os detalhes, os limites conhecidos e como reportar uma falha estão em SECURITY.md.

⚖️ Uso responsável

Baixe apenas conteúdo que você tem o direito de guardar e respeite os termos de uso de cada site e os direitos dos criadores.

🛠️ Desenvolvimento

Requisitos: Windows 10/11, Python 3.14 e Node.js 24 com Yarn 4 (via Corepack).

git clone https://github.com/Kaique292/salvai.git
cd salvai
py -3.14 -m venv .venv
.venv\Scripts\python.exe -m pip install -r requirements-dev.txt
corepack enable
yarn install

Comando	O que faz
yarn dev	Abre o app a partir do código
yarn build	Gera dist\Salvai.exe, dist\salvai-mcp.exe e os hashes
yarn lint	Confere formatação e qualidade (Prettier + Ruff)
yarn format	Formata tudo
yarn test	Roda todos os testes (Python e interface) com cobertura
yarn coverage:badge	Atualiza o badge de cobertura depois dos testes

Os prints deste README saem da interface de verdade, com dados de exemplo: .venv\Scripts\python.exe scripts\screenshots.py (precisa do Microsoft Edge e de internet para baixar as miniaturas).

Estrutura

salvai/
├─ src/
│  ├─ app.py            app (janela, fila, downloads, contas, ponte do MCP)
│  ├─ salvai_mcp.py     conector MCP
│  └─ ui/               interface (HTML, CSS e JavaScript)
│     ├─ mobile/        página do modo celular
│     └─ room/          página da sala de troca no navegador
├─ assets/              ícone, logo e tela de carregamento
├─ tests/              testes do app (pytest) e da interface (vitest)
├─ scripts/             geração da arte e dos prints, build e badge de cobertura
├─ packaging/           configuração do PyInstaller
├─ docs/images/         imagens deste README
└─ .github/             verificação, releases e modelos de issue

Commits e versões

Os commits seguem o padrão Conventional Commits, conferido automaticamente a cada commit (commitlint + husky). Antes de cada commit, o código é formatado (Prettier e Ruff).

Tipo	Quando usar	Efeito na versão
feat	recurso novo	1.x.0
fix	correção	1.0.x
perf	desempenho	1.0.x
refactor	mudança interna	—
docs	documentação	—
build	build e dependências	—
ci	automação	—
chore	manutenção	—

Exemplo: feat: adiciona suporte a playlists do SoundCloud. Um ! depois do tipo (feat!:) marca uma mudança incompatível e sobe a versão principal.

As versões e o CHANGELOG são gerados pelo release-please: a cada push na main ele abre um PR de release; ao aprovar, a versão é publicada e o GitHub gera e anexa o Salvai.exe, o salvai-mcp.exe e o SHA256SUMS.txt.

🇺🇸 In English

Salvaí is a free, ad-free YouTube, Instagram, TikTok, X and Facebook video downloader for Windows. Paste a link and save it as MP4 video (up to 4K) or MP3 audio (up to 320 kbps) — it also supports 1,800+ other sites, playlists, a download queue with priorities, and private content from accounts you connect.

• Phone mode: scan a QR code to send links to your PC, stream what was downloaded and save it to your phone over Wi-Fi — no app to install.
• Exchange room: swap files and whole folders both ways with a friend on another network through a private link and code — they join from any browser, no install. Drag files in, preview photos and videos before downloading.
• Claude integration (MCP): ask Claude to search, download and organize videos and music into folders.
• Single .exe, no install, no telemetry, updates verified by SHA-256.

⬇️ Download for Windows · The interface is in Portuguese (pt-BR).

🙏 Feito com

yt-dlp · FFmpeg · pywebview · Deno · SortableJS · Model Context Protocol · PyInstaller

O FFmpeg é distribuído junto com o app sob a licença GPL; o código-fonte está disponível em ffmpeg.org.

📄 Licença

O Salvaí é software livre sob a licença MIT: você pode usar, estudar, modificar e distribuir, inclusive em outros projetos, desde que mantenha o aviso de copyright.

☕ Apoie o projeto

Se o Salvaí te ajudou, considere pagar um café — isso ajuda a manter o app atualizado.