Communitygithub.com

globo-premium

Voos de câmera em um globo 3D com imagens de satélite reais (do espaço ao ponto exato), pin com cartão, etiquetas de região, rotas animadas contínuas ou tracejadas, relevo 3D de montanhas e Terra à noite com as luzes das cidades, para vídeos verticais 9:16 e horizontais 16:9. Use quando um vídeo precisa mostrar ONDE algo está, uma viagem, uma rota, um voo de um lugar para outro, um mapa ou um globo.

O que é globo-premium?

Globo premium é uma skill para agentes de IA que gera vídeos animados de voo sobre um globo 3D com imagens de satélite reais. Ela usa o motor MapLibre GL em Chromium headless para renderizar quadro a quadro, garantindo que não haja saltos ou peças de mapa faltando em um MP4 mudo, que pode ser combinado com áudio na edição. A skill suporta plataformas de linha de comando, sendo executada via Node.js (18+) e ffmpeg, e baixa automaticamente as tiles de mapa de servidores públicos durante a renderização – sem necessidade de chaves de API ou contas. É ideal para demonstrar localizações, viagens históricas, rotas intercontinentais e explorações geográficas em vídeos verticais (9:16) ou horizontais (16:9), oferecendo opções como iluminação noturna com as luzes da cidade (NASA Black Marble), relevo 3D de montanhas, pins com cartas, etiquetas de região e rotas animadas. O fluxo de trabalho inclui a geração de uma prévia rápida (bozza) e quadro de referência (foglio) para verificar o enquadramento antes do render final.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/danilopalomba/globo-premium/tree/main/skills/globo-premium

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Globo premium

Motor: a pasta motore/ desta skill (MapLibre GL em Chromium headless, quadro a quadro: nenhum salto, nenhuma peça faltando). Saída é um MP4 mudo: voz, efeitos e música são adicionados na edição.

Primeira vez: se na pasta da skill faltar node_modules, execute bash installa.sh (verifica Node 18+ e ffmpeg, instala Playwright e seu Chromium). Os mapas não precisam ser baixados nem configurados: nenhuma chave, nenhuma conta, as peças chegam sozinhas dos servidores públicos durante o render (é necessária internet).

G="<pasta da skill>/motore"        # a pasta base da skill (onde está este SKILL.md)
node $G/render.mjs viagem.json rascunho.mp4 --escala 0.5 --fps 15 --quadro quadro.jpg   # SEMPRE primeiro: rascunho + quadro de 16 quadros
node $G/render.mjs viagem.json clipe.mp4                                             # definitivo (w×h do arquivo, 30 fps)
#   --de 3 --ate 6  para renderizar apenas um trecho

Um rascunho de 8 s em 9:16 leva cerca de um minuto e enquadra exatamente como o definitivo. Veja o quadro antes do definitivo: pino dentro do quadro, rota visível, sem retângulos.

O arquivo da viagem

Exemplos prontos em motore/exemplos/: noite_roma_toquio.json (noite + rota, 9:16), marco_polo.json (percurso com etapas), everest.json (montanha 3D), derinkuyu.json (voo + relevo, 16:9), derinkuyu_espaco_169.json (do espaço a um ponto) e as versões _169.

  • w, h, fps, duracao; no 9:16 coloque u: 1.45 (escala de textos e pinos).
  • camera: chaves {t, lng, lat, zoom, pitch, bearing}, interpoladas com uma curva monotônica. Zoom 1-1,3 globo inteiro · 2,85-3,2 globo que preenche o 9:16 · 4-5 país · 8 região · 11-12,5 cidade. Pitch máximo ~52.
  • etiquetas: pino (texto CURTO, abaixo, lng, lat, de, ate, altura) ou regiao. O cartão do pino fica ACIMA do ponto: mantenha o centro da câmera ao norte do pino (pino na metade inferior), senão com pitch alto o cartão sai do quadro.
  • percursos: pontos [[lng,lat]…], de/ate, estilo continuo|tracejado, nota (pílula) com nota_de, nota_dx, nota_dy e nota_pos [lng,lat] (padrão: no meio entre partida e chegada; em rotas longas coloque-a sobre um ponto da rota). Para rotas longas use pontos no círculo máximo e faça a câmera seguir a cabeça da rota (chaves ao longo do percurso), senão a linha sai do 9:16.
  • estilo: "noite": NASA Black Marble 2016 (luzes das cidades; zoom máximo 8, portanto sem close-ups de cidades).
  • terreno: exagero do relevo (1,4-1,6 montanhas, 0 oceanos). sombras: false sobre o oceano.
  • blue_marble (padrão ligado): de longe NASA Blue Marble, de perto Sentinel-2, com transição entre os zooms blue_marble_zoom (padrão [7, 8.2]). Remove os retângulos do mapa de satélite. Nas montanhas da Ásia (Everest, Tibete) use [9.4, 10.6]; blue_marble: false apenas Sentinel-2.
  • Os cartões dos pinos e as notas permanecem sempre dentro do quadro sozinhos (se não couberem acima do ponto vão para baixo); se o ponto sair do quadro, o cartão sai com ele.
  • creditos: texto dos créditos no canto inferior esquerdo (padrão em português; coloque em inglês ou no seu idioma se necessário, sem remover as fontes).

Receitas

  • Voo de A para B (classificações, «onde fica»): A zoom 3,2 pitch 15 → meio do caminho zoom 1,9 → B zoom 6-6,8 pitch 30, em 3 s.
  • Viagem histórica: etapas reais como pontos, estilo continuo (o tracejado claro se perde em desertos), nota com anos ou km, câmera que segue.
  • Montanha: partida de zoom ~3,2 de cima, descida a 8,6 com pitch 38, chegada a 11 com pitch 50, centro um pouco ao norte do pico.
  • Noite: rotas e pinos destacam-se muito; ideal para voos intercontinentais.

Limitações conhecidas

  • Os retângulos do mapa de satélite (dado EOX) sobre Tibete/China/Índia são cobertos pelo Blue Marble até o zoom de blue_marble_zoom: se ainda aparecer um retângulo, aumente esses dois valores.
  • Ilhas pequenas no meio do oceano além do zoom ~6 mostram um retângulo mais claro: pare em 5,8-6,6.
  • Etiquetas longas saem do 9:16: 1-2 palavras no texto, o restante em abaixo.

Licenças

Veja CREDITOS.md na raiz do repositório. Use apenas a camada EOX 2016 (CC BY 4.0, uso comercial com crédito); NUNCA as camadas EOX 2018+ (não comerciais). Noite: NASA Black Marble 2016. De longe: NASA Blue Marble. Relevo: AWS Terrain Tiles (Mapzen). Copie os créditos na descrição do vídeo.

Habilidades Relacionadas