Escolha uma capa.
Deixe o álbum tocar.

O CAMINHO CURTO

Seu primeiro cartão, sem complicar.

Não precisa começar imprimindo cinquenta capas nem comprando todas as peças. Se você já tem um computador e um Plex funcionando, teste primeiro com um leitor USB e um cartão. A caixa bonita e o computador dedicado podem vir depois.

1. Abra o Album Cards. Instale a aplicação como explico abaixo.
2. Conecte seu Plex. Em Configurações, escolha Plex / Caldera e importe um álbum que você já consegue ouvir.
3. Confira o som. Escolha seu Caldera e use o botão de play do álbum antes de envolver o cartão.
4. Selecione o disco e abra Cartões. Clique em Atribuir selecionados, aproxime o cartão no leitor configurado no Linux.
5. Mude para Reproduzir. Retire e aproxime novamente. Agora aquele cartão escolhe aquele álbum.

O código está disponível gratuitamente no repositório oficial do Album Cards, com documentação principal em inglês e guias de apoio em português.

MEUS GASTOS / SETEMBRO DE 2026

Tudo o que usei, com os valores que paguei.

Estes foram os valores que paguei em setembro de 2026, em reais. São uma referência da minha montagem, não uma cotação atual: o seu custo depende do que você já tem e de onde vai comprar ou imprimir.

E o restante da montagem?

O subtotal acima não é o preço de um sistema de som completo. Estes são os outros itens usados ou necessários nesta montagem; seus valores ainda não entraram na conta.

O Album Cards e os arquivos do modelo 3D são gratuitos. Assinaturas, energia, frete e impostos que não foram discriminados aqui não são somados ao subtotal. No Spotify, considere seu plano Premium à parte: é um custo recorrente, não uma compra única.

O Orange Pi não serve só para os cartões.

O uso principal dele no meu setup é ser um reprodutor de música pela rede com Caldera. Escolho as músicas da minha coleção Plex no Plexamp pelo celular, e o Orange Pi 3B reproduz na Edifier M90 por USB. Assim, controlo tudo sem fio do sofá, sem transmitir o áudio por Bluetooth e sem a compressão de áudio desse caminho. O celular é o controle; quem toca é o pequeno computador ao lado da caixa.

Os cartões RFID acrescentam outra maneira de escolher um álbum nesse mesmo player. Por isso, os R$ 300 não foram um investimento exclusivo para este projeto. A qualidade final também depende dos arquivos de origem e das configurações de reprodução.

O subtotal de R$ 535 considera as cinco compras com preço informado. A caixa 3D consumiu 100 g de filamento: para estimar só o material, divida o preço do seu rolo de 1 kg por 10. Serviço de impressão, energia e eventuais perdas podem custar à parte. Caixa de som, servidor de músicas, cabos, fonte, armazenamento e assinaturas não estão incluídos. A versão Spotify pode reaproveitar um computador Linux e dispensa o servidor de músicas, mas exige uma assinatura Spotify Premium.

MODO COMPLETO / COLEÇÃO LOCAL

Seus álbuns, com Plex e Plexamp.

Este é o caminho do meu projeto: uma coleção de arquivos própria, servida pelo Plex, com um computador Linux dedicado à reprodução. Você escolhe a qualidade dos arquivos e o equipamento de áudio. A fidelidade final depende também do formato, das configurações de reprodução e da saída utilizada.

A ideia veio da vontade de escolher música olhando para uma capa, sem passar vários minutos rolando uma lista no celular. Cada cartão virou uma pequena edição do álbum: arte na frente, faixas e informações no verso.

No meu projeto original, as músicas ficam em um home server Linux com Plex Media Server. Um Orange Pi perto da caixa de som recebe o leitor USB e executa o Caldera. Uso a Edifier M90, ligada por USB ao Orange Pi e selecionada no modo de áudio USB. Esse é o modelo do meu setup; você pode usar outra caixa ativa com entrada de áudio USB ou um DAC compatível. O Plexamp no celular também pode controlar esse player.

Para reproduzir a ideia com Raspberry Pi, ele assume o papel desse pequeno computador ao lado da caixa. A montagem descrita aqui usa Linux de 64 bits. O passo a passo adapta essa mesma ideia para o Raspberry; a montagem que testei fisicamente foi a do Orange Pi.

Essas funções podem compartilhar um computador. Separá-las permite deixar o servidor onde ele já está e ter apenas uma pequena estação de música na sala. Mantenha os aparelhos na mesma rede local; uma rede de visitantes pode impedir que eles se encontrem.

Quem faz o quê nessa montagem

