aboutsummaryrefslogtreecommitdiff

Z-Audio

Tocador de música no terminal que recebe arquivos de áudio arbitrários da linha de comando

MVP

MVP completo em 2026-10-16

  • [X] Toca WAV
  • [X] Play/pause
  • [X] Barra de progresso

Próximos passos (a decidir)

  • Visualizador de espectro de frequência
  • Fila de reprodução
  • Utilizar miniaudio ao invés de SDL

Próximos passos (em ordem):

  • [X] Interface básica
    • [X] Metadados da música: título, álbum, artista
    • [X] Duração atualizada a cada segundo (formato: X:XX/Y:YY)
      • [X] Mudar o número de dígitos de acordo com duração da música (talvez dê pra fazer de primeira)
    • [X] Volume (+ indicador de volume)
    • [X] Barra de progresso
  • [X] Ler arquivos .mp3 ~~(talvez seja mais difícil)~~
  • [X] Mecanismo de "seek", que avança e retrocede a faixa
  • [X] Ler arquivos enviados como argumento pro programa
    • [X] Verificar se arquivo recebido existe
    • [ ] Se múltiplos arquivos forem recebidos, colocá-los em uma fila de reprodução
  • [X] Detectar se a música chegou ao seu final
    • [ ] Se sim, parar de contar o tempo
    • [X] Se sim, dar "seek" pra trás reinicia a música naquela posição

Descobertas:

  • Interfaces de terminal são complicadas. ANSI Escape Codes são necessários pra qualquer manipulação mais elaborada
    • Exemplo: escrever múltiplas linhas no terminal sem ficar dando enter, mantendo o texto atualizado sempre no mesmo lugar, exige uso das sequências \x1B[1E (código CSI CNL) e \x1B[1F (código CSI CPL) pra literalmente ir pra baixo e pra cima nas linhas do terminal; é a maneira curta e direta

Problemas:

  • [X] SDL espera uma janela pra capturar input. Sem janela, sem input pelo terminal!
    • [X] Tentar utilizar funções normais de pegar input
  • [X] A captura de keypresses da stdin espera um caractere '\n' pra ler. Como não precisar mais disso?
  • [X] Por algum motivo metada.artist retorna nulo, mesmo que o arquivo tenha essa informação
    • Acho que era uma questão do arquivo wav. Com um arquivo mp3 não teve problema
  • Cuidado ao converter .flac pra .mp3. Pequenos problemas de codificação atrapalham depois na hora de processar o áudio. É um problema de nicho, mas bom saber.
  • [X] O tempo percorrido não respeita o estado de pause
    • Funcionou, mas o código está bem feio
  • O uso de ANSI Escape Codes significa que a interface precisa verificar o tamanho da janela do terminal pra não desformatar tudo. Atualmente, redimensionar uma janela causa muitos problemas de formatação por conta disso
    • [ ] Corrigir