Bem-vindo à beta

Obrigado por testar a acervus. Este guia explica o que tem em mãos, como ficar configurado em cerca de dez minutos, e o que ainda está a ser construído.

O que é a acervus?

A acervus é a casa completa para a sua colecção de música. Unifica bibliotecas de vinil, digitais e cloud num só sítio: importa do Discogs, iTunes, Rekordbox, Serato ou qualquer CSV/XML; reproduz a partir de ficheiros locais, armazenamento na cloud, Bandcamp e YouTube num único leitor; enriquece cada faixa com BPM e tonalidade; etiqueta tudo à sua maneira; e constrói playlists prontas para sets de DJ, programas de rádio ou audição pessoal.

Pense na acervus como um upgrade limpo e DJ-aware de uma página de colecção Discogs — com tags unificadas, um leitor adequado, e as ferramentas específicas que colecionadores e performers realmente precisam.

O que pode fazer hoje

Estas funcionalidades estão ativas na beta:

• Importar a sua colecção — sync Discogs, iTunes XML, Rekordbox XML, exports Serato, Excel, CSV, XML genérico. O assistente de importação mapeia colunas e pré-visualiza resultados antes de confirmar.
• Etiquetagem unificada — géneros e estilos Discogs, géneros iTunes, e tags personalizadas fundem-se num único sistema de tags que controla totalmente. Filtre, fundir, codificar por cor, curar.
• Leitor multi-fonte — ligue pastas locais, Dropbox, Google Drive, OneDrive, links Bandcamp ou YouTube. Reproduza de todos na mesma fila.
• Enriquecimento BPM e Tonalidade — pesquisa automática de várias fontes, override manual, suporte para roda Camelot.
• Playlists — ilimitadas, nomeadas, reordenáveis, filtráveis por BPM/tonalidade/tag. Partilháveis (apenas por link, por agora).
• Dashboard de colecção — álbuns, faixas, artistas, editoras, distribuição por ano, breakdown por formato, e top artistas. Filtre por fonte.
• Edição inline — corrija títulos de faixas, BPMs, tonalidades, tags diretamente da página Musics. Cada edição é rastreada por campo.

O que vem a seguir

Veja o Roadmap na página inicial para a lista completa. Versão curta:

• Em desenvolvimento: Auto-tagging e enriquecimento; CDJ Direct Export (early access para admin testers); External Sync para Airtable/Sheets/Notion.
• Em breve: Wantlist, ferramenta Dig, Shelf & Labeling (organização física + etiquetas impressas), Rádio (reprodução pessoal).
• Planeado: Smart Previews (auto-match YouTube/Bandcamp), aplicação nativa Mac e Windows, app iOS e Android, Community Fund.

Começar — 10 minutos

1. Ligar Discogs (primeiro passo recomendado)

1. Aceda a Definições.
2. Na secção Integrações, clique em Discogs e cole o seu nome de utilizador Discogs e o personal access token. Obtenha um token em Discogs → Settings → Developers → "Generate new token".
3. Clique em Save, depois volte ao Dashboard e clique em Sync from Discogs. Consoante o tamanho da colecção, demora de alguns segundos a alguns minutos.

2. Importar outras fontes (opcional)

1. Aceda a Import / Export.
2. Largue um XML iTunes (Library.xml), XML Rekordbox, export Serato, ficheiro Excel/CSV, ou XML genérico.
3. O assistente de importação mostra colunas detectadas no ficheiro. Mapeie-as para campos acervus (título, artista, BPM, ano, etc.). Pré-visualize as primeiras 5 linhas e confirme.
4. Importações podem ser etiquetadas com um nome de fonte curto (ex. "iTunes" ou "Serato") para que possa filtrar por fonte depois.

3. Enriquecer e etiquetar

1. Abra a página Musics. Qualquer faixa sem BPM ou tonalidade é marcada.
2. Seleccione uma ou mais faixas e clique em Enrich para procurar BPM/tonalidade automaticamente em vários fornecedores.
3. Clique numa tag para filtrar; clique em + Tag numa faixa para adicionar uma. Tags personalizadas são criadas instantaneamente — sem necessidade de pré-definir.

4. Construir uma playlist

1. Abra Playlists.
2. Clique em New, dê nome à playlist, depois arraste faixas a partir de Musics ou páginas de Álbum.
3. Reordene com drag & drop. Exporte para CSV, ou — para admin testers — para uma pen USB Pioneer.

Coisas a saber

Segurança dos dados

• Os seus dados vivem no nosso servidor; mantenha uma cópia de segurança independente dos ficheiros-fonte (não conseguimos recuperar o seu XML iTunes original se desaparecer).
• Pode exportar todos os seus dados acervus como ZIP a qualquer momento em Definições → Privacidade.
• Pode eliminar a sua conta e todos os dados associados em Definições → Privacidade. É irreversível.

Limitações conhecidas

• CDJ Direct Export está em investigação de um freeze hardware com playlists muito grandes em algumas unidades Pioneer. Oculto por defeito; disponível para admin testers.
• Filtro Artista em USB CDJ pode mostrar “Empty” em algumas versões de firmware Pioneer. Esta é uma questão conhecida — o filtro na acervus funciona corretamente.
• Aplicações iOS e Android ainda não existem. A aplicação web é, porém, mobile-friendly.

Dar feedback

Lemos tudo:

• Bugs, comportamento inesperado, relatos de crash: beta@acervus.app. Inclua screenshots e o badge de versão (canto inferior direito de qualquer página, ou visível no card CDJ Export).
• Ideias de funcionalidades ou questões: o mesmo email.
• Questões de segurança, vulnerabilidades: security@acervus.app.

Relatos de bug de alto sinal incluem o que estava a tentar fazer, o que esperava, o que aconteceu na realidade, e valores exactos (título da faixa, fonte, nome de ficheiro, navegador, sistema operativo). Trabalhamos depressa quando temos passos de reprodução claros.

O que pedimos ao utilizador

• Não partilhe o seu link de convite ou credenciais de acesso.
• Não redistribua a acervus em si nem copie o UI.
• Não utilize a acervus para streaming público ou difusão sem as licenças musicais necessárias — ver os nossos Termos.
• Avise-nos quando algo partir. Não podemos corrigir o que não vemos.

Obrigado

Está a testar um produto inacabado. Tudo o que reporta torna a próxima versão melhor. Agradecemos.