Guia do Usuário NexaDeck

Primeiros Passos

Se você ainda não configurou o NexaDeck, siga o guia de Primeiros Passos primeiro. Esta seção cobre o que fazer após a instalação.

Download e Instalação

1. Entre no seu portal do cliente e baixe o instalador mais recente.
2. macOS: Abra o .dmg e arraste NexaDeck para Aplicativos.
3. Windows: Execute o instalador .msi e siga as instruções.
4. Linux: Use o .AppImage (torne executável com chmod +x) ou instale o pacote .deb.

Primeira Abertura

Na primeira abertura, NexaDeck abre na tela principal. Antes de conduzir um show, configure sua saída de áudio e configurações de tela em Configurações.

Em seguida, importe sua biblioteca de karaokê na aba Biblioteca.

Conduzindo um Show

NexaDeck é construído em torno do conceito de um show — uma sessão de karaokê com rotação de cantores, fila de músicas e música ambiente opcional entre performances.

Iniciando um Show

Clique em Iniciar Show na tela principal. Isso ativa a fila de rotação e habilita o gerenciamento de cantores. Se conectado ao NexaLive, o show fica ao vivo para pedidos do público.

A Fila de Rotação

A fila de rotação é o coração de qualquer show de karaokê. Ela determina a ordem de performance dos cantores.

• Adicionar cantores — Clique no botão + ou digite um nome para adicionar alguém à fila.
• Reordenar — Arraste cantores para cima ou para baixo para ajustar a ordem de rotação.
• Marcar ausente — Se um cantor sair, marque como ausente para ser pulado até retornar.
• Filas de músicas — Cada cantor tem sua própria fila. Adicione múltiplas músicas e NexaDeck escolhe a próxima quando for a vez.

Música Ambiente

Música ambiente toca automaticamente entre cantores para manter a energia. Adicione faixas à sua playlist de buffer na aba Biblioteca. NexaDeck faz crossfade entre faixas de buffer e performances de karaokê.

Gerenciamento de Pedidos

Quando conectado ao NexaLive, membros do público podem enviar pedidos de músicas pelo celular. Os pedidos aparecem na aba Pedidos com pontuação de correspondência automática contra sua biblioteca.

Pontuação de Correspondência

Cada pedido é comparado automaticamente com sua biblioteca. Correspondências exatas exibem um badge verde com a faixa correspondente. Correspondências parciais exibem um badge laranja quando o título confere mas o artista difere. Pedidos sem correspondência exibem um badge vermelho — a música não está na sua biblioteca.

Aceitar Pedidos

Clique em Aceitar e Adicionar à Fila para adicionar um pedido com correspondência diretamente à fila do cantor. Para correspondências parciais, você pode selecionar manualmente a faixa correta antes de aceitar. Use atalhos de teclado para um fluxo de trabalho mais rápido durante shows movimentados.

Recusar Pedidos

Clique em Recusar para declinar um pedido. Você pode opcionalmente incluir uma mensagem explicando o motivo — por exemplo, se a música já foi cantada anteriormente no show.

Gerenciando Sua Biblioteca

Sua biblioteca é a coleção de todas as faixas de karaokê disponíveis no NexaDeck. Suporta pares CDG+MP3, arquivos de vídeo MP4 e arquivos ZIP.

Importando Músicas

Vá em Biblioteca > Importar e selecione uma pasta. NexaDeck escaneia arquivos suportados, lê metadados (título, artista, duração) e adiciona à biblioteca. Importações grandes rodam em segundo plano.

Pesquisando e Navegando

Use a barra de busca no topo da biblioteca para encontrar músicas por título, artista ou nome de arquivo. Resultados atualizam conforme você digita. Você também pode navegar alfabeticamente ou filtrar por adicionados recentemente.

Busca Inteligente

A barra de busca faz correspondência simultânea com títulos, artistas e marcas. Digite qualquer fragmento e os resultados atualizam instantaneamente — não é preciso especificar em qual campo você está buscando.

Filtros de Formato

Use o menu suspenso de filtro por tipo para mostrar apenas formatos específicos: CDG (CD+Graphics), MP4 (karaokê em vídeo), ou Todos. Isso é útil quando você quer verificar quais formatos estão disponíveis para uma música específica.

Adição Rápida à Rotação

Arraste qualquer resultado de busca diretamente sobre um cantor na rotação para adicioná-lo instantaneamente à fila. Você também pode clicar com o botão direito em uma música para mais opções, incluindo adicionar a uma playlist ou ver detalhes da faixa.

Barra Lateral da Biblioteca

A barra lateral da biblioteca dá acesso rápido a diferentes vistas e ferramentas:

• Todas as Músicas — Navegue toda sua biblioteca.
• Playlists — Crie e gerencie playlists personalizadas para música ambiente ou noites temáticas.
• Importar — Importe novas músicas de uma pasta no seu computador.
• Songbook — Gere e imprima um songbook para seu local.
• Download — Baixe faixas de fontes conectadas.
• Metadados — Edite títulos, artistas e outros metadados das músicas.
• Manutenção — Encontre arquivos duplicados, faixas ausentes e corrija caminhos quebrados.
• Sincronização na Nuvem — Gerencie o status de sincronização da biblioteca com NexaLive.

Saúde da Biblioteca e Pré-Voo

O painel de saúde analisa toda sua biblioteca para detectar problemas que podem atrapalhar um show. Execute uma auditoria antes de cada evento para detectar problemas antecipadamente.

Categorias de Problemas

A auditoria verifica entradas mortas (arquivos que não existem mais no disco), arquivos CDG corrompidos (gráficos danificados ou ilegíveis), áudio truncado (arquivos que terminam abruptamente), arquivos de zero bytes, áudio de baixa taxa de bits e diferenças de duração entre faixas de áudio e CDG.

Checklist Pré-Show

Execute uma auditoria completa, revise e resolva os problemas de alta severidade, e depois exporte o relatório para seus registros. Um relatório de saúde limpo significa nenhuma surpresa durante seu show.

Gerenciamento de Cantores

NexaDeck mantém um diretório de cantores que persiste entre shows. Cada perfil de cantor rastreia histórico, preferências e dados de performance.

Diretório de Cantores

O diretório de cantores é seu banco de dados de todos que já cantaram nos seus shows. Cada perfil mostra:

• Contagem de visitas — Quantos shows frequentaram.
• Total de músicas — Quantas músicas cantaram em todos os shows.
• Preferências — Ajustes de tom e andamento que NexaDeck lembra para cada cantor.

Adicionando Cantores a um Show

Durante um show, adicione cantores digitando o nome no painel de rotação. NexaDeck auto-completa do diretório. Novos nomes são salvos automaticamente para shows futuros.

Perfis de Cantores

Clique no nome de qualquer cantor para abrir seu perfil detalhado. O perfil mostra o histórico completo de performances, músicas favoritas e quantos shows frequentaram.

Notas e Preferências

Adicione notas pessoais ao perfil de qualquer cantor — preferências de bebida, lembretes de aniversário ou preferências de estilo musical. As notas são privadas à sua instalação do NexaDeck e ajudam você a oferecer uma experiência personalizada.

Histórico de Performances

A aba de histórico mostra cada música que um cantor performou, organizada por data do show. Use para evitar repetir músicas recentes ou para sugerir favoritas que não cantaram há algum tempo.

Controles de Áudio

NexaDeck fornece processamento de áudio profissional construído sobre motor Rust para performance de baixa latência em tempo real.

Mudança de Tom

Ajuste o tom de qualquer faixa para cima ou para baixo em incrementos de semitom. Configurações de tom podem ser salvas por cantor para que NexaDeck aplique automaticamente a tonalidade preferida.

Controle de Andamento

Acelere ou desacelere faixas sem afetar o tom. Útil para cantores que precisam de andamento ligeiramente diferente ou para ajustar níveis de energia.

Configurações por Música

Cada música pode ter suas próprias configurações padrão de tom, andamento e volume. São aplicadas automaticamente sempre que a música é reproduzida.

Volume e Roteamento

Controle volume de saída principal, mix de microfone e volume de música ambiente independentemente. Roteie áudio para diferentes dispositivos de saída — por exemplo, envie karaokê para os alto-falantes do local e música ambiente para uma zona separada. Configure roteamento em Configurações > Áudio.

Configurações

Acesse configurações pelo ícone de engrenagem no canto superior direito. Seções disponíveis:

• Controle de Show — Opções padrão de show, temporização de avanço automático, comportamento de música ambiente.
• Geral — Idioma do aplicativo, tema, comportamento na inicialização.
• Áudio — Seleção de dispositivo de saída, taxa de amostragem, tamanho de buffer, roteamento.
• Aparência — Tema da interface, tamanho de fonte, configuração de saída de tela.
• NexaLive — Configurações de conexão na nuvem. Veja Conectando ao NexaLive.

Controle de Show

Configure o nome do seu show, defina regras de rotação (quantas músicas por vez, limites de cantores) e gerencie a temporização de sessões. O painel de controle de show é seu centro de comando para o andamento da noite.

Backup e Restauração

Proteja seu banco de dados da biblioteca, registros de cantores e histórico de shows com backups regulares.

Backup Local do Banco de Dados

NexaDeck faz backup automático do seu banco de dados antes de operações importantes como importações. Você também pode acionar um backup manual em Configurações > Manutenção. Os backups são armazenados junto à sua biblioteca.

Backup na Nuvem via NexaLive