Plex organiza e serve os arquivos. Plexamp é o aplicativo de música para acessar essa biblioteca. Caldera é um player de terceiros para Linux, sem necessidade de tela, que aceita o controle pelo Plexamp. Já o Album Cards é o aplicativo deste projeto: ele relaciona o ID do cartão ao álbum e envia o comando para tocar.

O Caldera é separado do Plexamp. Consulte a documentação do Caldera para Linux para plataformas e instalação.

02 / SEPARE AS PEÇAS

O que você precisa colocar na mesa.

Os links acima são os anúncios de referência do projeto; confira a variação escolhida e a compatibilidade com o vendedor. O nome “NFC” ou “leitor e gravador” no anúncio não garante que ele funcione como teclado. O teste que interessa aqui é receber o ID no computador.

Podemos receber comissão por compras feitas pelos links, sem custo adicional para você. A seção de custos registra o que paguei em setembro de 2026; os anúncios podem ter outros valores hoje.

PARA ALÉM DOS CARTÕES

Um player de rede, mesmo sem os cartões.

O Raspberry Pi ou Orange Pi pode ficar ao lado da caixa como seu player de música do dia a dia. Escolha um álbum no Plexamp do celular, selecione o Caldera como dispositivo de reprodução e dê play. Na mesma rede local, o celular envia os comandos, enquanto o Pi recebe a música do Plex e entrega o áudio à caixa por USB. Você continua usando o celular e deixa a reprodução com o player dedicado.

Os cartões são o jeito divertido de escolher o que ouvir. Eles não melhoram nem alteram o áudio. Ao escolher a mesma gravação, player e configurações no celular, você usa o mesmo caminho de reprodução. Leitor USB, capas impressas e caixa 3D são extras em volta de um player de rede que já é útil sozinho. O Caldera aceita controle remoto pelo Plexamp.

Controle sem fio, sem a compressão de áudio do Bluetooth.

Nesse caminho de rede para USB, o celular não precisa transmitir áudio à caixa por Bluetooth. Codecs Bluetooth comuns, como SBC e AAC, usam compressão com perdas; evitar essa etapa elimina uma possível conversão com perdas. Com uma fonte realmente FLAC no Plex, reprodução sem transcodificação com perdas e uma saída compatível, é possível preservar o áudio lossless nesse caminho. O Wi-Fi, por si só, não exige transformar a música num formato de áudio de menor qualidade.

Lossless significa preservar os dados do áudio, não necessariamente usar um arquivo sem compressão: o FLAC comprime sem descartar as amostras do áudio. Converter um MP3 em FLAC não recupera o que já foi perdido. Configurações de saída, mudança de taxa de amostragem, equalização e processamento de volume também importam; só usar USB não comprova uma reprodução bit-perfect.

E o Spotify e o Apple Music Lossless?

No Spotify, escolha o receptor do Pi nos dispositivos Spotify Connect do celular e dê play: também dá para usar sem cartões. O receptor recebe a música diretamente do Spotify e entrega por USB. A configuração do Raspotify deste projeto usa áudio com perdas em até 320 kbps. Ela evita a transmissão Bluetooth, mas não é uma promessa de suporte a Spotify Lossless.

Se os dois players usam alternância exclusiva da USB, só o receptor selecionado fica disponível. O cartão faz a troca automaticamente. Para mudar manualmente, execute bash deployment/dev.sh audio spotify ou bash deployment/dev.sh audio plex no Pi antes de escolhê-lo no celular.

O Apple Music Lossless é outro exemplo de fonte sem perdas. Ele precisa de um aparelho e caminho de áudio compatíveis, como um dispositivo suportado ligado por cabo a um DAC ou caixa ativa. Este guia não integra Apple Music ao Caldera nem ao Raspotify. Ter o Pi não o transforma automaticamente num receptor Apple Music Lossless; isso exigiria outra solução de reprodução compatível e verificada.

PREPARE SEU PLAYER

Qual sistema instalar?

Para um player dedicado, recomendo Linux de 64 bits sem área de trabalho. Você configura por outro computador e depois deixa o aparelho ao lado da caixa, sem monitor nem navegador aberto para ouvir seus cartões.

• Raspberry Pi 4 / 5: Raspberry Pi OS Lite 64-bit. Use o Raspberry Pi Imager e escolha o modelo exato da sua placa.
• Orange Pi 3B: Armbian Minimal / CLI com Debian estável, na imagem específica para o 3B. A placa tem suporte comunitário: confira as notas da imagem e da revisão de hardware. Meu aparelho atual usa Armbian com Debian 12. Imagens novas podem usar Debian 13; não testei fisicamente todas as imagens e revisões.
• PC Linux: Uma instalação atual de Debian ou Ubuntu de 64 bits serve como computador do player. Mantenha a área de trabalho se quiser usar o aplicativo nativo do Spotify no próprio PC.

