Adicionando metadados a um vídeo MP4

Adicionar informações úteis aos seus arquivos de vídeo - como título, autores, data de produção e uma breve descrição - pode ser muito útil tanto para você quanto para seus clientes. Esses dados adicionais - ou metadados - podem ser usados ​​por reprodutores de mídia para organizar seus diversos arquivos de vídeo.

Metadados do projeto

Adicionando um novo campo de metadado

O Kdenlive permite que você especifique as informações de metadados que devem ser adicionadas a um arquivo renderizado. Basta ir em Menu ‣ Arquivo ‣ Configurações do projeto, e selecionar a segunda aba chamada Metadados.

Clique duas vezes em qualquer entrada de metadados existente para alterá-la.

Clique em para adicionar uma nova entrada de metadados (consulte a lista de etiquetas possíveis e permitidas abaixo).

Para sua conveniência, o Kdenlive adiciona automaticamente os seguintes quatro elementos a cada novo projeto:

• Título

• Autor - não funciona para contêineres .mp4, mas funciona para contêineres .mov; você pode usar artista em vez disso com contêineres .mp4.

• Direitos autorais

• Ano - observe que este elemento não funciona para vídeos renderizados em contêineres MP4 (como .mov e .mp4). Veja abaixo para mais detalhes. Use um elemento de data em vez disso. Este elemento ano é bastante incômodo: você pode excluí-lo, mas ele reaparecerá automaticamente. Portanto, simplesmente ignore-o… como o ffmpeg também faz.

Mas existem outros elementos que você pode usar com seus contêineres MP4.

Contêineres MP4

Infelizmente, existem conjuntos de metadados conflitantes ao trabalhar com contêineres MP4. O conjunto MP4 padrão mais antigo é bastante limitado quanto aos metadados adicionais que podem ser usados. Além disso, existe o iTunes da Apple, que introduz uma grande quantidade de metadados e até mesmo altera o conjunto permitido de tempos em tempos. Voltaremos a essa diferença em breve.

Nota

Outros formatos de contêiner, como Matroska (.mkv) ou Audio Video Interleave (.avi), suportam ainda outros conjuntos de elementos de metadados.

Informações de metadados do contêiner MP4 compatíveis com o Ffmpeg

Mas agora vamos ao que interessa: aqui estão os elementos de metadados disponíveis que o ffmpeg suporta.

Nota

Você deve usar as chaves de metadados ffmpeg da segunda coluna da tabela abaixo como chaves de metadados na janela de metadados do projeto do Kdenlive.

Nota

O ffmpeg suporta diferentes elementos FFmpeg Metadata, com base no tipo de contêiner. E esse tipo de contêiner normalmente é derivado do sufixo do nome do arquivo contêiner: em particular, .mp4 e .mov.

