Pular para o conteúdo principal
WaveFlow
pt-BR

WaveFlow Server

Estávelv2.2.1

Sua música, onde você ouvir.

Seus arquivos. Seu servidor. Qualquer player.

Aponte o WaveFlow Server para as pastas onde sua música está. Ele monta sua biblioteca e toca no navegador, no celular ou no player WaveFlow, em casa ou fora, e baixa a qualidade sozinho quando a conexão está fraca.

Baixar o WaveFlow ServerComo instalar

Docker · Windows · macOS · Linux · Raspberry Pi 4 e 5

O player web do WaveFlow Server: mixes feitos com o que você ouve, acima de uma grade de álbuns, com a navegação à esquerda
O player web. Capas da biblioteca do próprio mantenedor, mostradas apenas como ilustração.

O que faz

  1. Um player no seu navegador

    Nada para instalar: abra o endereço do seu servidor e ouça no computador ou no celular. Via HTTPS, guarde músicas para ouvir quando estiver offline.

  2. Funciona com os apps que você já usa

    Apps de música que aceitam Subsonic se conectam sem ajustes, e o player WaveFlow mantém sua biblioteca e o que você ouve em sincronia entre os seus computadores.

  3. Sabe o que seus arquivos realmente são

    Cada arquivo lossless é medido, então um FLAC que traz as marcas de um arquivo com perdas é sinalizado como tal.

  4. Nada muda debaixo dos seus pés

    Álbuns e artistas mantêm a mesma identidade quando a biblioteca é varrida de novo, então os links que seus apps guardam continuam funcionando.

  5. Pronto em um minuto

    Um programa e um arquivo de banco de dados. Inicie no seu computador ou deixe rodando em um servidor doméstico com Docker.

  6. Seu, e só seu

    Seus arquivos de música nunca são alterados. Nada sai do seu servidor sem você ativar, e cada pessoa da casa pode ter a sua conta.

Em que pé está

Estável desde a versão 2.0. A versão 2.2.1 é a mais recente, novas versões continuam chegando, e o servidor pode avisar quando houver uma, depois que você permitir a verificação.

  • Docker Estável

    Uma imagem para amd64 e arm64: um servidor, um NAS ou um Raspberry Pi 4 ou 5.

  • Windows · macOS · Linux Estável

    Um arquivo compactado para extrair e iniciar no seu próprio computador: FFmpeg incluído, sem instalação.

Links

O player web

Um player no seu navegador

Nada para instalar: abra o endereço do seu servidor no computador ou no celular. Álbuns, artistas, pastas e gêneros, busca enquanto você digita, fila de reprodução, letras sincronizadas em tela cheia e mixes feitos com o que você realmente ouve.

Offline
Guarde as músicas que quiser e ouça sem conexão, nesse navegador, só na sua conta. Os navegadores permitem isso via HTTPS, ou no computador em que o servidor roda.
Instalável
Adicione ao celular como um app, com controles na tela de bloqueio, teclas de mídia e atalhos de teclado.
14 temas
Claros e escuros, para combinar com o ambiente e a hora.
9 idiomas
Inglês, francês, alemão, espanhol, italiano, japonês, coreano e chinês simplificado e tradicional.
Tocando agora no player web: a capa do álbum em tamanho grande, o título e o artista, e a qualidade do stream logo abaixo
Tocando agora, com o que está realmente sendo transmitido

Funciona com os apps que você já tem

O WaveFlow Server fala Subsonic e OpenSubsonic, o protocolo aberto que muitos apps de música já conhecem. Adicione seu servidor no app com o endereço, seu nome de usuário e uma senha de app: sem plugin, sem mais nada para instalar.