1. Baixe o gravador de imagens no site oficial do Raspberry Pi ou do Armbian. Escolha sua placa e a imagem de 64 bits.
2. Defina usuário, senha, nome do aparelho, rede e acesso SSH. Grave no microSD correto: essa etapa apaga o cartão escolhido.
3. Ligue a placa com uma fonte adequada. Se puder, use cabo de rede na primeira configuração. Conecte a caixa de som por USB e selecione a entrada USB dela.
4. No seu computador, abra um terminal e conecte com o usuário e o endereço que escolheu. Troque os exemplos abaixo pelos seus dados.

ssh seu-usuario@seu-player.local

Comprei meu Orange Pi 3B no AliExpress. Comece pela página do 3B no fabricante para conferir especificações e links de compra. Inclua fonte e armazenamento adequados: a placa sozinha não é o player completo.

Passo a passo oficial: Raspberry Pi · Armbian.

04 / FAÇA A MÚSICA TOCAR PRIMEIRO

Deixe um álbum pronto no Plex.

1. Instale o Plex Media Server no computador que guarda suas músicas e entre na sua conta.
2. No painel do Plex, adicione uma biblioteca do tipo Música e selecione a pasta dos seus arquivos. Aguarde a organização.
3. Escolha um álbum conhecido e confira artista, edição, capa e sequência. Teste algumas faixas, inclusive a última. Para acertar etiquetas dos arquivos, o MusicBrainz Picard é uma opção; ele não é obrigatório para usar o player.
4. Instale o Caldera no computador ligado à caixa de som seguindo a página oficial de instalação. Entre na mesma conta Plex e habilite o serviço conforme as instruções do instalador.
5. No Plexamp, selecione o Caldera como dispositivo de reprodução. Escolha a saída de áudio correta no computador e confirme que a caixa toca.

A biblioteca precisa permanecer acessível. Se suas músicas estão em um disco externo, esse disco deve estar conectado e montado quando o Plex inicia. Ter a capa e os nomes no catálogo não garante que o servidor ainda consiga abrir os arquivos.

ALBUM CARDS

Uma aplicação, no computador ligado ao leitor.

O Album Cards reúne álbuns, atribuições, artes e PDFs. Instale no computador Linux onde o leitor USB vai ficar. O serviço em segundo plano fará a leitura mesmo quando você fechar o navegador de configuração.

1. Instale o Node.js 24 LTS para sua arquitetura (ARM64 no Pi; x64 em um PC comum) e o Git. Confira node --version e npm --version.
2. Baixe o repositório público e instale as dependências. As duas versões do tutorial usam esta mesma aplicação.

git clone https://github.com/luizguilherme5/album-cards-en.git
cd album-cards-en
npm ci
npm run build
bash deployment/dev.sh setup
bash deployment/dev.sh up

Isso inicia a aplicação compilada como serviço. No próprio Linux, abra http://127.0.0.1:3850. Se ele não tem tela, abra um segundo terminal no seu computador e execute:

ssh -N -L 3850:127.0.0.1:3850 seu-usuario@seu-player.local

Mantenha esse terminal aberto enquanto configura e visite http://127.0.0.1:3850 no seu computador. O túnel leva você até a aplicação no Pi. O leitor continua ligado ao Pi. Fechar o túnel depois não encerra a música nem o serviço do leitor.

Para desenvolver ou experimentar localmente, npm run dev abre a mesma aplicação sem compilar antes. Não execute junto com o serviço na mesma porta. Para o uso diário, prefira os comandos de serviço acima.

Conecte o leitor uma vez.

1. Conecte o leitor no Linux. Em Configurações, clique em Detectar dispositivos Linux. Escolha seu leitor pelo nome e salve as configurações.
2. Espere o status USB reader connected. Se houver erro de permissão, siga docs/READER.md para permitir o acesso somente a esse leitor USB. O aplicativo deve rodar com seu usuário normal.
3. O aplicativo guarda a identidade do leitor e tenta reconectar quando ele volta. Se aparecerem dois leitores idênticos, selecione novamente o desejado. No modo nativo do Linux, nenhum campo de texto precisa ficar em foco.

06 / TRAGA SUA COLEÇÃO

Vamos usar Abbey Road como exemplo.

As telas deste guia vêm da minha biblioteca real, aberta na nova versão do Album Cards. Comecei com seis discos para mostrar o processo. Você pode escolher qualquer álbum que já tenha no seu Plex.

