Adding Metadata to MP4 Video

Adding a useful information to your video files - such as title, authors, the date of production, and some description - can be quite helpful to both yourself and your customers. This additional data - or metadata - can be used by media players to organize your many video files.

Project Metadata

Adding a new metadata field

Kdenlive ti permette di specificare le meta informazioni che dovrebbero essere aggiunte a un file esportato. Vai semplicemente in Menu ‣ File ‣ Impostazioni del progetto, poi seleziona la seconda scheda, chiamata Metadati.

Double-click any existing metadata entry to change it.

Click on to add a new metadata entry (see the list of possible and permissible tags below).

Per tua comodità, Kdenlive aggiunge automaticamente i seguenti quattro elementi a ciascun nuovo progetto:

• Titolo

• Autore: non funziona con i contenitori mp4, nessun problema invece con i mov; per gli mp4 puoi però utilizzare artista.

• Copyright

• Anno: da notare che questo elemento non funziona con i video esportati nei contenitori MP4 (quali mov e mp4), vedi sotto per i dettagli. Al suoi posto usa un elemento data. Questo elemento anno è in realtà piuttosto seccante: puoi cancellarlo, ma riapparirà automaticamente. Quindi puoi semplicemente… ignoralo, come del resto fa anche ffmpeg.

Ma ci sono altri elementi che puoi usare veramente con i contenitori MP4.

Contenitori MP4

Unfortunately, there are competing sets of metadata when working with MP4 containers. The older, standard MP4 set is rather limited in what additional metadata can be used. Then, there is Apple iTunes, and that brings in a lot of metadata, and even changes the allowed set from time to time. We will come back to this difference in a second.

Nota

Other container formats, such as Matroska (.mkv) or Audio Video Interleave (.avi), support yet other sets of metadata elements.

Le meta informazioni ffmpeg supportate dal contenitore MP4

But now for the real meat: here come the available metadata elements that ffmpeg supports.

Nota

You must use the ffmpeg metadata keys from the second column in the table below as the metadata keys in Kdenlive’s Project Metadata dialog.

Nota

ffmpeg supporta diversi elementi FFmpeg Metadata, a seconda del tipo di contenitore. Questo viene poi generalmente derivato dal suffisso (la parte finale) del nome del file del contenitore: in particolare mp4 e mov.

Elemento	ffmpeg Metadata Key	Descrizione (tipo di dato[1])	MOV	MP4	Etichetta
Titolo	title	Il titolo di questo video (stringa).	✔	✔	©nam
Anno	date	La data di produzione. Nota che la documentazione di ffmpeg è totalmente sbagliata qui: non c’è nessuna chiave chiamata year, ma solo data. (stringa)	✔	✔	©day
Copyright	copyright	Il copyright del tuo video. (stringa)	✔	✔	©cpy
Artista	artist	Il nome dell’artista (del video). Non utilizzare questo elemento per il compositore, perché per esso c’è un elemento dedicato, vedi più avanti. (stringa)	✔	✔	©ART
Artista dell’album	album_artist	Il nome dell’artista dell’album: potrebbe essere un artista ospite, oppure il principale. Questo elemento può anche essere saltato, o essere lo stesso dell’artista. (stringa)		✔	aART
Autore	autore	L’autore del video. (stringa)	✔		©aut
Compositore	composer	Il nome del compositore. (stringa)			©wrt
Album	album	Il titolo o il nome di questo album. (stringa)	✔		©alb
Descrizione	comment	Una descrizione (del contenuto) di questo video. Per una sinossi utilizza invece un elemento separato. (stringa)		✔	desc
Commento	comment	Un (breve) commento al video. Sarà probabilmente stato impostato dal pubblico, non al momento della produzione. (stringa)	✔		©des
Commento	comment	Come prima, ma codificato in un elemento separato. (stringa)	✔	✔	©cmt
Sintassi	synopsis	Una sinossi, una descrizione più lunga di questo video. (stringa)		✔	ldes
Genere	genre	Il genere al quale appartiene questo video. (stringa)	✔	✔	©gen
Make	make	(Stringa)	✔		©mak
Modello	model	(Stringa)	✔		©mod
Posizione	location	(Stringa)	✔		©xyz
Raggruppamento	grouping	Il nome di un gruppo al quale i video in qualche modo appartengono. In contrasto all’elemento album, il raggruppamento avviene all’interno (cioè sotto) al livello dell’album. (stringa)		✔	©grp
Spettacolo	show	Il nome dello spettacolo televisivo, se applicabile. (stringa)		✔	tvsh
Episodio	episode_id	Il nome o il numero dell’episodio, per visualizzarlo. Se necessario, utilizza l’elemento separato e opzionale numero dell’episodio per il corretto ordinamento. (stringa)		✔	tven
Episodio (ordinamento)	episode_sort	Questo elemento è solo per l’ordinamento, ma non viene mai visualizzato. Permette l’ordinamento numerico dei nomi degli episodi che sono stringhe, e non (necessariamente) numeri. L’intervallo valido è limitato solamente tra 0 e 255, quindi sembra non supportare tutte quelle telenovele infinite… (Int8)		✔	tves
Stagione	season_number	Il numero della stagione, solamente nell’intervallo che va da 0 a 255 (Int8).		✔	tvsn
Testi	lyrics	I testi facoltativi, per canticchiare malamente a lungo… (stringa)		✔	©lyr
Raccolta	compilation	Se è 1, allora questo file video fa parte di una compilation. Diversamente è 0 (Int8).		✔	cpil
Rete	network	(Stringa)		✔	tvnn
Tipo di supporto	media_type	(Int8)		✔	stik
Video HD	hd_video	(Int8)		✔	hdvd
Riproduzione senza intervallo	gapless_playback	(Int8)		✔	pgap
Strumento codificatore	encoder	Non disponibile per noi utenti, viene infatti impostato automaticamente da ffmpeg stesso; è impostato alla stringa della versione di libavformat.	✔		©swr
Strumento codificatore	encoding_tool	Non disponibile per noi utenti, viene infatti impostato automaticamente da ffmpeg stesso; è impostato alla stringa della versione di libavformat.		✔	©too

