XSPF - Revision history

DoesItReallyMatter: /* VLC Extensions */ nowiki

2019-02-01T04:36:59Z

VLC Extensions: nowiki

← Older revision		Revision as of 04:36, 1 February 2019
Line 24:		Line 24:
	* track		* track

	The extension format is defined in the namespace <code>xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/"</code>:		The extension format is defined in the namespace <code><nowiki>xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/"</nowiki></code>:
	<syntaxhighlight lang="xml">		<syntaxhighlight lang="xml">
	<playlist version="1" xmlns="http://xspf.org/ns/0/" xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/">		<playlist version="1" xmlns="http://xspf.org/ns/0/" xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/">

DoesItReallyMatter: syntaxhighlight

2019-02-01T04:35:12Z

syntaxhighlight

← Older revision		Revision as of 04:35, 1 February 2019
Line 5:		Line 5:
	== Sample ==		== Sample ==
	A very simple document looks like this:		A very simple document looks like this:
			<syntaxhighlight lang="xml">
	<?xml version="1.0" encoding="UTF-8"?>		<?xml version="1.0" encoding="UTF-8"?>
	<playlist version="1" xmlns="http://xspf.org/ns/0/">		<playlist version="1" xmlns="http://xspf.org/ns/0/">
Line 13:		Line 14:
	</trackList>		</trackList>
	</playlist>		</playlist>
			</syntaxhighlight>

	== Compatibility ==		== Compatibility ==
Line 23:		Line 25:

	The extension format is defined in the namespace <code>xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/"</code>:		The extension format is defined in the namespace <code>xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/"</code>:
			<syntaxhighlight lang="xml">
	<playlist version="1" xmlns="http://xspf.org/ns/0/" xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/">		<playlist version="1" xmlns="http://xspf.org/ns/0/" xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/">
	...		...
Line 29:		Line 32:
	</extension>		</extension>
	</playlist>		</playlist>
			</syntaxhighlight>

	Currently, extensions support the following elements:		Currently, extensions support the following elements:
Line 40:		Line 44:
	=== vlc:node ===		=== vlc:node ===
	This element will be displayed as a node in the playlist. It appears as an extension of the '''playlist''' block (under playlist/extension). Only its name can be specified:		This element will be displayed as a node in the playlist. It appears as an extension of the '''playlist''' block (under playlist/extension). Only its name can be specified:
			<syntaxhighlight lang="xml">
	<vlc:node title="Node title">		<vlc:node title="Node title">
	[list of vlc:item or vlc:node]		[list of vlc:item or vlc:node]
	</vlc:node>		</vlc:node>
			</syntaxhighlight>

	=== vlc:item ===		=== vlc:item ===
	This element represents a playlist item (not a node). It appears as an extension of the '''playlist''' block (under playlist/extension). It contains only a track id (see below, vlc:id):		This element represents a playlist item (not a node). It appears as an extension of the '''playlist''' block (under playlist/extension). It contains only a track id (see below, vlc:id):
			<syntaxhighlight lang="xml">
	<vlc:item tid="42" />		<vlc:item tid="42" />
			</syntaxhighlight>

	=== vlc:id ===		=== vlc:id ===
	This element specifies a track's id. It appears as an extension of the '''track''' block (under playlist/trackList/track/extension).		This element specifies a track's id. It appears as an extension of the '''track''' block (under playlist/trackList/track/extension).
			<syntaxhighlight lang="xml">
	<vlc:id>42</vlc:id>		<vlc:id>42</vlc:id>
			</syntaxhighlight>
	The value of the id corresponds to the value of the attribute tid of vlc:item.		The value of the id corresponds to the value of the attribute tid of vlc:item.
	Note that each vlc:id has to be different, per entry, or it will not show them all.		Note that each vlc:id has to be different, per entry, or it will not show them all.
Line 56:		Line 66:
	=== vlc:option ===		=== vlc:option ===
	This element allows you to add options to the input item. It appears as an extension of the '''track''' block (under playlist/trackList/track/extension).		This element allows you to add options to the input item. It appears as an extension of the '''track''' block (under playlist/trackList/track/extension).
			<syntaxhighlight lang="xml">
	<vlc:option>option-name</vlc:option>		<vlc:option>option-name</vlc:option>
			</syntaxhighlight>
	Or, if the option has a value:		Or, if the option has a value:
			<syntaxhighlight lang="xml">
	<vlc:option>option-name=option-value</vlc:option>		<vlc:option>option-name=option-value</vlc:option>
			</syntaxhighlight>

	=== Example of XSPF with VLC extensions ===		=== Example of XSPF with VLC extensions ===

	Let's summarize these as an example. This one shows passing VLC options per specified entry in the playlist.		Let's summarize these as an example. This one shows passing VLC options per specified entry in the playlist.
			<syntaxhighlight lang="xml">
	<?xml version="1.0" encoding="UTF-8"?>		<?xml version="1.0" encoding="UTF-8"?>
	<playlist version="1" xmlns="http://xspf.org/ns/0/" xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/">		<playlist version="1" xmlns="http://xspf.org/ns/0/" xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/">
Line 91:		Line 105:
	</trackList>		</trackList>
	</playlist>		</playlist>
			</syntaxhighlight>
	Here is an example that shows how you can have it show nested entries within the playlist window:		Here is an example that shows how you can have it show nested entries within the playlist window:
			<syntaxhighlight lang="xml">
	<?xml version="1.0" encoding="UTF-8"?>		<?xml version="1.0" encoding="UTF-8"?>
	<playlist version="1" xmlns="http://xspf.org/ns/0/" xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/">		<playlist version="1" xmlns="http://xspf.org/ns/0/" xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/">
Line 144:		Line 158:
	</extension>		</extension>
	</playlist>		</playlist>
			</syntaxhighlight>

	This playlist example will be displayed as:		This playlist example will be displayed as:

DoesItReallyMatter: {{xiph|XSPF}}

2019-01-23T10:03:47Z

← Older revision		Revision as of 10:03, 23 January 2019
Line 1:		Line 1:
	{{website\|XPSF\|http://www.xspf.org/}}		{{website\|XPSF\|http://www.xspf.org/}}
			{{xiph\|XSPF}}
	'''XSPF''', pronounced "spiff", is a [[playlist]] in [[XML]] format, which is supported by [[Xiph]]. It is a free and open format so can be easily, freely used for sharing playlists.		'''XSPF''', pronounced "spiff", is a [[playlist]] in [[XML]] format, which is supported by [[Xiph]]. It is a free and open format so can be easily, freely used for sharing playlists.

PeterMortensen: /* Compatability */ Spelling (ref. ).

2015-04-26T13:24:16Z

Compatability: Spelling (ref. <http://en.wiktionary.org/wiki/compatability>).

← Older revision		Revision as of 13:24, 26 April 2015
Line 13:		Line 13:
	</playlist>		</playlist>

	== ~~Compatability~~ ==		== Compatibility ==
	{{compat}}		{{compat}}

Rogerdpack: split examples

2011-07-14T15:53:24Z

split examples

@@ Line 60: / Line 60: @@
 === Example of XSPF with VLC extensions ===
 Let's summarize these as an example:
   <?xml version="1.0" encoding="UTF-8"?>
   <playlist version="1" xmlns="http://xspf.org/ns/0/" xmlns:vlc="http://www.videolan.org/vlc/playlist/ns/0/">
@@ Line 89: / Line 121: @@
           </track>
           <track>
               <title>Track 4</title>
               <location>dvd://e:\@1</location>

RogerDPack: /* Unsafe operations */

2010-11-19T12:33:34Z

Unsafe operations

← Older revision		Revision as of 12:33, 19 November 2010
Line 133:		Line 133:
	== Unsafe operations ==		== Unsafe operations ==
	Some operations, like setting volume, setting sout destination, etc. are deemed "unsafe" to be in the playlist, so you'll have to add those settings to the command line instead.		Some operations, like setting volume, setting sout destination, etc. are deemed "unsafe" to be in the playlist, so you'll have to add those settings to the command line instead.
			You'll get the error message:
			'''unsafe option "sout-audio" has been ignored for security reasons)''' or the like.

			http://forum.videolan.org/viewtopic.php?f=14&t=78945

	[[Category:Playlist]]		[[Category:Playlist]]

RogerDPack at 12:32, 19 November 2010

2010-11-19T12:32:16Z

← Older revision		Revision as of 12:32, 19 November 2010
Line 51:		Line 51:
	<vlc:id>42</vlc:id>		<vlc:id>42</vlc:id>
	The value of the id corresponds to the value of the attribute tid of vlc:item.		The value of the id corresponds to the value of the attribute tid of vlc:item.
			Note that each vlc:id has to be different, per entry, or it will not show them all.

	=== vlc:option ===		=== vlc:option ===
Line 88:		Line 89:
	</track>		</track>
	<track>		<track>
			<!-- for playing a DVD, track 1, from seconds 42 to 45, with no audio, equivalent to vlc dvd://e:\@1 --start-time=42 --stop-time=45 --no-audio --my-option=100 -->
	<title>Track 4</title>		<title>Track 4</title>
	<location>dvd://e:\@1</location~~> <!-- for playing a DVD, track 1, for example --~~>		<location>dvd://e:\@1</location>
	<extension application="http://www.videolan.org/vlc/playlist/0">		<extension application="http://www.videolan.org/vlc/playlist/0">
	<vlc:id>3</vlc:id>		<vlc:id>3</vlc:id>
	<vlc:option>my-option=42</vlc:option>		<vlc:option>my-option=100</vlc:option>
	<vlc:option>start-time=42</vlc:option>		<vlc:option>start-time=42</vlc:option>
	<vlc:option>stop-time=45</vlc:option>		<vlc:option>stop-time=45</vlc:option>

RogerDPack at 12:28, 19 November 2010

2010-11-19T12:28:44Z

← Older revision		Revision as of 12:28, 19 November 2010
Line 128:		Line 128:
	* [http://www.xiph.org/ Xiph.org]		* [http://www.xiph.org/ Xiph.org]
	* [http://www.xspf.org/quickstart/ XSPF project website].		* [http://www.xspf.org/quickstart/ XSPF project website].

			== Unsafe operations ==
			Some operations, like setting volume, setting sout destination, etc. are deemed "unsafe" to be in the playlist, so you'll have to add those settings to the command line instead.

	[[Category:Playlist]]		[[Category:Playlist]]

RogerDPack: /* Example of XSPF with VLC extensions */

2010-11-19T12:27:44Z

Example of XSPF with VLC extensions

← Older revision		Revision as of 12:27, 19 November 2010
Line 67:		Line 67:
	<track>		<track>
	<title>Track 1</title>		<title>Track 1</title>
			...
	<extension application="http://www.videolan.org/vlc/playlist/0">		<extension application="http://www.videolan.org/vlc/playlist/0">
	<vlc:id>0</vlc:id>		<vlc:id>0</vlc:id>
	~~<vlc:option>start-time=42</vlc:option>~~
	~~<vlc:option>stop-time=45</vlc:option>~~
	</extension>		</extension>
	~~<location>dvd://e:\@1</location> <!-- for playing a DVD, track 1, for example -->~~
	~~...~~
	</track>		</track>
	<track>		<track>
Line 92:		Line 89:
	<track>		<track>
	<title>Track 4</title>		<title>Track 4</title>
	~~...~~		<location>dvd://e:\@1</location> <!-- for playing a DVD, track 1, for example -->
	<extension application="http://www.videolan.org/vlc/playlist/0">		<extension application="http://www.videolan.org/vlc/playlist/0">
	<vlc:id>3</vlc:id>		<vlc:id>3</vlc:id>
	<vlc:option>my-option=42</vlc:option>		<vlc:option>my-option=42</vlc:option>
			<vlc:option>start-time=42</vlc:option>
			<vlc:option>stop-time=45</vlc:option>
			<vlc:option>no-audio</vlc:option>
	</extension>		</extension>
	</track>		</track>

RogerDPack: more examples-y

2010-11-19T12:18:36Z

more examples-y

← Older revision		Revision as of 12:18, 19 November 2010
Line 67:		Line 67:
	<track>		<track>
	<title>Track 1</title>		<title>Track 1</title>
	~~...~~
	<extension application="http://www.videolan.org/vlc/playlist/0">		<extension application="http://www.videolan.org/vlc/playlist/0">
	<vlc:id>0</vlc:id>		<vlc:id>0</vlc:id>
			<vlc:option>start-time=42</vlc:option>
			<vlc:option>stop-time=45</vlc:option>
	</extension>		</extension>
			<location>dvd://e:\@1</location> <!-- for playing a DVD, track 1, for example -->
			...
	</track>		</track>
	<track>		<track>