1. Abra Configurações e escolha Plex / Caldera como serviço de reprodução.
2. Preencha o endereço do Plex com a porta, por exemplo http://seu-servidor:32400, e seu token. O guia oficial do Plex mostra como obter um token pelo XML de um item. Esse método pode fornecer um token temporário; se ele expirar, atualize a configuração. Trate o token como senha e não o coloque em screenshots.
3. Clique em Encontrar Caldera na rede, escolha seu player e depois em Salvar configurações. Se a descoberta não encontrar nada, confira a conta Plex e a rede; também é possível preencher endereço e identificador do Caldera manualmente.
4. Clique em Escolher álbuns do Plex, pesquise “Abbey Road”, marque a edição desejada e clique em Importar selecionados. Cada importação aceita até 50 álbuns.
5. Volte à Coleção. A capa original e as faixas já aparecem. Clique em Dados para revisar o conteúdo e em ▶ para testar o comando de reprodução.

A importação lê dados e copia a capa para a aplicação; ela não move nem renomeia suas músicas. Uma capa já salva ou uma arte vertical pronta é preservada ao reimportar.

07 / DÊ UM ÁLBUM AO CARTÃO

O cadastro é uma aproximação.

Você não precisa gravar músicas nem escrever na memória do cartão. Ele já tem um identificador. É a aplicação que salva a relação entre esse número e Abbey Road.

1. Marque o checkbox de Abbey Road na Coleção e abra a aba Cartões.
2. Clique em Atribuir selecionados. Confira o nome ao lado de “Próximo”.
3. Com o leitor Linux configurado em Configurações, aproxime o cartão. Nenhum campo precisa de foco: o Pi lê diretamente o dispositivo USB.
4. Confira a confirmação da atribuição. Se selecionou vários álbuns, a fila segue em ordem alfabética: aproxime um cartão diferente para cada próximo disco.
5. Ao terminar, clique em Reproduzir. Retire e aproxime o cartão novamente para iniciar o álbum.

Quer reaproveitar um cartão? Marque “Permitir substituir atribuições” antes de começar. Durante o cadastro, o aplicativo não toca músicas. O mesmo ID não preenche duas posições no mesmo lote, e a sessão de atribuição expira depois de cinco minutos.

O que acontece depois do cadastro?

• Outro cartão inicia o álbum correspondente pela primeira faixa.
• O mesmo cartão novamente pede uma faixa aleatória daquele álbum.
• Retirar o cartão não pausa: o leitor usado aqui não informa a retirada ao aplicativo, mesmo mudando a cor do LED.

Ligue o aparelho, aproxime o cartão, ouça.

Depois de instalar e conectar o Caldera, execute este comando na pasta do Album Cards, no Linux:

bash deployment/dev.sh enable plex

Ele ativa o Album Cards e o player escolhido no início do sistema, inclusive sem ninguém fazer login. Pode pedir sua senha do Linux uma vez. O computador precisa continuar ligado e sem suspensão. Ao terminar os cadastros, volte para Reproduzir; o modo Atribuir serve apenas para cadastrar.

bash deployment/dev.sh status
bash deployment/dev.sh logs
bash deployment/dev.sh restart

Esses comandos mostram o estado, as mensagens recentes e reiniciam a aplicação. Teste um reinício e uma leitura antes de guardar o player no lugar definitivo. Faça backup da pasta data/ para preservar cartões, imagens e configurações privadas de conexão.

CAPAS E FICHAS

A capa encontra o formato do cartão.

Clique na imagem do álbum para abrir o editor. Use Enviar arte para escolher a imagem, arraste para posicionar e ajuste o zoom. A moldura já tem a proporção final: 54 mm de largura por 85,6 mm de altura.

No exemplo de Abbey Road, usei uma arte vertical com mais céu. Posicionei a imagem para preservar os quatro integrantes na parte inferior. Uma capa quadrada pode perder conteúdo ao preencher o cartão; preparar uma versão vertical antes permite escolher melhor o recorte. O editor enquadra a imagem, mas não inventa ou expande o fundo com IA.

Clique em Salvar arte vertical. A coleção atualiza a prévia e sinaliza a arte pronta. A capa original importada do Plex e a imagem enviada para o enquadramento ficam separadas; editar o cartão não altera a capa na biblioteca Plex.

A criatividade também faz parte da coleção.

As capas geralmente são quadradas; nossos cartões são verticais. Existem vários jeitos de juntar essas duas coisas. Em algumas artes da minha coleção, usei edição de imagem com IA para expandir o fundo antes de enviar o resultado ao Album Cards. Foi uma escolha criativa para o meu projeto, não uma etapa obrigatória para o seu.

