Estúdio Conhecer+Brasil

Em uma frase: produzir, sozinho e com baixo custo, vídeos documentais independentes (3–4 min) sobre a história do Brasil para o canal do YouTube Conhecer+Brasil.

• Para quem: uso próprio (um único produtor, o dono do canal).
• Resultado esperado: um vídeo pronto para o YouTube a partir de um tema, em menos de 1 hora de trabalho.
• Regra editorial: cada vídeo tem começo, meio e fim; não é seriado.
• Prioridades: segurança dos créditos, velocidade, custo baixo e qualidade do vídeo.

Como medir: vídeos publicados por mês, custo de créditos por vídeo, tempo do tema até o arquivo final.

Problema

Fazer um documentário histórico exige roteirista, narrador, ilustrador e editor. O estúdio junta tudo isso com IA num só lugar.

Funcionalidades (o que já existe)

• Linha do tempo com 36 episódios em ordem cronológica e status (planejado, em produção, pronto, publicado).
• Roteiro com IA em 6 cenas (abertura, 4 de desenvolvimento, desfecho), editável.
• Até 3 imagens por cena (IA, computador ou pintura histórica) e narração com voz masculina natural.
• Busca de pinturas históricas no Wikimedia Commons, com prévia, autoria e página da obra.
• Produção cena a cena: a seguinte só é liberada após marcar a anterior como pronta; cada cena pode ser reiniciada.
• Clipes em movimento por cena: animação da imagem por IA, vídeos reais do Pexels e do Wikimedia Commons, e clipe criado só a partir do texto (alternativa quando o filtro recusa a imagem).
• Sequência visual única com até 3 imagens e 10 clipes por cena; setas ↑/↓ misturam imagens, vídeos reais e animações na ordem desejada.
• Contexto histórico individual para cada imagem ou clipe, editável ou criado por IA e trocado junto com a mídia.
• Botão “Baixar roteiro”: exporta o episódio inteiro (todas as cenas, narrações e descrições de imagem) num arquivo de texto.
• Prévia no navegador com reprodução dos clipes na ordem salva; no modo “apenas clipes”, eles se repetem até o fim da narração.
• Exportação do vídeo final (MP4 no Chrome, WebM em outros), sempre com vinheta animada de 3 s, cartela do canal visível por 5 s, título do episódio e encerramento com o banner do canal enquanto o narrador agradece por ter assistido (mesma voz da narração).
• Biblioteca “Meus vídeos” com episódios prontos/publicados, atalho para o YouTube Studio e link público salvo após a publicação.
• Página “Canal” com banner do YouTube (2048 × 1152), logo, cartela panorâmica para download, descrição oficial e chamada para o público copiáveis.
• Downloads de cada imagem e áudio.
• Legendas automáticas derivadas da narração, visíveis na prévia e gravadas no vídeo final; quebram por frase, nunca deixam uma palavra sozinha na linha e entram um pouco antes da fala; podem ser desligadas por cena.
• Som ambiente próprio por cena (MP3, WAV, OGG, M4A ou AAC), repetido suavemente com volume ajustável de 0% a 30%.
• Narração individual por clipe, com divisão do roteiro e geração de voz separada; exportar reutiliza os áudios salvos.
• “Baixar vídeo da cena”: reúne somente a cena escolhida, com clipes completos na ordem, imagens, voz salva, contextos, legendas e trilha; sem abrir a prévia e sem vinhetas do canal.
• Trilha única por episódio: quatro instrumentais pré-carregados ou música própria, escuta com volume ajustável mesmo antes de escolher; padrão 10%, máximo 25%.
• Login (Google ou e-mail); apenas o dono gera conteúdo; visitantes só veem a linha do tempo.

Fora do escopo por enquanto

• Upload automático ao YouTube; a versão atual abre o YouTube Studio para o envio manual.
• Vários usuários ou equipe.

Critérios de aceite

• Um episódio com todas as cenas completas pode ser exportado sem erros.
• Pessoas que não são o dono não conseguem gastar créditos.

• Frontend: TanStack Start (React 19, Vite, SSR), Tailwind v4, componentes shadcn, TanStack Query.
• Backend: Lovable Cloud (banco Postgres, autenticação, armazenamento privado midia).
• Lógica de servidor: todas as escritas e chamadas de IA em server functions (src/lib/studio.functions.ts) protegidas pelo middleware requireDono.
• IA (Lovable AI Gateway): roteiro openai/gpt-6-astra; imagem openai/gpt-image-2.5-sunburst (1536×1024); voz google/gemini-3.1-flash-tts-preview (Charon); animação google/gemini-omni-1.1-flash (8s, 720p).
• Vídeos reais: API do Pexels (chave secreta no servidor) e API do Wikimedia Commons; apenas esses domínios são aceitos para download.
• Pinturas históricas: busca no Wikimedia Commons; a obra escolhida é copiada para o armazenamento privado e mantém crédito e link da fonte.
• Exportação: no navegador com Canvas + WebAudio + MediaRecorder, 1920×1080, sem custo de servidor.
• Legendas e mixagem: o texto da narração é dividido em blocos curtos que respeitam o fim de cada frase (sem palavra sozinha na linha) e sincronizado proporcionalmente à duração do áudio, com leve avanço de entrada; o som ambiente toca em repetição com entrada e saída suaves sob a voz.
• Mídia: arquivos privados acessados por links assinados de 365 dias.
• Validação: todas as entradas do servidor validadas com zod (IDs, tamanhos de texto, limites de cenas e clipes).

1. Abre a linha do tempo → escolhe um episódio.
2. Entra na conta → clica em “Gerar roteiro com IA”.
3. Revisa e edita textos → “Salvar edições”.
4. Gera imagem e voz da cena 1, revisa e marca como pronta.
5. A cena seguinte é liberada; repete a geração e aprovação até o final.
6. Adiciona clipes em movimento antes de marcar cada cena pronta.
7. Opcionalmente, troca a imagem gerada por uma pintura histórica encontrada no acervo.
8. “Assistir prévia” → “Exportar vídeo” → abre “Meus vídeos” e o YouTube Studio para subir o arquivo.
9. Depois da publicação, cola e salva o link público; então marca o episódio como publicado.

E se…

