Saltar para o conteúdo principal
WaveFlow
pt

WaveFlow Server

Estávelv2.2.1

A sua música, onde quer que a ouça.

Os seus ficheiros. O seu servidor. Qualquer leitor.

Indique ao WaveFlow Server as pastas onde guarda a sua música. Ele cria a biblioteca e toca-a num navegador, num telemóvel ou no leitor WaveFlow, em casa ou fora, e baixa a qualidade sozinho quando a ligação está fraca.

Transferir o WaveFlow ServerComo instalar

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

O leitor web do WaveFlow Server: misturas feitas a partir do que ouve, sobre uma grelha de álbuns, com a navegação à esquerda
O leitor web. Capas da biblioteca do próprio programador, mostradas apenas como ilustração.

O que faz

  1. Um leitor no seu navegador

    Nada para instalar: abra o endereço do seu servidor e ouça num computador ou num telemóvel. Por HTTPS, guarde faixas para quando estiver sem ligação.

  2. Funciona com as apps que já usa

    As apps de música compatíveis com Subsonic ligam-se tal como estão, e o leitor WaveFlow mantém a sua biblioteca e as suas audições em sintonia nos seus computadores.

  3. Sabe o que os seus ficheiros são de facto

    Cada ficheiro sem perdas é medido, por isso um FLAC que apresenta as marcas de um ficheiro com perdas é assinalado como tal.

  4. Nada se mexe debaixo dos seus pés

    Os álbuns e os artistas mantêm a mesma identidade quando a biblioteca é analisada de novo, por isso as ligações que as suas apps guardam continuam a funcionar.

  5. Pronto num minuto

    Um programa e um ficheiro de base de dados. Inicie-o no seu próprio computador, ou deixe-o a funcionar num servidor doméstico com Docker.

  6. Seu, e só seu

    Os seus ficheiros de música nunca são alterados. Nada sai do seu servidor sem o ativar, e cada pessoa lá de casa pode ter a sua própria conta.

Em que ponto está

Estável desde a 2.0. A versão 2.2.1 é a mais recente, continuam a sair versões novas, e o servidor pode avisá-lo quando sai uma, depois de lhe permitir que verifique.

  • 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 para extrair e iniciar no seu próprio computador: FFmpeg incluído, sem instalação.

Ligações

O leitor web

Um leitor no seu navegador

Nada para instalar: abra o endereço do seu servidor num computador ou num telemóvel. Álbuns, artistas, pastas e géneros, pesquisa à medida que escreve, a fila de reprodução, letras sincronizadas em ecrã inteiro e misturas feitas com o que ouve de facto.

Sem ligação
Guarde as faixas que escolher e ouça-as sem ligação, nesse navegador e só para a sua conta. Os navegadores permitem-no por HTTPS, ou no computador onde o servidor corre.
Instalável
Adicione-o ao telemóvel como uma app, com controlos no ecrã de bloqueio, teclas multimédia e atalhos de teclado.
14 temas
Claros e escuros, conforme a divisão e a hora.
9 idiomas
Inglês, francês, alemão, espanhol, italiano, japonês, coreano e chinês simplificado e tradicional.
A reproduzir no leitor web: a capa do álbum em grande, o título e o artista, e por baixo a qualidade da transmissão
A reproduzir, com o que está realmente a ser transmitido

Funciona com as apps que já tem

O WaveFlow Server fala Subsonic e OpenSubsonic, o protocolo aberto que muitas apps de música já conhecem. Adicione o seu servidor na app com o respetivo endereço, o seu nome de utilizador e uma palavra-passe de app: sem plugins, nada mais para instalar.

