pu2tqf-station
Apresentação da estação PU2TQF em vídeo, num player estático sem rastreio para o QRZ
git clone https://github.com/fernando-moretes/pu2tqf-station.gitcerca de 3 min · áudio gerado ao tocar
O pu2tqf-station é o repositório estático que hospeda, via GitHub Pages, a apresentação em vídeo da minha estação de radioamador PU2TQF e o player acessível que fica embutido na minha biografia do QRZ.
O que é e por que existe
Quem chega à página de um indicativo no QRZ quer saber três coisas em poucos segundos: quem opera, com que equipamento e o que de fato foi feito com ele. Texto corrido em biografia resolve parte disso. Um vídeo curto resolve melhor, desde que não traga junto o que costuma vir com player de terceiros: autoplay, cookies, script de analytics e uma dependência externa que pode sumir.
Por isso o repositório é deliberadamente pequeno. São quatro arquivos com papel definido:
player.html: o player, sem autoplay, sem analytics, sem cookies e sem script externo.PU2TQF-welcome-en.mp4: o vídeo, 1280×720 em H.264 com áudio AAC, cerca de 2:51.transcript-en.txt: o roteiro da narração em inglês.poster.jpg: o quadro de pré-visualização exibido antes do play.
A pergunta que guiou o desenho não foi "qual o player mais completo?", foi "o que continua funcionando daqui a cinco anos sem eu mexer?". Um HTML estático servido pelo GitHub Pages a partir da raiz da branch main não tem servidor para atualizar, dependência para corrigir nem conta de terceiro para expirar. O custo de manter isso é trocar dois arquivos quando o conteúdo muda.
O que o repositório garante
player.html.transcript-en.txt serve a quem não pode ou não quer ouvir.player.html, então o nome não muda.Do commit à biografia no QRZ
O diagrama responde a uma pergunta: por onde passa o vídeo até chegar ao visitante. Não há servidor próprio: o GitHub Pages serve a raiz da branch main e a biografia do QRZ embute o player. A linha tracejada marca o único passo manual, a revisão antes do push.
- Operador · PU2TQF
- Repositório · branch main
- GitHub Pages · raiz da main
- player.html · sem scripts externos
- MP4 + poster · H.264 / AAC
- Biografia QRZ · embed
- Visitante
Como funciona por dentro
Não existe build. O que está na raiz da main é exatamente o que o GitHub Pages entrega. O player.html referencia o MP4 e o poster.jpg pelo mesmo diretório, então o navegador do visitante só fala com um host: o do Pages.
A biografia do QRZ embute o player.html. Esse é o ponto de acoplamento do sistema inteiro, e é por isso que o README diz para manter o nome do arquivo estável. Renomear o player é uma falha silenciosa: o repositório continua publicando, o Pages continua respondendo, e a biografia passa a mostrar um quadro vazio sem que nada avise.
Sobre a narração: o inglês foi gerado por IA a partir do meu perfil de voz autorizado. As imagens vêm da galeria da estação que eu já tinha publicado no QRZ, então o vídeo não introduz material inédito, reorganiza o que já era público.
Os dados da estação descrevem experimentos pessoais, e o vídeo separa três coisas que em radioamador costumam ser misturadas: relatório de recepção (eu ouvi), contato completado (houve troca nos dois sentidos) e voz digital ligada à internet (o caminho passou por rede, não só por RF). Misturar as três infla o currículo da estação, e quem opera há tempo percebe na hora.
A voz não é reutilizável
O código é público, a voz não. O repositório não concede permissão para clonar ou reutilizar o perfil de voz, e equipamento, fotos e biografia são © Fernando Azevedo. Se você quer usar a estrutura para a sua estação, aproveite o player.html e grave a sua própria narração.
Como usar e atualizar
- 1
Clone o repositório
git clone https://github.com/fernando-moretes/pu2tqf-station.gite entre no diretório. Não há dependência para instalar. - 2
Pré-visualize localmente
Qualquer servidor estático serve. Com Python:
python3 -m http.server 8000e abrahttp://localhost:8000/player.html. Abrir o arquivo direto do disco funciona na maioria dos navegadores, mas servir por HTTP é mais próximo do que o Pages faz. - 3
Troque vídeo e transcrição juntos
Substitua
PU2TQF-welcome-en.mp4etranscript-en.txtno mesmo commit. Vídeo novo com transcrição antiga é texto que afirma algo que o áudio não diz mais. Se o quadro de abertura mudou, atualizeposter.jpgtambém. - 4
Revise a saída completa
Assista ao vídeo inteiro no player local antes do push. Com narração gerada por IA, a revisão de ponta a ponta é o único controle de qualidade que existe.
- 5
Publique na main
git push origin main. O GitHub Pages serve a raiz damain, e a biografia do QRZ passa a mostrar a versão nova sem nenhuma mudança do lado do QRZ, desde que o nomeplayer.htmlcontinue o mesmo.
git clone https://github.com/fernando-moretes/pu2tqf-station.git
cd pu2tqf-station
# confirm the replacement keeps 1280x720 H.264 / AAC
ffprobe -v error -show_entries stream=codec_name,width,height -of compact PU2TQF-welcome-en.mp4
# preview exactly what Pages will serve
python3 -m http.server 8000
# open http://localhost:8000/player.html
# video and transcript go in the same commit
git add PU2TQF-welcome-en.mp4 transcript-en.txt poster.jpg
git commit -m "Update station introduction video and transcript"
git push origin mainPerguntas frequentes
Por que não hospedar o vídeo num serviço de streaming?
Porque o player de terceiro traz cookies, scripts e regras que eu não controlo. Para um vídeo de 2:51 visto em uma biografia, um MP4 servido pelo Pages basta, e o custo de manutenção é zero até o conteúdo mudar.
Posso usar o player para a minha estação?
A estrutura, sim. A voz, as fotos, o equipamento e a biografia, não: são meus e o repositório não concede permissão de reuso da voz.
Por que só em inglês?
O QRZ é lido por operadores do mundo inteiro, e inglês é a língua comum do radioamador internacional. Os nomes de arquivo terminam em -en, o que deixa espaço para outra língua sem quebrar o que já existe.
O que acontece se eu renomear o player.html?
O embed da biografia do QRZ aponta para esse nome. Renomeado, o site continua no ar e a biografia mostra um quadro quebrado, sem erro em lugar nenhum.
Para quem é
Use este repositório como modelo quando você precisa de uma apresentação em vídeo embutida em uma página que você não controla, quer zero rastreio e não quer manter servidor. Ele não serve quando você precisa de legendas sincronizadas, várias resoluções ou métricas de audiência: nada disso existe aqui, de propósito. Para uma biografia de estação, a troca é boa: dois arquivos para atualizar, um nome de arquivo para nunca mudar e uma revisão completa antes de cada push.
Deep dives de arquitetura, AWS, IA e mercado: direto no seu email. Grátis.
Sem spam · cancele quando quiser