Protocolo
Subsonic · OpenSubsonic
Endereço
/rest/*A maioria dos apps adiciona sozinha: basta informar o endereço do seu servidor.
Senha
Os apps recebem uma senha própria, separada da que você usa no navegador.
Apps testados com o WaveFlow Server e as funções verificadas em cada um
AppFunções verificadas
SymfoniumAndroidNavegação, mudança da posição de reprodução em Opus, MP3 e FLAC, favoritos, avaliações, marcadores, letras
FeishinWindowsNavegar, pastas, letras sincronizadas, rádio, playlists
DSubAndroidPastas, podcasts, fila de reprodução, playlists, compartilhamento
JulietiPhoneNavegar, transcodificação, fila de reprodução, playlists

Cada app foi executado à mão, e cada resultado foi conferido no servidor, não na tela do app. O último teste completo terminou em 28 de outubro de 2026, antes da versão 2.0.0, então nem tudo o que foi adicionado desde então passou por esses apps.

Ver a matriz de compatibilidade

WaveFlow DesktopWindows · macOS · Linux

Mantém sua biblioteca e o que você ouve em sincronia entre os seus computadores, pela API nativa

Sabe o que seus arquivos realmente são

Uma biblioteca reunida ao longo dos anos tem surpresas. O WaveFlow Server analisa os próprios arquivos e envia a cada app o som que ele consegue reproduzir.

A página de qualidade: arquivos lossless medidos a partir do áudio, com a contagem de cada veredito e, para cada faixa, onde terminam os agudos
Cada arquivo lossless é analisado, em vez de ser aceito apenas pelo que declara.

  • Lossless falso, descoberto

    O áudio de cada arquivo lossless é medido. Um FLAC que traz as marcas de um arquivo com perdas é sinalizado como tal, assim como bits de preenchimento e áudio convertido para uma taxa de amostragem mais alta.

  • O original, ou mais leve no caminho

    Toque o arquivo original ou deixe o servidor convertê-lo em tempo real para MP3, Opus ou AAC quando a conexão estiver fraca. Um app que usa intervalos de bytes para mudar a posição de reprodução pode não conseguir fazer isso enquanto a conversão ainda estiver em andamento: nesse caso, use o arquivo original.

  • Volume uniforme

    O ReplayGain vai para os seus apps com cada faixa, e o servidor pode nivelar sozinho um stream convertido para um app que não consegue fazer isso.

Seu, e só seu

Um servidor na sua casa deve responder só a você. O WaveFlow Server foi feito assim desde a primeira inicialização.

Tudo o que o servidor pode contatar

  • Seus arquivos continuam como estão

    O scanner e cada edição de tags deixam seus arquivos de áudio intactos. Um arquivo que some mantém favoritos, avaliações e reproduções até voltar.

  • Nada sai sem você ativar

    Com as configurações padrão, o servidor não envia nada por conta própria. Letras, imagens de artistas, scrobbling e a verificação de atualizações esperam o seu sim.

  • Uma conta para cada pessoa da casa

    Cada conta vê só as bibliotecas a que pertence. As senhas são protegidas com Argon2id, o login tem limite contra tentativas de adivinhar a senha, e um token de uso único impede que um estranho tome posse de um servidor novo.

  • Backup com um comando

    Um comando copia o banco de dados e a sua chave juntos, e antes de uma atualização que altera o banco de dados, o servidor faz por conta própria uma cópia de ambos, a menos que você desative isso. Imagens de artistas, canvases e podcasts baixados ficam ao lado, na pasta de dados: faça backup da pasta inteira para guardar esses também.

Pronto em um minuto

Um contêiner, um arquivo de banco de dados, um arquivo de chave. Sem servidor de banco de dados, sem cache, nada mais para rodar, e o FFmpeg já vem incluído.

  1. Salve isto como compose.yaml

    Troque /path/to/music pela pasta onde está a sua música. O servidor só lê essa pasta, nunca altera.

    compose.yaml
    services:
  waveflow:
    image: ghcr.io/instazdll/waveflow-server:2.2.1
    restart: unless-stopped
    ports:
      - "4533:4533"
    environment:
      WAVEFLOW_DATA_DIR: /data
      WAVEFLOW_BIND: 0.0.0.0:4533
    volumes:
      - waveflow-data:/data
      - /path/to/music:/music:ro

volumes:
  waveflow-data:

  2. Inicie

    O Docker baixa a imagem e inicia o servidor em segundo plano.

    Terminal
    docker compose up -d

  3. Crie sua conta

    Abra http://your-host:4533. A tela de configuração cria a conta de administrador e pede um token de uso único, que o servidor anotou para você:

    Terminal
    docker compose exec waveflow cat /data/setup-token

  4. Adicione sua música

    Informe o nome da conta que você acabou de criar (aqui, admin). A primeira varredura começa sozinha.

    Terminal
    docker compose exec waveflow \
  waveflow-server library add --owner admin --name Music --path /music

A imagem

ghcr.io/instazdll/waveflow-server

Feita para amd64 e arm64, então roda em um Raspberry Pi 4 ou 5 com sistema de 64 bits. Cada versão recebe uma etiqueta com o seu número, latest acompanha a última versão estável, e a mesma imagem está no Docker Hub.

  • linux/amd64
  • linux/arm64

Ouvindo de fora de casa

O servidor fala HTTP simples, o que serve para uma rede em que você confia. Para ouvir de qualquer lugar, coloque-o atrás de HTTPS: o repositório tem uma configuração pronta com Caddy, que obtém e renova o certificado sozinho.

A configuração com Caddy

Sem Docker

Cada versão também tem um arquivo compactado para extrair e iniciar no seu próprio computador: sem instalação, com FFmpeg incluído, e o player web abre sozinho. O Windows e o macOS mostram um aviso na primeira abertura; o README.txt que vem dentro explica onde clicar.

  • Windows · x86_64.zip
  • macOS · Apple silicon.zip
  • macOS · Intel.zip
  • Linux · x86_64.tar.gz
  • Linux · arm64.tar.gz

As somas de verificação estão em SHA256SUMS, na mesma versão.

Baixar um arquivo compactado

Para ler mais

A família WaveFlow

Um jeito só de ouvir, em todas as telas.

Tudo começa pelo player. Um servidor de música, um app para o celular e um editor de letras são feitos do mesmo jeito: seus arquivos, nos seus dispositivos, sem nada para pagar.