Primeiros passos

O Ansuz não navega por pastas: ele lê as tags da sua música uma vez, monta um catálogo e, a partir dele, busca, ordena e reproduz. Comece com ⌘O ou Arquivo › Adicionar pasta… e escolha uma ou mais pastas, locais, em discos externos ou em um NAS montado. Cada pasta é uma fonte e aparece na barra lateral com uma runa, que você pode trocar com o botão direito. Cada seção da barra lateral (Biblioteca, Fontes, Playlists, Apple Music, Spotify) se recolhe com a seta que aparece à direita do título ao passar o mouse; o Ansuz lembra quais você fechou.

O Ansuz nunca modifica seus arquivos por conta própria. Tudo o que ele gera (índice, miniaturas, cache) fica nas pastas dele.

A primeira varredura conta os arquivos e depois lê todos, com o progresso e o tempo restante medidos sobre esse total; as seguintes só comparam tamanho e data e são rápidas. Se você fechar o Ansuz com uma varredura pela metade, na próxima abertura ele conta e compara toda a fonte de novo, mas só lê as tags que ainda não tinha lido; com a varredura concluída, abrir o app não inicia outra. Se você sair com uma varredura em andamento, o Ansuz avisa e deixa você escolher. Pastas locais são monitoradas automaticamente; as de rede são reescaneadas pelo menu da fonte. Se uma fonte não estiver montada, suas músicas ficam em cinza até voltar. Se mudar a coleção para outro disco ou NAS, use Realocar… no menu da fonte: avaliações, playlists e histórico são mantidos.

Falta a senha do servidor. O Ansuz monta sozinho as pastas de rede, sem mostrar diálogos, com a senha que estiver nas Chaves. Se as Chaves não tiverem a senha (por exemplo, porque você passou o NAS de AFP para SMB), a fonte continua na barra lateral marcada Falta a senha do servidor, e ao deixar o ponteiro sobre ela um balão explica o que fazer. Clique com o botão direito na fonte › Conectar pelo Finder… abre a conexão com o seu usuário já preenchido: digite a senha e marque Lembrar esta senha nas minhas chaves. A partir daí o Ansuz a monta sozinho. Se o servidor nem responde (você está em outra rede, ele está desligado), a fonte fica Não disponível, como sempre.

Informações da fonte. Clique com o botão direito em uma fonte (na barra lateral, ou no ícone dela no nível mais alto da visualização por pastas) › Informações da fonte… abre uma janela com a runa no topo e tudo sobre ela: o que a biblioteca sabe (músicas, arquivos ausentes, álbuns, artistas, duração total, tamanho, músicas com letra no Ansuz e os formatos com sua parte do espaço), os arquivos da pasta por tipo (músicas, letras .lrc, imagens e outros, quantos são e quanto ocupam), onde ela está (a pasta, se é um disco interno, externo ou de rede e qual servidor, o volume e seu espaço livre) e o disco que a contém (modelo, SSD ou disco rígido, como está conectado e seu status SMART). Contar os arquivos exige percorrer a pasta inteira, o que leva minutos em um NAS com muitas músicas: por isso o Ansuz guarda a última contagem com a data e só conta de novo quando você clica em Contar de novo. Uma fonte indisponível mostra o que a biblioteca sabe e a última contagem.

As runas. A runa de cada fonte é desenhada como o logo do Ansuz: ouro sobre um quadrado preto. Na visualização por pastas, onde as fontes aparecem grandes, ela também tem uma moldura dourada e o nome da runa embaixo do símbolo; botão direito › Mudar runa para escolher outra. Com Mostrar as fontes indisponíveis desativado, uma fonte indisponível desaparece de todos os lugares: das músicas e dos álbuns, da lista de gêneros e suas contagens e da visualização por pastas.

A biblioteca

• Avaliação e Curti. A tabela de faixas tem uma coluna Avaliação com cinco estrelas (um clique numa estrela define, repetir na mesma remove) e um coração Curti. Os dois também estão no menu contextual da linha, para várias linhas de uma vez, e dá para ordenar por avaliação. Com o Last.fm conectado, o «Curti» é marcado lá também.
• Músicas mostra a tabela. Clicar em um cabeçalho ordena por aquela coluna; o botão Ordenar permite até quatro níveis (artista, depois ano, depois álbum…) e é lembrado. Clique com o botão direito em um cabeçalho para escolher as colunas visíveis; BPM, tonalidade e artista do álbum têm suas colunas.
• Álbuns mostra a grade de capas, com seu próprio Ordenar de quatro níveis. Um clique abre a página do álbum: capa grande, detalhes, Reproduzir, Aleatório, Reproduzir a seguir e a lista de músicas. Ali, um clique duplo na capa a mostra maior, com toda a qualidade da imagem dos seus arquivos. Um clique duplo no nome do artista mostra todos os álbuns dele (os que ele tem como artista do álbum e aqueles em que aparece); Voltar retorna para onde você estava. O menu Campos escolhe o que aparece sob cada capa: título, artista do álbum, artista, ano, músicas, duração, reproduções ou data de adição. Clique com o botão direito em uma capa para um menu com Reproduzir, Aleatório, Reproduzir a seguir, Adicionar à fila, Editar tags e as tarefas de biblioteca limitadas a esse disco: reler tags, reescanear as pastas do álbum (só essas, em segundos: adiciona o que é novo, marca o que falta e junta as músicas que o servidor agora mostra com outro nome), procurar capa, identificar, analisar BPM e tonalidade, calcular ReplayGain. O mesmo menu aparece com o clique direito na capa da página do álbum. Um álbum com vários discos mostra as faixas separadas por disco, como no Apple Music.
• A busca filtra por título, artista, álbum e gênero enquanto você digita, nas duas visualizações.
• Playlists: o + da barra lateral cria uma; o botão direito em uma ou mais músicas as adiciona.
• Músicas sem tags (WAV, DFF, arquivos com tags incompletas) recebem artista, álbum, ano e número de faixa dos nomes de pasta e arquivo, por exemplo Artista - Álbum (Ano)/01 - Título; uma tag presente sempre vence.
• Recentes na barra lateral lista os últimos 100 álbuns adicionados à biblioteca, do mais novo ao mais antigo.
• Início, primeiro item da barra lateral e onde o Ansuz abre, deixa à mão o que você ouve todo dia: prateleiras de álbuns Favoritos, Ouvidos recentemente e Mais ouvidos acima da coleção inteira, tudo em uma só rolagem. Cada prateleira rola para o lado; Ver todos a abre em grade. Marque um álbum como favorito com o coração na página do álbum ou com Adicionar aos favoritos no menu da capa; é uma marca da biblioteca, os arquivos não são alterados. Mais ouvidos soma as reproduções das faixas do álbum; Ouvidos recentemente, a última vez que qualquer uma delas tocou.
• As capas vêm dos arquivos ou de um cover.jpg na pasta; se não houver, do Cover Art Archive e do Last.fm.