Como preparei as versões com ajuda de IA

1. Parti da capa original em boa resolução e a anexei como referência em um editor de imagem com expansão generativa.
2. Pedi uma composição vertical na proporção do cartão, expandindo o fundo em vez de esticar a imagem. A intenção era manter a identidade da capa, os personagens e os textos. A posição depende da arte: nem tudo precisa ficar no centro.
3. Comparei o resultado com a original. A IA pode mudar rostos, letras e detalhes ou criar emendas e objetos repetidos. Descartei ou ajustei versões que não funcionaram; nem sempre a primeira tentativa foi a escolhida.
4. Enviei a imagem escolhida ao Album Cards, ajustei a posição e o zoom e salvei o recorte final. O aplicativo cuida da proporção de impressão; a edição com IA acontece separadamente.

CAPA ORIGINAL

ADAPTAÇÃO VERTICAL · COM IA

Prefere criar do seu jeito, sem IA? Também vale.

Você pode manter a capa original como ela é e montar um cartão bonito no Canva, no Photoshop ou no editor de que mais gosta. A capa quadrada com uma moldura colorida, um pouco de respiro ou um título abaixo pode virar um template para a coleção inteira. Não precisa preencher todos os cantos com a fotografia.

1. Crie uma tela vertical de 1080 × 1712 px, na mesma proporção do cartão de 54 × 85,6 mm.
2. Coloque a capa original inteira, sem deformar. Escolha o tamanho e a posição e use o espaço restante para uma cor de fundo, margens ou elementos gráficos seus. Deixe textos pequenos afastados da linha de corte.
3. Exporte em PNG ou JPG de boa qualidade. Clique na arte do álbum no Album Cards, use Enviar arte, confira o template inteiro na prévia e clique em Salvar arte vertical.

Use as ferramentas com que você se sente à vontade. Experimente cores, composições e materiais e faça uma impressão de teste antes do lote. A graça é montar uma coleção com a sua cara — a criatividade vale mais do que seguir o meu layout.

Prepare também o verso.

Em Dados, confira título, artista, ano, gravadora e faixas. Cada faixa tem número e disco: use disco 1 e disco 2 quando a edição tiver dois volumes. A importação depende dos dados do serviço de origem, então uma gravadora ausente precisa ser preenchida por você.

Clique em Ficha para ver o verso renderizado antes de imprimir. A ficha usa esses dados, organiza os discos separadamente e ajusta o texto ao espaço. Se o conteúdo não couber no limite de legibilidade, a geração avisa em vez de cortar as últimas linhas. O JSON exportado guarda os dados do álbum para backup ou troca entre instalações.

IMPRESSÃO E MONTAGEM

Imprima uma folha de teste primeiro.

1. Selecione os álbuns desejados, até 50 por lote, e abra Impressão.
2. Use Gerar PDF das capas para a frente. Os discos precisam ter arte vertical salva.
3. Use Gerar PDF das fichas para o verso. Os dois seguem a ordem alfabética da seleção.
4. Confira a prévia e baixe o PDF. Escolha papel A4, orientação paisagem e escala 100% / tamanho real. Desative “ajustar à página”.
5. Meça um cartão impresso: ele deve ter 54 × 85,6 mm. Depois corte e monte um exemplar antes de imprimir a coleção inteira.

Cada folha comporta 10 cartões, com 3 mm de espaço entre artes. Para imprimir frente e verso, existe a opção “Espelhar ordem dos versos”. A orientação de virar a folha depende da impressora; faça o teste com uma folha identificada antes. Também dá para imprimir frente e verso separadamente em adesivo e aplicar no cartão.

O PDF pronto, antes de gastar papel.

Estas são as páginas reais geradas pela nova aplicação com os seis álbuns do exemplo. O espaço restante é normal: a folha comporta até dez cartões, mas este lote tem seis.

Abrir PDF de exemplo — capas · Abrir PDF de exemplo — fichas

Como eu imprimi e montei os meus.

Imprimi a frente em papel fotográfico mais grosso e brilhante, para dar presença à capa. No verso, usei papel fotográfico mais fino e sem brilho, que deixa a ficha agradável de ler. São duas impressões separadas, em papéis diferentes.

1. Teste primeiro em papel comum. Imprima a 100%, meça 54 × 85,6 mm e confirme frente e verso do mesmo álbum.
2. Escolha o papel no diálogo da impressora. Use a configuração indicada para seu papel brilhante ou fosco e confira a espessura que a impressora aceita. Não há uma gramatura única obrigatória.
3. Espere a impressão secar. Respeite a orientação do fabricante antes de empilhar, cortar ou colocar no sleeve.
4. Corte pelas marcas. Os 3 mm entre as artes dão espaço para separar os cartões sem cortar o conteúdo. Régua e base de corte ajudam a manter as bordas retas.
5. Monte um exemplar completo. Junte capa, cartão RFID e ficha correspondente, com as faces impressas voltadas para fora. Teste a leitura e o encaixe antes de repetir o lote.

