Documentação
Tudo que você precisa saber para transformar sua experiência de áudio no navegador com o Spatialify.
Recursos Principais
Instalação
A instalação do Spatialify é simples e rápida. Siga os passos abaixo para começar a usar a extensão em seu Firefox.
spatialify.zip ou spatialify.xpi da página de releases do projeto ou do Firefox Add-ons.
about:debugging#/runtime/this-firefox na barra de endereços e pressione Enter.
manifest.json da pasta da extensão (ou o arquivo .xpi completo).
music.youtube.com em uma nova aba. O ícone do Spatialify aparecerá na toolbar quando o site for detectado.
Como Usar
O Spatialify possui duas interfaces principais: o popup rápido na toolbar e o painel de configurações avançadas.
Popup Rápido
Clique no ícone do Spatialify na toolbar do Firefox para abrir o popup. Aqui você encontra:
- Toggle Áudio Espacial: Liga/desliga o processamento com um clique
- Slider de Intensidade: Controle rápido da intensidade do efeito (0-100%)
- Presets: Escolha entre Sutil, Amplo ou Ultra para ajustes rápidos
- Botão Avançado: Abre o painel completo de configurações
Painel de Configurações
Acesse controles detalhados clicando em "Avançado" no popup ou indo em about:addons → Spatialify → Preferências.
| Controle | Descrição | Intervalo |
|---|---|---|
| Largura Estéreo | Controla a expansão lateral da imagem estéreo. Valores altos criam sensação de "palco" mais amplo. | 0% - 200% |
| Efeito Haas | Atraso em milissegundos entre canais. Adiciona profundidade e sensação de espaço. | 0ms - 30ms |
| Inversão de Fase | Inverte a fase do canal direito. Use com cuidado — pode cancelar frequências quando somado a mono. | On/Off |
| Compensação de Ganho | Reduz o volume para compensar o aumento de energia causado pelo processamento. | 0dB - -12dB |
Presets Personalizados
No painel de configurações, você pode salvar suas próprias configurações:
- Ajuste os sliders para sua preferência
- Digite um nome no campo "Salvar Preset"
- Clique em Salvar
- Seu preset aparecerá na lista ao lado
Para deletar um preset personalizado, passe o mouse sobre ele e clique no ícone de lixeira.
Entendendo os Recursos
O que é Áudio Espacial?
Áudio espacial refere-se a técnicas de processamento que criam uma sensação de dimensão, profundidade e posicionamento no som. Diferente de simplesmente aumentar o volume, o Spatialify manipula a imagem estéreo — a distribuição do som entre os canais esquerdo e direito.
Tecnologias Utilizadas
Compatibilidade
O Spatialify foi projetado exclusivamente para o YouTube Music (music.youtube.com). Ele detecta automaticamente quando você está no site compatível e ativa os controles.
<audio> ou <video> da página para aplicar o processamento. Cada site tem uma estrutura diferente, e atualmente o Spatialify é otimizado apenas para o player do YouTube Music.
Perguntas Frequentes
A extensão é gratuita?
Sim! O Spatialify é completamente gratuito e open source. Não há anúncios, nem compras dentro do app.
Por que o ícone está cinza/desativado?
O ícone fica ativo apenas quando você está em uma aba com music.youtube.com aberto. Se estiver em outro site, o popup mostrará uma mensagem indicando para abrir o YouTube Music.
O áudio fica com delay?
O processamento é feito em tempo real pela Web Audio API e não adiciona latência perceptível. O delay configurado no Efeito Haas é intencional para criar profundidade — se preferir áudio mais "seco", deixe este controle em 0ms.
Posso usar com fones Bluetooth?
Sim! O processamento acontece antes do áudio sair do navegador, então funciona com qualquer dispositivo de saída: fones com fio, Bluetooth, caixas de som, etc.
Por que o volume diminui quando ativo?
O processamento de áudio pode aumentar a energia total do sinal (especialmente com expansão estéreo). Use o slider Compensação de Ganho para ajustar o volume final ao seu gosto.
Como desinstalar?
Vá em about:addons no Firefox, encontre "Spatialify" na lista, clique no menu (⋯) e selecione Remover.
A extensão coleta meus dados?
Absolutamente não. Todo o processamento é local. Não coletamos histórico de reprodução, preferências musicais, ou qualquer dado pessoal. Veja a seção de Privacidade abaixo para mais detalhes.
Privacidade & Segurança
O que é processado localmente
- Stream de áudio do YouTube Music (em tempo real, não armazenado)
- Seus presets personalizados (salvos no storage local do navegador)
- Configurações de sliders (também local)
O que NUNCA é coletado
- Histórico de músicas ouvidas
- Conteúdo do áudio (letras, melodias, etc)
- Dados de login do YouTube/Google
- Informações de navegação em outros sites
- Endereço IP ou localização
- Estatísticas de uso
Permissões necessárias
| Permissão | Por que é necessária |
|---|---|
| storage | Para salvar seus presets personalizados e configurações entre sessões. |
| host: music.youtube.com | Para acessar o player de áudio da página e aplicar o processamento. |
Código Aberto
O código-fonte completo do Spatialify está disponível para auditoria.