src/plugins/id3/id3.c

   1 /**
   2  * Copyright (C) 2008 by INdT
   3  *
   4  * This program is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Lesser General Public License
   6  * as published by the Free Software Foundation; either version 2
   7  * of the License, or (at your option) any later version.
   8  *
   9  * This program is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12  * GNU General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Lesser General Public License
  15  * along with this program; if not, write to the Free Software
  16  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  17  *
  18  * @author Andre Moreira Magalhaes <andre.magalhaes@openbossa.org>
  19  */
  20
  21 /**
  22  * @brief
  23  *
  24  * id3 file parser.
  25  */
  26
  27 #ifdef HAVE_CONFIG_H
  28 #include "config.h"
  29 #endif
  30
  31 #define _GNU_SOURCE
  32 #define _XOPEN_SOURCE 600
  33 #include <lightmediascanner_plugin.h>
  34 #include <lightmediascanner_db.h>
  35 #include <lightmediascanner_charset_conv.h>
  36 #include <sys/types.h>
  37 #include <sys/stat.h>
  38 #include <fcntl.h>
  39 #include <stdio.h>
  40 #include <stdlib.h>
  41 #include <string.h>
  42 #include <unistd.h>
  43 #include <ctype.h>
  44
  45 #define ID3V2_HEADER_SIZE       10
  46 #define ID3V2_FOOTER_SIZE       10
  47
  48 enum ID3Encodings {
  49     ID3_ENCODING_LATIN1 = 0,
  50     ID3_ENCODING_UTF16,
  51     ID3_ENCODING_UTF16BE,
  52     ID3_ENCODING_UTF8,
  53     ID3_ENCODING_UTF16LE,
  54     ID3_ENCODING_LAST
  55 };
  56 #define ID3_NUM_ENCODINGS ID3_ENCODING_LAST
  57
  58
  59 #include "id3v1_genres.c"
  60
  61 struct id3_info {
  62     struct lms_string_size title;
  63     struct lms_string_size artist;
  64     struct lms_string_size album;
  65     struct lms_string_size genre;
  66     unsigned char trackno;
  67     int cur_artist_priority;
  68 };
  69
  70 struct id3v2_frame_header {
  71     char frame_id[4];
  72     unsigned int frame_size;
  73     int compression;
  74     int data_length_indicator;
  75 };
  76
  77 struct id3v1_tag {
  78     char title[30];
  79     char artist[30];
  80     char album[30];
  81     char year[4];
  82     char comments[30];
  83     char genre;
  84 } __attribute__((packed));
  85
  86 struct plugin {
  87     struct lms_plugin plugin;
  88     lms_db_audio_t *audio_db;
  89     lms_charset_conv_t *cs_convs[ID3_NUM_ENCODINGS];
  90 };
  91
  92 static const char _name[] = "id3";
  93 static const struct lms_string_size _exts[] = {
  94     LMS_STATIC_STRING_SIZE(".mp3"),
  95     LMS_STATIC_STRING_SIZE(".aac")
  96 };
  97
  98 static unsigned int
  99 _to_uint(const char *data, int data_size)
 100 {
 101     unsigned int sum = 0;
 102     unsigned int last, i;
 103
 104     last = data_size > 4 ? 3 : data_size - 1;
 105
 106     for (i = 0; i <= last; i++)
 107         sum |= ((unsigned char) data[i]) << ((last - i) * 8);
 108
 109     return sum;
 110 }
 111
 112 static inline int
 113 _is_id3v2_second_synch_byte(unsigned char byte)
 114 {
 115     if (byte == 0xff)
 116         return 0;
 117     if ((byte & 0xE0) == 0xE0)
 118         return 1;
 119     return 0;
 120 }
 121
 122 static long
 123 _find_id3v2(int fd)
 124 {
 125     long buffer_offset = 0;
 126     char buffer[3], *p;
 127     int buffer_size = sizeof(buffer);
 128     const char pattern[] = "ID3";
 129     ssize_t nread;
 130
 131     /* These variables are used to keep track of a partial match that happens at
 132      * the end of a buffer. */
 133     int previous_partial_match = -1;
 134     int previous_partial_synch_match = 0;
 135     int first_synch_byte;
 136
 137     /* Start the search at the beginning of the file. */
 138     lseek(fd, 0, SEEK_SET);
 139
 140     if ((nread = read(fd, &buffer, buffer_size)) != buffer_size)
 141         return -1;
 142
 143     /* check if pattern is in the beggining of the file */
 144     if (memcmp(buffer, pattern, 3) == 0)
 145         return 0;
 146
 147     /* This loop is the crux of the find method.  There are three cases that we
 148      * want to account for:
 149      * (1) The previously searched buffer contained a partial match of the
 150      * search pattern and we want to see if the next one starts with the
 151      * remainder of that pattern.
 152      *
 153      * (2) The search pattern is wholly contained within the current buffer.
 154      *
 155      * (3) The current buffer ends with a partial match of the pattern.  We will
 156      * note this for use in the next iteration, where we will check for the rest
 157      * of the pattern.
 158      */
 159     while (1) {
 160         /* (1) previous partial match */
 161         if (previous_partial_synch_match &&
 162             _is_id3v2_second_synch_byte(buffer[0]))
 163             return -1;
 164
 165         if (previous_partial_match >= 0 &&
 166             previous_partial_match < buffer_size) {
 167             const int pat_offset = buffer_size - previous_partial_match;
 168
 169             if (memcmp(buffer, pattern + pat_offset, 3 - pat_offset) == 0)
 170                 return buffer_offset - buffer_size + previous_partial_match;
 171         }
 172
 173         /* (2) pattern contained in current buffer */
 174         p = buffer;
 175         while ((p = memchr(p, 'I', buffer_size - (p - buffer)))) {
 176             if (buffer_size - (p - buffer) < 3)
 177                 break;
 178
 179             if (memcmp(p, pattern, 3) == 0)
 180                 return buffer_offset + (p - buffer);
 181
 182             p += 1;
 183         }
 184
 185         p = memchr(buffer, 255, buffer_size);
 186         if (p)
 187             first_synch_byte = p - buffer;
 188         else
 189             first_synch_byte = -1;
 190
 191         /* Here we have to loop because there could be several of the first
 192          * (11111111) byte, and we want to check all such instances until we
 193          * find a full match (11111111 111) or hit the end of the buffer.
 194          */
 195         while (first_synch_byte >= 0) {
 196             /* if this *is not* at the end of the buffer */
 197             if (first_synch_byte < buffer_size - 1) {
 198                 if(_is_id3v2_second_synch_byte(buffer[first_synch_byte + 1]))
 199                     /* We've found the frame synch pattern. */
 200                     return -1;
 201                 else
 202                     /* We found 11111111 at the end of the current buffer
 203                      * indicating a partial match of the synch pattern.
 204                      * The find() below should return -1 and break out of
 205                      * the loop.
 206                      */
 207                     previous_partial_synch_match = 1;
 208             }
 209
 210             /* Check in the rest of the buffer. */
 211             p = memchr(p + 1, 255, buffer_size - (p + 1 - buffer));
 212             if (p)
 213                 first_synch_byte = p - buffer;
 214             else
 215                 first_synch_byte = -1;
 216         }
 217
 218         /* (3) partial match */
 219         if (buffer[nread - 1] == pattern[1])
 220             previous_partial_match = nread - 1;
 221         else if (memcmp(&buffer[nread - 2], pattern, 2) == 0)
 222             previous_partial_match = nread - 2;
 223         buffer_offset += buffer_size;
 224
 225         if ((nread = read(fd, &buffer, sizeof(buffer))) == -1)
 226             return -1;
 227     }
 228
 229     return -1;
 230 }
 231
 232 static unsigned int
 233 _get_id3v2_frame_header_size(unsigned int version)
 234 {
 235     switch (version) {
 236     case 0:
 237     case 1:
 238     case 2:
 239         return 6;
 240     case 3:
 241     case 4:
 242     default:
 243         return 10;
 244     }
 245 }
 246
 247 static void
 248 _parse_id3v2_frame_header(char *data, unsigned int version, struct id3v2_frame_header *fh)
 249 {
 250     switch (version) {
 251     case 0:
 252     case 1:
 253     case 2:
 254         memcpy(fh->frame_id, data, 3);
 255         fh->frame_id[3] = 0;
 256         fh->frame_size = _to_uint(data + 3, 3);
 257         fh->compression = 0;
 258         fh->data_length_indicator = 0;
 259         break;
 260     case 3:
 261         memcpy(fh->frame_id, data, 4);
 262         fh->frame_size = _to_uint(data + 4, 4);
 263         fh->compression = data[9] & 0x40;
 264         fh->data_length_indicator = 0;
 265         break;
 266     case 4:
 267     default:
 268         memcpy(fh->frame_id, data, 4);
 269         fh->frame_size = _to_uint(data + 4, 4);
 270         fh->compression = data[9] & 0x4;
 271         fh->data_length_indicator = data[9] & 0x1;
 272         break;
 273     }
 274 }
 275
 276 static inline void
 277 _get_id3v2_frame_info(const char *frame_data, unsigned int frame_size, struct lms_string_size *s, lms_charset_conv_t *cs_conv)
 278 {
 279     if (frame_size > s->len)
 280         s->str = realloc(s->str, sizeof(char) * (frame_size + 1));
 281     memcpy(s->str, frame_data, frame_size);
 282     s->str[frame_size] = '\0';
 283     s->len = frame_size;
 284     if (cs_conv)
 285         lms_charset_conv(cs_conv, &s->str, &s->len);
 286 }
 287
 288 static int
 289 _get_id3v1_genre(unsigned int genre, struct lms_string_size *out)
 290 {
 291     if (genre < ID3V1_NUM_GENRES) {
 292         unsigned int size, base;
 293
 294         base = id3v1_genres_offsets[genre];
 295         size = id3v1_genres_offsets[genre + 1] - base;
 296         out->str = malloc(size);
 297         out->len = size - 1;
 298         memcpy(out->str, id3v1_genres_mem + base, size);
 299
 300         return 0;
 301     }
 302     return -1;
 303 }
 304
 305 static inline int
 306 _parse_id3v1_genre(const char *str_genre, struct lms_string_size *out)
 307 {
 308     return _get_id3v1_genre(atoi(str_genre), out);
 309 }
 310
 311 static inline void
 312 _get_id3v2_genre(const char *frame_data, unsigned int frame_size, struct lms_string_size *out, lms_charset_conv_t *cs_conv)
 313 {
 314     int i, is_number;
 315     struct lms_string_size genre = {0};
 316
 317     _get_id3v2_frame_info(frame_data, frame_size, &genre, cs_conv);
 318
 319     if (!genre.str)
 320         return;
 321
 322     if (out->str)
 323         free(out->str);
 324
 325     is_number = (genre.len != 0 && genre.str[0] != '(');
 326     if (is_number) {
 327         for (i = 0; i < genre.len; ++i) {
 328             if (!isdigit(genre.str[i])) {
 329                 is_number = 0;
 330                 break;
 331             }
 332         }
 333     }
 334
 335     if (is_number && _parse_id3v1_genre(genre.str, out) == 0) {
 336         /* id3v1 genre found */
 337         free(genre.str);
 338         return;
 339     }
 340
 341     /* ID3v2.3 "content type" can contain a ID3v1 genre number in parenthesis at
 342      * the beginning of the field. If this is all that the field contains, do a
 343      * translation from that number to the name and return that.  If there is a
 344      * string folloing the ID3v1 genre number, that is considered to be
 345      * authoritative and we return that instead. Or finally, the field may
 346      * simply be free text, in which case we just return the value. */
 347
 348     if (genre.len > 1 && genre.str[0] == '(') {
 349         char *closing = NULL;
 350
 351         if (genre.str[genre.len - 1] == ')') {
 352             closing = strchr(genre.str, ')');
 353             if (closing == genre.str + genre.len - 1) {
 354                 /* ) is the last character and only appears once in the
 355                  * string get the id3v1 genre enclosed by parentheses
 356                  */
 357                 if (_parse_id3v1_genre(genre.str + 1, out) == 0) {
 358                     free(genre.str);
 359                     return;
 360                 }
 361             }
 362         }
 363
 364         /* get the string followed by the id3v1 genre */
 365         if (!closing)
 366             closing = strchr(genre.str, ')');
 367
 368         if (closing) {
 369             out->str = strdup(closing + 1);
 370             out->len = genre.len - (closing + 1 - genre.str);
 371             free(genre.str);
 372             return;
 373         }
 374     }
 375
 376     /* pure text */
 377     *out = genre;
 378 }
 379
 380 static void
 381 _parse_id3v2_frame(struct id3v2_frame_header *fh, const char *frame_data, struct id3_info *info, lms_charset_conv_t **cs_convs)
 382 {
 383     lms_charset_conv_t *cs_conv = NULL;
 384     unsigned int text_encoding, frame_size;
 385     static const int artist_priorities[] = { 3, 4, 2, 1 };
 386
 387 #if 0
 388     fprintf(stderr, "frame id = %.4s frame size = %d text encoding = %d\n",
 389             fh->frame_id, fh->frame_size, frame_data[0]);
 390 #endif
 391
 392     /* Latin1  = 0
 393      * UTF16   = 1
 394      * UTF16BE = 2
 395      * UTF8    = 3
 396      * UTF16LE = 4
 397      */
 398     text_encoding = frame_data[0];
 399
 400     /* skip first byte - text encoding */
 401     frame_data += 1;
 402     frame_size = fh->frame_size - 1;
 403
 404     if (text_encoding >= 0 && text_encoding < ID3_NUM_ENCODINGS) {
 405         if (text_encoding == ID3_ENCODING_UTF16) {
 406             if (memcmp(frame_data, "\xfe\xff", 2) == 0)
 407                 text_encoding = ID3_ENCODING_UTF16BE;
 408             else
 409                 text_encoding = ID3_ENCODING_UTF16LE;
 410             frame_data += 2;
 411             frame_size -= 2;
 412         }
 413         cs_conv = cs_convs[text_encoding];
 414     }
 415
 416     /* ID3v2.2 used 3 bytes for the frame id, so let's check it */
 417     if (memcmp(fh->frame_id, "TIT2", 4) == 0 ||
 418         memcmp(fh->frame_id, "TT2", 3) == 0)
 419         _get_id3v2_frame_info(frame_data, frame_size, &info->title, cs_conv);
 420     else if (memcmp(fh->frame_id, "TP", 2) == 0) {
 421         int index = -1;
 422
 423         if (memcmp(fh->frame_id, "TPE", 3) == 0) {
 424             /* this check shouldn't be needed, but let's make sure */
 425             if (fh->frame_id[3] >= '1' && fh->frame_id[3] <= '4')
 426                 index = fh->frame_id[3] - '1';
 427         }
 428         else {
 429             /* ignore TPA, TPB */
 430             if (fh->frame_id[2] >= '1' && fh->frame_id[2] <= '4')
 431                 index = fh->frame_id[2] - '1';
 432         }
 433
 434         if (index != -1 &&
 435             artist_priorities[index] > info->cur_artist_priority) {
 436             struct lms_string_size artist = {0};
 437
 438             _get_id3v2_frame_info(frame_data, frame_size, &artist, cs_conv);
 439             lms_string_size_strip_and_free(&artist);
 440             if (artist.str) {
 441                 if (info->artist.str)
 442                     free(info->artist.str);
 443                 info->artist = artist;
 444                 info->cur_artist_priority = artist_priorities[index];
 445             }
 446         }
 447     }
 448     /* TALB, TAL */
 449     else if (memcmp(fh->frame_id, "TAL", 3) == 0)
 450         _get_id3v2_frame_info(frame_data, frame_size, &info->album, cs_conv);
 451     /* TCON, TCO */
 452     else if (memcmp(fh->frame_id, "TCO", 3) == 0)
 453         _get_id3v2_genre(frame_data, frame_size, &info->genre, cs_conv);
 454     else if (memcmp(fh->frame_id, "TRCK", 4) == 0 ||
 455              memcmp(fh->frame_id, "TRK", 3) == 0) {
 456         struct lms_string_size trackno = {0};
 457         _get_id3v2_frame_info(frame_data, frame_size, &trackno, cs_conv);
 458         info->trackno = atoi(trackno.str);
 459         free(trackno.str);
 460     }
 461 }
 462
 463 static int
 464 _parse_id3v2(int fd, long id3v2_offset, struct id3_info *info, lms_charset_conv_t **cs_convs)
 465 {
 466     char header_data[10], frame_header_data[10];
 467     unsigned int tag_size, major_version, frame_data_pos, frame_data_length, frame_header_size;
 468     int extended_header, footer_present;
 469     struct id3v2_frame_header fh;
 470     size_t nread;
 471
 472     lseek(fd, id3v2_offset, SEEK_SET);
 473
 474     /* parse header */
 475     if (read(fd, header_data, ID3V2_HEADER_SIZE) != ID3V2_HEADER_SIZE)
 476         return -1;
 477
 478     tag_size = _to_uint(header_data + 6, 4);
 479     if (tag_size == 0)
 480         return -1;
 481
 482     /* parse frames */
 483     major_version = header_data[3];
 484
 485     frame_data_pos = 0;
 486     frame_data_length = tag_size;
 487
 488     /* check for extended header */
 489     extended_header = header_data[5] & 0x20; /* bit 6 */
 490     if (extended_header) {
 491         /* skip extended header */
 492         unsigned int extended_header_size;
 493         char extended_header_data[4];
 494
 495         if (read(fd, extended_header_data, 4) != 4)
 496             return -1;
 497         extended_header_size = _to_uint(extended_header_data, 4);
 498         lseek(fd, extended_header_size - 4, SEEK_CUR);
 499         frame_data_pos += extended_header_size;
 500         frame_data_length -= extended_header_size;
 501     }
 502
 503     footer_present = header_data[5] & 0x8;   /* bit 4 */
 504     if (footer_present && frame_data_length > ID3V2_FOOTER_SIZE)
 505         frame_data_length -= ID3V2_FOOTER_SIZE;
 506
 507     frame_header_size = _get_id3v2_frame_header_size(major_version);
 508     while (frame_data_pos < frame_data_length - frame_header_size) {
 509         nread = read(fd, frame_header_data, frame_header_size);
 510         if (nread == 0)
 511             break;
 512
 513         if (nread != frame_header_size)
 514             return -1;
 515
 516         if (frame_header_data[0] == 0)
 517             break;
 518
 519         _parse_id3v2_frame_header(frame_header_data, major_version, &fh);
 520         if (!fh.frame_size)
 521             break;
 522
 523         if (!fh.compression &&
 524             fh.frame_id[0] == 'T' &&
 525             memcmp(fh.frame_id, "TXXX", 4) != 0) {
 526             char *frame_data;
 527
 528             if (fh.data_length_indicator)
 529                 lseek(fd, 4, SEEK_CUR);
 530
 531             frame_data = malloc(sizeof(char) * fh.frame_size);
 532             if (read(fd, frame_data, fh.frame_size) != fh.frame_size) {
 533                 free(frame_data);
 534                 return -1;
 535             }
 536
 537             _parse_id3v2_frame(&fh, frame_data, info, cs_convs);
 538             free(frame_data);
 539         }
 540         else {
 541             if (fh.data_length_indicator)
 542                 lseek(fd, fh.frame_size + 4, SEEK_CUR);
 543             else
 544                 lseek(fd, fh.frame_size, SEEK_CUR);
 545         }
 546
 547         frame_data_pos += fh.frame_size + frame_header_size;
 548     }
 549
 550     return 0;
 551 }
 552
 553 static int
 554 _parse_id3v1(int fd, struct id3_info *info, lms_charset_conv_t *cs_conv)
 555 {
 556     struct id3v1_tag tag;
 557     if (read(fd, &tag, sizeof(struct id3v1_tag)) == -1)
 558         return -1;
 559
 560     info->title.str = strndup(tag.title, 30);
 561     info->title.len = strlen(info->title.str);
 562     lms_charset_conv(cs_conv, &info->title.str, &info->title.len);
 563     info->artist.str = strndup(tag.artist, 30);
 564     info->artist.len = strlen(info->artist.str);
 565     lms_charset_conv(cs_conv, &info->artist.str, &info->artist.len);
 566     info->album.str = strndup(tag.album, 30);
 567     info->album.len = strlen(info->album.str);
 568     lms_charset_conv(cs_conv, &info->album.str, &info->album.len);
 569     _get_id3v1_genre(tag.genre, &info->genre);
 570     if (tag.comments[28] == 0 && tag.comments[29] != 0)
 571         info->trackno = (unsigned char) tag.comments[29];
 572
 573     return 0;
 574 }
 575
 576 static void *
 577 _match(struct plugin *p, const char *path, int len, int base)
 578 {
 579     int i;
 580
 581     i = lms_which_extension(path, len, _exts, LMS_ARRAY_SIZE(_exts));
 582     if (i < 0)
 583       return NULL;
 584     else
 585       return (void*)(i + 1);
 586 }
 587
 588 static int
 589 _parse(struct plugin *plugin, struct lms_context *ctxt, const struct lms_file_info *finfo, void *match)
 590 {
 591     struct id3_info info = {{0}, {0}, {0}, {0}, 0, -1};
 592     struct lms_audio_info audio_info = {0, {0}, {0}, {0}, {0}, 0, 0, 0};
 593     int r, fd;
 594     long id3v2_offset;
 595
 596     fd = open(finfo->path, O_RDONLY);
 597     if (fd < 0) {
 598         perror("open");
 599         return -1;
 600     }
 601
 602     id3v2_offset = _find_id3v2(fd);
 603     if (id3v2_offset >= 0) {
 604 #if 0
 605         fprintf(stderr, "id3v2 tag found in file %s with offset %ld\n",
 606                 finfo->path, id3v2_offset);
 607 #endif
 608         if (_parse_id3v2(fd, id3v2_offset, &info, plugin->cs_convs) != 0) {
 609             r = -2;
 610             goto done;
 611         }
 612     }
 613     else {
 614         char tag[3];
 615 #if 0
 616         fprintf(stderr, "id3v2 tag not found in file %s. trying id3v1\n",
 617                 finfo->path);
 618 #endif
 619         /* check for id3v1 tag */
 620         if (lseek(fd, -128, SEEK_END) == -1) {
 621             r = -3;
 622             goto done;
 623         }
 624
 625         if (read(fd, &tag, 3) == -1) {
 626             r = -4;
 627             goto done;
 628         }
 629
 630         if (memcmp(tag, "TAG", 3) == 0) {
 631 #if 0
 632             fprintf(stderr, "id3v1 tag found in file %s\n", finfo->path);
 633 #endif
 634             if (_parse_id3v1(fd, &info, ctxt->cs_conv) != 0) {
 635                 r = -5;
 636                 goto done;
 637             }
 638         }
 639     }
 640
 641     lms_string_size_strip_and_free(&info.title);
 642     lms_string_size_strip_and_free(&info.artist);
 643     lms_string_size_strip_and_free(&info.album);
 644     lms_string_size_strip_and_free(&info.genre);
 645
 646     if (!info.title.str) {
 647         int ext_idx;
 648         ext_idx = ((int)match) - 1;
 649         info.title.len = finfo->path_len - finfo->base - _exts[ext_idx].len;
 650         info.title.str = malloc((info.title.len + 1) * sizeof(char));
 651         memcpy(info.title.str, finfo->path + finfo->base, info.title.len);
 652         info.title.str[info.title.len] = '\0';
 653         lms_charset_conv(ctxt->cs_conv, &info.title.str, &info.title.len);
 654     }
 655
 656 #if 0
 657     fprintf(stderr, "file %s info\n", finfo->path);
 658     fprintf(stderr, "\ttitle='%s'\n", info.title.str);
 659     fprintf(stderr, "\tartist='%s'\n", info.artist.str);
 660     fprintf(stderr, "\talbum='%s'\n", info.album.str);
 661     fprintf(stderr, "\tgenre='%s'\n", info.genre.str);
 662     fprintf(stderr, "\ttrack number='%d'\n", info.trackno);
 663 #endif
 664
 665     audio_info.id = finfo->id;
 666     audio_info.title = info.title;
 667     audio_info.artist = info.artist;
 668     audio_info.album = info.album;
 669     audio_info.genre = info.genre;
 670     audio_info.trackno = info.trackno;
 671     r = lms_db_audio_add(plugin->audio_db, &audio_info);
 672
 673   done:
 674     posix_fadvise(fd, 0, 0, POSIX_FADV_DONTNEED);
 675     close(fd);
 676
 677     if (info.title.str)
 678         free(info.title.str);
 679     if (info.artist.str)
 680         free(info.artist.str);
 681     if (info.album.str)
 682         free(info.album.str);
 683     if (info.genre.str)
 684         free(info.genre.str);
 685
 686     return r;
 687 }
 688
 689 static int
 690 _setup(struct plugin *plugin, struct lms_context *ctxt)
 691 {
 692     int i;
 693     const char *id3_encodings[ID3_NUM_ENCODINGS] = {
 694         "Latin1",
 695         NULL, /* UTF-16 */
 696         "UTF-16BE",
 697         NULL, /* UTF-8 */
 698         "UTF-16LE",
 699     };
 700
 701     plugin->audio_db = lms_db_audio_new(ctxt->db);
 702     if (!plugin->audio_db)
 703         return -1;
 704
 705     for (i = 0; i < ID3_NUM_ENCODINGS; ++i) {
 706         /* do not create charset conv for UTF-8 encoding */
 707         if (!id3_encodings[i]) {
 708             plugin->cs_convs[i] = NULL;
 709             continue;
 710         }
 711         plugin->cs_convs[i] = lms_charset_conv_new_full(0, 0);
 712         if (!plugin->cs_convs[i])
 713             return -1;
 714         lms_charset_conv_add(plugin->cs_convs[i], id3_encodings[i]);
 715     }
 716
 717     return 0;
 718 }
 719
 720 static int
 721 _start(struct plugin *plugin, struct lms_context *ctxt)
 722 {
 723     return lms_db_audio_start(plugin->audio_db);
 724 }
 725
 726 static int
 727 _finish(struct plugin *plugin, struct lms_context *ctxt)
 728 {
 729     int i;
 730
 731     if (plugin->audio_db)
 732         lms_db_audio_free(plugin->audio_db);
 733
 734     for (i = 0; i < ID3_NUM_ENCODINGS; ++i) {
 735         if (plugin->cs_convs[i])
 736             lms_charset_conv_free(plugin->cs_convs[i]);
 737     }
 738
 739     return 0;
 740 }
 741
 742 static int
 743 _close(struct plugin *plugin)
 744 {
 745     free(plugin);
 746     return 0;
 747 }
 748
 749 API struct lms_plugin *
 750 lms_plugin_open(void)
 751 {
 752     struct plugin *plugin;
 753
 754     plugin = (struct plugin *)malloc(sizeof(*plugin));
 755     plugin->plugin.name = _name;
 756     plugin->plugin.match = (lms_plugin_match_fn_t)_match;
 757     plugin->plugin.parse = (lms_plugin_parse_fn_t)_parse;
 758     plugin->plugin.close = (lms_plugin_close_fn_t)_close;
 759     plugin->plugin.setup = (lms_plugin_setup_fn_t)_setup;
 760     plugin->plugin.start = (lms_plugin_start_fn_t)_start;
 761     plugin->plugin.finish = (lms_plugin_finish_fn_t)_finish;
 762
 763     return (struct lms_plugin *)plugin;
 764 }