3bd19839b6c16ec5eb69cc68a2374f96431a0f3b
[platform/upstream/lightmediascanner.git] / 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, int strip)
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     if (strip)
287         lms_string_size_strip_and_free(s);
288 }
289
290 static int
291 _get_id3v1_genre(unsigned int genre, struct lms_string_size *out)
292 {
293     if (genre < ID3V1_NUM_GENRES) {
294         unsigned int size, base, len;
295
296         base = id3v1_genres_offsets[genre];
297         size = id3v1_genres_offsets[genre + 1] - base;
298         len = size - 1;
299
300         if (len > out->len) {
301             char *p = realloc(out->str, size);
302             if (!p)
303                 return -2;
304             out->str = p;
305         }
306
307         out->len = len;
308         memcpy(out->str, id3v1_genres_mem + base, size);
309
310         return 0;
311     }
312     return -1;
313 }
314
315 static inline int
316 _parse_id3v1_genre(const char *str_genre, struct lms_string_size *out)
317 {
318     return _get_id3v1_genre(atoi(str_genre), out);
319 }
320
321 static inline void
322 _get_id3v2_genre(const char *frame_data, unsigned int frame_size, struct lms_string_size *out, lms_charset_conv_t *cs_conv)
323 {
324     int i, is_number;
325     struct lms_string_size genre = {0};
326
327     _get_id3v2_frame_info(frame_data, frame_size, &genre, cs_conv, 1);
328
329     if (!genre.str)
330         return;
331
332     is_number = (genre.len != 0 && genre.str[0] != '(');
333     if (is_number) {
334         for (i = 0; i < genre.len; ++i) {
335             if (!isdigit(genre.str[i])) {
336                 is_number = 0;
337                 break;
338             }
339         }
340     }
341
342     if (is_number && _parse_id3v1_genre(genre.str, out) == 0) {
343         /* id3v1 genre found */
344         free(genre.str);
345         return;
346     }
347
348     /* ID3v2.3 "content type" can contain a ID3v1 genre number in parenthesis at
349      * the beginning of the field. If this is all that the field contains, do a
350      * translation from that number to the name and return that.  If there is a
351      * string folloing the ID3v1 genre number, that is considered to be
352      * authoritative and we return that instead. Or finally, the field may
353      * simply be free text, in which case we just return the value. */
354
355     if (genre.len > 1 && genre.str[0] == '(') {
356         char *closing = NULL;
357
358         if (genre.str[genre.len - 1] == ')') {
359             closing = strchr(genre.str, ')');
360             if (closing == genre.str + genre.len - 1) {
361                 /* ) is the last character and only appears once in the
362                  * string get the id3v1 genre enclosed by parentheses
363                  */
364                 if (_parse_id3v1_genre(genre.str + 1, out) == 0) {
365                     free(genre.str);
366                     return;
367                 }
368             }
369         }
370
371         /* get the string followed by the id3v1 genre */
372         if (!closing)
373             closing = strchr(genre.str, ')');
374
375         if (closing) {
376             closing++;
377             out->len = genre.len - (closing - genre.str);
378             out->str = genre.str;
379             memmove(out->str, closing, out->len + 1); /* includes '\0' */
380             lms_string_size_strip_and_free(out);
381             return;
382         }
383     }
384
385     /* pure text */
386     *out = genre;
387 }
388
389 static void
390 _parse_id3v2_frame(struct id3v2_frame_header *fh, const char *frame_data, struct id3_info *info, lms_charset_conv_t **cs_convs)
391 {
392     lms_charset_conv_t *cs_conv = NULL;
393     unsigned int text_encoding, frame_size;
394     static const int artist_priorities[] = { 3, 4, 2, 1 };
395
396 #if 0
397     fprintf(stderr, "frame id = %.4s frame size = %d text encoding = %d\n",
398             fh->frame_id, fh->frame_size, frame_data[0]);
399 #endif
400
401     /* Latin1  = 0
402      * UTF16   = 1
403      * UTF16BE = 2
404      * UTF8    = 3
405      * UTF16LE = 4
406      */
407     text_encoding = frame_data[0];
408
409     /* skip first byte - text encoding */
410     frame_data += 1;
411     frame_size = fh->frame_size - 1;
412
413     if (text_encoding >= 0 && text_encoding < ID3_NUM_ENCODINGS) {
414         if (text_encoding == ID3_ENCODING_UTF16) {
415             if (memcmp(frame_data, "\xfe\xff", 2) == 0)
416                 text_encoding = ID3_ENCODING_UTF16BE;
417             else
418                 text_encoding = ID3_ENCODING_UTF16LE;
419             frame_data += 2;
420             frame_size -= 2;
421         }
422         cs_conv = cs_convs[text_encoding];
423     }
424
425     /* ID3v2.2 used 3 bytes for the frame id, so let's check it */
426     if (memcmp(fh->frame_id, "TIT2", 4) == 0 ||
427         memcmp(fh->frame_id, "TT2", 3) == 0)
428         _get_id3v2_frame_info(frame_data, frame_size, &info->title, cs_conv, 1);
429     else if (memcmp(fh->frame_id, "TP", 2) == 0) {
430         int index = -1;
431
432         if (memcmp(fh->frame_id, "TPE", 3) == 0) {
433             /* this check shouldn't be needed, but let's make sure */
434             if (fh->frame_id[3] >= '1' && fh->frame_id[3] <= '4')
435                 index = fh->frame_id[3] - '1';
436         }
437         else {
438             /* ignore TPA, TPB */
439             if (fh->frame_id[2] >= '1' && fh->frame_id[2] <= '4')
440                 index = fh->frame_id[2] - '1';
441         }
442
443         if (index != -1 &&
444             artist_priorities[index] > info->cur_artist_priority) {
445             struct lms_string_size artist = {0};
446
447             _get_id3v2_frame_info(frame_data, frame_size, &artist, cs_conv, 1);
448             if (artist.str) {
449                 if (info->artist.str)
450                     free(info->artist.str);
451                 info->artist = artist;
452                 info->cur_artist_priority = artist_priorities[index];
453             }
454         }
455     }
456     /* TALB, TAL */
457     else if (memcmp(fh->frame_id, "TAL", 3) == 0)
458         _get_id3v2_frame_info(frame_data, frame_size, &info->album, cs_conv, 1);
459     /* TCON, TCO */
460     else if (memcmp(fh->frame_id, "TCO", 3) == 0)
461         _get_id3v2_genre(frame_data, frame_size, &info->genre, cs_conv);
462     else if (memcmp(fh->frame_id, "TRCK", 4) == 0 ||
463              memcmp(fh->frame_id, "TRK", 3) == 0) {
464         struct lms_string_size trackno = {0};
465         _get_id3v2_frame_info(frame_data, frame_size, &trackno, cs_conv, 0);
466         info->trackno = atoi(trackno.str);
467         free(trackno.str);
468     }
469 }
470
471 static int
472 _parse_id3v2(int fd, long id3v2_offset, struct id3_info *info, lms_charset_conv_t **cs_convs)
473 {
474     char header_data[10], frame_header_data[10];
475     unsigned int tag_size, major_version, frame_data_pos, frame_data_length, frame_header_size;
476     int extended_header, footer_present;
477     struct id3v2_frame_header fh;
478     size_t nread;
479
480     lseek(fd, id3v2_offset, SEEK_SET);
481
482     /* parse header */
483     if (read(fd, header_data, ID3V2_HEADER_SIZE) != ID3V2_HEADER_SIZE)
484         return -1;
485
486     tag_size = _to_uint(header_data + 6, 4);
487     if (tag_size == 0)
488         return -1;
489
490     /* parse frames */
491     major_version = header_data[3];
492
493     frame_data_pos = 0;
494     frame_data_length = tag_size;
495
496     /* check for extended header */
497     extended_header = header_data[5] & 0x20; /* bit 6 */
498     if (extended_header) {
499         /* skip extended header */
500         unsigned int extended_header_size;
501         char extended_header_data[4];
502
503         if (read(fd, extended_header_data, 4) != 4)
504             return -1;
505         extended_header_size = _to_uint(extended_header_data, 4);
506         lseek(fd, extended_header_size - 4, SEEK_CUR);
507         frame_data_pos += extended_header_size;
508         frame_data_length -= extended_header_size;
509     }
510
511     footer_present = header_data[5] & 0x8;   /* bit 4 */
512     if (footer_present && frame_data_length > ID3V2_FOOTER_SIZE)
513         frame_data_length -= ID3V2_FOOTER_SIZE;
514
515     frame_header_size = _get_id3v2_frame_header_size(major_version);
516     while (frame_data_pos < frame_data_length - frame_header_size) {
517         nread = read(fd, frame_header_data, frame_header_size);
518         if (nread == 0)
519             break;
520
521         if (nread != frame_header_size)
522             return -1;
523
524         if (frame_header_data[0] == 0)
525             break;
526
527         _parse_id3v2_frame_header(frame_header_data, major_version, &fh);
528         if (!fh.frame_size)
529             break;
530
531         if (!fh.compression &&
532             fh.frame_id[0] == 'T' &&
533             memcmp(fh.frame_id, "TXXX", 4) != 0) {
534             char *frame_data;
535
536             if (fh.data_length_indicator)
537                 lseek(fd, 4, SEEK_CUR);
538
539             frame_data = malloc(sizeof(char) * fh.frame_size);
540             if (read(fd, frame_data, fh.frame_size) != fh.frame_size) {
541                 free(frame_data);
542                 return -1;
543             }
544
545             _parse_id3v2_frame(&fh, frame_data, info, cs_convs);
546             free(frame_data);
547         }
548         else {
549             if (fh.data_length_indicator)
550                 lseek(fd, fh.frame_size + 4, SEEK_CUR);
551             else
552                 lseek(fd, fh.frame_size, SEEK_CUR);
553         }
554
555         frame_data_pos += fh.frame_size + frame_header_size;
556     }
557
558     return 0;
559 }
560
561 static int
562 _parse_id3v1(int fd, struct id3_info *info, lms_charset_conv_t *cs_conv)
563 {
564     struct id3v1_tag tag;
565     if (read(fd, &tag, sizeof(struct id3v1_tag)) == -1)
566         return -1;
567
568     info->title.str = strndup(tag.title, 30);
569     info->title.len = strlen(info->title.str);
570     lms_charset_conv(cs_conv, &info->title.str, &info->title.len);
571     info->artist.str = strndup(tag.artist, 30);
572     info->artist.len = strlen(info->artist.str);
573     lms_charset_conv(cs_conv, &info->artist.str, &info->artist.len);
574     info->album.str = strndup(tag.album, 30);
575     info->album.len = strlen(info->album.str);
576     lms_charset_conv(cs_conv, &info->album.str, &info->album.len);
577     _get_id3v1_genre(tag.genre, &info->genre);
578     if (tag.comments[28] == 0 && tag.comments[29] != 0)
579         info->trackno = (unsigned char) tag.comments[29];
580
581     return 0;
582 }
583
584 static void *
585 _match(struct plugin *p, const char *path, int len, int base)
586 {
587     int i;
588
589     i = lms_which_extension(path, len, _exts, LMS_ARRAY_SIZE(_exts));
590     if (i < 0)
591       return NULL;
592     else
593       return (void*)(i + 1);
594 }
595
596 static int
597 _parse(struct plugin *plugin, struct lms_context *ctxt, const struct lms_file_info *finfo, void *match)
598 {
599     struct id3_info info = {{0}, {0}, {0}, {0}, 0, -1};
600     struct lms_audio_info audio_info = {0, {0}, {0}, {0}, {0}, 0, 0, 0};
601     int r, fd;
602     long id3v2_offset;
603
604     fd = open(finfo->path, O_RDONLY);
605     if (fd < 0) {
606         perror("open");
607         return -1;
608     }
609
610     id3v2_offset = _find_id3v2(fd);
611     if (id3v2_offset >= 0) {
612 #if 0
613         fprintf(stderr, "id3v2 tag found in file %s with offset %ld\n",
614                 finfo->path, id3v2_offset);
615 #endif
616         if (_parse_id3v2(fd, id3v2_offset, &info, plugin->cs_convs) != 0) {
617             r = -2;
618             goto done;
619         }
620     }
621     else {
622         char tag[3];
623 #if 0
624         fprintf(stderr, "id3v2 tag not found in file %s. trying id3v1\n",
625                 finfo->path);
626 #endif
627         /* check for id3v1 tag */
628         if (lseek(fd, -128, SEEK_END) == -1) {
629             r = -3;
630             goto done;
631         }
632
633         if (read(fd, &tag, 3) == -1) {
634             r = -4;
635             goto done;
636         }
637
638         if (memcmp(tag, "TAG", 3) == 0) {
639 #if 0
640             fprintf(stderr, "id3v1 tag found in file %s\n", finfo->path);
641 #endif
642             if (_parse_id3v1(fd, &info, ctxt->cs_conv) != 0) {
643                 r = -5;
644                 goto done;
645             }
646         }
647     }
648
649     if (!info.title.str) {
650         int ext_idx;
651         ext_idx = ((int)match) - 1;
652         info.title.len = finfo->path_len - finfo->base - _exts[ext_idx].len;
653         info.title.str = malloc((info.title.len + 1) * sizeof(char));
654         memcpy(info.title.str, finfo->path + finfo->base, info.title.len);
655         info.title.str[info.title.len] = '\0';
656         lms_charset_conv(ctxt->cs_conv, &info.title.str, &info.title.len);
657     }
658
659 #if 0
660     fprintf(stderr, "file %s info\n", finfo->path);
661     fprintf(stderr, "\ttitle='%s'\n", info.title.str);
662     fprintf(stderr, "\tartist='%s'\n", info.artist.str);
663     fprintf(stderr, "\talbum='%s'\n", info.album.str);
664     fprintf(stderr, "\tgenre='%s'\n", info.genre.str);
665     fprintf(stderr, "\ttrack number='%d'\n", info.trackno);
666 #endif
667
668     audio_info.id = finfo->id;
669     audio_info.title = info.title;
670     audio_info.artist = info.artist;
671     audio_info.album = info.album;
672     audio_info.genre = info.genre;
673     audio_info.trackno = info.trackno;
674     r = lms_db_audio_add(plugin->audio_db, &audio_info);
675
676   done:
677     posix_fadvise(fd, 0, 0, POSIX_FADV_DONTNEED);
678     close(fd);
679
680     if (info.title.str)
681         free(info.title.str);
682     if (info.artist.str)
683         free(info.artist.str);
684     if (info.album.str)
685         free(info.album.str);
686     if (info.genre.str)
687         free(info.genre.str);
688
689     return r;
690 }
691
692 static int
693 _setup(struct plugin *plugin, struct lms_context *ctxt)
694 {
695     int i;
696     const char *id3_encodings[ID3_NUM_ENCODINGS] = {
697         "Latin1",
698         NULL, /* UTF-16 */
699         "UTF-16BE",
700         NULL, /* UTF-8 */
701         "UTF-16LE",
702     };
703
704     plugin->audio_db = lms_db_audio_new(ctxt->db);
705     if (!plugin->audio_db)
706         return -1;
707
708     for (i = 0; i < ID3_NUM_ENCODINGS; ++i) {
709         /* do not create charset conv for UTF-8 encoding */
710         if (!id3_encodings[i]) {
711             plugin->cs_convs[i] = NULL;
712             continue;
713         }
714         plugin->cs_convs[i] = lms_charset_conv_new_full(0, 0);
715         if (!plugin->cs_convs[i])
716             return -1;
717         lms_charset_conv_add(plugin->cs_convs[i], id3_encodings[i]);
718     }
719
720     return 0;
721 }
722
723 static int
724 _start(struct plugin *plugin, struct lms_context *ctxt)
725 {
726     return lms_db_audio_start(plugin->audio_db);
727 }
728
729 static int
730 _finish(struct plugin *plugin, struct lms_context *ctxt)
731 {
732     int i;
733
734     if (plugin->audio_db)
735         lms_db_audio_free(plugin->audio_db);
736
737     for (i = 0; i < ID3_NUM_ENCODINGS; ++i) {
738         if (plugin->cs_convs[i])
739             lms_charset_conv_free(plugin->cs_convs[i]);
740     }
741
742     return 0;
743 }
744
745 static int
746 _close(struct plugin *plugin)
747 {
748     free(plugin);
749     return 0;
750 }
751
752 API struct lms_plugin *
753 lms_plugin_open(void)
754 {
755     struct plugin *plugin;
756
757     plugin = (struct plugin *)malloc(sizeof(*plugin));
758     plugin->plugin.name = _name;
759     plugin->plugin.match = (lms_plugin_match_fn_t)_match;
760     plugin->plugin.parse = (lms_plugin_parse_fn_t)_parse;
761     plugin->plugin.close = (lms_plugin_close_fn_t)_close;
762     plugin->plugin.setup = (lms_plugin_setup_fn_t)_setup;
763     plugin->plugin.start = (lms_plugin_start_fn_t)_start;
764     plugin->plugin.finish = (lms_plugin_finish_fn_t)_finish;
765
766     return (struct lms_plugin *)plugin;
767 }