Note

• Non c’è modo di aggiungere la copertina ai contenitori MP4 con ffmpeg, e, di conseguenza, con Kdenlive. Puoi però ricorrere ad altri strumenti di etichettatura dei contenitore video, come ad esempio AtomicParsley.

• Kdenlive sfrutta ffmpeg per la codifica, quindi, se questo non supporta determinati atomi, non c’è modo di ottenerli nel file esportato tramite Kdenlive.

Letture ulteriori

The following references give some more background information on ffmpeg and metadata in .mov/.mp4 containers.

1. Innanzitutto, anzi, soprattutto, il codice sorgente di ffmpeg per riferimento, e in particolare quello di moveenc.c.

   1. mov_write_ilst_tag() è responsabile della scrittura delle etichette compatibili con iTunes per i contenitori .mp4.

   2. mov_write_udta_tag() scrive invece le etichette MPEG standard quando si utilizza un contenitore .mov.

2. How To: Create/Write ID3 tags using ffmpeg di Jon Hall. Questo articolo ha finalmente messo l’autore sulla strada giusta; fai tuttavia attenzione ad alcune chiavi ffmpeg errate nella tabella di Jon (come ad esempio TIT3, che l’autore pensa non sia corretta). Questo potrebbe essere dovuto a dei cambiamenti successivi in ffmpeg (o in qualsiasi altra cosa). Alla fine, dato che alcune delle chiavi di Jon non hanno funzionato, l’autore è andato a vedere il codice sorgente di ffmpeg: ovviamente è la fonte più autorevole. L’autore è tuttavia molto grato a Jon e a qualcuna delle rare fonti davvero buone e con una buona visione dell’argomento: la maggior parte ti dice solamente come premere alcuni pulsanti in qualche applicazione, ma non ti dà alcun indizio su quello che accade veramente dietro le quinte.

3. How To: Dump and Load metadata with ffmpeg by Jon Hall. Sheds more light on how to work with metadata when it comes to ffmpeg.

4. L’articolo metadata su MultimediaWiki.

Fonti

Il testo originale è stato inviato dall’utente TheDiveO all’ormai defunto blog kdenlive.org. Per questo la documentazione è stata estratta da kdenlive.org, aggiornata e adattata per corrispondere allo stile generale.

---

[1]

I tipi di dati sono (String)=stringa, (Int8)=intero (8-bit)