# pu2tqf-station

Apresentação da estação PU2TQF em vídeo, num player estático sem rastreio para o QRZ

- URL: https://fernando.moretes.com/open-source/pu2tqf-station

- Markdown: https://fernando.moretes.com/open-source/pu2tqf-station/guide.md?lang=pt

- GitHub: https://github.com/fernando-moretes/pu2tqf-station

- Language: HTML

- Topics: 

- Stars: 0

- Forks: 0

- Updated: 2026-11-13T01:45:57Z

---

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

- **Sem rastreio:** nenhum cookie, nenhum analytics e nenhum script externo no `player.html`.
- **Sem autoplay:** o visitante decide quando o áudio começa, o que importa numa página que já tem outros elementos.
- **Formato de vídeo comum:** H.264 com AAC em 1280×720, que os navegadores atuais tocam nativamente.
- **Transcrição junto do vídeo:** o roteiro em `transcript-en.txt` serve a quem não pode ou não quer ouvir.
- **Nome de arquivo estável:** o QRZ embute `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.

### Publicação

- Operador PU2TQF (user)
- Repositório branch main (ci)
- GitHub Pages raiz da main (edge)

### Conteúdo estático

- player.html sem scripts externos (frontend)
- MP4 + poster H.264 / AAC (storage)

### Consumo

- Biografia QRZ embed (external)
- Visitante (user)

### Fluxos

- op -> repo: revisa e faz push
- repo -> pages: publica
- pages -> player: serve HTTPS
- player -> media: carrega
- qrz -> player: embute
- visitor -> qrz: abre perfil

## 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.git` e 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 8000` e abra `http://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.mp4` e `transcript-en.txt` no 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, atualize `poster.jpg` també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 da `main`, e a biografia do QRZ passa a mostrar a versão nova sem nenhuma mudança do lado do QRZ, desde que o nome `player.html` continue o mesmo.

_Conferência rápida antes de publicar: formato do vídeo e preview local_

```bash
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 main
```

## Perguntas 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.

## Referências

- [fernando-moretes/pu2tqf-station (GitHub)](https://github.com/fernando-moretes/pu2tqf-station)
- [GitHub Pages documentation](https://docs.github.com/en/pages)
- [QRZ.com](https://www.qrz.com)

## 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.

## Links

- [GitHub repository](https://github.com/fernando-moretes/pu2tqf-station)