• …não estiver logado? Vê o episódio, mas os botões de gerar ficam bloqueados e aparece o aviso para entrar.
• …outra pessoa criar conta? Recebe “Acesso restrito ao dono do estúdio” e nada é gerado.
• …os créditos de IA acabarem? Mensagem “Créditos de IA esgotados”; nada é perdido.
• …muitas solicitações seguidas? Mensagem pedindo para aguardar e tentar de novo.
• …refazer o roteiro? Pede confirmação, pois substitui as cenas atuais (imagens e vozes antigas deixam de ser usadas).
• …editar uma descrição e usar “Gerar todas”? O estúdio salva as edições antes de gerar, traduz descrições em português e informa exatamente qual cena foi recusada.
• …a imagem for recusada? Edite o campo “Descrição da imagem” da cena indicada; mudar somente a narração não altera a imagem.
• …a voz parecer exagerada? A nova narração usa ritmo moderado, pausas discretas e ênfase apenas em pontos importantes; regenere a voz da cena para aplicar.
• …a animação por IA falhar? Aviso com o motivo; tente outra imagem.
• …usar uma pintura? Busque pelo fato, personagem ou ano, confira o contexto e clique na obra; ela entra como nova imagem na sequência da cena.
• …tentar gerar a próxima cena? Os controles ficam bloqueados até a cena anterior ser marcada como pronta.
• …reiniciar uma cena? Imagem, voz e clipes são removidos; texto e descrição permanecem. As aprovações posteriores são reabertas.
• …a cena já tiver 10 clipes? Não aceita mais; remova um antes (a lixeira apaga o arquivo de vez).
• …gerar mais de um clipe com o mesmo prompt? Cada clique em “Animar imagem (IA)” ou “Clipe só do texto (IA)” cria um clipe novo (até 10 por cena). Os resultados variam entre tentativas, mesmo com o mesmo texto, e cada clipe consome créditos de vídeo.
• …eu mudar a ordem visual? Os botões de seta ficam junto de cada imagem e clipe. A ordem mista é salva na hora e usada na prévia e exportação.
• …adicionar contextos diferentes? Cada imagem ou clipe tem seu próprio campo. O cartão permanece enquanto aquela mídia aparece e muda automaticamente na próxima.
• …aperfeiçoar meu próprio contexto? Digite em “Contexto desta mídia” e clique em “Aperfeiçoar com IA”. A IA melhora clareza e concisão, preservando sua ideia dentro da história da cena e do episódio. A chave “Limitar IA a 10 s de leitura” vem ligada: gera até 20 palavras, com leitura estimada de duas palavras por segundo. Pode desligá-la antes de pedir à IA. A estimativa aparece ao lado da chave; textos antigos e edições manuais não são cortados. O resultado substitui o texto no campo e é salvo para a prévia e o vídeo; você pode revisá-lo depois. Com o campo vazio, “Gerar com IA” cria uma nota com o mesmo limite. Só essa mídia muda, sem gerar voz; limitar o contexto não encurta a narração nem impede o vídeo de esperar por um áudio longo. A solicitação de IA consome créditos.
• …marcar “usar apenas clipes”? A prévia e o vídeo final repetem os clipes na ordem salva até terminar a narração, sem exibir a imagem estática.
• …fechar a aba durante a exportação? A exportação é cancelada; é preciso recomeçar.
• …assistir a uma cena fora do app? Ao lado de “Assistir prévia”, clique em “Baixar vídeo da cena” e aguarde a porcentagem terminar, sem fechar a aba. No computador, o arquivo é baixado; em telas de toque, clique em “Salvar vídeo pronto” para salvar ou compartilhar. Não precisa marcar a cena anterior pronta nem gerar outra voz. MP4 quando suportado, WebM como alternativa. Cada clipe toca inteiro; se sua fala for mais longa, mantém o último quadro até terminar.
• …clicar em “Publicar”? O YouTube Studio abre em outra aba. O envio não é automático; depois, copie o link público e salve no episódio.
• …o episódio não existir? Página “Episódio não encontrado” com link de volta.

• Personalidade: documentário épico, arquivo histórico, pergaminho à luz de vela.
• Cores: fundo escuro sépia, destaques em dourado, texto creme. Tudo por tokens no tema, sem cores fixas.
• Tipografia: Cinzel nos títulos (inscrição clássica) e Lora no texto (leitura longa).
• Layout: linha do tempo vertical com marcadores dourados; editor em cartões por cena (texto à esquerda, imagem à direita).
• Princípios: um botão principal por etapa, barra com etapa e porcentagem durante a criação do roteiro e das mídias, mensagens em português simples.
• Identidade: logo quadrada oficial com mapa do Brasil, referências históricas e nome Conhecer+Brasil; cartela panorâmica separada para abertura e encerramento.
• Vídeo: cartela do canal em estilo editorial histórico, com cores da bandeira, linha do tempo visual do Brasil e mensagem “Conheça o passado. Entenda o presente. Descubra o Brasil.”; depois, tela com o título do episódio, zoom lento nas imagens, título da cena em dourado e cartela de encerramento.

Tabela episodios (leitura pública, escrita só pelo servidor)

• id, ordem (posição na linha do tempo), periodo, titulo, sinopse.
• status: planejado · em produção · pronto · publicado.
• cenas (lista): cada cena tem texto, prompt, áudio, até 3 imagens, até 5 clipes, midia_ordem para a sequência visual e contextos_midia para a nota histórica de cada mídia. Campos antigos continuam aceitos.
• youtube_url: link público opcional do vídeo depois de publicado.
• created_at, updated_at.

Tabela user_roles (papéis)

• user_id, role (admin = dono). Cada usuário só vê o próprio papel; ninguém se promove pelo app.
• A função has_role confirma se quem chama é o dono.

Armazenamento midia (privado)

Pasta por episódio: {id}/cenaN.png, vozN.wav, clipeN.mp4.

episodios 1 ── * cenas (dentro do registro)
cenas     1 ── 1 imagem, 1 voz, 0..10 clipes  → arquivos em "midia"
auth.users 1 ── * user_roles (admin = dono)

Concluído

• Fase 1 — Episódio 1 montado manualmente (Descobrimento, 1500).
• Fase 2 — Estúdio: linha do tempo, roteiro, imagem, voz, prévia.
• Fase 3 — Login e bloqueio dos botões de gerar.
• Fase 4 — Exportação de vídeo no navegador.
• Fase 5 — Clipes em movimento (IA, Pexels, Wikimedia).
• Fase 6 — Acesso exclusivo do dono e esta documentação.
• Fase 7 — Barra de evolução para roteiro, imagens e narrações.
• Fase 8 — Busca e uso de pinturas históricas com crédito da fonte.
• Fase 9 — Aprovação sequencial e reinício individual de cenas.
• Fase 10 — Excluir imagem, dicas nos botões e mistura/ordenação de clipes reais e animados (função reordenarClipes, protegida por requireDono).
• Fase 11 — Envio de imagem e vídeo do próprio PC e botão “Baixar roteiro” (.txt com todas as cenas).
• Fase 12 — Biblioteca de vídeos, publicação assistida pelo YouTube Studio, link público por episódio e página de identidade do canal.