Protocolo
Subsonic · OpenSubsonic
Endereço
/rest/*A maioria das apps adiciona-o sozinha: basta indicar-lhes o endereço do seu servidor.
Palavra-passe
As apps têm uma palavra-passe própria, separada da que usa no navegador.
Apps testadas com o WaveFlow Server, e o que se viu cada uma fazer
AppO que se viu fazer
SymfoniumAndroidNavegar, avançar em Opus, MP3 e FLAC, favoritos, classificações, marcadores, letras
FeishinWindowsNavegar, pastas, letras sincronizadas, rádio, listas de reprodução
DSubAndroidPastas, podcasts, fila de reprodução, listas de reprodução, partilha
JulietiPhoneNavegar, transcodificação, fila de reprodução, listas de reprodução

Cada app foi testada à mão, e cada resultado foi lido de volta no servidor, e não no ecrã da app. A última ronda completa terminou a 28 de outubro de 2026, antes da 2.0.0, pelo que o que foi acrescentado desde então ainda não foi testado com estas apps.

Ler a matriz de compatibilidade

WaveFlow DesktopWindows · macOS · Linux

Mantém a sua biblioteca e as suas audições em sintonia nos seus computadores, através da API nativa

Sabe o que os seus ficheiros são de facto

Uma biblioteca reunida ao longo dos anos guarda surpresas. O WaveFlow Server ouve os próprios ficheiros e envia a cada app o som que ela consegue receber.

A página de qualidade: ficheiros sem perdas medidos a partir do seu áudio, com uma contagem por veredicto e, para cada faixa, o ponto onde terminam os agudos
Cada ficheiro sem perdas medido, e não aceite pela palavra

  • O falso lossless, descoberto

    O áudio de cada ficheiro sem perdas é medido. Um FLAC que apresenta as marcas de um ficheiro com perdas é assinalado como tal, tal como os bits de preenchimento e o áudio reamostrado para uma taxa de amostragem mais alta.

  • O original, ou mais leve pelo caminho

    Ouça o ficheiro original, ou deixe o servidor convertê-lo em tempo real para MP3, Opus ou AAC quando a ligação está limitada. Uma aplicação que avança por intervalo de bytes pode falhar numa conversão ainda em curso: dê-lhe o ficheiro original.

  • Volume uniforme

    O ReplayGain segue para as suas apps com cada faixa, e o servidor pode nivelar sozinho uma transmissão convertida para uma app que não o faça.

Seu, e só seu

Um servidor em sua casa deve responder apenas a si. O WaveFlow Server foi construído assim desde o primeiro arranque.

Tudo o que o servidor pode contactar

  • Os seus ficheiros ficam como estão

    O analisador e cada edição de etiquetas deixam os seus ficheiros de áudio intactos. Um ficheiro que desaparece mantém os favoritos, as classificações e as audições até voltar.

  • Nada sai sem o ativar

    Com as predefinições, o servidor não envia nada por iniciativa própria. As letras, as imagens de artistas, o scrobbling e a verificação de atualizações esperam, cada um, pelo seu sim.

  • Uma conta para cada pessoa lá de casa

    Cada conta vê apenas as bibliotecas a que pertence. As palavras-passe são protegidas com hash Argon2id, o início de sessão tem limites contra tentativas em série, e um token de utilização única impede que um desconhecido se apodere de um servidor acabado de instalar.

  • Cópia de segurança com um só comando

    Um comando copia a base de dados e a respetiva chave em conjunto e, antes de uma atualização que altere a base de dados, o servidor faz por si uma cópia de ambas, a menos que o desative. As imagens de artistas, os canvases e os podcasts transferidos ficam ao lado, na pasta de dados: faça cópia de segurança da pasta inteira para os guardar também.

Pronto num minuto

Um contentor, um ficheiro de base de dados, um ficheiro de chave. Sem servidor de base de dados, sem cache, nada mais para executar, e o FFmpeg já vem incluído.

  1. Guarde isto como compose.yaml

    Substitua /path/to/music pela pasta onde está a sua música. O servidor limita-se a lê-la.

    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. Arranque-o

    O Docker obtém a imagem e inicia o servidor em segundo plano.

    Terminal
    docker compose up -d

  3. Crie a sua conta

    Abra http://your-host:4533. O ecrã de configuração cria a conta de administrador e pede um token de utilização única, que o servidor registou para si:

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

  4. Adicione a sua música

    Indique o nome da conta que acabou de criar (aqui, admin). A primeira análise 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

Construída para amd64 e arm64, por isso funciona num Raspberry Pi 4 ou 5 com um sistema de 64 bits. Cada versão leva o seu número, latest acompanha a última versão estável, e a mesma imagem está no Docker Hub.

  • linux/amd64
  • linux/arm64

Ouvir de fora de casa

O servidor fala HTTP simples, o que serve numa rede de confiança. Para ouvir de qualquer lado, 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 do Caddy

Sem Docker

Cada versão tem também um arquivo para extrair e iniciar no seu próprio computador: sem instalação, com FFmpeg incluído, e o leitor web abre-se sozinho. O Windows e o macOS avisam no primeiro arranque; o README.txt lá dentro diz 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.

Transferir um arquivo

Para ler mais

A família WaveFlow

Uma só forma de ouvir, em todos os ecrãs.

Tudo começa pelo leitor. Um servidor de música, uma aplicação para o telemóvel e um editor de letras são feitos da mesma maneira: os seus ficheiros, nos seus dispositivos, sem nada a pagar.