O sleeve segura o conjunto.

Usei sleeves Chimera de 57,5 × 89 mm para reunir e proteger o cartão e as duas impressões. Este é o pacote com 100 unidades que usei ↗. Confira a medida da variação anunciada e teste com os papéis escolhidos: a espessura do conjunto também influencia o encaixe. Não force nem dobre o cartão para colocá-lo.

O link dos sleeves pode gerar comissão, sem custo adicional para você. O anúncio é uma referência do material usado, não uma garantia de medidas para todas as variações.

CAIXA 3D

A caixa também faz parte do ritual.

Comecei com um estudo visual para imaginar o player pronto. Depois, o desenho virou um modelo em peças separadas para impressão. A primeira imagem é o conceito; a segunda mostra a geometria final do conjunto V3.

A caixa 3D é opcional. Confira as medidas do leitor, a passagem dos cabos e o alcance da leitura na posição planejada antes de fechar o conjunto. Os arquivos V3 ficam em hardware/ no repositório oficial; use as instruções que acompanham o modelo para escolher a orientação no fatiador. Os modelos são de minha autoria, sob CC BY 4.0. Pode compartilhar e adaptar, dando crédito.

SPOTIFY

Seus álbuns do Spotify, em cartões.

Este caminho precisa de Spotify Premium, internet, um computador Linux rodando Album Cards, leitor USB e cartões compatíveis. Não exige Plex nem coleção baixada. Siga a preparação do sistema e instale o Album Cards; depois volte aqui. O leitor fica conectado ao Linux.

O receptor também funciona sem cartões: escolha-o no Spotify Connect do celular. Veja como funcionam a reprodução pela rede e a qualidade de áudio.

1. Escolha onde o som vai sair.

No Raspberry ou Orange Pi ao lado da caixa, use o Raspotify, receptor comunitário Spotify Connect baseado no librespot. O instalador deste projeto usa o executável dele em um serviço do seu usuário. Em um PC Linux com área de trabalho, você pode usar o aplicativo nativo do Spotify: entre na conta, toque uma música e mantenha-o aberto. Nessa variação, configure o início automático do Spotify na área de trabalho e mantenha a sessão gráfica ativa.

Para o receptor dedicado no Pi, execute na pasta do Album Cards:

bash deployment/dev.sh dependencies
curl -fL "https://dtcooper.github.io/raspotify/raspotify-latest_$(dpkg --print-architecture).deb" -o /tmp/raspotify.deb
bash deployment/dev.sh install-spotify /tmp/raspotify.deb
cp -n deployment/runtime.env.example ~/.config/album-cards/runtime.env
nano ~/.config/album-cards/runtime.env

O primeiro comando instala os componentes de áudio e descoberta de rede do Debian. No arquivo, escolha o nome da caixa e a saída ALSA mostrada por aplay -l. Na minha Edifier M90, a saída é plughw:CARD=M90,DEV=0 e o formato é S24_3; use o nome real do seu dispositivo. No nano, salve com Ctrl+O, Enter e saia com Ctrl+X. Se o arquivo já existe, edite em vez de substituir.

bash deployment/dev.sh spotify up

A primeira execução começa em 20% de volume. Depois de ajustar no Spotify, o receptor lembra o último nível nos reinícios e nas trocas entre players. O controle de volume da própria caixa é independente.

No celular, abra o Spotify na mesma rede e escolha “Album Cards” nos dispositivos Connect. Toque uma música na caixa. Essa primeira conexão associa o receptor à conta e permite que ele guarde o login localmente. O celular é apenas um controle: o leitor USB fica no Pi.

2. Permita que o Album Cards controle o play.

1. Abra o Spotify Developer Dashboard, crie um aplicativo para uso pessoal, escolha Web API e preencha os campos obrigatórios.
2. Em Redirect URIs, adicione exatamente http://127.0.0.1:3850/auth/spotify/callback. Salve. Não troque por localhost nem pelo IP do Pi.
3. Copie o Client ID. No Album Cards → Configurações → Spotify, cole e clique em Conectar Spotify. Autorize no navegador. Não precisa de Client Secret. Mantenha o túnel SSH aberto durante essa etapa.
4. Clique em Buscar dispositivos, selecione o receptor do Pi (ou Spotify nativo do PC) e Salvar configurações. Se não aparecer, volte ao Spotify e selecione esse dispositivo uma vez.