Próximos passos sugeridos

1. Gerar título, descrição e tags para o YouTube (alcance).
2. Miniatura (thumbnail) automática por episódio.
3. Limpeza de arquivos antigos não usados (custo de armazenamento).
4. Domínio próprio para a marca.

• Vídeos independentes: quem chega por busca no YouTube entende qualquer vídeo sem ver os outros.
• 6 cenas de ~100 palavras: dá 3–4 minutos, bom para retenção e custo baixo de geração.
• Exportação no navegador: não gasta servidor nem créditos; em troca, exige a aba aberta.
• Pexels e Wikimedia antes da IA: vídeos reais são gratuitos; a animação por IA custa mais e fica para cenas sem material real.
• Arquivos privados: a plataforma bloqueia arquivos públicos; links assinados resolvem.
• Primeira conta vira dona: como o canal é só seu, é a forma mais simples de trancar o estúdio sem configuração extra.

Segurança

• Corrigido: qualquer pessoa podia criar conta e gastar créditos. Agora só o dono gera conteúdo (verificado no servidor em todas as 10 ações).
• Corrigido: visitantes sem login não conseguem consultar papéis de usuário.
• Downloads de vídeo aceitam só Pexels e Wikimedia (evita uso do servidor para baixar qualquer coisa).
• Chaves de IA e do Pexels ficam somente no servidor.
• Todas as entradas validadas (tamanhos, IDs, limites).

Depuração e limpeza

• Corrigido: a prévia ainda mostrava o nome antigo “SagaBrasileira”.
• Sem eventos desnecessários: não há atualizações automáticas contínuas; a animação por IA consulta o progresso só enquanto está gerando.

Custo e velocidade

• “Gerar todas” pula cenas que já têm imagem ou voz (não gasta de novo).
• Imagens em qualidade média (bom equilíbrio custo × qualidade para 1080p com zoom).
• Ferramenta de exportação só é carregada quando você clica em exportar.

Pontos de atenção

• Ao refazer roteiro ou imagem, os arquivos antigos continuam guardados (ocupam espaço).
• Links de mídia expiram em 1 ano; episódios antigos precisarão regenerar os links.

• Quantos vídeos por mês você quer publicar?
• Quer também versões curtas (Shorts, 60s, vertical) de cada episódio?
• Legendas: queimadas no vídeo ou arquivo separado (.srt) para o YouTube?
• Os 36 episódios da linha do tempo estão bons, ou quer incluir o período de 1930 até hoje?
• Tem um limite de gasto mensal com créditos de IA?

Antes de começar: exporte o episódio até 100% e guarde o arquivo de vídeo no computador. Confira o vídeo inteiro, principalmente a voz, os contextos históricos, a vinheta e o encerramento.

1. Abrir o envio

1. Abra Meus vídeos no estúdio e localize o episódio pronto.
2. Clique em Publicar. O YouTube Studio abrirá em outra aba.
3. Entre na conta oficial do canal Conhecer+Brasil, se o YouTube solicitar.
4. Clique em Selecionar arquivos e escolha o vídeo exportado no computador. Não feche a página enquanto o envio estiver em andamento.

2. Preencher os detalhes