Elemento	Chave de metadado do ffmpeg	Descrição (tipo de dado [1])	MOV	MP4	Etiqueta
Título	title	Título deste vídeo. (String)	✔	✔	©nam
Ano	date	Data de produção. Observe que a documentação do ffmpeg está totalmente incorreta neste ponto; não existe uma chave chamada “year”, apenas “date”. (String)	✔	✔	©day
Direitos autorais	copyright	Os direitos autorais do seu vídeo. (String)	✔	✔	©cpy
Artista	artist	O nome do artista (do vídeo). Por favor, não use este elemento para o compositor, pois existe um elemento dedicado especificamente para ele, veja abaixo. (String)	✔	✔	©ART
Artista do álbum	album_artist	O nome do artista do álbum: pode ser um artista convidado ou um artista em destaque. Este elemento também pode ser omitido ou ser o mesmo nome do artista. (String)		✔	aART
Autor	author	O autor do vídeo. (String)	✔		©aut
Compositor	composer	O nome do compositor. (String)			©wrt
Álbum	album	O título ou o nome deste álbum. (String)	✔		©alb
Descrição	comment	Descrição (de conteúdo) deste vídeo. Para uma sinopse, consulte o elemento específico para isso. (String)		✔	desc
Comentário	comment	Um comentário (curto) sobre o seu vídeo. Este comentário provavelmente será definido pelo público, não no momento da produção. (String)	✔		©des
Comentário	comment	Igual ao anterior, mas codificado em um elemento separado. (String)	✔	✔	©cmt
Sinopse	synopsis	Uma sinopse, uma descrição mais longa deste vídeo. (String)		✔	ldes
Gênero	genre	O gênero a que este vídeo pertence. (String)	✔	✔	©gen
Marca	make	(String)	✔		©mak
Modelo	model	(String)	✔		©mod
Localização	location	(String)	✔		©xyz
Agrupamento	grouping	O nome de um grupo de vídeos que, de alguma forma, pertencem ao mesmo conjunto. Ao contrário do elemento álbum, o agrupamento ocorre dentro (ou seja, abaixo) do nível do álbum. (String)		✔	©grp
Programa	show	O nome do programa de TV, se aplicável. (String)		✔	tvsh
Episódio	episode_id	O nome ou o número do episódio, para exibição. Se necessário, utilize o elemento separado, porém opcional, do número do episódio para a ordenação correta. (String)		✔	tven
Episódio (Ordenação)	episode_sort	Este elemento serve apenas para ordenação, mas nunca é exibido. Permite a ordenação numérica de nomes de episódios que são strings, mas não (necessariamente) números. O intervalo válido é limitado a 0 a 255, portanto, aparentemente, não é compatível com todas aquelas telenovelas intermináveis… (Int8)		✔	tves
Temporada	season_number	O número da temporada, no intervalo de 0 a 255 apenas. (Int8)		✔	tvsn
Letra	lyrics	Letra opcional para cantar junto de forma desajeitada… (String)		✔	©lyr
Compilação	compilation	Se 1, então este arquivo de vídeo faz parte de uma compilação. 0 caso contrário. (Int8)		✔	cpil
Rede	network	(String)		✔	tvnn
Tipo de mídia	media_type	(Int8)		✔	stik
Vídeo HD	hd_video	(Int8)		✔	hdvd
Reprodução contínua	gapless_playback	(Int8)		✔	pgap
Ferramenta de codificação	encoder	Não está disponível para nós, usuários, pois é definida automaticamente pelo próprio ffmpeg; este valor é definido com base na string de versão do libavformat.	✔		©swr
Ferramenta de codificação	encoding_tool	Não está disponível para nós, usuários, pois é definida automaticamente pelo próprio ffmpeg; este valor é definido com base na string de versão do libavformat.		✔	©too

Notas

• Não é possível adicionar capas de vídeo ou imagens de DVD a contêineres MP4 usando o ffmpeg e, consequentemente, no Kdenlive. Em vez disso, você precisa recorrer a outras ferramentas de marcação de contêineres de vídeo, como o AtomicParsley.

• O Kdenlive utiliza o ffmpeg para codificação, portanto, se o ffmpeg não suportar determinados átomos, não haverá maneira de o Kdenlive incluí-los no arquivo de saída renderizado.

Leitura complementar

As referências a seguir fornecem mais informações básicas sobre o ffmpeg e os metadados em contêineres .mov/.mp4.

1. Em primeiro lugar, e acima de tudo, o código-fonte do ffmpeg para referência, e o moveenc.c em particular.

   1. A função mov_write_ilst_tag() é responsável por escrever as etiquetas compatíveis com o iTunes para contêineres .mp4.

   2. A função mov_write_udta_tag() grava as etiquetas padrão MPEG ao usar um contêiner .mov.

2. How To: Create/Write ID3 tags using ffmpeg por Jon Hall. Este artigo finalmente colocou o autor no caminho certo. No entanto, cuidado com algumas chaves incorretas do ffmpeg na tabela de Jon (como a chave TIT3, que o autor considera incorreta); isso pode ser devido a alterações posteriores no ffmpeg (ou algo do tipo). No final, como algumas das chaves de Jon não funcionaram, o autor optou pelo código-fonte do ffmpeg, que é a fonte oficial, obviamente. Mesmo assim, o autor é muito grato a Jon, que é uma das raras fontes realmente boas com um bom conhecimento sobre o assunto. A maioria das outras fontes apenas ensina como pressionar alguns botões em algum aplicativo, mas não dá nenhuma pista sobre o que realmente acontece nos bastidores.

3. How To: Dump and Load metadata with ffmpeg por Jon Hall. Explica melhor como trabalhar com metadados no ffmpeg.

4. Artigo metadata da MultimediaWiki.

Fontes

O texto original foi enviado pelo usuário TheDiveO para o blog kdenlive.org, agora extinto. Para esta documentação, ele foi extraído do kdenlive.org, atualizado e adaptado para corresponder ao estilo geral.

---

[1]

Os tipos de dados são (String)=string, (Int8)=inteiro (8 bits)