3. Importe o álbum e associe um cartão.

1. No Spotify, abra um álbum → Compartilhar → Copiar link do álbum. No Album Cards, abra Coleção → Adicionar álbuns e cole o link ou ID na importação Spotify.
2. Teste o botão de play do álbum. O dispositivo escolhido deve iniciar o álbum, não apenas abrir a página dele.
3. Selecione o álbum, abra Cartões → Atribuir selecionados e aproxime o cartão no leitor ligado ao Linux. Confira a confirmação, volte para Reproduzir e aproxime novamente.

O mapa fica no Album Cards no Pi: ID do cartão → álbum → Spotify. Não é preciso escrever nada no chip. Depois da configuração, você pode fechar o navegador.

Se escolheu o Spotify nativo no PC em vez do Raspotify, use bash deployment/dev.sh enable app. Isso inicia apenas o Album Cards ao ligar; o Spotify ainda precisa da sessão gráfica e do seu próprio início automático. O comando abaixo é para o receptor dedicado.

bash deployment/dev.sh enable spotify

bash deployment/dev.sh status
bash deployment/dev.sh logs
bash deployment/dev.sh restart

O controle de reprodução pela API exige Premium. Aplicativos em desenvolvimento têm limites de conta e usuários; confira as regras atuais do Dashboard. Raspotify é um projeto comunitário, separado do Spotify. Fontes: Playback API · Redirect URI · Development mode.

Agora personalize sua coleção. A seguir estão as etapas de artes, PDFs, papéis, sleeves e caixa 3D opcional, assim como na versão Plex.

CAPAS E FICHAS

A capa encontra o formato do cartão.

Clique na imagem do álbum para abrir o editor. Use Enviar arte para escolher a imagem, arraste para posicionar e ajuste o zoom. A moldura já tem a proporção final: 54 mm de largura por 85,6 mm de altura.

No exemplo de Abbey Road, usei uma arte vertical com mais céu. Posicionei a imagem para preservar os quatro integrantes na parte inferior. Uma capa quadrada pode perder conteúdo ao preencher o cartão; preparar uma versão vertical antes permite escolher melhor o recorte. O editor enquadra a imagem, mas não inventa ou expande o fundo com IA.

Clique em Salvar arte vertical. A coleção atualiza a prévia e sinaliza a arte pronta. A capa original importada do Plex e a imagem enviada para o enquadramento ficam separadas; editar o cartão não altera a capa na biblioteca Plex.

A criatividade também faz parte da coleção.

As capas geralmente são quadradas; nossos cartões são verticais. Existem vários jeitos de juntar essas duas coisas. Em algumas artes da minha coleção, usei edição de imagem com IA para expandir o fundo antes de enviar o resultado ao Album Cards. Foi uma escolha criativa para o meu projeto, não uma etapa obrigatória para o seu.

Como preparei as versões com ajuda de IA

1. Parti da capa original em boa resolução e a anexei como referência em um editor de imagem com expansão generativa.
2. Pedi uma composição vertical na proporção do cartão, expandindo o fundo em vez de esticar a imagem. A intenção era manter a identidade da capa, os personagens e os textos. A posição depende da arte: nem tudo precisa ficar no centro.
3. Comparei o resultado com a original. A IA pode mudar rostos, letras e detalhes ou criar emendas e objetos repetidos. Descartei ou ajustei versões que não funcionaram; nem sempre a primeira tentativa foi a escolhida.
4. Enviei a imagem escolhida ao Album Cards, ajustei a posição e o zoom e salvei o recorte final. O aplicativo cuida da proporção de impressão; a edição com IA acontece separadamente.

CAPA ORIGINAL

ADAPTAÇÃO VERTICAL · COM IA

Prefere criar do seu jeito, sem IA? Também vale.

Você pode manter a capa original como ela é e montar um cartão bonito no Canva, no Photoshop ou no editor de que mais gosta. A capa quadrada com uma moldura colorida, um pouco de respiro ou um título abaixo pode virar um template para a coleção inteira. Não precisa preencher todos os cantos com a fotografia.

1. Crie uma tela vertical de 1080 × 1712 px, na mesma proporção do cartão de 54 × 85,6 mm.
2. Coloque a capa original inteira, sem deformar. Escolha o tamanho e a posição e use o espaço restante para uma cor de fundo, margens ou elementos gráficos seus. Deixe textos pequenos afastados da linha de corte.
3. Exporte em PNG ou JPG de boa qualidade. Clique na arte do álbum no Album Cards, use Enviar arte, confira o template inteiro na prévia e clique em Salvar arte vertical.

