# Z-Audio Nome provisório pq é um projeto de áudio e usa zig ## Ideia - Tocador de música - Visualizador de espectro de frequência ## MVP MVP completo em 2026-10-16 - [X] Toca WAV - [X] Play/pause - [X] Barra de progresso ## 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 # Descobertas: - Interfaces de terminal são complicadas. [ANSI Escape Codes](https://en.wikipedia.org/wiki/ANSI_escape_code#Control_Sequence_Introducer_commands) 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? - Resposta: [Entering raw mode](https://viewsourcecode.org/snaptoken/kilo/02.enteringRawMode.html#a-timeout-for-read) - [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