1. Título: use o nome do episódio e o período, de forma clara. Exemplo: O Descobrimento do Brasil (1500) | Conhecer+Brasil.
2. Descrição: siga a ordem testada no Episódio 1 — (1) chamada para o público nas primeiras linhas (curtir, inscrever-se e ativar o sino, comentar e compartilhar), porque é o que aparece antes do “mostrar mais”; (2) em seguida, a apresentação do tema e o que o público aprenderá; (3) por fim, as hashtags (#HistoriaDoBrasil, #ConhecerMaisBrasil etc.). A descrição oficial do canal e a chamada podem ser copiadas na página Canal. Os créditos do episódio (canal, autor, data da publicação, aviso de produção com IA e fontes das obras) aparecem no cartão final do vídeo e podem ser copiados em Créditos do vídeo, na página do episódio, para colar na descrição.
3. Miniatura: envie uma imagem horizontal em 16:9, nítida e com texto curto. Não use o banner do canal como miniatura.
4. Playlist: escolha ou crie uma lista como História do Brasil. Esta etapa é opcional.
5. Público: para documentários históricos destinados ao público geral, marque “Não, não é conteúdo para crianças”, salvo quando o vídeo tiver sido criado especificamente para crianças.
6. Se houver imagens históricas sensíveis, revise as opções de restrição de idade antes de continuar.

3. Conferir e publicar

1. Aguarde o YouTube concluir o processamento e as verificações de direitos autorais. O envio pode terminar antes da versão em alta definição.
2. Em Elementos do vídeo, tela final e cartões são opcionais. Eles podem ser adicionados depois.
3. Em Visibilidade, escolha Não listado para revisar primeiro, Privado para guardar, Público para publicar agora ou Programar para definir dia e hora.
4. Para o primeiro vídeo, recomenda-se usar Não listado, assistir pelo link e só depois mudar para Público.
5. Clique em Salvar, Publicar ou Programar, conforme a opção escolhida.

4. Guardar o link no estúdio

1. No YouTube Studio, abra o vídeo e copie o endereço público, normalmente iniciado por https://youtu.be/ ou https://www.youtube.com/watch?v=.
2. Volte a Meus vídeos, cole o endereço em Link depois da publicação e clique em Salvar link.
3. Abra o episódio e use Marcar publicado somente depois de confirmar que o vídeo está acessível no YouTube.

Checklist antes de tornar público

• O título e a descrição estão sem erros.
• A miniatura representa corretamente o episódio.
• Imagem e som funcionam do começo ao fim.
• As fontes e os créditos de obras históricas estão indicados quando necessário.
• O vídeo está no canal Conhecer+Brasil e o link foi salvo no estúdio.

Segurança: o estúdio apenas abre a página oficial do YouTube. A senha e a confirmação final permanecem exclusivamente na sua conta.

Agenda quinzenal

• Meta: publicar um episódio a cada 15 dias.
• A página Agenda calcula as próximas datas a partir do último vídeo publicado e as distribui pelos próximos episódios, em ordem cronológica.
• Clique em Ativar lembretes no navegador: a partir de 3 dias antes (ou se estiver atrasado), o estúdio mostra um aviso ao ser aberto — no máximo um por dia.
• Limite: o aviso aparece quando o estúdio é aberto naquele navegador; não chega por e-mail ou celular com o estúdio fechado.
• Técnico: cálculo no navegador (calcularAgenda em src/routes/agenda.tsx) usando publicado_em; sem nova tabela nem custo de servidor.

• Regra de ouro: não é preciso criar uma rede nova para cada episódio. Comece por uma ou duas redes onde o público de história já está e amplie depois.
• Facebook: crie uma Página (não perfil pessoal) com o nome e a logo do canal. Publique o link do vídeo com uma pergunta curta (ex.: “Você sabia que o Brasil já tinha milhões de habitantes antes de 1500?”) e compartilhe em grupos de história — sempre contribuindo com o grupo, nunca só colando o link.
• Instagram: crie um perfil profissional com a logo como foto e o link do canal na bio. Publique Reels verticais curtos (30–60 s) recortados do episódio, com legenda e chamada “vídeo completo no canal”.
• TikTok: mesmo formato do Reels — cortes verticais de 30–60 s com um fato surpreendente no primeiro segundo. O TikTok é a rede que mais alcança gente nova sem seguidores.
• X (Twitter): publique um “fio” (thread) com 3–5 fatos do episódio e o link do vídeo no fim. Público de história engaja bem com imagens de época nos tuítes.
• Cortes verticais (9:16): o vídeo vertical curto é o padrão aceito por todas as redes; publique o mesmo corte no TikTok, Reels e YouTube Shorts, com pequenas adaptações de capa e legenda para cada rede [5](https://digitalmidiaservice.com.br/adaptacao-de-conteudo-como-reutilizar-videos-em-multiplas-plataformas-shorts-e-reels/). Um vídeo reaproveitado em várias redes multiplica o alcance sem multiplicar o trabalho [2](https://foloza.com/blog/empilhar-receita-criador-multi-plataforma-2026-guia-tiktok-youtube-instagram-facebook).
• O que evitar: spam de “assistam meu canal” em comentários e grupos — as plataformas penalizam e afasta o público [1](https://sextosentidovirtual.com/como-divulgar-meu-canal-no-youtube-o-guia-de-trafego-absoluto/). Prefira teaser antes da publicação e post com link direto no dia do lançamento [3](https://thriveagency.com/news/how-to-use-social-media-to-grow-your-youtube-channel/).
• Identidade: use o mesmo nome (Conhecer+Brasil), a mesma logo e a mesma frase nas redes — ajuda o público a reconhecer o canal [3](https://thriveagency.com/news/how-to-use-social-media-to-grow-your-youtube-channel/).
• No estúdio: na página do episódio (status “pronto” ou “publicado”), a seção “Divulgação nas redes sociais” gera com IA a chamada, a legenda e as hashtags do episódio, prontas para copiar e colar em cada rede. Depois de postar, cole os links dos posts do Facebook, Instagram e TikTok no mesmo lugar para guardar o histórico; eles aparecem como botões na página “Meus vídeos”. A publicação continua manual — o estúdio não posta sozinho em nenhuma rede.

Divulgação paga (etapa futura) — Google Ads

• Vincular o canal ao Google Ads não é necessário agora. Primeiro, publique de forma orgânica mais 2–3 episódios e observe retenção e engajamento no YouTube Studio.
• Para um primeiro teste pago, use as Promoções do YouTube Studio com orçamento pequeno (ex.: R$ 5–10 por dia) antes da configuração avançada do Google Ads.
• Anúncio compra alcance, não fidelidade: invista em vídeos que já retêm bem o público orgânico.
• Quando chegar a hora, o Google Ads pode ser conectado ao estúdio para acompanhar campanhas.

Fluxo para produzir os clipes de cada cena no Kling AI, dividindo a história em tomadas curtas de cerca de 5 segundos. As cenas 4–6 do Episódio 2 (O Descobrimento) já têm os prompts prontos — gravados no campo prompt do clipe de cada cena e reunidos no documento “Kit de produção” em arquivos. O mesmo passo a passo vale para os próximos episódios.

Passo a passo por tomada

1. Planeje seis tomadas: cada cena tem exatamente 6 vídeos de 5 s no Kling (cerca de 30 s), com início, ação e fim claros, composição da imagem-base e 3 notas históricas específicas da cena. Som e voz continuam sendo produzidos no estúdio.
2. Crie a imagem-base no estúdio: em cada cena, use Gerar imagem (o prompt de imagem já está na cena) e clique em Marcar pronta ao aprovar. Para uma segunda imagem da mesma cena, gere fora ou use outro prompt e traga com Subir imagem (PC).
3. Anime no Kling: baixe a imagem da cena no estúdio e use como quadro inicial (Image-to-Video), cole o prompt de animação em inglês, configure 1080p, 5 s, 1 saída, Áudio nativo desligado e baixe o MP4.
4. Tomada sem imagem-base: use Text-to-Video com o prompt em inglês da tomada; se o Kling recusar, tente o botão Clipe só do texto (IA) do estúdio.
5. Traga para o estúdio: na cena, Subir vídeo (PC) — dá para selecionar vários MP4 de uma vez (sobem em sequência, com contador de progresso) — e ordene com as setas junto das imagens e dos outros clipes.

Checklist do Kling (cada geração)

• Resolução 1080p; duração 5 s; 1 saída.
• Áudio nativo desligado — narração e som ambiente entram na montagem do estúdio.
• Proporção acompanha a imagem-base (com quadro inicial, o Kling usa a proporção da imagem).
• Prompt em inglês, descrevendo movimento de câmera, época, luz e terminando com “no text”.

1. No episódio, localize Trilha sonora do episódio e clique em Ouvir na música que deseja avaliar.
2. Ajuste Volume enquanto ouve, mesmo sem ter clicado em “Usar”. A alteração é imediata; 0% silencia, o padrão é 10% e o máximo é 25%.
3. Clique em Usar para guardar a música e o volume no episódio. Apenas o dono pode salvar essa escolha.
4. Para a música já escolhida, solte o controle de volume ou termine o ajuste pelo teclado para salvar. Ouvir outra música não muda a escolha nem o volume guardado até clicar em “Usar”.
5. Também pode Subir música (PC) (até 25 MB) ou escolher Sem trilha. Confira os direitos de uso de qualquer música enviada.
6. A prévia e a exportação usam a trilha escolhida por baixo da voz. Exportar não exige gerar a narração novamente.

Parte técnica

O controle distingue escuta local e escolha salva: estadoVolumeTrilha permite ajustar durante a escuta, mas só grava quando o dono ajusta a trilha atual. O reprodutor de escuta usa o volume indicado, sem multiplicá-lo. A escolha permanece em cenas[0].trilha_url/trilha_nome/trilha_volume; nenhuma mudança de permissão ou de armazenamento.

• v1.75 (19/10/2026): legendas não deixam o fragmento “de Cabral.” isolado: o final curto recebe mais uma palavra e as linhas visuais também são equilibradas. A exportação aumenta a voz em 4 dB, sem alterar os áudios salvos nem o volume escolhido para a trilha. Um limitador antecipado controla os picos em -1 dB sem reduzir a fala inteira, nos dois modos de exportação. Objetivo de volume percebido: próximo de -14 LUFS; o valor exato depende do áudio e deve ser medido no arquivo final. Baixe novamente para aplicar ao vídeo. Técnico: mixagem compartilhada em exportar-video.ts e ganho/limitador em audio-exportacao.ts.
• v1.74 (19/10/2026): velocidade automática do clipe para sincronizar com a narração, a pedido do dono: quando a fala de um clipe é maior que o vídeo, o clipe desacelera sozinho (até 0,8x) para os dois terminarem juntos, em vez de congelar o quadro final. Falas muito longas (que precisariam de menos de 0,8x) continuam segurando o último quadro. Vale para a prévia e para a exportação (vídeo completo e cena individual). Técnico: velocidadeClipe em exportacao-cena.ts, taxa por trecho em exportar-video.ts e playbackRate na prévia (MidiaPrevia); testes em src/lib/exportacao-cena.test.ts.
• v1.73 (19/10/2026): três regras de acabamento na exportação, a pedido do dono: 1) no fim de cada cena, a imagem permanece de 1,5 a 2 segundos depois da última palavra (respiro antes da próxima cena); 2) o pico do áudio final é limitado a -1 dB, sem distorcer (no caminho quadro a quadro o mix é medido e reduzido só se passar do limite; na gravação em tempo real, um ganho fixo de -1 dB); 3) o vídeo sai a 24 quadros por segundo, igual às tomadas. Técnico: PADDING_FIM_FALA, PICO_MAX e FPS_EXPORT em exportar-video.ts.
• v1.72 (19/10/2026): legendas revisadas a pedido do dono: a quebra agora respeita o fim de cada frase, nenhuma linha fica com uma palavra só (o restinho é juntado ao bloco anterior ou as linhas são equilibradas) e a legenda entra um pouco antes da fala (avanço de ~1 palavra de leitura). Vale para a prévia e para a exportação. Técnico: nova função blocosLegenda em studio.functions.ts, usada por legendaNoMomento; testes em src/lib/legendas.test.ts.
• v1.71 (19/10/2026): o quadro “Descrição do YouTube” ganhou uma orientação fixa sobre o “Próximo episódio”: lembra que a IA não cita outros vídeos e explica que, ao publicar o episódio seguinte, basta copiar o link dele, trocar a linha “Próximo episódio” pelo link real e clicar em “Salvar descrição” antes de colar no YouTube Studio. Texto apenas informativo, sem alteração de dados.
• v1.70 (19/10/2026): quadro “Descrição do YouTube” na página do episódio: gerar com IA, editar, salvar e copiar. A IA não cita outros episódios (cada vídeo é independente). Técnico: gerarDescricaoYoutube/salvarDescricaoYoutube com requireDono; texto em cenas[0].descricao_youtube.
• v1.69 (18/10/2026): chave por mídia “Limitar IA a 10 s de leitura”, ligada por padrão, para gerar ou aperfeiçoar contextos de até 20 palavras (estimativa de leitura, não duração da voz). O servidor valida o limite antes de salvar e pode solicitar uma reformulação curta; se continuar longo, preserva o texto atual. Textos já salvos, edição manual, voz e duração do vídeo permanecem intactos. Técnico: limite e estimativa em contexto-edicao.ts, testes de 20/21 palavras e chave desligada; fila de salvamento mantida.
• v1.68 (18/10/2026): créditos de autoria no fim do episódio. O vídeo completo ganha um cartão final (7 segundos, com a trilha continuando e saindo suavemente) com o canal Conhecer+Brasil, “Waldemar Oliveira — autoria e direção”, a data — a da publicação; se o episódio ainda não foi publicado, vale o dia da exportação —, o aviso “Produção realizada com auxílio de inteligência artificial” e as fontes das obras usadas (até 3 linhas, com “+N outras fontes”). A mesma lista aparece em “Créditos do vídeo” na página do episódio, com botão “Copiar créditos” para colar na descrição da publicação. O download por cena continua sem cartão. Técnico: src/lib/creditos.ts (creditosDoEpisodio/textoCreditos); exportarVideo recebe publicadoEm e desenha o cartão após o agradecimento; testes em src/lib/creditos.test.ts.
• v1.67 (18/10/2026): contexto digitado por mídia pode ser aperfeiçoado pela IA preservando o assunto do dono. O texto atual é enviado explicitamente; geração e salvamento usam a fila do episódio, atualizam apenas a nota escolhida e preservam demais edições. Resultado salvo em contextos_midia, usado pela prévia e exportação, sem mudar narração ou mídia.
• v1.66 (18/10/2026): a vinheta falada do meio do episódio foi removida. No lugar, uma faixa silenciosa com “👍 Curta · ✅ Inscreva-se · 🔔 Ative o sininho” aparece por 6 segundos sobre o vídeo em andamento, nos primeiros segundos da cena do meio — sem interromper a cena e sem voz extra. O encerramento falado com o banner de agradecimento continua no fim do vídeo.
• v1.65 (18/10/2026): encerramento falado: o vídeo exportado termina com o banner do canal (o mesmo da página “Canal”) enquanto o narrador agradece — “Obrigado por assistir até o fim… até o próximo episódio do Conhecer Mais Brasil” — com a mesma voz Charon da narração. O agradecimento é um áudio fixo do estúdio (vinheta-agradecimento.wav), sem custo de IA por exportação, e entra só no vídeo completo do episódio (o download por cena continua sem vinhetas). Técnico: banner servido como asset CDN (banner-agradecimento.png.asset.json); o exportador agenda o áudio em fimCenas e desenha o banner em tela cheia com entrada suave.
• v1.64 (18/10/2026): download completo por cena, independente da prévia, com reutilização de voz e trilha, clipes inteiros, progresso e botão para salvar o arquivo preparado em telas de toque. Documentação e mapa mental atualizados.
• v1.63 (18/10/2026): prévia com narração por clipe mais robusta: se o vídeo travar para carregar, a fala pausa e volta junto; a fala sempre retoma após uma espera; se a voz de um clipe não carregar, aparece um aviso e o vídeo segue; um vigia avança o clipe se algo parar de responder.
• v1.62 (18/10/2026): volume liberado durante “Ouvir”, mesmo sem trilha escolhida. A escuta usa o percentual exibido, sem amplificação oculta. Ajustar outra música não altera a trilha salva; “Usar” grava a nova escolha e seu volume. Acrescentados guia de trilha sonora e mapa mental nesta documentação, com narração por clipe, produção em 6 tomadas e fluxo até publicação.
• v1.61 (18/10/2026): trilha sonora do episódio. Painel “Trilha sonora do episódio” abaixo dos botões: escolha uma das 4 trilhas instrumentais originais do estúdio (Épica, Solene, Tensão, Serena — livres de direitos), suba uma música própria (MP3/WAV até 25 MB) ou deixe “Sem trilha”. Volume padrão 10% (0–25%). A música toca contínua do início ao fim, com entrada e saída suaves, na prévia e no vídeo final. Técnico: guardada em cenas[0].trilha_url/trilha_nome/trilha_volume; funções salvarTrilha e enviarTrilha com requireDono; mixagem em tocarTrilha no exportador.
• v1.60 (18/10/2026): narração por clipe. Cada vídeo da cena tem seu próprio texto e voz (botão “Gerar voz” no clipe; os outros não mudam). “Dividir narração nos clipes” reparte o texto da cena por frases, sem custo. A fala acompanha a duração de cada vídeo: o contador mostra palavras, tempo estimado da fala e duração do vídeo; se a fala for maior, o último quadro segura até ela terminar. Prévia e exportação seguem esse alinhamento e as legendas mostram o texto do clipe. Técnico: clipes[].narracao_texto/audio_url, funções salvarNarracaoClipe e gerarVozClipe com requireDono; na exportação, os áudios dos clipes são emendados num buffer por cena. Cenas sem voz por clipe continuam usando a narração geral.
• v1.59 (18/10/2026): corrigida a edição dos contextos: espaços e quebras de linha permanecem durante a digitação. As notas da cena são salvas individualmente ao sair do campo, sem recarregar o roteiro ou substituir edições recentes. Os salvamentos de contexto aguardam um ao outro para não sobrescrever notas anteriores; falhas são avisadas sem apagar o texto digitado. O limite continua sendo 300 caracteres por nota.
• v1.58 (18/10/2026): passagem entre mídias na prévia refeita com dois reprodutores persistentes: o próximo clipe é pré-carregado e o quadro anterior só sai quando o primeiro quadro do seguinte foi decodificado. Imagens também aguardam decodificação, sem entrada por transparência. Durante uma espera, narração e ambiente pausam juntos e retomam quando a mídia está pronta; erros mantêm o último quadro em vez de avançar para uma tela vazia. A alteração vale para a prévia de cada cena e do episódio completo; não modifica os arquivos originais nem a exportação.
• v1.57 (18/10/2026): cada imagem ou clipe da sequência visual pode ser renomeado: o lápis ao lado do nome abre um campo de texto (até 80 caracteres) onde o dono escreve o nome que quiser — “A primeira missa”, “Chegada da esquadra” etc. O nome é salvo no episódio (renomearMidia, protegido por requireDono) e passa a ser o nome do arquivo na hora de baixar o clipe. Deixando o campo vazio e salvando, volta a etiqueta original (crédito de origem). O crédito de fontes externas (Pexels, Wikimedia) continua guardado e continua aparecendo no roteiro, só deixa de ser a etiqueta exibida quando há nome próprio. Corrigido também o limite interno da ordem das mídias, que travava o salvar de cenas com mais de 8 itens (máximo real: 3 imagens + 10 clipes).
• v1.56 (17/10/2026): correção do local do download: cada clipe da sequência visual da cena tem seu próprio botão “Baixar”, ao lado das setas e antes da lixeira. Baixa o arquivo original, sem montar o episódio, acrescentar narração ou gastar créditos. Disponível também em cenas ainda bloqueadas. O botão colocado por engano em “Meus vídeos” foi removido; a exportação completa continua na tela do episódio. Em dispositivos de toque, o primeiro toque prepara o arquivo e o segundo permite salvá-lo.
• v1.55 (17/10/2026): botão “Baixar vídeo” (ícone ↓) em cada episódio da página “Meus vídeos”, ao lado das setas de subir/descer: gera e baixa o MP4 final do episódio direto do navegador (mesma montagem do botão “Exportar vídeo” da tela do episódio), mostrando a porcentagem no próprio botão durante a geração. Visível só para o dono logado; a montagem acontece no computador e pode levar alguns minutos.
• v1.54 (17/10/2026): botão “Baixar capa (thumbnail)” na tela do episódio: gera no navegador (sem custo de IA) uma capa 1280×720 a partir da primeira imagem da Cena 1, com degradê escuro, selo “Conhecer+Brasil”, período e título do episódio sobrepostos (src/lib/capa.ts, gerarCapaBlob). Serve como miniatura personalizada no YouTube Studio — o YouTube pega automaticamente o quadro da cartela na abertura, então a capa deve ser enviada à mão. Exige que a Cena 1 tenha imagem.
• v1.53 (17/10/2026): vinheta falada no meio do episódio exportado: entre as cenas do meio, a voz do canal diz “Você está no Conhecer+Brasil! Deixe seu like, inscreva-se no canal e ative o sininho…”, sobre a cartela com o texto “👍 Curta · ✅ Inscreva-se · 🔔 Ative o sininho” (áudio fixo em vinheta-cta.wav); o lembrete da primeira cena (v1.52) foi removido para não repetir. Na página “Meus vídeos”, o dono logado reordena os episódios com setas de subir/descer (moverEpisodio, protegido por requireDono, troca o campo ordem com o vizinho).
• v1.52 (16/10/2026): o vídeo exportado ganha um lembrete animado “👍 Curta o vídeo — Inscreva-se no canal e ative o sino 🔔”, exibido uma vez por 5 segundos no início da primeira cena (canto inferior direito), além da chamada que já aparece no encerramento sobre a cartela.
• v1.51 (06/10/2026): os contextos históricos (as 3 notas da cena e o contexto de cada mídia) ficam sempre dentro do contexto da CENA: aprofundam um detalhe do que a narração conta naquele momento (o povo, o lugar, o objeto ou o acontecimento citados), usando o episódio (título, período e sinopse) como moldura histórica; a mídia serve só de referência visual e a nota não descreve a mídia em si. Mantida a regra v1.50 de não repetir contexto já usado.
• v1.50 (06/10/2026): os contextos históricos deixam de se repetir: ao gerar as 3 notas da cena ou o contexto de uma mídia, a IA recebe a lista de todos os contextos já usados no episódio (mídias e cenas) e não pode repetir fato nem parafrasear; a resposta é conferida antes de salvar e, se vier repetida, o pedido é refeito uma vez exigindo dados totalmente diferentes.
• v1.49 (06/10/2026): o botão “Subir vídeo (PC)” passa a aceitar seleção múltipla: vários arquivos sobem em sequência num só envio, com contador “Subindo… X/Y”, respeitando o limite de 10 clipes por cena e informando erros por arquivo sem interromper os demais.
• v1.48 (06/10/2026): a imagem por IA passa a retratar sempre o INÍCIO da cena (primeiro quadro, guiado pelas primeiras frases da narração), servindo de quadro inicial no Kling. Novo botão “Gerar novamente (IA)”: troca a primeira imagem por outra versão no mesmo lugar da sequência e apaga o arquivo antigo (gerarImagem com substituir, protegido por requireDono).
• v1.47 (06/10/2026): nova seção “Kit de produção por episódio (imagem → Kling → estúdio)” (14), com o fluxo de tomadas curtas, o checklist do Kling e a preparação das cenas 4–6 do Episódio 2 (prompts de animação em inglês gravados no campo prompt do clipe das cenas). O Histórico de revisões passou a ser a seção 15.
• v1.46 (06/10/2026): correção da trava que impedia salvar cenas com mais de 5 clipes (o limite real passou a ser 10 em todas as validações). Nova seção “Divulgação nas redes sociais” na página do episódio: gera com IA chamada, legenda e hashtags para Facebook, Instagram, TikTok e Shorts, e guarda os links dos posts publicados (colunas facebook_url, instagram_url e tiktok_url em episodios, funções protegidas gerarTextoRedes e salvarLinksSociais). Os links aparecem como botões em “Meus vídeos”. Publicação segue manual (assistida), sem postagem automática.
• v1.45 (05/10/2026): cada cena aceita até 10 clipes para avaliação; a lixeira de um clipe agora também apaga o arquivo do armazenamento.
• v1.44 (01/10/2026): a divulgação nas outras redes virou uma seção própria, “Como criar e divulgar o canal nas outras redes” (13), com criação de páginas/perfis, cortes verticais e o que evitar; a divulgação paga (Google Ads) continua como etapa futura.
• v1.43 (01/10/2026): nova seção “Divulgação nas outras redes” (Facebook, X, Instagram, TikTok): criação de páginas/perfis, cortes verticais reaproveitados e o que evitar (spam).
• v1.42 (01/10/2026): página Agenda com publicações a cada 15 dias e lembretes no navegador; orientações de divulgação paga (Google Ads) registradas como etapa futura.
• v1.41 (01/10/2026): orientação de descrição do YouTube ajustada para a ordem validada no Episódio 1: chamada para o público nas primeiras linhas, depois a apresentação do tema e, por fim, as hashtags.
• v1.40 (30/09/2026): data de publicação dos episódios: preenchida automaticamente ao marcar como publicado ou ao salvar o link do YouTube, e editável à mão em “Meus vídeos” e na página do episódio. A data aparece na linha do tempo, na biblioteca e no cabeçalho do episódio; a linha do tempo também ganhou o atalho “Assistir no YouTube”. Técnico: coluna publicado_em em episodios e função protegida salvarDataPublicacao.
• v1.39 (30/09/2026): os botões de excluir e subir/descer mídias permanecem disponíveis em cenas posteriores bloqueadas; somente novas gerações, buscas e envios aguardam a cena anterior ser marcada pronta.
• v1.38 (30/09/2026): legendas automáticas por cena na prévia e na exportação, com opção de desligar; envio de som ambiente por cena, reprodução em loop e volume ajustável até 30%, mixado suavemente abaixo da narração.
• v1.37 (30/09/2026): a abertura agora mostra primeiro a vinheta animada de 3 s e depois a cartela panorâmica por 5 s, antes do título do episódio. Antes, a vinheta substituía a cartela, que podia não aparecer no vídeo exportado. O encerramento também passou para 5 s.
• v1.36 (30/09/2026): nova seção “Como subir para o YouTube”, com preparação do arquivo, preenchimento de título, descrição, miniatura e público, verificações, opções de visibilidade, publicação e gravação do link no estúdio.
• v1.35 (30/09/2026): mínimo de 3 contextos históricos por cena: campos “Contexto 1–3” e botão “Gerar 3 contextos (IA)”. Se as mídias tiverem menos de 3 contextos próprios, as notas da cena se alternam (começo, meio e fim da narração) na prévia, na exportação e no roteiro baixado; com 3 ou mais contextos por mídia, vale a nota de cada mídia. Campo contextos_cena nas cenas.
• v1.34 (30/09/2026): botão “🖨 Imprimir” no topo da documentação: abre a impressão do navegador com versão para papel (fundo claro, sem botões nem menus, seções inteiras por página).
• v1.30 (30/09/2026): o banner do canal (2048 × 1152) ficou guardado na página “Canal”, com botão para baixar; nova chamada para o público (curtir, inscrever-se e ativar o sino) copiável na mesma página e exibida sobre o encerramento dos vídeos exportados.
• v1.31 (30/09/2026): o banner baixado pelo botão da página “Canal” passou a ter 2048 × 1152 pixels de verdade — a versão anterior tinha 1920 × 1088 e o YouTube rejeitava no upload.
• v1.32 (30/09/2026): exportação deixa de parecer travada em 12%: os clipes passam a ser lidos em sequência (tocando) em vez de saltar quadro a quadro, o que era muito lento em vídeos MP4; o progresso mostra uma casa decimal. Técnico: avancar() em exportar-video.ts usa requestVideoFrameCallback e só faz seek em cortes/repetições. Mantenha a aba visível durante a exportação.
• v1.33 (30/09/2026): exportação continuava parada em 12%. Agora os clipes e a vinheta são decodificados direto do arquivo, quadro a quadro, sem usar o player do navegador (que ficava esperando quadros que não chegavam). Técnico: criarLeitor() usa mediabunny (VideoSampleSink.samples(), leitura sequencial com reinício só em repetição/corte); fontes de vídeo abstraídas em FonteVideo; o codec é verificado antes de carregar mídias; a barra de progresso atualiza a cada 250 ms; fila de áudio com contrapressão. Sem WebCodecs, cai na gravação em tempo real.
• v1.29 (30/09/2026): exportação deixa de ficar parada em 0%: o carregamento inicial agora mostra evolução, mídias têm limite de espera e clipes indisponíveis são ignorados em vez de bloquear todo o vídeo.
• v1.28 (30/09/2026): a página “Canal” passou a usar a nova logo quadrada oficial, derivada da identidade histórica aprovada, no lugar da antiga arte azul.
• v1.27 (30/09/2026): vinheta animada de 3 s (com som) abre todos os vídeos exportados; MP4 otimizado para YouTube (1080p30 H.264 High ~12 Mbps, AAC 48 kHz estéreo 384 kbps, quadro-chave a cada 0,5 s, faststart); pré-aquecimento dos clipes (primeiro quadro decodificado antes da exportação e próximo clipe preparado ~1 s antes da troca).
• v1.26 (30/09/2026): exportação MP4 refeita: o vídeo é montado quadro a quadro (30 fps exatos, H.264 + AAC via WebCodecs/mp4-muxer) com índice no início do arquivo (faststart). Não depende mais da aba ficar visível nem trava em players; navegadores sem WebCodecs usam a gravação em tempo real antiga.
• v1.25 (30/09/2026): nova cartela panorâmica Full HD, mais humana e histórica: linha do tempo visual das culturas originárias ao Brasil contemporâneo, mapa integrado, cores da bandeira e mensagem central do canal. A nova arte também passa a abrir e encerrar os vídeos exportados.
• v1.24 (30/09/2026): contexto histórico por mídia: cada imagem ou clipe pode ter uma nota própria, escrita manualmente ou gerada por IA. A prévia e a exportação mantêm a nota até aquela mídia terminar e a trocam junto com a próxima.
• v1.23 (29/09/2026): cada cena aceita até 3 imagens, vindas da IA, do computador ou de pinturas históricas. Imagens e clipes aparecem numa sequência visual única com setas, seguida pela prévia e pela exportação; episódios antigos continuam compatíveis.
• v1.22 (29/09/2026): botão “Copiar texto” em cada episódio da linha do tempo e na página do episódio: copia a sinopse para a área de transferência, pronta para colar no campo “Contexto de época”. Não consome créditos. O episódio 2 (O Descobrimento) voltou de “publicado” para “pronto”.
• v1.21 (29/09/2026): “Contexto de época” por cena: nota histórica curta (até 300 caracteres) criada junto com o roteiro ou pelo botão “Gerar contexto (IA)”, editável no editor, exibida como cartão no canto superior esquerdo na prévia e no vídeo exportado (entra aos 1,5 s da cena e dura até 7 s). Também sai no arquivo “Baixar roteiro”.
• v1.20 (29/09/2026): esclarecimento sobre geração múltipla de clipes: cada geração acrescenta um clipe novo (até 5 por cena), o mesmo prompt produz resultados diferentes a cada tentativa, e recusas do filtro de segurança não consomem créditos.
• v1.19 (29/09/2026): botão “Clipe só do texto (IA)”: gera o clipe apenas a partir do prompt do clipe (ou da descrição da imagem), sem enviar a imagem da cena — alternativa quando o filtro de segurança recusa a imagem.
• v1.18 (29/09/2026): campo “Prompt do clipe (opcional)” por cena: quando preenchido, “Animar imagem (IA)” usa exatamente esse texto (câmera, movimento, clima e áudio) em vez do movimento automático. Salvo ao sair do campo.
• v1.17 (29/09/2026): correção dos botões de download: “Baixar cartela” e “Baixar logo” (página Canal) e “Baixar imagem”/“Baixar áudio” (página do episódio) agora salvam o arquivo direto no computador, em vez de abrir a mídia em uma nova página.
• v1.16 (29/09/2026): página “Meus vídeos” para episódios prontos/publicados, abertura do YouTube Studio, gravação segura do link público e página “Canal” com logo, cartela panorâmica e descrição copiável.
• v1.15 (29/09/2026): setas de ordenação maiores e visíveis em cada clipe; prévia corrigida para reproduzir clipes e respeitar “usar apenas clipes”; exportação sempre inclui uma tela própria com o título do episódio.
• v1.14 (29/09/2026): vídeos exportados abrem com a cartela do canal Conhecer+Brasil (3 s, antes do título) e terminam com ela (4 s).
• v1.13 (28/09/2026): botão “Baixar roteiro” no topo do episódio: baixa um arquivo .txt com o roteiro completo (todas as cenas, texto da narração, descrições de imagem e o que já foi gerado). Não custa créditos.
• v1.12 (28/09/2026): envio de arquivos do próprio computador: “Subir imagem (PC)” usa uma foto/arte sua (JPG, PNG ou WebP, até 25 MB) como imagem da cena, e “Subir vídeo (PC)” adiciona um vídeo seu (MP4, WebM, MOV ou OGG, até 50 MB) como clipe etiquetado “Próprio (PC)”, que entra na exportação na ordem definida pelas setas ↑/↓.
• v1.1 (28/09/2026): acesso exclusivo do dono, correção do nome na prévia, documentação criada.
• v1.2 (28/09/2026): descrições de cena aceitas em português (tradução automática para inglês antes da imagem); aviso claro quando o filtro de segurança recusa uma imagem.
• v1.3 (28/09/2026): correção da tradução aplicada às imagens; geração em lote salva as edições antes de começar e identifica a cena recusada.
• v1.4 (28/09/2026): narração ajustada para um estilo documental mais natural, com menos ênfase e dramatização.
• v1.5 (28/09/2026): busca de pinturas históricas por cena no Wikimedia Commons, com autoria, data e link da obra.
• v1.6 (28/09/2026): geração sequencial; cada cena libera a seguinte após “Marcar pronta”, com opção de reiniciar suas mídias.
• v1.7 (28/09/2026): novo botão “Excluir imagem” na cena: remove a imagem (gerada ou pintura importada do acervo), limpa o crédito e apaga o arquivo guardado; narração e clipes são mantidos.
• v1.8 (28/09/2026): dicas de uso em todos os botões do editor (passar o mouse mostra o que cada um faz), incluindo o comportamento de “Animar imagem”: cria um clipe de ~8s em 720p a partir da imagem atual, que permanece inalterada; os clipes aparecem em “Clipes em movimento” e entram na exportação intercalados com as imagens.
• v1.9 (28/09/2026): mistura de vídeos reais e animados na mesma cena: cada clipe ganha etiqueta de origem (Animado (IA), Real (Pexels) ou Real (Wikimedia)) e botões ↑/↓ para definir a ordem de entrada no vídeo exportado; a ordem é gravada no episódio e a exportação a respeita, intercalando clipes reais e animados após a imagem da cena.
• v1.10 (28/09/2026): botão “Assistir prévia” em cada cena: toca somente aquela cena (imagem + narração atuais), sem a abertura e sem avançar para as cenas seguintes; o botão do topo continua tocando o episódio completo, com abertura.
• v1.11 (28/09/2026): opção “Usar apenas clipes nesta cena” (campo so_clipes): na exportação, os clipes se repetem durante toda a narração e a imagem estática não aparece. Sem a opção, os clipes tocam primeiro e a imagem completa o tempo restante. Na mesma versão, novos roteiros passaram a vir com a descrição da imagem em português (a tradução para inglês continua automática antes de gerar a imagem); roteiros antigos com descrição em inglês podem ser editados normalmente.
• v1.0: clipes em movimento, exportação, login, troca do nome para Conhecer+Brasil.

Não gostou de algo? Diga o que e por quê (ex.: “o roteiro está longo demais, quero 2 minutos”). Esta documentação e o estúdio são atualizados juntos a cada mudança.