Use as ferramentas com que você se sente à vontade. Experimente cores, composições e materiais e faça uma impressão de teste antes do lote. A graça é montar uma coleção com a sua cara — a criatividade vale mais do que seguir o meu layout.

Prepare também o verso.

Em Dados, confira título, artista, ano, gravadora e faixas. Cada faixa tem número e disco: use disco 1 e disco 2 quando a edição tiver dois volumes. A importação depende dos dados do serviço de origem, então uma gravadora ausente precisa ser preenchida por você.

Clique em Ficha para ver o verso renderizado antes de imprimir. A ficha usa esses dados, organiza os discos separadamente e ajusta o texto ao espaço. Se o conteúdo não couber no limite de legibilidade, a geração avisa em vez de cortar as últimas linhas. O JSON exportado guarda os dados do álbum para backup ou troca entre instalações.

IMPRESSÃO E MONTAGEM

Imprima uma folha de teste primeiro.

1. Selecione os álbuns desejados, até 50 por lote, e abra Impressão.
2. Use Gerar PDF das capas para a frente. Os discos precisam ter arte vertical salva.
3. Use Gerar PDF das fichas para o verso. Os dois seguem a ordem alfabética da seleção.
4. Confira a prévia e baixe o PDF. Escolha papel A4, orientação paisagem e escala 100% / tamanho real. Desative “ajustar à página”.
5. Meça um cartão impresso: ele deve ter 54 × 85,6 mm. Depois corte e monte um exemplar antes de imprimir a coleção inteira.

Cada folha comporta 10 cartões, com 3 mm de espaço entre artes. Para imprimir frente e verso, existe a opção “Espelhar ordem dos versos”. A orientação de virar a folha depende da impressora; faça o teste com uma folha identificada antes. Também dá para imprimir frente e verso separadamente em adesivo e aplicar no cartão.

O PDF pronto, antes de gastar papel.

Estas são as páginas reais geradas pela nova aplicação com os seis álbuns do exemplo. O espaço restante é normal: a folha comporta até dez cartões, mas este lote tem seis.

Abrir PDF de exemplo — capas · Abrir PDF de exemplo — fichas

Como eu imprimi e montei os meus.

Imprimi a frente em papel fotográfico mais grosso e brilhante, para dar presença à capa. No verso, usei papel fotográfico mais fino e sem brilho, que deixa a ficha agradável de ler. São duas impressões separadas, em papéis diferentes.

1. Teste primeiro em papel comum. Imprima a 100%, meça 54 × 85,6 mm e confirme frente e verso do mesmo álbum.
2. Escolha o papel no diálogo da impressora. Use a configuração indicada para seu papel brilhante ou fosco e confira a espessura que a impressora aceita. Não há uma gramatura única obrigatória.
3. Espere a impressão secar. Respeite a orientação do fabricante antes de empilhar, cortar ou colocar no sleeve.
4. Corte pelas marcas. Os 3 mm entre as artes dão espaço para separar os cartões sem cortar o conteúdo. Régua e base de corte ajudam a manter as bordas retas.
5. Monte um exemplar completo. Junte capa, cartão RFID e ficha correspondente, com as faces impressas voltadas para fora. Teste a leitura e o encaixe antes de repetir o lote.

O sleeve segura o conjunto.

Usei sleeves Chimera de 57,5 × 89 mm para reunir e proteger o cartão e as duas impressões. Este é o pacote com 100 unidades que usei ↗. Confira a medida da variação anunciada e teste com os papéis escolhidos: a espessura do conjunto também influencia o encaixe. Não force nem dobre o cartão para colocá-lo.

O link dos sleeves pode gerar comissão, sem custo adicional para você. O anúncio é uma referência do material usado, não uma garantia de medidas para todas as variações.

CAIXA 3D

A caixa também faz parte do ritual.

Comecei com um estudo visual para imaginar o player pronto. Depois, o desenho virou um modelo em peças separadas para impressão. A primeira imagem é o conceito; a segunda mostra a geometria final do conjunto V3.

A caixa 3D é opcional. Confira as medidas do leitor, a passagem dos cabos e o alcance da leitura na posição planejada antes de fechar o conjunto. Os arquivos V3 ficam em hardware/ no repositório oficial; use as instruções que acompanham o modelo para escolher a orientação no fatiador. Os modelos são de minha autoria, sob CC BY 4.0. Pode compartilhar e adaptar, dando crédito.

FAQ

Perguntas antes de montar?

Já começou e alguma coisa travou? Veja as verificações logo abaixo.

QUANDO ALGO NÃO SAI DE PRIMEIRA

Comece pelo último passo que funcionou.