Quando conectado ao NexaLive, seu catálogo e dados de cantores sincronizam automaticamente para a nuvem. Isso serve como backup remoto — se seu disco local falhar, você pode restaurar pela sua conta NexaLive.

Restaurando de um Backup

Para restaurar, vá em Configurações > Manutenção > Restaurar e selecione um arquivo de backup. NexaDeck substituirá o banco de dados atual pelo conteúdo do backup. Seus arquivos de áudio e CDG não são afetados — apenas o banco de dados (metadados de faixas, cantores, histórico de shows) é restaurado.

Estatísticas e Análises

NexaDeck rastreia dados detalhados de performance em todos os seus shows.

Painel

O painel de estatísticas mostra métricas principais em um relance: total de shows realizados, total de músicas tocadas, cantores únicos, média de músicas por show e mais.

Rankings

Veja quem e o que é mais popular nos seus shows:

• Músicas Mais Tocadas — Faixas mais pedidas e tocadas em todos os shows.
• Cantores Mais Ativos — Seus performers mais frequentes e prolíficos.
• Artistas Mais Populares — Artistas mais populares na sua rotação.

Histórico de Shows

Navegue por uma linha do tempo de cada show que você realizou. Cada entrada mostra data, duração, número de cantores, músicas tocadas e notas da sessão.

Conectando ao NexaLive

NexaLive é o complemento na nuvem do NexaDeck. Habilita pedidos de músicas do público, controle remoto DJ pelo celular e status do show ao vivo para seu público.

Configurando a Conexão

1. Abra Configurações > NexaLive no NexaDeck.
2. Entre com suas credenciais da conta Abydonian.
3. NexaDeck estabelecerá uma conexão segura com os servidores NexaLive. Um indicador verde confirma que a conexão está ativa.

Sincronizando Sua Biblioteca

Uma vez conectado, NexaDeck sincroniza sua biblioteca de músicas com o NexaLive. Membros do público podem então navegar seu catálogo e enviar pedidos. A sincronização roda em segundo plano — sua biblioteca permanece atualizada conforme você adiciona ou remove músicas. Use Biblioteca > Sincronização na Nuvem para verificar o status.

Recebendo Pedidos

Pedidos de músicas de membros do público aparecem na aba Pedidos na tela principal. Cada pedido mostra o título da música, nome do solicitante e hora do envio. Aceite um pedido para adicioná-lo à fila de um cantor, ou recuse.

Status da Conexão

O indicador de conexão NexaLive aparece no canto superior direito do NexaDeck. Verde significa conectado, amarelo significa reconectando e vermelho significa desconectado. NexaDeck reconecta automaticamente se a conexão cair.

Configuração do Quiosque

Cada local recebe um código de quiosque único que membros do público inserem no celular para enviar pedidos. Configure seu código de quiosque em Configurações > NexaLive e exiba-o de forma visível no local.

Solução de Problemas de Conexão

Se a conexão cair repetidamente, verifique as configurações do seu firewall — NexaDeck precisa de acesso HTTPS de saída. Você também pode tentar alternar entre os modos WebSocket e polling nas configurações avançadas de conexão.

Atalhos de Teclado

NexaDeck suporta atalhos de teclado para controle rápido do show. Aqui estão as atribuições padrão:

Personalize atalhos em Configurações > Geral > Atalhos de Teclado.

Solução de Problemas

Soluções para problemas comuns que você pode encontrar.

Problemas de Áudio

Se o áudio não reproduz, verifique seu dispositivo de saída em Configurações > Áudio. Certifique-se de que o dispositivo correto está selecionado e o volume está ativo. Para faixas que reproduzem mas soam errado, tente ajustar os controles de tom e andamento — algumas faixas CDG têm codificação não padrão.

Problemas de Exibição CDG

Se as letras aparecem distorcidas ou as cores estão erradas, o arquivo CDG pode estar corrompido. Execute uma auditoria de Saúde da Biblioteca para identificar arquivos danificados. Re-extrair do disco original geralmente resolve o problema.

Conexão NexaLive

Se o NexaDeck não consegue conectar ao NexaLive, verifique sua conexão com a internet e confirme que suas credenciais estão corretas em Configurações > NexaLive. O indicador de status na barra inferior mostra o estado atual da conexão. Tente desconectar e reconectar se o status estiver travado.

Erros de Importação

Se músicas falham ao importar, verifique se o formato de arquivo é suportado (CDG+MP3, CDG+WAV ou MP4). Os arquivos devem ser legíveis e não estar bloqueados por outro aplicativo. O log de importação mostra detalhes para cada arquivo que falhou.

Precisa de Ajuda?

Se tiver dúvidas ou encontrar um problema, visite nossa página de contato ou entre em contato com nossa equipe de suporte. Estamos aqui para ajudar.