1 /******************************************************************************
2 * xspf.c : XSPF playlist export functions
3 ******************************************************************************
4 * Copyright (C) 2006 the VideoLAN team
7 * Authors: Daniel Stränger <vlc at schmaller dot de>
8 * Yoann Peronneau <yoann@videolan.org>
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 2 of the License, or
13 * (at your option) any later version.
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software
22 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301, USA.
23 *******************************************************************************/
26 * \file modules/misc/playlist/xspf.c
27 * \brief XSPF playlist export functions
33 #include "vlc_strings.h"
37 * \brief Prints the XSPF header to file, writes each item by xspf_export_item()
38 * and closes the open xml elements
39 * \param p_this the VLC playlist object
40 * \return VLC_SUCCESS if some memory is available, otherwise VLC_ENONMEM
42 int E_(xspf_export_playlist)( vlc_object_t *p_this )
44 const playlist_t *p_playlist = (playlist_t *)p_this;
45 const playlist_export_t *p_export =
46 (playlist_export_t *)p_playlist->p_private;
48 playlist_item_t *p_node = p_export->p_root;
50 /* write XSPF XML header */
51 fprintf( p_export->p_file, "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" );
52 fprintf( p_export->p_file,
53 "<playlist version=\"1\" xmlns=\"http://xspf.org/ns/0/\">\n" );
55 if( !p_node ) return VLC_SUCCESS;
57 /* export all items in a flat format */
58 fprintf( p_export->p_file, "\t<trackList>\n" );
60 for( i = 0; i < p_node->i_children; i++ )
62 xspf_export_item( p_node->pp_children[i], p_export->p_file,
65 fprintf( p_export->p_file, "\t</trackList>\n" );
67 /* export the tree structure in <extension> */
68 fprintf( p_export->p_file, "\t<extension>\n" );
70 for( i = 0; i < p_node->i_children; i++ )
72 xspf_extension_item( p_node->pp_children[i], p_export->p_file,
75 fprintf( p_export->p_file, "\t</extension>\n" );
77 /* close the header elements */
78 fprintf( p_export->p_file, "</playlist>\n" );
84 * \brief exports one item to file or traverse if item is a node
85 * \param p_item playlist item to export
86 * \param p_file file to write xml-converted item to
87 * \param p_i_count counter for track identifiers
89 static void xspf_export_item( playlist_item_t *p_item, FILE *p_file,
97 /* if we get a node here, we must traverse it */
98 if( p_item->i_children > 0 )
101 for( i = 0; i < p_item->i_children; i++ )
103 xspf_export_item( p_item->pp_children[i], p_file, p_i_count );
108 /* leaves can be written directly */
109 fprintf( p_file, "\t\t<track>\n" );
111 /* print identifier and increase the counter */
112 fprintf( p_file, "\t\t\t<identifier>%d</identifier>\n", *p_i_count );
115 /* -> the location */
116 if( p_item->p_input->psz_uri && *p_item->p_input->psz_uri )
118 psz = assertUTF8URI( p_item->p_input->psz_uri );
119 fprintf( p_file, "\t\t\t<location>%s</location>\n", psz );
123 /* -> the name/title (only if different from uri)*/
124 if( p_item->p_input->psz_name &&
125 p_item->p_input->psz_uri &&
126 strcmp( p_item->p_input->psz_uri, p_item->p_input->psz_name ) )
128 psz_temp = convert_xml_special_chars( p_item->p_input->psz_name );
130 fprintf( p_file, "\t\t\t<title>%s</title>\n", psz_temp );
134 if( p_item->p_input->p_meta == NULL )
136 goto xspfexportitem_end;
139 /* -> the artist/creator */
140 psz = p_item->p_input->p_meta->psz_artist ?
141 strdup( p_item->p_input->p_meta->psz_artist ):
150 psz = p_item->p_input->p_meta->psz_author ?
151 strdup( p_item->p_input->p_meta->psz_author ):
154 psz_temp = convert_xml_special_chars( psz );
155 if( psz ) free( psz );
158 fprintf( p_file, "\t\t\t<creator>%s</creator>\n", psz_temp );
163 psz = p_item->p_input->p_meta->psz_album ?
164 strdup( p_item->p_input->p_meta->psz_album ):
166 psz_temp = convert_xml_special_chars( psz );
167 if( psz ) free( psz );
170 fprintf( p_file, "\t\t\t<album>%s</album>\n", psz_temp );
174 /* -> the track number */
175 psz = p_item->p_input->p_meta->psz_tracknum ?
176 strdup( p_item->p_input->p_meta->psz_tracknum ):
182 fprintf( p_file, "\t\t\t<trackNum>%i</trackNum>\n", atoi( psz ) );
188 /* -> the duration */
189 if( p_item->p_input->i_duration > 0 )
191 fprintf( p_file, "\t\t\t<duration>%ld</duration>\n",
192 (long)(p_item->p_input->i_duration / 1000) );
195 fprintf( p_file, "\t\t</track>\n" );
201 * \brief exports one item in extension to file and traverse if item is a node
202 * \param p_item playlist item to export
203 * \param p_file file to write xml-converted item to
204 * \param p_i_count counter for track identifiers
206 static void xspf_extension_item( playlist_item_t *p_item, FILE *p_file,
209 if( !p_item ) return;
211 /* if we get a node here, we must traverse it */
212 if( p_item->i_children > 0 )
216 fprintf( p_file, "\t\t<node>\n" );
217 fprintf( p_file, "\t\t\t<title>%s</title>\n",
218 p_item->p_input->psz_name );
220 for( i = 0; i < p_item->i_children; i++ )
222 xspf_extension_item( p_item->pp_children[i], p_file, p_i_count );
225 fprintf( p_file, "\t\t</node>\n" );
230 /* print leaf and increase the counter */
231 fprintf( p_file, "\t\t\t<item href=\"%d\" />\n", *p_i_count );
238 * \param psz_name the location of the media ressource (e.g. local file,
239 * device, network stream, etc.)
240 * \return a new char buffer which asserts that the location is valid UTF-8
242 * \note the returned buffer must be freed, when it isn't used anymore
244 static char *assertUTF8URI( char *psz_name )
246 char *psz_ret = NULL; /**< the new result buffer to return */
247 char *psz_s = NULL, *psz_d = NULL; /**< src & dest pointers for URI conversion */
248 vlc_bool_t b_name_is_uri = VLC_FALSE;
250 if( !psz_name || !*psz_name )
253 /* check that string is valid UTF-8 */
254 /* XXX: Why do we even need to do that ? (all strings in core are UTF-8 encoded */
255 if( !( psz_s = EnsureUTF8( psz_name ) ) )
258 /* max. 3x for URI conversion (percent escaping) and
259 8 bytes for "file://" and NULL-termination */
260 psz_ret = (char *)malloc( sizeof(char)*strlen(psz_name)*6*3+8 );
264 /** \todo check for a valid scheme part preceding the colon */
265 if( strchr( psz_s, ':' ) )
268 b_name_is_uri = VLC_TRUE;
270 /* assume "file" scheme if no scheme-part is included */
273 strcpy( psz_ret, "file://" );
279 /* percent-encode all non-ASCII and the XML special characters and the percent sign itself */
280 if( *psz_s & B10000000 ||
285 ( *psz_s == '%' && !b_name_is_uri ) )
288 *psz_d++ = hexchars[(*psz_s >> 4) & B00001111];
289 *psz_d++ = hexchars[*psz_s & B00001111];
300 return (char *)realloc( psz_ret, sizeof(char)*strlen( psz_ret ) + 1 );