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
22 #include "libavutil/avstring.h"
23 #include "libavcodec/mpegaudio.h"
24 #include "libavcodec/mpegaudiodecheader.h"
27 #define ID3v2_HEADER_SIZE 10
28 #define ID3v1_TAG_SIZE 128
30 #define ID3v1_GENRE_MAX 125
32 static const char *id3v1_genre_str
[ID3v1_GENRE_MAX
+ 1] = {
66 [33] = "Instrumental",
79 [46] = "Instrumental Pop",
80 [47] = "Instrumental Rock",
84 [51] = "Techno-Industrial",
89 [56] = "Southern Rock",
94 [61] = "Christian Rap",
97 [64] = "Native American",
100 [67] = "Psychadelic",
111 [78] = "Rock & Roll",
115 [82] = "National Folk",
117 [84] = "Fast Fusion",
124 [91] = "Gothic Rock",
125 [92] = "Progressive Rock",
126 [93] = "Psychedelic Rock",
127 [94] = "Symphonic Rock",
131 [98] = "Easy Listening",
137 [104] = "Chamber Music",
140 [107] = "Booty Bass",
142 [109] = "Porn Groove",
150 [117] = "Power Ballad",
151 [118] = "Rhythmic Soul",
157 [124] = "Euro-House",
158 [125] = "Dance Hall",
161 /* buf must be ID3v2_HEADER_SIZE byte long */
162 static int id3v2_match(const uint8_t *buf
)
164 return buf
[0] == 'I' &&
169 (buf
[6] & 0x80) == 0 &&
170 (buf
[7] & 0x80) == 0 &&
171 (buf
[8] & 0x80) == 0 &&
172 (buf
[9] & 0x80) == 0;
175 static unsigned int id3v2_get_size(ByteIOContext
*s
, int len
)
179 v
= (v
<<7) + (get_byte(s
)&0x7F);
183 static void id3v2_read_ttag(AVFormatContext
*s
, int taglen
, char *dst
, int dstlen
)
191 taglen
--; /* account for encoding type byte */
192 dstlen
--; /* Leave space for zero terminator */
194 switch(get_byte(s
->pb
)) { /* encoding type */
196 case 0: /* ISO-8859-1 (0 - 255 maps directly into unicode) */
200 PUT_UTF8(get_byte(s
->pb
), tmp
, if (q
- dst
< dstlen
- 1) *q
++ = tmp
;)
206 len
= FFMIN(taglen
, dstlen
);
207 get_buffer(s
->pb
, dst
, len
);
216 * Handles ID3v2.2, 2.3 and 2.4.
220 static void id3v2_parse(AVFormatContext
*s
, int len
, uint8_t version
, uint8_t flags
)
232 reason
= "compression";
251 reason
= "unsynchronization";
255 if(isv34
&& flags
& 0x40) /* Extended header present, just skip over it */
256 url_fskip(s
->pb
, id3v2_get_size(s
->pb
, 4));
258 while(len
>= taghdrlen
) {
260 tag
= get_be32(s
->pb
);
261 tlen
= id3v2_get_size(s
->pb
, 4);
262 get_be16(s
->pb
); /* flags */
264 tag
= get_be24(s
->pb
);
265 tlen
= id3v2_get_size(s
->pb
, 3);
267 len
-= taghdrlen
+ tlen
;
272 next
= url_ftell(s
->pb
) + tlen
;
275 case MKBETAG('T', 'I', 'T', '2'):
276 case MKBETAG(0, 'T', 'T', '2'):
277 id3v2_read_ttag(s
, tlen
, s
->title
, sizeof(s
->title
));
279 case MKBETAG('T', 'P', 'E', '1'):
280 case MKBETAG(0, 'T', 'P', '1'):
281 id3v2_read_ttag(s
, tlen
, s
->author
, sizeof(s
->author
));
283 case MKBETAG('T', 'A', 'L', 'B'):
284 case MKBETAG(0, 'T', 'A', 'L'):
285 id3v2_read_ttag(s
, tlen
, s
->album
, sizeof(s
->album
));
287 case MKBETAG('T', 'C', 'O', 'N'):
288 case MKBETAG(0, 'T', 'C', 'O'):
289 id3v2_read_ttag(s
, tlen
, s
->genre
, sizeof(s
->genre
));
291 case MKBETAG('T', 'C', 'O', 'P'):
292 case MKBETAG(0, 'T', 'C', 'R'):
293 id3v2_read_ttag(s
, tlen
, s
->copyright
, sizeof(s
->copyright
));
295 case MKBETAG('T', 'R', 'C', 'K'):
296 case MKBETAG(0, 'T', 'R', 'K'):
297 id3v2_read_ttag(s
, tlen
, tmp
, sizeof(tmp
));
298 s
->track
= atoi(tmp
);
301 /* padding, skip to end */
302 url_fskip(s
->pb
, len
);
306 /* Skip to end of tag */
307 url_fseek(s
->pb
, next
, SEEK_SET
);
310 if(version
== 4 && flags
& 0x10) /* Footer preset, always 10 bytes, skip over it */
311 url_fskip(s
->pb
, 10);
315 av_log(s
, AV_LOG_INFO
, "ID3v2.%d tag skipped, cannot handle %s\n", version
, reason
);
316 url_fskip(s
->pb
, len
);
319 static void id3v1_get_string(char *str
, int str_size
,
320 const uint8_t *buf
, int buf_size
)
326 for(i
= 0; i
< buf_size
; i
++) {
330 if ((q
- str
) >= str_size
- 1)
337 /* 'buf' must be ID3v1_TAG_SIZE byte long */
338 static int id3v1_parse_tag(AVFormatContext
*s
, const uint8_t *buf
)
343 if (!(buf
[0] == 'T' &&
347 id3v1_get_string(s
->title
, sizeof(s
->title
), buf
+ 3, 30);
348 id3v1_get_string(s
->author
, sizeof(s
->author
), buf
+ 33, 30);
349 id3v1_get_string(s
->album
, sizeof(s
->album
), buf
+ 63, 30);
350 id3v1_get_string(str
, sizeof(str
), buf
+ 93, 4);
352 id3v1_get_string(s
->comment
, sizeof(s
->comment
), buf
+ 97, 30);
353 if (buf
[125] == 0 && buf
[126] != 0)
356 if (genre
<= ID3v1_GENRE_MAX
)
357 av_strlcpy(s
->genre
, id3v1_genre_str
[genre
], sizeof(s
->genre
));
361 static void id3v1_create_tag(AVFormatContext
*s
, uint8_t *buf
)
365 memset(buf
, 0, ID3v1_TAG_SIZE
); /* fail safe */
369 strncpy(buf
+ 3, s
->title
, 30);
370 strncpy(buf
+ 33, s
->author
, 30);
371 strncpy(buf
+ 63, s
->album
, 30);
374 for(i
= 0;i
< 4; i
++) {
375 buf
[96 - i
] = '0' + (v
% 10);
379 strncpy(buf
+ 97, s
->comment
, 30);
384 for(i
= 0; i
<= ID3v1_GENRE_MAX
; i
++) {
385 if (!strcasecmp(s
->genre
, id3v1_genre_str
[i
])) {
394 static int mp3_read_probe(AVProbeData
*p
)
396 int max_frames
, first_frames
= 0;
397 int fsize
, frames
, sample_rate
;
399 uint8_t *buf
, *buf2
, *end
;
400 AVCodecContext avctx
;
402 if(id3v2_match(p
->buf
))
403 return AVPROBE_SCORE_MAX
/2+1; // this must be less than mpeg-ps because some retards put id3v2 tags before mpeg-ps files
407 end
= buf
+ p
->buf_size
- sizeof(uint32_t);
409 for(; buf
< end
; buf
= buf2
+1) {
412 for(frames
= 0; buf2
< end
; frames
++) {
413 header
= AV_RB32(buf2
);
414 fsize
= ff_mpa_decode_header(&avctx
, header
, &sample_rate
);
419 max_frames
= FFMAX(max_frames
, frames
);
421 first_frames
= frames
;
423 if (first_frames
>=3) return AVPROBE_SCORE_MAX
/2+1;
424 else if(max_frames
>500)return AVPROBE_SCORE_MAX
/2;
425 else if(max_frames
>=3) return AVPROBE_SCORE_MAX
/4;
426 else if(max_frames
>=1) return 1;
431 * Try to find Xing/Info/VBRI tags and compute duration from info therein
433 static void mp3_parse_vbr_tags(AVFormatContext
*s
, AVStream
*st
, offset_t base
)
436 int frames
= -1; /* Total number of frames in file */
437 const offset_t xing_offtbl
[2][2] = {{32, 17}, {17,9}};
441 if(ff_mpa_check_header(v
) < 0)
444 ff_mpegaudio_decode_header(&c
, v
);
448 /* Check for Xing / Info tag */
449 url_fseek(s
->pb
, xing_offtbl
[c
.lsf
== 1][c
.nb_channels
== 1], SEEK_CUR
);
451 if(v
== MKBETAG('X', 'i', 'n', 'g') || v
== MKBETAG('I', 'n', 'f', 'o')) {
454 frames
= get_be32(s
->pb
);
457 /* Check for VBRI tag (always 32 bytes after end of mpegaudio header) */
458 url_fseek(s
->pb
, base
+ 4 + 32, SEEK_SET
);
460 if(v
== MKBETAG('V', 'B', 'R', 'I')) {
461 /* Check tag version */
462 if(get_be16(s
->pb
) == 1) {
463 /* skip delay, quality and total bytes */
464 url_fseek(s
->pb
, 8, SEEK_CUR
);
465 frames
= get_be32(s
->pb
);
472 spf
= c
.lsf
? 576 : 1152; /* Samples per frame, layer 3 */
473 st
->duration
= av_rescale_q(frames
, (AVRational
){spf
, c
.sample_rate
},
477 static int mp3_read_header(AVFormatContext
*s
,
478 AVFormatParameters
*ap
)
481 uint8_t buf
[ID3v1_TAG_SIZE
];
482 int len
, ret
, filesize
;
485 st
= av_new_stream(s
, 0);
487 return AVERROR(ENOMEM
);
489 st
->codec
->codec_type
= CODEC_TYPE_AUDIO
;
490 st
->codec
->codec_id
= CODEC_ID_MP3
;
491 st
->need_parsing
= AVSTREAM_PARSE_FULL
;
494 /* try to get the TAG */
495 if (!url_is_streamed(s
->pb
)) {
496 /* XXX: change that */
497 filesize
= url_fsize(s
->pb
);
498 if (filesize
> 128) {
499 url_fseek(s
->pb
, filesize
- 128, SEEK_SET
);
500 ret
= get_buffer(s
->pb
, buf
, ID3v1_TAG_SIZE
);
501 if (ret
== ID3v1_TAG_SIZE
) {
502 id3v1_parse_tag(s
, buf
);
504 url_fseek(s
->pb
, 0, SEEK_SET
);
508 /* if ID3v2 header found, skip it */
509 ret
= get_buffer(s
->pb
, buf
, ID3v2_HEADER_SIZE
);
510 if (ret
!= ID3v2_HEADER_SIZE
)
512 if (id3v2_match(buf
)) {
513 /* parse ID3v2 header */
514 len
= ((buf
[6] & 0x7f) << 21) |
515 ((buf
[7] & 0x7f) << 14) |
516 ((buf
[8] & 0x7f) << 7) |
518 id3v2_parse(s
, len
, buf
[3], buf
[5]);
520 url_fseek(s
->pb
, 0, SEEK_SET
);
523 off
= url_ftell(s
->pb
);
524 mp3_parse_vbr_tags(s
, st
, off
);
525 url_fseek(s
->pb
, off
, SEEK_SET
);
527 /* the parameters will be extracted from the compressed bitstream */
531 #define MP3_PACKET_SIZE 1024
533 static int mp3_read_packet(AVFormatContext
*s
, AVPacket
*pkt
)
536 // AVStream *st = s->streams[0];
538 size
= MP3_PACKET_SIZE
;
540 ret
= av_get_packet(s
->pb
, pkt
, size
);
542 pkt
->stream_index
= 0;
546 /* note: we need to modify the packet size here to handle the last
552 static int mp3_read_close(AVFormatContext
*s
)
560 static void id3v2_put_size(AVFormatContext
*s
, int size
)
562 put_byte(s
->pb
, size
>> 21 & 0x7f);
563 put_byte(s
->pb
, size
>> 14 & 0x7f);
564 put_byte(s
->pb
, size
>> 7 & 0x7f);
565 put_byte(s
->pb
, size
& 0x7f);
568 static void id3v2_put_ttag(AVFormatContext
*s
, const char *string
, uint32_t tag
)
570 int len
= strlen(string
);
571 put_be32(s
->pb
, tag
);
572 id3v2_put_size(s
, len
+ 1);
574 put_byte(s
->pb
, 3); /* UTF-8 */
575 put_buffer(s
->pb
, string
, len
);
580 * Write an ID3v2.4 header at beginning of stream
583 static int mp3_write_header(struct AVFormatContext
*s
)
590 snprintf(tracktxt
, sizeof(tracktxt
), "%d", s
->track
);
592 snprintf( yeartxt
, sizeof(yeartxt
) , "%d", s
->year
);
594 if(s
->title
[0]) totlen
+= 11 + strlen(s
->title
);
595 if(s
->author
[0]) totlen
+= 11 + strlen(s
->author
);
596 if(s
->album
[0]) totlen
+= 11 + strlen(s
->album
);
597 if(s
->genre
[0]) totlen
+= 11 + strlen(s
->genre
);
598 if(s
->copyright
[0]) totlen
+= 11 + strlen(s
->copyright
);
599 if(s
->track
) totlen
+= 11 + strlen(tracktxt
);
600 if(s
->year
) totlen
+= 11 + strlen(yeartxt
);
601 if(!(s
->streams
[0]->codec
->flags
& CODEC_FLAG_BITEXACT
))
602 totlen
+= strlen(LIBAVFORMAT_IDENT
) + 11;
607 put_be32(s
->pb
, MKBETAG('I', 'D', '3', 0x04)); /* ID3v2.4 */
609 put_byte(s
->pb
, 0); /* flags */
611 id3v2_put_size(s
, totlen
);
613 if(s
->title
[0]) id3v2_put_ttag(s
, s
->title
, MKBETAG('T', 'I', 'T', '2'));
614 if(s
->author
[0]) id3v2_put_ttag(s
, s
->author
, MKBETAG('T', 'P', 'E', '1'));
615 if(s
->album
[0]) id3v2_put_ttag(s
, s
->album
, MKBETAG('T', 'A', 'L', 'B'));
616 if(s
->genre
[0]) id3v2_put_ttag(s
, s
->genre
, MKBETAG('T', 'C', 'O', 'N'));
617 if(s
->copyright
[0]) id3v2_put_ttag(s
, s
->copyright
, MKBETAG('T', 'C', 'O', 'P'));
618 if(s
->track
) id3v2_put_ttag(s
, tracktxt
, MKBETAG('T', 'R', 'C', 'K'));
619 if(s
->year
) id3v2_put_ttag(s
, yeartxt
, MKBETAG('T', 'Y', 'E', 'R'));
620 if(!(s
->streams
[0]->codec
->flags
& CODEC_FLAG_BITEXACT
))
621 id3v2_put_ttag(s
, LIBAVFORMAT_IDENT
, MKBETAG('T', 'E', 'N', 'C'));
625 static int mp3_write_packet(struct AVFormatContext
*s
, AVPacket
*pkt
)
627 put_buffer(s
->pb
, pkt
->data
, pkt
->size
);
628 put_flush_packet(s
->pb
);
632 static int mp3_write_trailer(struct AVFormatContext
*s
)
634 uint8_t buf
[ID3v1_TAG_SIZE
];
636 /* write the id3v1 tag */
637 if (s
->title
[0] != '\0') {
638 id3v1_create_tag(s
, buf
);
639 put_buffer(s
->pb
, buf
, ID3v1_TAG_SIZE
);
640 put_flush_packet(s
->pb
);
644 #endif //CONFIG_MUXERS
646 #ifdef CONFIG_MP3_DEMUXER
647 AVInputFormat mp3_demuxer
= {
655 .flags
= AVFMT_GENERIC_INDEX
,
656 .extensions
= "mp2,mp3,m2a", /* XXX: use probe */
659 #ifdef CONFIG_MP2_MUXER
660 AVOutputFormat mp2_muxer
= {
662 "MPEG audio layer 2",
664 #ifdef CONFIG_LIBMP3LAME
677 #ifdef CONFIG_MP3_MUXER
678 AVOutputFormat mp3_muxer
= {
680 "MPEG audio layer 3",