2 * MP3 muxer and demuxer
3 * Copyright (c) 2003 Fabrice Bellard
5 * This file is part of FFmpeg.
7 * FFmpeg is free software; you can redistribute it and/or
8 * modify it under the terms of the GNU Lesser General Public
9 * License as published by the Free Software Foundation; either
10 * version 2.1 of the License, or (at your option) any later version.
12 * FFmpeg is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
15 * Lesser General Public License for more details.
17 * You should have received a copy of the GNU Lesser General Public
18 * License along with FFmpeg; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
23 #include "libavutil/avstring.h"
24 #include "libavcodec/mpegaudio.h"
25 #include "libavcodec/mpegaudiodecheader.h"
29 #define ID3v1_TAG_SIZE 128
31 #define ID3v1_GENRE_MAX 125
33 static const char * const id3v1_genre_str[ID3v1_GENRE_MAX + 1] = {
67 [33] = "Instrumental",
80 [46] = "Instrumental Pop",
81 [47] = "Instrumental Rock",
85 [51] = "Techno-Industrial",
90 [56] = "Southern Rock",
95 [61] = "Christian Rap",
98 [64] = "Native American",
101 [67] = "Psychadelic",
112 [78] = "Rock & Roll",
116 [82] = "National Folk",
118 [84] = "Fast Fusion",
125 [91] = "Gothic Rock",
126 [92] = "Progressive Rock",
127 [93] = "Psychedelic Rock",
128 [94] = "Symphonic Rock",
132 [98] = "Easy Listening",
138 [104] = "Chamber Music",
141 [107] = "Booty Bass",
143 [109] = "Porn Groove",
151 [117] = "Power Ballad",
152 [118] = "Rhythmic Soul",
158 [124] = "Euro-House",
159 [125] = "Dance Hall",
162 static unsigned int id3v2_get_size(ByteIOContext *s, int len)
166 v= (v<<7) + (get_byte(s)&0x7F);
170 static void id3v2_read_ttag(AVFormatContext *s, int taglen, const char *key)
173 int len, dstlen = sizeof(dst) - 1;
180 taglen--; /* account for encoding type byte */
182 switch(get_byte(s->pb)) { /* encoding type */
184 case 0: /* ISO-8859-1 (0 - 255 maps directly into unicode) */
188 PUT_UTF8(get_byte(s->pb), tmp, if (q - dst < dstlen - 1) *q++ = tmp;)
194 len = FFMIN(taglen, dstlen-1);
195 get_buffer(s->pb, dst, len);
200 if (!strcmp(key, "genre")
201 && sscanf(dst, "(%d)", &genre) == 1 && genre <= ID3v1_GENRE_MAX)
202 av_strlcpy(dst, id3v1_genre_str[genre], sizeof(dst));
205 av_metadata_set(&s->metadata, key, dst);
211 * Handles ID3v2.2, 2.3 and 2.4.
215 static void id3v2_parse(AVFormatContext *s, int len, uint8_t version, uint8_t flags)
226 reason = "compression";
245 reason = "unsynchronization";
249 if(isv34 && flags & 0x40) /* Extended header present, just skip over it */
250 url_fskip(s->pb, id3v2_get_size(s->pb, 4));
252 while(len >= taghdrlen) {
254 tag = get_be32(s->pb);
255 tlen = id3v2_get_size(s->pb, 4);
256 get_be16(s->pb); /* flags */
258 tag = get_be24(s->pb);
259 tlen = id3v2_get_size(s->pb, 3);
261 len -= taghdrlen + tlen;
266 next = url_ftell(s->pb) + tlen;
269 case MKBETAG('T', 'I', 'T', '2'):
270 case MKBETAG(0, 'T', 'T', '2'):
271 id3v2_read_ttag(s, tlen, "title");
273 case MKBETAG('T', 'P', 'E', '1'):
274 case MKBETAG(0, 'T', 'P', '1'):
275 id3v2_read_ttag(s, tlen, "author");
277 case MKBETAG('T', 'A', 'L', 'B'):
278 case MKBETAG(0, 'T', 'A', 'L'):
279 id3v2_read_ttag(s, tlen, "album");
281 case MKBETAG('T', 'C', 'O', 'N'):
282 case MKBETAG(0, 'T', 'C', 'O'):
283 id3v2_read_ttag(s, tlen, "genre");
285 case MKBETAG('T', 'C', 'O', 'P'):
286 case MKBETAG(0, 'T', 'C', 'R'):
287 id3v2_read_ttag(s, tlen, "copyright");
289 case MKBETAG('T', 'R', 'C', 'K'):
290 case MKBETAG(0, 'T', 'R', 'K'):
291 id3v2_read_ttag(s, tlen, "track");
294 /* padding, skip to end */
295 url_fskip(s->pb, len);
299 /* Skip to end of tag */
300 url_fseek(s->pb, next, SEEK_SET);
303 if(version == 4 && flags & 0x10) /* Footer preset, always 10 bytes, skip over it */
304 url_fskip(s->pb, 10);
308 av_log(s, AV_LOG_INFO, "ID3v2.%d tag skipped, cannot handle %s\n", version, reason);
309 url_fskip(s->pb, len);
312 static void id3v1_get_string(AVFormatContext *s, const char *key,
313 const uint8_t *buf, int buf_size)
319 for(i = 0; i < buf_size; i++) {
323 if ((q - str) >= sizeof(str) - 1)
330 av_metadata_set(&s->metadata, key, str);
333 /* 'buf' must be ID3v1_TAG_SIZE byte long */
334 static int id3v1_parse_tag(AVFormatContext *s, const uint8_t *buf)
339 if (!(buf[0] == 'T' &&
343 id3v1_get_string(s, "title", buf + 3, 30);
344 id3v1_get_string(s, "author", buf + 33, 30);
345 id3v1_get_string(s, "album", buf + 63, 30);
346 id3v1_get_string(s, "year", buf + 93, 4);
347 id3v1_get_string(s, "comment", buf + 97, 30);
348 if (buf[125] == 0 && buf[126] != 0) {
349 snprintf(str, sizeof(str), "%d", buf[126]);
350 av_metadata_set(&s->metadata, "track", str);
353 if (genre <= ID3v1_GENRE_MAX)
354 av_metadata_set(&s->metadata, "genre", id3v1_genre_str[genre]);
360 static int mp3_read_probe(AVProbeData *p)
362 int max_frames, first_frames = 0;
363 int fsize, frames, sample_rate;
365 uint8_t *buf, *buf0, *buf2, *end;
366 AVCodecContext avctx;
369 if(ff_id3v2_match(buf0)) {
370 buf0 += ff_id3v2_tag_len(buf0);
375 end = p->buf + p->buf_size - sizeof(uint32_t);
377 for(; buf < end; buf= buf2+1) {
380 for(frames = 0; buf2 < end; frames++) {
381 header = AV_RB32(buf2);
382 fsize = ff_mpa_decode_header(&avctx, header, &sample_rate, &sample_rate, &sample_rate, &sample_rate);
387 max_frames = FFMAX(max_frames, frames);
389 first_frames= frames;
391 if (first_frames>=3) return AVPROBE_SCORE_MAX/2+1;
392 else if(max_frames>500)return AVPROBE_SCORE_MAX/2;
393 else if(max_frames>=3) return AVPROBE_SCORE_MAX/4;
394 else if(buf0!=p->buf) return AVPROBE_SCORE_MAX/4-1;
395 else if(max_frames>=1) return 1;
400 * Try to find Xing/Info/VBRI tags and compute duration from info therein
402 static int mp3_parse_vbr_tags(AVFormatContext *s, AVStream *st, int64_t base)
405 int frames = -1; /* Total number of frames in file */
406 const int64_t xing_offtbl[2][2] = {{32, 17}, {17,9}};
411 if(ff_mpa_check_header(v) < 0)
414 if (ff_mpegaudio_decode_header(&c, v) == 0)
415 vbrtag_size = c.frame_size;
419 /* Check for Xing / Info tag */
420 url_fseek(s->pb, xing_offtbl[c.lsf == 1][c.nb_channels == 1], SEEK_CUR);
422 if(v == MKBETAG('X', 'i', 'n', 'g') || v == MKBETAG('I', 'n', 'f', 'o')) {
425 frames = get_be32(s->pb);
428 /* Check for VBRI tag (always 32 bytes after end of mpegaudio header) */
429 url_fseek(s->pb, base + 4 + 32, SEEK_SET);
431 if(v == MKBETAG('V', 'B', 'R', 'I')) {
432 /* Check tag version */
433 if(get_be16(s->pb) == 1) {
434 /* skip delay, quality and total bytes */
435 url_fseek(s->pb, 8, SEEK_CUR);
436 frames = get_be32(s->pb);
443 /* Skip the vbr tag frame */
444 url_fseek(s->pb, base + vbrtag_size, SEEK_SET);
446 spf = c.lsf ? 576 : 1152; /* Samples per frame, layer 3 */
447 st->duration = av_rescale_q(frames, (AVRational){spf, c.sample_rate},
452 static int mp3_read_header(AVFormatContext *s,
453 AVFormatParameters *ap)
456 uint8_t buf[ID3v1_TAG_SIZE];
457 int len, ret, filesize;
460 st = av_new_stream(s, 0);
462 return AVERROR(ENOMEM);
464 st->codec->codec_type = CODEC_TYPE_AUDIO;
465 st->codec->codec_id = CODEC_ID_MP3;
466 st->need_parsing = AVSTREAM_PARSE_FULL;
469 /* try to get the TAG */
470 if (!url_is_streamed(s->pb)) {
471 /* XXX: change that */
472 filesize = url_fsize(s->pb);
473 if (filesize > 128) {
474 url_fseek(s->pb, filesize - 128, SEEK_SET);
475 ret = get_buffer(s->pb, buf, ID3v1_TAG_SIZE);
476 if (ret == ID3v1_TAG_SIZE) {
477 id3v1_parse_tag(s, buf);
479 url_fseek(s->pb, 0, SEEK_SET);
483 /* if ID3v2 header found, skip it */
484 ret = get_buffer(s->pb, buf, ID3v2_HEADER_SIZE);
485 if (ret != ID3v2_HEADER_SIZE)
487 if (ff_id3v2_match(buf)) {
488 /* parse ID3v2 header */
489 len = ((buf[6] & 0x7f) << 21) |
490 ((buf[7] & 0x7f) << 14) |
491 ((buf[8] & 0x7f) << 7) |
493 id3v2_parse(s, len, buf[3], buf[5]);
495 url_fseek(s->pb, 0, SEEK_SET);
498 off = url_ftell(s->pb);
499 if (mp3_parse_vbr_tags(s, st, off) < 0)
500 url_fseek(s->pb, off, SEEK_SET);
502 /* the parameters will be extracted from the compressed bitstream */
506 #define MP3_PACKET_SIZE 1024
508 static int mp3_read_packet(AVFormatContext *s, AVPacket *pkt)
511 // AVStream *st = s->streams[0];
513 size= MP3_PACKET_SIZE;
515 ret= av_get_packet(s->pb, pkt, size);
517 pkt->stream_index = 0;
521 /* note: we need to modify the packet size here to handle the last
527 #if CONFIG_MP2_MUXER || CONFIG_MP3_MUXER
528 static int id3v1_set_string(AVFormatContext *s, const char *key,
529 uint8_t *buf, int buf_size)
532 if ((tag = av_metadata_get(s->metadata, key, NULL, 0)))
533 strncpy(buf, tag->value, buf_size);
537 static int id3v1_create_tag(AVFormatContext *s, uint8_t *buf)
542 memset(buf, 0, ID3v1_TAG_SIZE); /* fail safe */
546 count += id3v1_set_string(s, "title", buf + 3, 30);
547 count += id3v1_set_string(s, "author", buf + 33, 30);
548 count += id3v1_set_string(s, "album", buf + 63, 30);
549 count += id3v1_set_string(s, "year", buf + 93, 4);
550 count += id3v1_set_string(s, "comment", buf + 97, 30);
551 if ((tag = av_metadata_get(s->metadata, "track", NULL, 0))) {
553 buf[126] = atoi(tag->value);
556 if ((tag = av_metadata_get(s->metadata, "genre", NULL, 0))) {
557 for(i = 0; i <= ID3v1_GENRE_MAX; i++) {
558 if (!strcasecmp(tag->value, id3v1_genre_str[i])) {
570 static void id3v2_put_size(AVFormatContext *s, int size)
572 put_byte(s->pb, size >> 21 & 0x7f);
573 put_byte(s->pb, size >> 14 & 0x7f);
574 put_byte(s->pb, size >> 7 & 0x7f);
575 put_byte(s->pb, size & 0x7f);
578 static void id3v2_put_ttag(AVFormatContext *s, const char *string, uint32_t tag)
580 int len = strlen(string);
581 put_be32(s->pb, tag);
582 id3v2_put_size(s, len + 1);
584 put_byte(s->pb, 3); /* UTF-8 */
585 put_buffer(s->pb, string, len);
590 * Write an ID3v2.4 header at beginning of stream
593 static int mp3_write_header(struct AVFormatContext *s)
595 AVMetadataTag *title, *author, *album, *genre, *copyright, *track, *year;
598 title = av_metadata_get(s->metadata, "title", NULL, 0);
599 author = av_metadata_get(s->metadata, "author", NULL, 0);
600 album = av_metadata_get(s->metadata, "album", NULL, 0);
601 genre = av_metadata_get(s->metadata, "genre", NULL, 0);
602 copyright = av_metadata_get(s->metadata, "copyright", NULL, 0);
603 track = av_metadata_get(s->metadata, "track", NULL, 0);
604 year = av_metadata_get(s->metadata, "year", NULL, 0);
606 if(title) totlen += 11 + strlen(title->value);
607 if(author) totlen += 11 + strlen(author->value);
608 if(album) totlen += 11 + strlen(album->value);
609 if(genre) totlen += 11 + strlen(genre->value);
610 if(copyright) totlen += 11 + strlen(copyright->value);
611 if(track) totlen += 11 + strlen(track->value);
612 if(year) totlen += 11 + strlen(year->value);
613 if(!(s->streams[0]->codec->flags & CODEC_FLAG_BITEXACT))
614 totlen += strlen(LIBAVFORMAT_IDENT) + 11;
619 put_be32(s->pb, MKBETAG('I', 'D', '3', 0x04)); /* ID3v2.4 */
621 put_byte(s->pb, 0); /* flags */
623 id3v2_put_size(s, totlen);
625 if(title) id3v2_put_ttag(s, title->value, MKBETAG('T', 'I', 'T', '2'));
626 if(author) id3v2_put_ttag(s, author->value, MKBETAG('T', 'P', 'E', '1'));
627 if(album) id3v2_put_ttag(s, album->value, MKBETAG('T', 'A', 'L', 'B'));
628 if(genre) id3v2_put_ttag(s, genre->value, MKBETAG('T', 'C', 'O', 'N'));
629 if(copyright) id3v2_put_ttag(s, copyright->value, MKBETAG('T', 'C', 'O', 'P'));
630 if(track) id3v2_put_ttag(s, track->value, MKBETAG('T', 'R', 'C', 'K'));
631 if(year) id3v2_put_ttag(s, year->value, MKBETAG('T', 'Y', 'E', 'R'));
632 if(!(s->streams[0]->codec->flags & CODEC_FLAG_BITEXACT))
633 id3v2_put_ttag(s, LIBAVFORMAT_IDENT, MKBETAG('T', 'E', 'N', 'C'));
637 static int mp3_write_packet(struct AVFormatContext *s, AVPacket *pkt)
639 put_buffer(s->pb, pkt->data, pkt->size);
640 put_flush_packet(s->pb);
644 static int mp3_write_trailer(struct AVFormatContext *s)
646 uint8_t buf[ID3v1_TAG_SIZE];
648 /* write the id3v1 tag */
649 if (id3v1_create_tag(s, buf) > 0) {
650 put_buffer(s->pb, buf, ID3v1_TAG_SIZE);
651 put_flush_packet(s->pb);
655 #endif /* CONFIG_MP2_MUXER || CONFIG_MP3_MUXER */
657 #if CONFIG_MP3_DEMUXER
658 AVInputFormat mp3_demuxer = {
660 NULL_IF_CONFIG_SMALL("MPEG audio"),
665 .flags= AVFMT_GENERIC_INDEX,
666 .extensions = "mp2,mp3,m2a", /* XXX: use probe */
670 AVOutputFormat mp2_muxer = {
672 NULL_IF_CONFIG_SMALL("MPEG audio layer 2"),
684 AVOutputFormat mp3_muxer = {
686 NULL_IF_CONFIG_SMALL("MPEG audio layer 3"),