Pastas renomeadas ou movidas. Se você renomear uma pasta ou movê-la dentro de uma fonte, o Ansuz reconhece as músicas pelo nome do arquivo, tamanho e data: continuam sendo as mesmas músicas, com avaliações, playlists e histórico. O mesmo vale para um arquivo que aparece com outro nome na mesma pasta: um NAS compartilhado por SMB não consegue enviar nomes com «?» ou «:» e dá a eles um nome curto como 0HCQHK~2.M4A. Na próxima varredura (Reescanear no menu da fonte, ou ⇧⌘R) a música antiga e a nova voltam a ser uma só, com tudo o que as duas tinham. Uma subpasta que o macOS não deixa ler (a lixeira #recycle de um NAS, a pasta de outro usuário) é ignorada, e as músicas dela não são marcadas como ausentes.

Artistas mostra os artistas de álbum com a foto, ou a capa de um álbum até ela chegar. As letras à direita levam a qualquer letra e a busca da barra filtra a lista. A página de um artista tem uma biografia curta, Reproduzir e Aleatório, os álbuns do mais recente ao mais antigo e os artistas relacionados da sua biblioteca. Álbuns, EPs, singles, grandes sucessos e coletâneas aparecem em seções separadas. O tipo é deduzido do título e da duração: até 3 músicas é um single e até 6 um EP, ambos com menos de 30 minutos.

Artistas com o mesmo nome. Duas bandas com o mesmo nome são um único artista para as tags. O Ansuz as mantém separadas com um qualificador mostrado em cinza ao lado do nome; ele nunca vai no scrobble nem nas buscas on-line, mas a busca da biblioteca o usa: airbag argentina encontra só esse Airbag. A separação é automática quando os arquivos trazem o ID de artista do MusicBrainz, quando a pasta do artista se chama “Nome (algo)”, como “Airbag (argentina)”, e quando a correspondência de álbuns com o MusicBrainz mostra que um disco é de outro artista com esse nome. Para fazer à mão, clique com o botão direito em um álbum › Separar artista…, ou use o botão ⋯ do painel Artista: escolha os álbuns que são do outro artista e um qualificador. Sua escolha fica guardada e vale acima do resto; mover os álbuns de volta para o artista sem qualificador os une de novo. Cada artista passa a ter sua própria biografia, foto e próximos shows. Seus arquivos nunca são alterados.

Desconectar uma fonte. Vai viajar e o NAS ou o disco externo ficam em casa? Clique com o botão direito na fonte › Desconectar. O Ansuz deixa uma fonte desconectada em paz: não a procura ao iniciar, não tenta montar o compartilhamento (assim o macOS não mostra a janela de conexão) e não a escaneia nem a monitora. As músicas dela continuam no catálogo como as de qualquer fonte indisponível, ocultas ou em cinza conforme o seu ajuste. A fonte continua na barra lateral, marcada como Desconectada; quando voltar, clique com o botão direito › Conectar e o Ansuz a verifica e a escaneia de novo.

Gêneros. O gênero de uma música é uma lista. O Ansuz lê todos os valores GENRE do arquivo e também separa os que vêm escritos como um único texto (“Chillout, Lounge, Downtempo”, “Pop/Rock”, “House|Deep House”), então uma música conta para cada um dos seus gêneros. Gêneros na barra lateral lista todos com a quantidade de músicas; o campo de busca reduz a lista, e um clique abre a biblioteca filtrada por aquele gênero. Os gêneros também aparecem como botões na página do álbum e na janela de informações da faixa, há uma coluna Gênero na tabela de músicas (clique com o botão direito no cabeçalho para mostrá-la) e um campo Gênero para a grade de álbuns, e a busca encontra músicas por qualquer um dos seus gêneros. Nas playlists inteligentes, “Gênero é Rock” vale para uma música com a tag “Pop, Rock”. No editor de tags, o campo Gênero do álbum preenche todas as faixas e cada faixa tem o seu; escreva vários gêneros separados por vírgulas e eles são gravados como valores separados.

Data de lançamento. Um álbum traz a data de lançamento completa quando ela é conhecida, não só o ano: “12 de março de 1995” sob o título na página do álbum, e um campo Data de lançamento que você pode mostrar sob cada capa na grade de álbuns. O Ansuz a lê da tag DATE dos seus arquivos (e de RELEASEDATE ou ORIGINALDATE quando caem no mesmo ano), e associar um álbum ao MusicBrainz acrescenta o mês e o dia quando suas tags só têm o ano; uma data de outro ano nunca substitui a sua. Ordenar os álbuns por ano os deixa em ordem de lançamento dentro de cada ano. No editor de tags, o campo Data de lançamento aceita só o ano, ano e mês, ou a data completa (1995, 1995-03 ou 1995-03-12) e a grava em todas as faixas. O inspetor do álbum oferece a data do MusicBrainz como uma diferença que você pode aceitar, e Arte - PDF a imprime no encarte e na contracapa.

Coletâneas. Coletâneas na barra lateral mostra só os álbuns que suas tags marcam como coletânea: os que têm a marca de coletânea (COMPILATION = 1, a caixa “Parte de uma coletânea” da maioria dos editores de tags) ou “Various Artists”, “Varios Artistas” ou “Various” como artista do álbum. O Ansuz não deduz pelo conteúdo: um sampler de gravadora guardado sob o nome da gravadora fica de fora a menos que você o marque. Para marcar um álbum, abra o editor de tags e ative Coletânea.

Discos por artista do álbum. O Ansuz monta cada disco pelo artista do álbum das suas tags, não pelo artista de cada faixa. Se as tags não o trazem, decide por pasta: as faixas de uma mesma pasta com o mesmo título de álbum são um disco. Se alguma traz artista do álbum, ele vale para todas; se não, vence o artista da maioria das faixas (um “feat.” conta para o principal) e, sem maioria, o disco aparece como Vários artistas. Isso não o inclui em Coletâneas, que continua mostrando só o que as tags marcam.

Bibliotecas grandes. O Ansuz foi pensado para coleções de até um milhão de faixas. A tabela de faixas, a grade de álbuns, a visualização de pastas e a busca nunca carregam a coleção inteira: pedem ao banco só o que está na tela, então chegar ao fim da tabela é tão rápido quanto o começo. As pastas locais são vigiadas e, quando um arquivo muda, só a pasta dele é lida de novo. Uma busca de uma única letra ou dígito não filtra (com um milhão de faixas, coincidiria com quase todas); a partir do segundo caractere, sim. Com playlists grandes, o iPhone sincroniza em partes e traz só o que mudou.

Visualização por pastas

Além de Músicas e Álbuns, a visualização Pastas percorre sua música do jeito que ela está guardada: cada fonte é uma pasta, e dentro dela você navega pelas mesmas pastas que vê no Finder. Ela tem as três apresentações do Finder, escolhidas à direita da barra de caminho: ícones (a pasta mostra a capa da música que contém), lista (com triângulos para expandir uma pasta no lugar) e colunas (uma coluna por nível, com pré-visualização da música selecionada). Clique duas vezes em uma pasta para abri-la, e em uma música para tocá-la junto com o resto da pasta. As setas de voltar e avançar e a barra de caminho levam você de um lado a outro, e o campo de busca filtra a pasta atual por nome. Clique com o botão direito em uma pasta para tocá-la, em ordem aleatória, colocá-la na fila, criar uma playlist com ela, analisar BPM e tonalidade ou calcular ReplayGain onde ainda falta, ou mostrá-la no Finder; as músicas têm o menu de sempre. Ir para a pasta, no menu de qualquer música e no menu ⋯ do player, salta para a pasta que a contém.

A visualização por pastas vem do índice da biblioteca, não do disco: também funciona com um disco ou compartilhamento desconectado, e mostra apenas os arquivos de áudio que o Ansuz indexou. Com uma fonte selecionada na barra lateral, a visualização fica dentro dessa fonte.

Navegador por colunas

O quarto modo da barra no alto da janela, depois de Músicas, Álbuns e Pastas, é Colunas: a biblioteca filtrada passo a passo. No alto, de duas a cinco colunas lado a lado; embaixo, a tabela de músicas com o que você escolheu. Cada coluna lista os valores de um campo entre as músicas que as colunas à esquerda deixam passar, com quantas músicas cada valor tem. Todos vem sempre primeiro, e no fim Desconhecido, Sem classificação ou Vários artistas reúnem as músicas que não têm esse dado. Com ⌘-clique você escolhe vários valores na mesma coluna. Um clique duplo em um valor reproduz tudo o que ele deixa passar, e o clique direito oferece Reproduzir, Aleatório, Reproduzir a seguir e Adicionar à fila; a tabela de baixo tem o menu de sempre. Para corrigir um gênero errado (ou qualquer outra tag) sem sair da visualização, clique com o botão direito em um álbum da coluna Álbum, ou em músicas da tabela, e escolha Editar tags…: o editor de tags do álbum abre por cima e, ao salvar, as colunas são contadas de novo. Salvar deixa a alteração na biblioteca; gravá-la nos arquivos exige Permitir editar tags nos arquivos em Ajustes › Biblioteca.

Há catorze campos para escolher: gênero, artista, artista do álbum, compositor, álbum, ano, década, formato, taxa de amostragem, fonte, avaliação (estrelas), Curti, tonalidade e BPM (de dez em dez). As colunas ficam guardadas em configurações com nome: o menu da faixa acima das colunas passa de uma para outra, e Editar colunas… renomeia a atual, escolhe o campo de cada coluna, duplica, apaga ou traz de volta as que vêm com o app com Restaurar padrões. O app traz quatro: Gênero (gênero → artista do álbum → álbum), Compositor (compositor → ano → álbum), Década (década → artista do álbum → álbum) e Qualidade de áudio (formato → taxa de amostragem → artista do álbum → álbum).

O navegador trabalha dentro do que está selecionado na barra lateral (todas as músicas, uma fonte…) e da busca, e deixa de fora as versões duplicadas se a biblioteca as oculta. Tudo é contado no banco de dados da biblioteca: mesmo com um milhão de músicas, a primeira coluna leva uma fração de segundo e as seguintes são instantâneas.

Playlists

Crie uma playlist com o + da barra lateral, Arquivo › Nova playlist… (⌘N) ou Nova playlist com a seleção… no menu das músicas. Adicione músicas com Adicionar à playlist nesse menu ou arrastando linhas sobre a playlist na barra lateral; se algumas já estavam lá, o Ansuz pergunta se adiciona mesmo assim ou pula. Dentro de uma playlist, arraste as linhas para reordená-las e Delete as remove. Com o botão direito numa playlist você a reproduz, embaralha, toca a seguir ou manda para a fila, e renomeia, duplica, exporta ou apaga; arraste as playlists para ordenar a barra lateral. O cabeçalho mostra quantas músicas ela tem e quanto duram. Salvar como playlist… no painel da fila guarda o que você ia ouvir.

Playlists inteligentes (+ › Nova playlist inteligente…, ⌥⌘N): se preenchem sozinhas por regras e estão sempre em dia. Atendem a todas ou a qualquer uma das condições sobre título, artista, álbum, gênero, ano, avaliação, curtidas, reproduções, última reprodução, data de adição, duração, BPM, tom, formato, letra, identificação, capa, disponibilidade ou fonte; você pode limitá-las a um número de músicas, minutos, horas ou MB escolhidos ao acaso ou por um campo, e dar uma ordem. O editor mostra ao vivo quantas músicas correspondem. Editar regras… fica no cabeçalho e no menu.

Arquivos: Exportar… grava M3U8, PLS ou XSPF (escolhido pela extensão) com caminhos absolutos; Importar playlist… lê esses formatos, procura cada música pelo caminho nas suas fontes ou, se não achar, por artista e título, e mostra o que encontrou antes de criar a playlist.

Análise de uma playlist. Clique com o botão direito em uma playlist na barra lateral › Analisar BPM e tonalidade ou Calcular ReplayGain executa essa análise nas músicas dela, só onde ainda falta, para que uma playlist longa não refaça o que já foi feito. Para refazer uma, use o menu da música ou do álbum.

Migrar do Música ou do iTunes

Anos de avaliações, reproduções e playlists não precisam ficar para trás. No Música, escolha Arquivo › Biblioteca › Exportar Biblioteca… e salve o XML; no Ansuz, Arquivo › Importar do Música… o lê (o iTunes exporta o mesmo arquivo). As músicas são associadas pelo caminho do arquivo, então adicione primeiro as pastas onde essa música está. Se a pasta mudou de lugar (um NAS montado em outro ponto, uma coleção copiada para um disco novo), o Ansuz ainda encontra as músicas pela última parte do caminho, e funciona com o disco desconectado. As músicas que não são arquivos em disco (Apple Music, streams) ficam de fora.

Antes de gravar qualquer coisa você vê quantas músicas foram encontradas, exemplos das que não foram e o que pode vir: avaliações (só onde você não tem nenhuma no Ansuz, a menos que peça para substituí-las; as que o Música calcula a partir da avaliação de um álbum são ignoradas), Curti, reproduções, pulos e data da última reprodução, e suas playlists, cada uma com quantas de suas músicas foram encontradas. As pastas passam a fazer parte do nome (“Festas / Casamento”), as playlists inteligentes chegam com as músicas que têm hoje, e uma playlist cujo nome você já usa no Ansuz só é substituída se você a marcar.

As reproduções do Música se somam às do Ansuz, e o Ansuz lembra quantas já trouxe de cada música: importe mais tarde uma exportação mais nova e só a diferença é acrescentada. Nada é gravado nos seus arquivos nem na biblioteca do Música.

Estatísticas

Estatísticas na barra lateral mostra o que você andou ouvindo. Escolha um período (7, 30 ou 90 dias, 12 meses, ou tudo) e você tem o número de reproduções com a variação em relação ao período anterior, o tempo de escuta e quantos artistas, álbuns e músicas diferentes tocaram; um gráfico de reproduções ao longo do tempo; os artistas, álbuns, músicas e gêneros mais ouvidos (10, 25 ou 50), cada um com sua barra; e suas reproduções por década, por hora do dia e por dia da semana. Um clique em um álbum o abre, em uma música a encontra na biblioteca, em um gênero o percorre, e em um artista faz a busca. Você também vê os artistas que ouviu pela primeira vez no período, sua sequência atual e a maior de dias com música, e as fotos dos artistas ao lado dos nomes; Exportar… salva tudo em um arquivo CSV para uma planilha.

Uma reprodução é uma escuta completa pela regra do Last.fm: metade da música ou quatro minutos. Uma música conta para cada um dos seus gêneros. Para um período, tudo vem do histórico com data que o Ansuz guarda. “Tudo” usa os contadores de reproduções, então inclui também o que você importou do Música; os gráficos por data, hora e dia da semana contam só o que foi ouvido no Ansuz. Embaixo, Biblioteca diz quanto da sua coleção você nunca ouviu, e um botão cria uma playlist inteligente com exatamente essas músicas.

Reprodução

Aleatório e Repetir. Dois botões na barra do reprodutor. Aleatório deixa a faixa atual primeiro e embaralha o resto; desligar restaura a ordem, e enquanto estiver ativo cada fila nova começa embaralhada. Repetir alterna nada → a fila inteira (a lista ou o disco) → a faixa. Os dois são lembrados.

Minirreprodutor e barra de menus. Uma janela compacta e flutuante (Janela › Minirreprodutor, ⇧⌘M) com a capa, a faixa, os controles, o progresso e o volume, sempre acima das outras janelas. E o Ansuz na barra de menus: a faixa que está tocando com anterior, reproduzir/pausar e próxima, a um clique.

Enquanto carrega. Quando uma faixa demora a começar (um disco de rede ocupado, um disco acordando), o botão de reproduzir mostra um indicador de atividade e a barra mostra a faixa pedida com Carregando… embaixo, até que comece a tocar. Não é preciso clicar de novo: pedir a mesma faixa outra vez não a reinicia. Se você pausar enquanto carrega, a faixa abre pausada e pronta (a barra diz Carregando… (em pausa)). O mesmo acontece ao pular para outra parte da faixa com a barra de progresso, e no iPhone quando ele controla o Mac.

Clique duplo em uma música a reproduz e coloca na fila o restante da lista visível. A barra inferior tem anterior, play/pausa, próxima, a posição (clique para pular) e o volume; clicar no alto-falante silencia. A reprodução é contínua entre músicas; em Ajustes › Geral você pode definir um crossfade de até 12 segundos, que funde o fim de cada música com o início da seguinte (nunca entre músicas recortadas da mesma imagem de disco).

Sem pausas, na amostra. Sem crossfade, quando duas músicas seguidas têm o mesmo formato (frequência e canais), a segunda começa na amostra seguinte à última da primeira, com seu próprio ReplayGain desde a primeira amostra: álbuns ao vivo e mixagens contínuas tocam de ponta a ponta. Se um arquivo deixar de ser lido no meio de uma música (um NAS que se desconectou), a reprodução para com um aviso em vez de percorrer a fila inteira; clique em Reproduzir quando o disco voltar.

Formatos: MP3, AAC, ALAC, FLAC, WAV, AIFF, Ogg Vorbis, Opus e DSD (DSF e DFF), que o Ansuz converte em PCM de alta resolução ao reproduzir. Também APE (Monkey's Audio), WavPack, Musepack, WMA, TTA, TAK, Shorten, RealAudio, ATRAC e TrueHD: o que o macOS não sabe decodificar é decodificado pelo FFmpeg, que vai dentro do app como framework substituível, e os formatos sem perda soam exatamente como o original, amostra por amostra. As teclas de mídia do teclado, a Central de Controle e os fones controlam a reprodução. Os DTS-CD (um fluxo DTS dentro de um WAV ou FLAC) são reconhecidos pelas palavras de sincronismo, aparecem como “DTS” e são decodificados com o decodificador DTS do FFmpeg, que vai dentro do app como framework substituível; discos 5.1 são mixados para estéreo a menos que sua saída tenha mais canais.

Nivelamento de volume (ReplayGain). Ajustes › Geral › Nivelamento de volume lê as tags REPLAYGAIN que seus arquivos já têm (do foobar2000, MusicBrainz Picard, mp3gain e afins) e toca todas as faixas com volume parecido. Faixa iguala tudo; Álbum mantém as diferenças de nível dentro de um disco; Automático usa o ganho do álbum quando a faixa anterior ou a seguinte na fila é do mesmo álbum, e o da faixa caso contrário. A pré-amplificação soma ou tira decibéis, e Evitar clipping limita o ganho ao pico gravado nas tags. Faixas sem tags tocam sem alteração. Calcular os valores para os arquivos que não os têm é uma tarefa agendada, descrita mais abaixo.

BPM e tonalidade. O andamento e a tonalidade são lidos das tags (BPM, INITIALKEY) e aparecem na janela de informações da faixa (⌘I); a tonalidade pode ser escrita na notação clássica (F♯m, B♭) ou na roda de Camelot (11A, 6B), à escolha em Ajustes › Geral.

O menu ⋯. Ao lado da barra de progresso, o botão ⋯ reúne as ações sobre a música que está tocando: informações, adicionar a uma playlist (ou a uma nova), Amei e classificação, Ir para o álbum, Ir para a música (mostra a música na tabela) e as tarefas de biblioteca só para essa música: Completar tags, Reler tags, Analisar BPM e tonalidade e Calcular ReplayGain. As mesmas tarefas estão no menu do clique direito de qualquer música, inclusive dentro da página de um álbum.

Saída de áudio

Em Ajustes › Áudio, ou com o botão de saída ao lado do controle de volume (ele mostra o ícone do dispositivo), você escolhe por onde o Ansuz toca: Saída do sistema segue a que o Mac estiver usando, ou escolha um dispositivo (um DAC USB, fones de ouvido, os alto-falantes integrados). Só o Ansuz toca por ali; todos os outros apps continuam usando a saída do sistema. O Ansuz lembra o dispositivo entre uma abertura e outra.

• Ajustar a taxa de amostragem a cada arquivo (ativado por padrão): o dispositivo muda para a taxa do arquivo, 44,1, 48, 96 kHz…, e assim nada é convertido. Se o dispositivo não tiver essa taxa, o Ansuz usa a mais próxima que seja limpa (um múltiplo inteiro, como 88,2 para 44,1). Músicas com a mesma taxa continuam sem pausas; quando a taxa muda entre duas músicas há uma pausa curta enquanto o dispositivo troca.
• Modo exclusivo (desativado por padrão): enquanto o Ansuz tiver uma música carregada, nenhum outro app pode tocar por esse dispositivo, nem os sons do sistema. Ele é liberado quando a reprodução para. Alguns dispositivos, como os agregados, não permitem isso; os ajustes avisam.
• Volume: se o dispositivo escolhido tem controle de volume próprio, o controle do Ansuz move esse volume e o áudio chega ao dispositivo em nível digital máximo. Quando você muda para um dispositivo assim, o Ansuz assume o nível que ele já tinha.
• Bit-perfect: o rótulo ao lado do volume fica verde quando o dispositivo recebe as amostras do arquivo exatamente como são. Quando está cinza, a dica dele diz o que as altera: uma taxa diferente, o volume do Ansuz abaixo do máximo, ReplayGain, crossfade, DSD ou DTS convertidos para PCM, multicanal mixado para estéreo, um arquivo com mais bits do que o dispositivo aceita, ou Bluetooth e AirPlay.
• DSD nativo (DoP): se o seu DAC aceita DSD sobre PCM (DoP), ative Enviar DSD nativo (DoP) para ele em Ajustes › Áudio; a opção aparece quando o dispositivo chega a 176,4 kHz. Assim, os arquivos DSF, DFF e SACD chegam ao DAC como o fluxo original de 1 bit, de DSD64 a DSD256, sem conversão. Enquanto o DSD toca desse jeito, o Ansuz usa o dispositivo em modo exclusivo e não mexe nas amostras: sem ReplayGain nem crossfade, e o controle de volume só funciona se o dispositivo tiver volume próprio. A etiqueta ao lado do volume mostra DSD · DoP. Ative apenas para um DAC compatível com DoP: qualquer outro dispositivo reproduz isso como ruído alto.
• Se o dispositivo escolhido for desconectado, o Ansuz pausa, passa para a saída do sistema e avisa você; quando ele volta, oferece voltar a usá-lo.

Quando o Ansuz é encerrado, cada dispositivo volta à taxa que tinha e o modo exclusivo é liberado. O Ansuz nunca muda o dispositivo que o resto do Mac usa.

Discos inteiros em um arquivo

Um CD inteiro extraído em um único arquivo aparece na biblioteca como suas faixas, não como uma linha de uma hora: cada faixa com título, duração, avaliação, histórico e letra próprios, reproduzidas sem cortes uma após a outra. O arquivo inteiro não é listado além delas.

Imagem de áudio + folha .cue. Qualquer formato que o Ansuz reproduz serve como imagem (FLAC, APE, WavPack, WAV, AIFF, ALAC, MP3, e DSF/DFF para rips de vinil em DSD). A folha .cue fica na mesma pasta que a imagem:

• É associada pelo nome declarado em FILE: exato, ou o mesmo nome sem extensão (a folha diz .wav, a imagem é .flac). Com várias folhas na pasta, vence a que tem o nome da imagem.
• Uma folha pode ter vários FILE, por exemplo um lado de vinil por arquivo. Cada faixa vai do seu INDEX 01 ao seguinte; o pregap fica com a faixa anterior, como no EAC e no foobar2000.
• Uma folha «por faixa» (um arquivo por faixa, cada um com um único TRACK em 00:00:00) não divide nada: esses arquivos são indexados normalmente.
• Da folha vêm os títulos e intérpretes das faixas, o título e o artista do disco, REM DATE, REM GENRE e REM DISCNUMBER; o que ela não declara vem das tags da imagem (álbum, ano, gênero, capa). Quando diferem, a folha vence. Codificação UTF-8 ou Latin-1.
• Se a folha mudar ou sumir, a próxima varredura refaz as faixas. Essas faixas ficam fora do editor de tags: os dados delas estão na folha.

Imagens ISO de SACD. Um .iso de Super Audio CD é lido diretamente, em DSD puro ou comprimido em DST, imagem normal ou dump bruto. As faixas vêm do índice do disco: título, intérprete e compositor por faixa, título e artista do álbum, ano. O ISO não traz capa: coloque um cover.jpg na pasta. Usa-se a área estéreo; em Ajustes › Biblioteca, Reproduzir a área multicanal toca a área surround quando existe, mixada para estéreo ou em 5.1 se a sua saída permitir.

Não suportados: folhas que apontam para outra pasta, imagens BIN brutas e ISOs de dados com arquivos dentro (não são SACD).

O painel lateral

⌥⌘I abre o painel da direita, que acompanha a música em reprodução:

• Fila: o que está tocando e o que vem a seguir. Clique duplo pula para uma música, arrastar reordena, ⌫ ou botão direito remove, Limpar esvazia.
• Letra: de um arquivo .lrc ao lado da música, das tags do arquivo, ou do LRCLIB (correspondência exata por título, artista, álbum e duração; se vários candidatos servem, você escolhe um). Se for sincronizada, a linha atual é destacada e um clique pula para aquele ponto. A letra que você traz vence todas as outras: Importar letra… aceita um .txt ou .lrc, Colar letra usa a área de transferência, e você pode arrastar um arquivo para o painel. Uma letra sem sincronia se sincroniza depois no editor Sincronizar: Espaço ou Enter em cada linha quando é cantada, ↑↓ para mover, ←→ para ajustar ±100 ms (⇧ 10 ms, ⌥ 1 s), ⌘↩ para reproduzir a partir de uma linha, ⌫ para apagar a marca, e ⌘Z desfaz tudo. Salvar guarda a sincronização na biblioteca; Ajustes › Biblioteca também pode escrever um .lrc ao lado do arquivo. Publicar no LRCLIB compartilha uma letra sincronizada com a base pública após uma prévia dos dados; o Ansuz resolve o proof-of-work do LRCLIB em segundo plano e avisa ao terminar. Letras que você contribuiu, na barra lateral, lista o que você publicou. Remover letra apaga o que está guardado para o Ansuz procurar de novo. Os botões A acima da letra a diminuem ou aumentam, assim como ⌘− e ⌘+ (⌘0 volta ao tamanho normal) e o gesto de pinça no trackpad; o Ansuz lembra o tamanho.
• Artista: foto, biografia no seu idioma e site oficial, buscados por vez nas tags dos seus arquivos, MusicBrainz, Wikidata, Discogs (depois de colar seu token em Ajustes › Discogs) e Last.fm; botões para o site, Bandcamp, Wikipédia, Discogs e as redes oficiais (Instagram, Facebook, X, YouTube, Spotify, Apple Music…), cada um com a fonte na dica. Se o site não aparecer, Buscar na web abre o navegador, e o campo Site deixa você digitá-lo: o Ansuz respeita o que você escreveu. Além disso, próximos shows com data, cidade, casa e link para ingressos segundo Bandsintown e Ticketmaster (Bandsintown cobre o mundo todo; Ticketmaster só onde vende), gêneros e artistas parecidos.
• Semelhantes: músicas parecidas segundo o Last.fm, marcando as que você já tem.

⌘I ou Visualização › Informações da faixa em reprodução… abre uma janela com tudo o que o Ansuz sabe sobre a faixa atual: capa, dados do álbum, características da gravação (formato, taxa de amostragem, canais, taxa de bits, duração e, para uma faixa dentro de uma imagem de disco, seu segmento, além do código ISRC e do ID de gravação do MusicBrainz quando o arquivo os traz ou o Ansuz o identificou), o arquivo físico com o local e um botão para mostrá-lo no Finder, uso na biblioteca e a letra. Informações da faixa… no menu do botão direito da tabela abre o mesmo para qualquer faixa.

Versões preferidas

Quando a mesma música existe em várias fontes (por exemplo em MP3 e em FLAC), o Ansuz agrupa as cópias e escolhe uma versão preferida: ganha a fonte mais acima na barra lateral (arraste para mudar a prioridade) e, na mesma fonte, a melhor qualidade. Toda a música mostra só as preferidas; cada fonte mostra tudo o que tem. Músicas com cópias levam a marca “N versões”, e Ver todas as versões no menu do botão direito as lista. Botão direito em Toda a música desativa a ocultação.

Last.fm e ListenBrainz

Em Ajustes › Last.fm, Conectar abre o navegador para autorizar o Ansuz; assim que você autoriza, o Ansuz percebe sozinho e se conecta em segundos. Em Ajustes › ListenBrainz não há chave de aplicativo para autorizar: cole o token de usuário do seu perfil do ListenBrainz (listenbrainz.org/settings) e clique em Conectar. Você pode usar um serviço ou os dois. A partir daí cada reprodução é enviada ao passar da metade da música ou de quatro minutos, com o número da faixa, o artista do álbum e o ID de gravação do MusicBrainz quando o Ansuz o conhece (e o ISRC para o ListenBrainz), assim os serviços reconhecem a gravação exata em vez de adivinhar pelos nomes. Sem rede, as reproduções ficam guardadas e são enviadas depois; cada serviço tem sua própria fila e seu próprio Tentar novamente.

Apple Music, Spotify e TIDAL

As quatro ficam em Ajustes › Plataformas, cada uma com seu interruptor: uma plataforma desativada some da barra lateral e de Publicar no, e a conta continua conectada.

Em Ajustes › Plataformas › Apple Music, Conectar pede permissão ao macOS; não é preciso conta nem chave além do seu ID Apple. A partir daí uma seção Apple Music na barra lateral lista suas playlists do Apple Music: cada uma mostra as músicas, marca as que já estão na sua biblioteca (Tocar reproduz dos seus arquivos), tem Abrir no Música e, com assinatura do Apple Music, Tocar no Apple Music toca dentro do Ansuz. Clique com o botão direito em uma playlist sua e escolha Publicar no Apple Music…: o Ansuz combina cada música com o catálogo (por ISRC quando seus arquivos o trazem, senão por título, artista e duração), mostra o que encontrou e cria a playlist na sua biblioteca do Apple Music, que vai com você para o celular. Músicas não encontradas ficam de fora.

Spotify funciona do mesmo jeito em Ajustes › Plataformas › Spotify: Conectar abre o navegador para autorizar o Ansuz e traz você de volta. Suas playlists do Spotify aparecem na barra lateral, as músicas que você tem tocam dos seus arquivos, Abrir no Spotify abre a playlist no app do Spotify e Publicar no › Spotify a cria na sua conta. O Spotify só compartilha as músicas das playlists que você criou ou nas quais colabora: uma playlist que você segue mostra um aviso no lugar das músicas. Abrir no Spotify oferece o app do Spotify ou o site, e cada música que você não tem traz os mesmos dois ícones na coluna Ouvir. O Spotify não deixa outros apps tocarem seu catálogo no Mac, então aqui não há botão de tocar.

TIDAL funciona do mesmo jeito em Ajustes › Plataformas › TIDAL: Conectar abre o navegador para autorizar o Ansuz e traz você de volta. As playlists que são suas no TIDAL aparecem na barra lateral, as músicas que você tem tocam dos seus arquivos, Abrir no TIDAL oferece o app do TIDAL ou o site (também por música), e Publicar no › TIDAL cria a playlist na sua conta como não listada. O TIDAL só deixa outros apps tocarem prévias, então aqui também não há botão de tocar. O YouTube Music é só importação: Ajustes › Plataformas › YouTube Music conecta sua conta do Google com permissão somente leitura, suas playlists do YouTube Music (e suas curtidas) aparecem na barra lateral, as músicas que você tem tocam dos seus arquivos e o resto abre no site do YouTube Music. Não se publica no YouTube Music: a cota diária do YouTube é compartilhada por todos que usam o Ansuz. Para levar uma playlist mesmo assim, Publicar no › YouTube Music (arquivo CSV para o TuneMyMusic)… salva um CSV com título, artista, álbum e ISRC de cada música; envie-o no TuneMyMusic (um serviço web gratuito) com o YouTube Music como destino e a playlist é recriada na sua conta.

Arte - PDF: encarte e capas para o seu CD

Na página de um álbum, Arte - PDF… (⌘P) monta um PDF com o que o Ansuz já sabe do disco: a capa, as tags, as letras e a ficha técnica. Escolha o encarte (A4 ou Carta, claro ou escuro, com a ficha técnica, os créditos, as tags e as letras que você marcar: capa, dados e lista de músicas, todas as tags dos arquivos (as que todas as músicas compartilham uma vez, depois as de cada música), uma letra por página) ou as capas da caixa (caixa jewel com frente dobrável de quatro faces e contracapa com lombadas, caixa jewel com frente simples, frente para caixa slim ou digipak de quatro painéis) em tamanho real com marcas de corte, e sangria de 3 mm só se for para uma gráfica. A pré-visualização se atualiza a cada opção; Salvar PDF… salva onde você quiser e Imprimir… imprime em 100 % para as medidas saírem certas. Se a melhor capa for pequena, o Ansuz avisa e pode procurar uma grande na internet. As escolhas ficam guardadas por álbum. É para ter seus discos no computador ou repor uma capa estragada: um álbum por vez, sem etiquetas para o disco nem códigos de barras.

Identificação

Botão direito › Identificar com AcoustID calcula a impressão digital acústica da música e consulta o AcoustID e o MusicBrainz. Guarda os identificadores e, se o arquivo não tinha tags, preenche título, artista e álbum na biblioteca (não no arquivo). Ajustes › Identificação permite identificar toda a biblioteca.

Completar tags. Procura no MusicBrainz o que falta na música (título, artista, álbum, ano, gênero, ISRC), identificando-a antes pela impressão digital se for preciso, e adiciona à biblioteca do Ansuz. Nunca substitui um valor que já existia e nunca grava no arquivo. Calcular ReplayGain em uma só música mede o disco inteiro, porque o ganho de álbum precisa de todas as faixas.

Edição de tags

O Ansuz edita tags em duas etapas. Editar muda a biblioteca na hora (a busca, as playlists, o iPhone e todas as visualizações veem na mesma hora) e deixa a alteração aguardando gravação; seus arquivos só são tocados quando você clica em Gravar tags. Assim você pode editar com um disco ou um NAS desconectado, desfazer e revisar tudo antes que um único arquivo mude.

O Editor de tags (⌥⌘T, ou Abrir no editor de tags nas faixas selecionadas) tem um filtro em cima: regras como as das playlists inteligentes, mais Aguardando gravação, Em conflito, Não foi possível gravar e Parte de uma imagem de disco, e filtros prontos como Sem gênero ou Sem compositor no menu Filtros. O resultado fica parado enquanto você edita (uma faixa que você corrige não some da lista) até você clicar em Atualizar. Clique duas vezes em uma célula ou pressione Return para editá-la; Tab passa ao campo seguinte e Return ao mesmo campo da faixa seguinte. Definir … Aplicar à seleção ou Aplicar a todas coloca um valor em muitas faixas de uma vez (deixe o valor vazio para limpar o campo). ⌘Z e ⇧⌘Z desfazem e refazem edições inteiras. As células editadas aparecem em cor, e um ponto marca as faixas aguardando gravação.

O painel lateral mostra todos os campos das faixas selecionadas, agrupados: básico, créditos (compositor, letrista, arranjador, intérprete, regente), lançamento, identificadores e outros. Com várias faixas, um campo que difere mostra Vários: digitar um valor o coloca em todas, e o botão ao lado oferece Usar o valor da primeira faixa ou Limpar em todas. Um campo vazio que o álbum tem (artista do álbum, data) aparece em cinza: pressione Return para confirmá-lo na faixa. Enquanto você digita, o Ansuz sugere valores que já existem na sua biblioteca, os mais usados primeiro.

Percorrer (⌘R) passa pelo resultado uma faixa por vez, com os campos que você marcou no painel lateral (gênero e compositor por padrão) e a música tocando a partir dos 30 segundos; sua fila de reprodução pausa e continua depois. Return aceita e passa à próxima, ⌘Return aplica os mesmos valores ao resto do álbum, ⌘← volta, ⌘D copia o que você aceitou na faixa anterior, e Sem letra (instrumental) marca uma faixa para que ela deixe de aparecer em Sem letra. Fora dos campos, Espaço pausa a música e as setas avançam ou voltam 5 segundos. O Ansuz lembra onde você parou.

Padrões e ações… altera muitas faixas de uma vez, com uma prévia de cada mudança antes de aplicá-la: Tag → Tag preenche um campo a partir de um padrão no estilo do Mp3tag (%artist%, %title%, %track%, %filename%… e funções como $title(), $num(%track%,2), $replace() ou $regex()); Nome do arquivo → Tags lê campos do nome do arquivo e, com “/”, das suas pastas (%artist%/%album% (%year%)/%track% %title%); Maiúsculas aplica maiúsculas de título no seu idioma (palavras pequenas como “de” ou “e” ficam em minúscula, e números romanos e siglas são respeitados), maiúsculas de frase, tudo em maiúsculas ou tudo em minúsculas; Numeração numera as faixas 1, 2, 3… na ordem da grade, por álbum e disco, com os totais. Qualquer um pode ser salvo como ação, e as ações podem ser exportadas e importadas em JSON; duas já vêm prontas: Coletânea (Vários artistas) e Limpar (espaços, aspas, traços). Tudo se aplica às faixas selecionadas ou a todos os resultados, e se desfaz com ⌘Z.

De fora: MusicBrainz… busca o álbum da faixa selecionada e lista os lançamentos parecidos; escolha um para ver o que ele colocaria em cada faixa (pareadas por disco e número): data, selo, número de catálogo, código de barras, identificadores, números e totais, e os créditos das obras (compositor, letrista, arranjador, regente). Só são aplicados os campos que você marcar; título, artista e álbum começam desmarcados. Os gêneros dele, e os que o painel lateral sugere com Gêneros do MusicBrainz, nunca são aplicados se você não clicar em um. O menu da grade também busca letras (as salvas, um .lrc ao lado do arquivo, as tags ou o LRCLIB) e as marca para gravação nos arquivos, e Marcar os valores da biblioteca para gravação faz o mesmo com o que o Ansuz sabe e o arquivo talvez não diga (deduzido dos nomes das pastas ou completado pelo MusicBrainz). Quando um arquivo mudou fora do Ansuz, Mostrar alterações… mostra os três valores de cada campo em conflito (antes, no arquivo, na biblioteca) e você fica com o seu ou com o do arquivo, campo por campo. Histórico… lista cada alteração com quantas faixas já foram gravadas, e Reverter a desfaz (se já estava gravada, a reversão fica aguardando gravação).

Imagens e dados do arquivo: o painel lateral mostra a capa embutida no arquivo e permite definir uma imagem por tipo (capa frontal, contracapa, disco, artista, outros) nas faixas selecionadas: escolha uma imagem, traga a grande da internet (Cover Art Archive, Last.fm) ou arraste uma; Reduzir para 1200 px evita que uma capa de vários megabytes engorde cada faixa de um álbum. Substituir um tipo mantém as outras imagens do arquivo. A seção Técnico lê o arquivo: quais tags ele tem e em que versão (ID3v2.3, ID3v2.4, ID3v1, APEv2, Vorbis, MP4…), as imagens embutidas e todas as chaves brutas; um Campo personalizado adiciona a chave de que você precisar. O menu da grade calcula o ReplayGain e o marca para gravação nos arquivos, e Limpar os arquivos ao gravar deixa um MP3 só com ID3v2.4 (sem ID3v1 nem APEv2) e um FLAC sem ID3. Verificar… procura problemas típicos no resultado (sem ano, números de faixa repetidos ou faltando, vários artistas sem artista do álbum, gêneros diferentes em um álbum, sem capa, texto mal codificado) e Mostrar coloca essas faixas na grade.

Busca por texto e Atalhos: ao lado de Regras, o filtro tem um modo Texto para digitar buscas como genre:"" year<1990 ou album:contains Live NOT artist:"Various Artists": field:value (sem importar maiúsculas nem acentos), field:"" vazio, field:* não vazio, field:contains x, year<1990, bpm>=120, is:pending, is:conflict, has:cover, no:lyrics, palavras soltas (título, artista ou álbum), AND, OR, NOT e parênteses; os nomes dos campos são escritos em inglês. Filtros › Salvar o filtro atual… guarda um filtro de qualquer um dos dois tipos nesse menu. No app Atalhos, o Ansuz oferece Tags aguardando gravação, Definir um tag e Aplicar um padrão de tags (sobre as músicas de uma busca por texto) e Gravar tags. Em Ajustes › Biblioteca › Editor de tags você escolhe de onde Percorrer começa cada música, o idioma de Maiúsculas de título e se as imagens novas são reduzidas para 1200 px.

Renomear e mover arquivos: a aba Renomear arquivos de Padrões e ações… monta o novo caminho de cada arquivo a partir das suas tags, dentro da mesma fonte: %albumartist%/%album% (%year%)/$num(%track%,2) %title% (“/” cria pastas; a extensão se mantém; os caracteres que um compartilhamento de rede não aceita são substituídos, e uma barra dentro de um valor como AC/DC não cria pasta). A prévia mostra o caminho atual e o novo, e marca o que não pode ser movido: outro arquivo já existente ali, duas faixas que ficariam com o mesmo nome, faixas de uma imagem de disco com cue sheet (o .cue nomeia o arquivo). Nada se move até Gravar tags, e um arquivo existente nunca é substituído; o .lrc gravado pelo Ansuz acompanha a sua música, e uma pasta que fica vazia é removida. Suas playlists, reproduções e classificações continuam com a música.

A barra de baixo conta o que está aguardando em toda a biblioteca. Mostrar alterações… lista cada campo antes e depois; dali você descarta, grava só o que escolher ou resolve conflitos. Gravar tags precisa de Permitir editar tags nos arquivos ativado em Ajustes › Biblioteca (desativado por padrão).

Como o Ansuz grava: copia o arquivo, grava as tags na cópia, verifica que o áudio é exatamente o mesmo de antes (uma impressão digital só do áudio, sem as tags) e que as tags são lidas de volta como esperado, e só então substitui o original em um único passo. Se o arquivo mudou desde a última vez que o Ansuz o leu, nada é gravado e o campo aparece Em conflito, para você escolher entre o seu valor e o do arquivo. A música que está tocando espera a próxima rodada. As faixas dentro de imagens de disco com cue sheet, e os formatos cujo áudio o Ansuz não consegue verificar, são editados só na biblioteca. Gravar tags não faz o iPhone baixar a música de novo: só as tags novas viajam.

O editor de álbum (Editar tags… em um álbum) funciona do mesmo jeito: Salvar mantém as alterações na biblioteca, e Salvar e gravar tags também as grava nos arquivos. Artista (todas as faixas) entre os campos do disco coloca o mesmo artista em todas as faixas de uma vez; com o botão direito em uma faixa, Aplicar este artista / compositor / número de disco a todas as faixas copia o valor dessa linha para toda a coluna.

Inspetor do álbum

Inspetor na página de um álbum (ou Inspetor do álbum… no menu do botão direito de um álbum) mostra, fonte por fonte, o que a biblioteca sabe do disco: se está associado a um lançamento do MusicBrainz e a um do Discogs, quantas faixas têm gravação do MusicBrainz, ISRC, impressão digital acústica e letra, o código de barras, e a capa com seu tamanho. Abaixo, a lista do que falta. Verificar on-line consulta o MusicBrainz, o Discogs (com seu token dos Ajustes), o Last.fm e o Cover Art Archive, associa o lançamento do Discogs quando o código de barras ou o artista e o título o encontram sem ambiguidade, avisa se há uma capa maior disponível, e lista as diferenças entre sua biblioteca e essas fontes: título do álbum, ano, gravadora, número de catálogo, código de barras, país e títulos das faixas.

Usar este ao lado de uma diferença grava esse valor só na biblioteca do Ansuz: seus arquivos nunca são tocados. Reler as tags restaura o que os arquivos dizem; para alterar os arquivos, use o editor de tags. O artista do álbum é mostrado para comparação, mas nunca é alterado daqui.

Adicionar ao MusicBrainz… (no inspetor de um álbum não associado, ou no menu do botão direito do álbum) é para os discos que o MusicBrainz ainda não tem: o Ansuz abre o navegador no editor de lançamentos do MusicBrainz com tudo preenchido a partir dos seus arquivos: título, artista, ano, país, gravadora, número de catálogo, código de barras, e uma mídia por disco com título, número, duração e gravação de cada faixa quando conhecidos. Você precisa de uma conta no MusicBrainz; revisa, completa e confirma lá, e nada é adicionado até você fazer isso. Quando o MusicBrainz confirma o novo lançamento, ele devolve você ao Ansuz, que associa o álbum na hora. O editor não tem campo para ISRC, que fica só na sua biblioteca.

Preparar rascunho para o Discogs… (no inspetor de um álbum sem lançamento no Discogs, ou no menu do botão direito do álbum) faz o mesmo para o Discogs, que não tem um editor pré-preenchível: o Ansuz salva um CSV no formato exato da ferramenta CSV-to-Draft do Discogs (artista, título, gravadora, número de catálogo, formato, gênero, faixas, data, código de barras) e abre essa página no navegador; lá você envia o arquivo e o Discogs cria um rascunho privado que você revisa, completa e submete. A ferramenta aceita só uma gravadora, um formato e um gênero, e as faixas sem posição, duração nem artista, então o Ansuz escreve nas notas o país, os gêneros das suas tags e a lista completa com durações e artistas, pronta para copiar no formulário. Nada é publicado até você submeter o rascunho no Discogs.

Tarefas agendadas

Alguns trabalhos levam dias numa biblioteca grande: reler as tags de 200.000 arquivos num NAS, procurar capas álbum por álbum, tirar a impressão digital do que não tem tags. Ajustes › Tarefas deixa que rodem sozinhos dentro de janelas de horário que você escolhe, uma por dia da semana (de segunda a sexta das 3:00 às 7:00, por exemplo). O Ansuz precisa estar aberto: um app da App Store em sandbox não pode trabalhar em segundo plano. Enquanto uma tarefa está em execução o Mac não entra em repouso sozinho (a tela pode apagar); deixe a tampa aberta e o carregador conectado.

Uma tarefa que não termina na janela continua na seguinte, e nada é feito duas vezes: cada faixa e cada álbum anotam na biblioteca o que já foi feito (com qual leitura de tags, se a capa já foi procurada, se já tem impressão digital), e a próxima execução pula. Uma tarefa se desliga sozinha quando não tem mais nada a fazer; quando a última da rodada se desliga, todas voltam a ligar para a próxima. As tarefas rodam na ordem da lista: arraste uma até a linha onde você a quer. Cada tarefa mostra quanto falta, o último resultado, e tem um botão Executar agora que ignora as janelas; Parar para depois do lote atual.

• Procurar arquivos adicionados e removidos: a mesma varredura incremental de ⇧⌘R, fonte por fonte (tamanho e data; só os arquivos alterados são lidos).
• Reler tags: as faixas indexadas antes de o Ansuz guardar ReplayGain, BPM e tonalidade.
• Procurar capas faltantes: embutida, pasta, Cover Art Archive, Last.fm.
• Identificar faixas sem tags: impressão digital acústica com AcoustID e MusicBrainz.
• Associar os álbuns ao MusicBrainz: cada álbum é associado a um lançamento do MusicBrainz pelo código de barras, pelo grupo de lançamentos que o AcoustID encontrou, ou por artista, título e número de faixas, verificado faixa por faixa contra as durações. O Ansuz guarda o lançamento, o ID de gravação e o ISRC de cada faixa, a gravadora, o número de catálogo e o país, e o lançamento do Discogs que o MusicBrainz vincula; nada do que suas tags já dizem é sobrescrito. Álbuns sem correspondência são tentados de novo após 30 dias. Associar ao MusicBrainz no menu do botão direito de um álbum associa aquele disco na hora e também carrega nas suas músicas todas as tags que o MusicBrainz tem, substituindo o que elas dizem: títulos, artistas, números, data, gravadora, número de catálogo, código de barras, ISRC, identificadores, créditos e o gênero mais votado. Só a biblioteca do Ansuz muda (Gravar tags leva para os arquivos) e tudo se desfaz de uma vez pelo histórico do editor de tags. As músicas repetidas no álbum (outra edição, outra pasta) recebem as mesmas tags.
• Analisar BPM e tonalidade: para faixas cujas tags não os têm, o Ansuz decodifica até três minutos e estima o andamento (envelope de ataques e autocorrelação) e a tonalidade (cromagrama contra os perfis de Krumhansl-Kessler). As tags sempre mandam: a análise só completa o que falta.
• Calcular ReplayGain: para as faixas cujas tags não o trazem, o Ansuz mede o loudness do arquivo inteiro com EBU R128 (ITU-R BS.1770-4, com pico real) e guarda o ganho de faixa e de álbum, referidos a −18 LUFS. Trabalha um disco por vez, assim o ganho de álbum sai do disco inteiro; as tags sempre ganham, e reler as tags conserva o que foi medido. A janela de informações da faixa avisa quando um valor foi medido pelo Ansuz. Nada é escrito nos seus arquivos.
• Procurar letras: .lrc ao lado da música, tags e depois LRCLIB, para as músicas sem letra; uma música sem resultado é tentada de novo após 30 dias.
• Publicar no LRCLIB as letras sincronizadas que faltam: desligada por padrão; na primeira vez que você liga, o Ansuz avisa que o LRCLIB é público. Publica as letras sincronizadas que você importou, sincronizou ou que vieram de arquivos .lrc e tags, uma música por segundo, pulando o que já está lá com o mesmo conteúdo.

Análise manual. Analisar BPM e tonalidade e Calcular ReplayGain no menu de uma música, um álbum, uma playlist ou uma pasta rodam um trabalho por vez: o progresso aparece na barra de ferramentas, com um botão para interrompê-lo, e ao final o Ansuz informa quantas músicas não puderam ser analisadas, se houver.

Ansuz no iPhone

O Ansuz para iPhone tem dois modos em um só app: controle remoto, que navega pela biblioteca do seu Mac e comanda o que toca nele, e reproduzir neste iPhone, com uma biblioteca no telefone que junta as playlists que o Mac copia para ele com as suas próprias músicas. O iPhone também funciona sem Mac. Entre o iPhone e o Mac tudo passa pela sua rede local, criptografado, sem contas nem servidores no meio. Troque de modo com o botão no canto superior esquerdo.

Início, a primeira aba nos dois modos, mostra prateleiras dos seus álbuns Favoritos, Ouvidos recentemente e Mais ouvidos; deslize uma prateleira para o lado ou toque no título para ver todos. O coração na página de um álbum o marca como favorito. Controlando o Mac, as prateleiras são as do Mac; no iPhone vêm da música do telefone, com os favoritos marcados de qualquer um dos lados (viajam a cada sincronização) e as reproduções deste iPhone.

Sua música, sem Mac. O Ansuz tem uma pasta própria no app Arquivos (No Meu iPhone › Ansuz): o que você copia para lá entra sozinho na biblioteca, e o que você apaga dela pelo Arquivos sai da biblioteca. Também dá para copiar música por cabo a partir de um computador: num Mac pelo Finder (seção Arquivos do iPhone), no Windows com o app Dispositivos Apple. A pasta do Ansuz não entra no backup do iCloud: ao trocar de iPhone, é preciso copiar as músicas de novo.

Importar e adicionar pastas. Em Fontes, o botão + oferece Importar do Arquivos…, Enviar de um computador…, Conectar a um servidor… e Adicionar a biblioteca do Música (veja abaixo). Importar do Arquivos… abre um único seletor em que você marca arquivos de áudio, zips e pastas, tudo junto: os arquivos são copiados para a pasta do Ansuz, e para cada pasta o Ansuz pergunta: Copiar para o Ansuz a mantém no iPhone mesmo que o original não esteja mais lá; Usar no local não ocupa espaço, mas só toca enquanto a pasta estiver disponível: um pendrive conectado, o iCloud Drive, um servidor de rede montado no Arquivos, Google Drive, Dropbox, OneDrive… Uma pasta usada no local nunca é modificada. O seletor não deixa marcar várias pastas: para escolher pastas, entre na que as contém e toque em Abrir sem marcar nada. Se ela tiver subpastas, o Ansuz mostra Escolha o que importar com cada subpasta marcada (desmarque as que não quiser; a música solta dessa pasta também aparece): Copiar os selecionados para o Ansuz copia o que está marcado, e Usar “pasta” onde está usa a pasta inteira com todas as subpastas. Por exemplo, abra Downloads e marque ali os álbuns. O Ansuz também aparece em Abrir com… e no compartilhamento para arquivos de áudio e zips: AirDrop, WhatsApp, Mail, downloads do Safari; eles são copiados para a pasta do Ansuz e adicionados sozinhos. Um zip nunca é descompactado sem perguntar (Descompactar as músicas?), e só são extraídas as músicas, as letras .lrc, as folhas .cue e as capas. No iPhone o Ansuz reproduz FLAC, ALAC e AAC (M4A), MP3, WAV e AIFF, e lê tags e capas (embutidas ou cover.jpg) no próprio telefone. Uma faixa no topo mostra o andamento do que está sendo importado, com um botão para cancelar, e depois o resultado.

Enviar de um computador. Em Fontes › + › Enviar de um computador…, o iPhone mostra um endereço (por exemplo http://192.168.1.20:8080), um código QR desse endereço e um PIN de seis dígitos. Num computador conectado à mesma rede Wi-Fi (Windows, Mac ou Linux, qualquer navegador), abra esse endereço e digite o PIN: aparece uma página do Ansuz onde você arrasta arquivos ou pastas inteiras, ou os escolhe com Escolher arquivos ou Escolher uma pasta. Cada arquivo mostra seu andamento, são enviados três de cada vez, a estrutura de pastas é mantida, o que já está no iPhone não é enviado de novo e o que não é música é ignorado; um zip chega ao iPhone, que pergunta se deve descompactá-lo. As músicas entram na pasta do Ansuz e na biblioteca à medida que chegam. Enquanto a tela estiver aberta, o iPhone não se bloqueia sozinho; deixe-a aberta até terminar (se você sair do app, a transferência é interrompida e, ao voltar, continua com o mesmo PIN). O servidor só existe enquanto essa tela está aberta e usa a sua rede local, sem internet nem nuvem; o PIN protege o acesso (cinco PINs errados o bloqueiam por 30 segundos). Na primeira vez, o iOS pede permissão para usar a rede local.

Servidores de música. Em Fontes › + › Conectar a um servidor… você adiciona um servidor Subsonic ou OpenSubsonic (Navidrome, Airsonic, Gonic e outros compatíveis): o endereço (http:// ou https://), usuário e senha, ou Usar uma chave de API (OpenSubsonic); um nome opcional; e a Qualidade do download (Original, MP3 320 kbps ou MP3 192 kbps). O Ansuz testa a conexão antes de salvar. A senha fica nas chaves do iPhone e não trafega: cada pedido leva um token de uso único. O catálogo do servidor entra na biblioteca do iPhone: os álbuns aparecem junto com os demais (o mesmo álbum no servidor e no iPhone aparece uma vez só), a busca abrange tudo, as playlists aparecem como somente leitura e funciona no CarPlay. Ele é lido de novo uma vez por dia ou com Sincronizar agora. Cada música é baixada para um cache do iPhone ao ser tocada (e as próximas da fila enquanto a atual toca). Para ouvir sem conexão, Baixar para o iPhone em um álbum ou playlist com músicas do servidor as copia para a pasta do Ansuz, onde ficam como música do iPhone. Tocando no servidor em Fontes você vê o estado, o endereço, o usuário, a última sincronização e a qualidade do download (MP3 usa menos dados celulares; Original mantém os arquivos sem perdas como estão), com Sincronizar agora e Remover do Ansuz…, que tira as músicas dele da biblioteca sem mudar nada no servidor; o que você baixou fica. Se o servidor não responde (sem rede, fora de casa), ele fica Não conectada: as músicas dele ficam ocultas até ele voltar, e o que você baixou continua tocando. Se a rede cai durante a reprodução, o Ansuz para naquela música sem perder a fila. Bem no alto, em Tipo de servidor, você escolhe Subsonic ou DLNA / UPnP. Um servidor DLNA é o servidor de mídia de um NAS ou de um computador (Twonky, MiniDLNA, Plex, Gerbera…): em Na sua rede o Ansuz mostra os que encontra sozinho, poucos segundos depois de abrir a aba (Procurar de novo repete a busca), e com um toque você adiciona um. Ele procura na rede do iPhone e também nas redes dos servidores e NAS que você já usa: em casas com duas redes, o servidor de mídia costuma ficar na do NAS. Só usa a permissão de rede local. Para um servidor em outra rede, em Outro servidor você digita só o endereço IP ou o nome dele, sem usuário nem senha, e o Ansuz encontra o servidor; se não encontrar, digite o endereço completo da descrição dele (por exemplo http://192.168.1.10:9000/dev0/desc.xml). Se o servidor tem uma visualização por pastas, o Ansuz usa essa, e uma música que o servidor mostra em várias visualizações aparece uma só vez. FLAC, ALAC, AAC, MP3, WAV e AIFF são baixados como estão; de outros formatos é baixada a versão que o servidor converte, se ele oferecer, e senão a música não é listada. As playlists de um servidor DLNA não são importadas, e se o servidor refizer o banco de dados, as músicas dele podem voltar a entrar como novas. SMB é para a pasta compartilhada de um NAS ou de um computador, pelo app Arquivos. Digite o endereço (por exemplo smb://192.168.1.10) e toque em Conectar no Arquivos: o Arquivos abre Conectar ao Servidor com o endereço já preenchido; toque no ✓ azul no canto superior direito e entre com seu usuário do NAS (quem guarda a senha é o Arquivos, não o Ansuz). Ao voltar ao Ansuz com ◀ Ansuz, o seletor se abre: toque em Explorar, volte à lista de locais, sob o título Compartilhado abra o NAS, entre na pasta de música e toque em Abrir sem selecionar nada. A pasta é usada onde está, sem ser copiada nem alterada. Os servidores que você já usou aparecem em Servidores recentes, para não digitar o endereço de novo. Quando o Arquivos se desconecta do NAS, a fonte fica Não conectada sem perder suas músicas; na tela dela, Conectar no Arquivos leva você a reconectar, e ao voltar a pasta volta sozinha.

O app Música. Em Fontes › + › Adicionar a biblioteca do Música, o Ansuz pede permissão para ler a biblioteca do app Música (o iOS pergunta uma vez só) e a adiciona como a fonte App Música: as músicas que você comprou, importou de um CD ou sincronizou a partir de um computador entram na biblioteca do Ansuz junto com as demais (o mesmo álbum em duas fontes aparece uma vez só), com as playlists, que são somente leitura, e no CarPlay, e tocam com a reprodução contínua, o ReplayGain e o crossfade do Ansuz. O Ansuz as lê onde estão: nunca as copia, altera ou apaga, e elas não ocupam espaço. O que você adicionar ou tirar no Música aparece ou desaparece sozinho. As músicas do Apple Music com proteção contra cópia e as que estão só no iCloud sem terem sido baixadas tocam apenas no app Música: não são listadas, e a fonte diz quantas são. Se você tirar a permissão em Ajustes › Apps › Ansuz › Mídia e Apple Music, a fonte fica Não conectada até você permitir de novo; Remover do Ansuz… a tira da biblioteca sem mexer no app Música.

Fontes. A aba Fontes lista cada fonte com quantas músicas tem, quanto ocupa e o seu estado: indexando, com o andamento; Não conectada; ou baixando do iCloud (tantas de tantas). Sincronizado do Mac é o que o Mac copia; ao tocar nela, abre-se a sincronização. A tela da Pasta do Ansuz tem Indexar novamente e Apagar todas as músicas desta pasta…, que pede confirmação e é a única coisa que o Ansuz apaga. Uma pasta usada no local que não está disponível fica Não conectada e suas músicas não aparecem até ela voltar, mas não são apagadas; Remover do Ansuz… tira as músicas dela da biblioteca e deixa os arquivos onde estão. Se uma pasta do iCloud Drive tem músicas que não estão no telefone, o Ansuz as pede ao iCloud e mostra quantas já baixaram antes de lê-las. Se o mesmo álbum está em duas fontes, ele aparece uma só vez (vence a cópia do Mac). No fim de Fontes ficam os ajustes de reprodução (ReplayGain, crossfade).

Emparelhamento. No Mac, em Ajustes › Dispositivos, ative Permitir que o Ansuz no iPhone e na Apple TV se conecte. Abra o Ansuz no iPhone na mesma rede: ele encontra o Mac sozinho. Na primeira vez, o Mac mostra um alerta com um código; emparelhe só se ele for igual ao código no iPhone. Depois disso, ele se reconecta sem perguntar. Dispositivos emparelhados lista cada iPhone e permite revogá-lo.

Controle remoto. Álbuns, artistas, gêneros, playlists e busca em toda a biblioteca, com capas; tocar, pausar, pular e avançar ou voltar dentro da música; aleatório e repetir; a fila, para reordenar, remover ou tocar a seguir; avaliações e Curti; o volume do Ansuz e a saída de áudio do Mac; a letra sincronizada da música que está tocando. Enquanto um iPhone estiver conectado, o Mac não entra em repouso por inatividade. Em Artistas, cada artista do álbum aparece com a foto e, à direita, uma barra de letras: toque numa letra ou deslize o dedo pela barra para pular. Toque num artista para abrir a página dele: foto, biografia com Ler mais, Reproduzir e Aleatório, os discos separados em Álbuns, EPs, Singles, Grandes sucessos e Coletâneas, e Artistas relacionados da sua biblioteca.

Levar música para o iPhone. No Mac, clique com o botão direito numa playlist › Levar para o iPhone e escolha o formato: o arquivo original (convertido quando o iPhone não consegue reproduzi-lo), Apple Lossless 16 bits / 44,1 kHz, ou AAC 256 kbps, o menor. DSD, SACD, DTS-CD e imagens de CD com folha .cue são sempre convertidos; as cópias convertidas ficam no cache do Ansuz. As playlists inteligentes viajam já resolvidas. No iPhone, Fontes › Sincronizado do Mac mostra quanto ocupa cada playlist e quanto falta baixar; Sincronizar agora baixa o resto em segundo plano, mesmo com o telefone bloqueado, e remove o que o Mac não envia mais. Letras, capas e ReplayGain viajam com cada música. Com Preferir a versão mais leve em Ajustes › Dispositivos, uma música que você tem em várias cópias (MP3 e FLAC, por exemplo) vai como a que gera o arquivo menor; as avaliações e as reproduções continuam indo para a versão preferida.

Ouvir no iPhone. Playlists, álbuns e busca no que está no telefone, sem cortes entre as músicas, com crossfade, ReplayGain e controles na Tela Bloqueada e na Central de Controle. As reproduções são enviadas por scrobbling do iPhone ao Last.fm e ao ListenBrainz com as contas do Mac (ficam na fila quando não há internet), e o Mac não as envia de novo. Avaliações, Curti e reproduções voltam para o Mac assim que o iPhone o encontra na rede; se uma música foi avaliada nos dois, vale a alteração mais recente. Numa playlist comum, Editar permite remover e reordenar músicas, e a mudança é aplicada no Mac sem sobrescrever o que você adicionou lá; as playlists inteligentes são montadas pelo Mac e são somente leitura no iPhone. Na aba Álbuns, o seletor no alto passa para Artistas: a mesma lista com fotos, barra de letras e página do artista de quando você controla o Mac, com a música do iPhone e a dos servidores conectados (Subsonic, DLNA). Reproduzir e Aleatório tocam no iPhone.

CarPlay. No carro, o Ansuz mostra as músicas que estão no iPhone: suas playlists, álbuns e músicas, cada um com Aleatório, e a tela padrão de Tocando agora com aleatório e repetir. Funciona sem conexão de rede; o Mac não é necessário. A aba Artistas tem um índice de letras ao lado (com muitos artistas, primeiro se escolhe a letra); cada artista mostra Aleatório e os discos separados em Álbuns, EPs, Singles, Grandes sucessos e Coletâneas. Sem sinal, como nos apps de streaming, some o que está só nos seus servidores e fica o que está no iPhone; volta sozinho quando o sinal volta.

Siri. Diga “Tocar Coldplay com o app Ansuz”: um artista, um álbum, uma música, uma playlist ou um gênero, e também “…a seguir”, “…no final” ou “em ordem aleatória”. Funciona com o iPhone bloqueado e no CarPlay. Toca onde tocaria se você tocasse na tela: no modo controle remoto com o Mac conectado, procura na biblioteca do Mac e toca no Mac; se não, na do iPhone. Se não estiver no iPhone, mas o Mac emparelhado estiver na rede, o Ansuz se conecta sozinho, procura na biblioteca do Mac (a do seu NAS, por exemplo) e toca no Mac. Os nomes são comparados sem diferenciar maiúsculas, acentos nem um “The” ou “Os” inicial; uma música toca seguida do resto do álbum, e um artista ou um gênero em ordem aleatória. “Tocar Ansuz” sozinho retoma o que estava tocando. A Siri costuma entender “no Ansuz” como parte do título: diga “com o app Ansuz”, ou só “Tocar Coldplay” e escolha o Ansuz na lista que a Siri mostra.

Apple TV. Com Fontes › Apple TV › Compartilhar com a Apple TV ativado, uma Apple TV com o Ansuz na mesma rede pode navegar e tocar as músicas deste iPhone enquanto o Ansuz está aberto aqui (veja Ansuz na Apple TV). Na primeira vez, o iPhone mostra o código da Apple TV: aceite só se coincidir. A mesma seção lista as Apple TV emparelhadas; deslize uma para removê-la. As músicas do app Música não são compartilhadas.

Não existe nuvem nem conta do Ansuz. O iPhone só conversa com o seu Mac, pela sua rede local (e, enquanto você envia músicas de um computador, com o navegador desse computador), com os serviços de scrobbling que você já usa, com os servidores de música que você conectar, com uma Apple TV com a qual você compartilhe a biblioteca (Compartilhar com a Apple TV) e, só se você escolher uma pasta do iCloud Drive ou de outro provedor, com esse provedor por meio do app Arquivos. A música do seu Mac vai para o seu telefone (e, se você a compartilhar, para a sua Apple TV) e para nenhum outro lugar.

Ansuz na Apple TV

O Ansuz para Apple TV reproduz na TV a biblioteca do seu Mac, por streaming criptografado na rede local. Nenhuma música fica guardada na Apple TV: cada música vem do Mac enquanto toca. Há Álbuns, Artistas, Playlists, Tocando agora e a busca (a lupa), com o teclado na tela ou por ditado. Fontes é a última aba. Voltar em Tocando agora leva você de volta à aba onde escolheu a música.

Uma barra vertical de letras à direita de Álbuns e Artistas leva direto a uma letra: mova o foco para a direita até a barra e escolha. Os álbuns seguem a ordem da grade, por artista do álbum.

Reproduzir uma música não tira você de onde está, assim dá para experimentar várias músicas de um álbum. Para abrir Tocando agora, use a aba, ou mantenha pressionada a música que está tocando e escolha Tocando agora.

Artistas mostra uma grade com a foto de cada artista (a capa de um dos álbuns até ela chegar) e um campo de busca. A página de um artista tem a foto, uma biografia curta, Reproduzir e Aleatório, os álbuns e Artistas relacionados: os parecidos segundo o Last.fm que estão na sua biblioteca. Fotos e biografias precisam de internet na primeira vez.

Início, a primeira seção na TV, mostra as mesmas prateleiras do Mac e do iPhone: Favoritos, Ouvidos recentemente e Mais ouvidos, da biblioteca escolhida (a do Mac ou a dos servidores da TV), com Ver todos em cada uma. O coração na página de um álbum o marca como favorito.

Se a faixa tiver letra, aparece «Letra · mantenha pressionado para ver» sob a barra de progresso: mantenha o clickpad pressionado e escolha Mostrar letra. A letra sincronizada acompanha a faixa com a linha atual em branco; a não sincronizada avança junto com ela. A escolha fica para as próximas faixas e, enquanto a letra está na tela, a TV não entra em repouso. As faixas de um servidor Subsonic ou Navidrome mostram a letra que o servidor tem (incorporada ao arquivo ou num .lrc), sincronizada se for assim.

Emparelhamento. No Mac, em Ajustes › Dispositivos, ative Permitir que o Ansuz no iPhone e na Apple TV se conecte. Abra o Ansuz na Apple TV na mesma rede e escolha o seu Mac. A Apple TV mostra um código de seis dígitos e o Mac, um alerta com um código: clique em Emparelhar só se forem iguais. Depois disso, ela se reconecta sozinha e aparece em Dispositivos emparelhados, onde você pode revogá-la.

Formatos. Tudo o que o Mac reproduz. O que a Apple TV não decodifica (DSD, SACD, DTS-CD, APE, músicas de imagens com .cue, Ogg Vorbis…) o Mac envia convertido na hora: começa logo, sem esperar a conversão da música inteira, e você ainda pode pular para qualquer ponto.

Servidores de música, sem o Mac. Na aba Fontes você escolhe qual biblioteca a Apple TV mostra: a do seu Mac, ao vivo, ou Servidores de música. Uma de cada vez, porque a mesma música no Mac e em um servidor apareceria duas vezes. Adicionar um servidor Subsonic ou Navidrome… adiciona um servidor Subsonic ou OpenSubsonic (Navidrome, Airsonic, Gonic, LMS): o endereço, e usuário e senha ou Usar uma chave de API (OpenSubsonic). Adicionar um servidor de mídia DLNA… adiciona um servidor de mídia DLNA/UPnP (Twonky, MiniDLNA, Plex, Serviio, Universal Media Server e os que vêm em muitos NAS), encontrado sozinho em Nesta rede ou digitado em Por endereço. A Apple TV lê o catálogo de cada servidor para um índice próprio e toca direto do servidor, mesmo com o Mac desligado; um álbum que está em dois servidores aparece uma vez só, e um servidor que não responde fica oculto até voltar. O que a Apple TV não decodifica (Ogg Vorbis, APE…) é pedido a um servidor Subsonic convertido para MP3; em um servidor DLNA essa música é pulada. Os servidores são lidos de novo uma vez por dia, ou com Ler de novo na tela do servidor. O índice fica no cache: se o tvOS o apagar, ele é refeito sozinho; os servidores continuam salvos e as senhas ficam nas chaves. Pastas compartilhadas (SMB) não: o tvOS não tem o app Arquivos. Sem um Mac emparelhado, a primeira tela também oferece Usar um servidor de música.

Leituras longas. Ler um servidor grande leva tempo: 180.000 músicas por DLNA passam de uma hora. A Apple TV anota até onde chegou a cada 5.500 músicas, mais ou menos, então se a leitura for interrompida (você saiu do app, ele foi fechado ou a rede caiu) ela continua sozinha dali quando você volta ao app ou o abre. Se a rede cair, tenta de novo sozinha depois de 5 segundos, 15 segundos e um minuto, e enquanto isso Fontes mostra A conexão foi perdida. Tentando de novo… Na tela do servidor aparece A leitura parou em N músicas., com Continuar lendo (N músicas) para seguir e Ler de novo para começar do zero. Se o servidor recusar algumas pastas (um Plex ocupado faz isso), elas são pedidas de novo; e se mesmo assim alguma ficar sem ler, a leitura não apaga nada do que já estava lá. A Apple TV não relê o servidor inteiro a cada vez que abre: faz isso quando o servidor avisa que há músicas novas ou removidas, e uma vez por semana para mudanças de tags; uma leitura interrompida continua de onde parou por três dias.

Scrobbling e reproduções. A Apple TV faz scrobble no Last.fm e no ListenBrainz com as contas do Mac (ou do iPhone) com o qual está emparelhada: não é preciso entrar na conta pela TV. As reproduções de músicas do Mac vão para o histórico e os contadores do Mac, e ficam guardadas na Apple TV enquanto não há conexão. As de músicas dos servidores de música ficam na Apple TV.

Um iPhone como fonte. No iPhone, ative Fontes › Apple TV › Compartilhar com a Apple TV (vem desativado). A Apple TV mostra o iPhone na lista junto aos Macs, com um ícone de iPhone; escolha-o e confirme o código de seis dígitos no iPhone. A partir daí a Apple TV navega e toca a biblioteca do iPhone. Funciona enquanto o Ansuz está aberto no iPhone (com uma Apple TV conectada, a tela do iPhone não se apaga sozinha). O iPhone envia o arquivo original, sem converter: as músicas que a Apple TV não decodifica são puladas. As músicas do app Música e as de imagens com .cue não são compartilhadas. As reproduções na TV vão para o histórico do iPhone. A Apple TV fica emparelhada com um Mac ou iPhone de cada vez.

Tocando agora e o Siri Remote. A tela de reprodução foi feita para ser vista a três metros, com o fundo tirado da capa. No clickpad: um clique reproduz ou pausa; deslizar rápido para a direita ou a esquerda passa para a música seguinte ou anterior; arrastar devagar percorre a música (pula ao soltar); clicar na borda direita ou esquerda avança ou volta 10 segundos; deslizar para baixo mostra a fila; manter pressionado abre o menu da música (Ir para o álbum, Ir para o artista, A seguir).

Menus e fila. Mantenha pressionada uma música ou um álbum em qualquer lista para Reproduzir a seguir, Adicionar à fila, Ir para o álbum e Ir para o artista; nos álbuns também Reproduzir e Aleatório. Em A seguir, escolher uma música pula para ela; mantendo-a pressionada, você tem Tocar agora, Reproduzir a seguir, Mover para cima, Mover para baixo e Remover da fila. Limpar a seguir esvazia tudo o que vem depois. Num álbum de um servidor DLNA (como o Plex), Reler tags lê de novo no servidor só a pasta desse álbum: em segundos entra o que é novo, as tags são corrigidas e sai o que não existe mais. Serve quando você acabou de organizar um álbum; se renomeou a pasta, a de cima é relida.

Modo repouso. Se há música tocando e ninguém mexe no controle por dois minutos, no lugar do protetor de tela do sistema aparecem a capa e a música em tela cheia, movendo-se devagar. Qualquer botão volta. Em pausa, o protetor de tela do sistema funciona normalmente.

Se a conexão cair. Se a rede cair ou o Mac for desligado, a Apple TV pausa, avisa e se reconecta sozinha; retoma a mesma música na mesma posição. Depois de mais de 10 minutos sem conexão, fica em pausa. O Ansuz também responde à Central de Controle da Apple TV e ao controle remoto da Central de Controle do iPhone.

Servidor Subsonic

O Ansuz pode servir a biblioteca do seu Mac para apps compatíveis com Subsonic, como Amperfy, play:Sub, Symfonium, Feishin ou Supersonic, no celular, no tablet ou em outro computador. Ative em Ajustes › Dispositivos › Servidor Subsonic; ele vem desligado.

• Conectar um app: crie um usuário com Adicionar usuário…, abra Credenciais e copie a senha ou a chave de API. No app, digite o endereço mostrado nos Ajustes (por exemplo http://192.168.0.20:4533), o usuário e a senha.
• Perfis: Dispositivo próprio vê todas as fontes (ou as que você escolher), conta suas reproduções e pode mudar curtidas, avaliações e playlists, a menos que você o deixe só para ouvir. Convidado é para outra pessoa: vê só as fontes escolhidas, não muda nada e as reproduções dele não contam nas suas estatísticas.
• Reproduções: o que você ouve num app com um usuário próprio entra no histórico e nas estatísticas e, com Enviar para o Last.fm e o ListenBrainz… ativado, é enviado a partir do Mac. Desative o scrobbling no próprio app, ou cada música vai contar duas vezes.
• Qualidade e dados: sem limite, o app recebe o arquivo original (um FLAC de qualidade CD usa cerca de 1 Mbit/s; um de 24 bits/96 kHz, 3). DSD, imagens com cue e formatos pouco comuns chegam como WAV. Se o app pedir um limite de bitrate, o Ansuz converte para AAC na hora (também quando pede MP3: o Mac não tem codificador de MP3).
• Fora de casa: o servidor só aceita conexões da rede local. Para ouvir de fora, instale o Tailscale no Mac e no celular e use no app o endereço 100.x do Mac. Com Fora de casa › Abrir uma porta no roteador, o Ansuz pede ao roteador que redirecione uma porta para o Mac (UPnP ou NAT-PMP) e mostra se conseguiu. Da internet só são aceitas conexões por HTTPS com um certificado: até que um seja configurado, nada de fora entra. Se o seu provedor usa CGNAT (um endereço público compartilhado entre muitos clientes, comum em fibra e redes móveis), nenhuma porta pode ser aberta e o caminho é o Tailscale. Para carregar o certificado, use Importar certificado e chave… (os dois arquivos do tailscale cert, ou fullchain.pem e privkey.pem do certbot) ou Importar .p12…. Ele precisa ser de um nome que aponte para o Mac: um domínio seu apontando para seu endereço público, ou o nome do Tailscale. Com ele, o Ansuz também escuta na porta 4534 por HTTPS, e os apps usam https://nome:porta. Acessos de fora mostra quem se conectou pela internet e os acessos que falharam. Com Certificado automático, o Ansuz obtém sozinho o certificado do Let’s Encrypt e o renova: digite o nome, escolha ZoneEdit ou Cloudflare e salve as credenciais (ZoneEdit: o usuário e o token de autenticação dinâmica da zona; Cloudflare: um token de API com permissão para editar o DNS). Teste primeiro com o serviço de testes e depois desative-o. Com DNS dinâmico, o nome acompanha seu endereço público quando o provedor o muda. → Fora de casa, passo a passo
• Sempre disponível: fechar a janela não desliga o servidor; a barra de menus mostra quantos apps estão conectados e, enquanto houver algum, o Mac não entra em repouso sozinho. Com Ajustes › Geral › Abrir ao iniciar sessão, ele volta a ficar disponível depois de reiniciar.

Ouvir fora de casa, passo a passo

Com isto você ouve sua biblioteca de qualquer lugar, no celular ou em outro computador, por uma conexão criptografada e com um certificado que os apps aceitam. Na primeira vez leva cerca de meia hora; depois não há nada a fazer: o Ansuz renova o certificado e acompanha seu endereço público quando ele muda.

Importante: este guia usa serviços de outras empresas: ZoneEdit (o DNS do seu domínio), Let’s Encrypt (o certificado), seu roteador e seu provedor de internet. Qualquer um deles pode mudar suas páginas, menus, nomes ou condições sem aviso, e então o que você vê pode não coincidir com este guia. Isso não é um erro do Ansuz: procure a opção equivalente na página ou na ajuda desse serviço. As mensagens do Ansuz sempre dizem qual serviço falhou.

O que você precisa:

• O Mac ligado, com o Ansuz aberto e Servir a biblioteca para apps Subsonic ativado (veja Servidor Subsonic). Se o Mac dormir ou estiver desligado, não há música fora de casa.
• Um roteador que consiga abrir portas sozinho (UPnP ou NAT-PMP). Os da maioria dos provedores conseguem; às vezes é preciso ativar isso nas configurações dele.
• Um domínio próprio (por exemplo seunome.com.br), comprado em um registrador. O Ansuz não vende nem dá domínios.
• Uma conta no ZoneEdit para gerenciar o DNS desse domínio.

Passo 1: a porta no roteador

1. Em Ajustes › Dispositivos › Fora de casa, ative Abrir uma porta no roteador.
2. Espere alguns segundos e veja Roteador:
   • Diz que a porta foi aberta (por UPnP ou NAT-PMP) e mostra o Endereço público: siga para o passo 2.
   • O roteador não respondeu: abra as configurações do roteador (normalmente pelo navegador, no endereço da etiqueta do aparelho), procure UPnP e ative. Se ele não tiver, redirecione à mão a porta TCP que o Ansuz mostra para o endereço deste Mac.
   • Um aviso que menciona CGNAT: seu provedor compartilha um endereço público entre muitos clientes e nenhuma porta chega à sua casa. Este guia não funciona nesse caso; use o Tailscale (veja Servidor Subsonic) ou peça ao provedor um endereço público próprio.

Passo 2: o domínio no ZoneEdit

1. Crie uma conta em zoneedit.com e adicione seu domínio como zona. O ZoneEdit mostra os servidores de nomes que devem ser usados.
2. No registrador onde você comprou o domínio (no Brasil, o Registro.br), troque os servidores de nomes (DNS) do domínio pelos do ZoneEdit. A mudança pode levar várias horas para aparecer na internet.
3. Escolha o nome que você vai usar, por exemplo musica.seunome.com.br. Um subdomínio é melhor: o domínio sozinho pode já estar em uso para outra coisa, como um site.

Passo 3: o token do ZoneEdit

O Ansuz precisa de permissão para alterar dois registros do seu DNS: um temporário, que prova ao Let’s Encrypt que o domínio é seu, e o endereço do nome quando o provedor o muda. Essa permissão é o token de autenticação dinâmica, que não é sua senha do ZoneEdit.

1. No ZoneEdit, abra o DNS do seu domínio e procure DYN RECORDS (registros dinâmicos). Clique no ícone da chave inglesa.
2. Adicione o nome escolhido (por exemplo musica) com um TTL (o valor que o ZoneEdit sugere serve).
3. Em DYN AUTHENTICATION TOKEN, clique em ENABLE, depois em NEXT, e confirme. O ZoneEdit mostra o token: copie-o.

Se você não encontrar essas opções com esses nomes, o ZoneEdit mudou o site: procure «dynamic authentication token» na ajuda dele.

Passo 4: o certificado no Ansuz

1. Em Ajustes › Dispositivos › Certificado automático, ative Obter e renovar um certificado automaticamente.
2. Nome: o nome completo escolhido (musica.seunome.com.br).
3. Provedor de DNS: ZoneEdit. Usuário: seu nome de usuário do ZoneEdit (não o e-mail). Token de autenticação dinâmica: o do passo 3. Zona: seu domínio (seunome.com.br). Clique em Salvar credenciais. O Ansuz os guarda nas chaves do Mac.
4. Ative Manter o nome apontando para este Mac (DNS dinâmico). Em alguns segundos, O nome aponta para mostra seu endereço público.
5. Com Usar o serviço de testes do Let’s Encrypt ativado, clique em Obter certificado agora. Leva de meio minuto a alguns minutos; Estado mostra cada passo e termina em Certificado obtido em ….
6. Desative o serviço de testes e clique de novo em Obter certificado agora: este é o certificado de verdade. Ao pedir um certificado você aceita o acordo de assinante do Let’s Encrypt.

A partir daí, o Ansuz o renova antes que expire (mais ou menos a cada dois meses) e atualiza o nome se seu endereço público mudar. Para isso o Mac precisa estar ligado de vez em quando.

Passo 5: o usuário e o app

1. Em Usuários Subsonic, crie um usuário para cada celular ou pessoa (Adicionar usuário…) e copie a senha em Credenciais.
2. No app, digite o endereço mostrado em Endereço de fora (por exemplo https://musica.seunome.com.br:4534), o usuário e a senha. Use o nome exato: com outro, o app recusa o certificado. O mesmo endereço funciona em casa e fora.
3. No Ansuz para iPhone: escolha Reproduzir neste iPhone com o botão de modo e depois Fontes › + › Conectar a um servidor… › Servidor Subsonic. Na ficha do servidor escolha a qualidade: Convertida, 192 kbps gasta menos dados móveis.

Passo 6: testar

Desligue o Wi-Fi do celular e toque algo usando dados móveis. No Mac, Acessos de fora mostra o endereço do celular, o usuário e o app. Se funcionar, pronto.

Se algo falhar

O roteador não respondeu	O UPnP está desligado no roteador: ative-o, ou redirecione a porta à mão (passo 1).
CGNAT	Seu provedor não lhe dá um endereço próprio: use o Tailscale, ou peça um endereço público.
O provedor de DNS recusou o usuário ou o token.	Confira se o usuário é o do ZoneEdit e não o seu e-mail, e se o token é o dessa zona. Na dúvida, crie um novo token no ZoneEdit e salve as credenciais de novo.
O registro DNS não apareceu em 3 minutos.	O ZoneEdit demorou mais que o normal. Tente de novo daqui a pouco.
Não foi possível conectar ao Let’s Encrypt	O Let’s Encrypt pode estar em manutenção (o estado está em letsencrypt.status.io). O serviço de testes às vezes fica parado mais tempo que o de verdade: nesse caso, você pode ir direto ao certificado real.
O Let’s Encrypt não conseguiu verificar o nome	O domínio ainda não aponta para os servidores do ZoneEdit (passo 2), ou a zona está errada. Espere algumas horas depois de trocar os servidores de nomes.
O app diz que o certificado não é válido	Você digitou um nome diferente do do certificado, ou ainda está com o do serviço de testes (passo 4, item 5).
Funciona em casa mas não fora	O nome não aponta para seu endereço (veja O nome aponta para), a porta não está aberta (passo 1) ou o Mac está dormindo. Alguns provedores bloqueiam conexões de entrada: consulte o seu.

Segurança: pela internet só se entra por HTTPS com o certificado, com usuário e senha; depois de 10 tentativas erradas esse endereço fica bloqueado por 15 minutos. Use um usuário por dispositivo: se perder o celular, você desativa só esse. Para deixar de aceitar conexões de fora, desative Abrir uma porta no roteador.

Ajustes

• Geral: idioma do app (requer reiniciar) e aparência (Sistema, Claro ou Escuro). Crossfade entre músicas (0 a 12 segundos). Nivelamento de volume por ReplayGain (Desligado, Faixa, Álbum, Automático) com pré-amplificação e proteção contra clipping. Notação da tonalidade: clássica ou Camelot. Na página desse álbum, abaixo dos botões, há links para mais música do autor no YouTube Music, Apple Music, Spotify e TIDAL; o link do YouTube Music também está no menu da fonte e ao lado deste ajuste.
• Áudio: dispositivo de saída, ajuste da taxa de amostragem a cada arquivo e modo exclusivo. Veja Saída de áudio.
• Biblioteca: edição de tags, área multicanal dos SACD e o álbum de amostra incluído (pode ser removido e recolocado). «Mostrar as fontes indisponíveis», desligado, esconde as fontes desconectadas da barra lateral, e suas músicas de Toda a música e Recentes, até que voltem. Quantos álbuns cada prateleira do Início traz (100 por padrão).
• Last.fm: conta e scrobbling.
• ListenBrainz: token de usuário e envio das reproduções.
• Discogs: token pessoal para perfis, fotos e links de artistas.
• Apple Music: permissão, estado da assinatura e suas playlists.
• Spotify: conexão pelo navegador e suas playlists.
• TIDAL: conexão pelo navegador e suas playlists.
• Identificação: identificação em massa por impressão digital.
• Dispositivos: permitir que o Ansuz no iPhone e na Apple TV se conecte, dispositivos emparelhados e as playlists que vão para o telefone, com seu formato. Veja Ansuz no iPhone e Ansuz na Apple TV.

Atalhos de teclado

⌘O	Adicionar pasta
⌘⇧R	Reescanear todas as fontes
Espaço	Play / pausa
⌘→	Próxima
⌘←	Anterior (ou reinicia após 3 s)
⌘I	Informações da faixa em reprodução
⌥⌘I	Mostrar ou ocultar o painel lateral
⌘− ⌘+ ⌘0	Diminuir, aumentar ou restaurar o tamanho da letra
⌘,	Ajustes
⌘?	Esta ajuda
⌫ na fila	Remover a música selecionada
Clique duplo	Reproduzir

Agradecimentos

O Ansuz se apoia em software de código aberto: TagLib (LGPL 2.1 / MPL 1.1) lê e grava as tags, Chromaprint (LGPL 2.1) calcula as impressões acústicas e vai como framework substituível dentro do app, FFmpeg (LGPL 2.1) decodifica os DTS-CD e os formatos que o macOS não traz (APE, WavPack, Musepack, WMA e outros), também como framework substituível compilado só com decodificadores de áudio, e GRDB.swift (MIT) cuida do banco SQLite. Os textos das licenças estão incluídos no pacote do app.

O Ansuz inclui o álbum “Desnudo Frente a Vos” (2026) de Alberto Yualé, autor do app, com sua permissão, como fonte de amostra; aparece na barra lateral como qualquer fonte e pode ser removido em Ajustes › Biblioteca.

Os metadados vêm de AcoustID, MusicBrainz, Cover Art Archive, Last.fm, LRCLIB, Wikidata e Wikipédia, cada um com seus próprios termos. O Ansuz só os consulta para o que você pede: identificar uma faixa, buscar capas, letras ou biografias e, se você conectar sua conta, enviar suas reproduções ao Last.fm.