Documentation:Streaming HowTo/Streaming for the iPhone - Revision history

DoesItReallyMatter: Format

2019-05-16T03:45:36Z

Format

← Older revision		Revision as of 03:45, 16 May 2019
Line 40:		Line 40:

	index-url=		index-url=
	*This is the URL that corresponds to the dst above (how a browser would access the dst file). The # characters get replaced same as in the dst parameter. Note: The filename portion of this URL will most likely need to be in the exact same format as the dst parameter. So for example if dst=/www/seg-##.ts then the index-url should be something like index-url=http://mydomain.com/streams/seg-##.ts (Note the same number of # characters)		*This is the URL that corresponds to the dst above (how a browser would access the dst file). The # characters get replaced same as in the dst parameter. Note: The filename portion of this URL will most likely need to be in the exact same format as the dst parameter. So for example if dst=/www/seg-##.ts then the index-url should be something like <code><nowiki>index-url=http://mydomain.com/streams/seg-##.ts</nowiki></code> (Note the same number of # characters)

	ratecontrol=(default: false)		ratecontrol=(default: false)
Line 50:		Line 50:
	*The Web Server root directory is /var/www		*The Web Server root directory is /var/www
	*The domain name of the web server is mydomain.com		*The domain name of the web server is mydomain.com
	*The stream segments & index files will be written into /var/www/streaming/ and will be accessed via http://mydomain.com/streaming/~~...~~		*The stream segments & index files will be written into /var/www/streaming/ and will be accessed via <code><nowiki>http://mydomain.com/streaming/</nowiki></code>…
	*The destination stream name index file will be called "mystream.m3u8"		*The destination stream name index file will be called "mystream.m3u8"
	*The following HTML will allow you to view the video based on the above on an iPhone:		*The following HTML will allow you to view the video based on the above on an iPhone:
Line 56:		Line 56:

	Re-stream a live video feed:		Re-stream a live video feed:
	% '''vlc -I dummy --mms-caching 0 http://www.nasa.gov/55644main_NASATV_Windows.asx vlc://quit --sout='#transcode{width=320,height=240,fps=25,vcodec=h264,vb=256,venc=x264{aud,profile=baseline,level=30,keyint=30,ref=1},acodec=mp3,ab=96}:std{access=livehttp{seglen=10,delsegs=true,numsegs=5,index=/var/www/streaming/mystream.m3u8,index-url=http://mydomain.com/streaming/mystream-########.ts},mux=ts{use-key-frames},dst=/var/www/streaming/mystream-########.ts}' '''		{{%}} '''<nowiki>vlc -I dummy --mms-caching 0 http://www.nasa.gov/55644main_NASATV_Windows.asx vlc://quit --sout='#transcode{width=320,height=240,fps=25,vcodec=h264,vb=256,venc=x264{aud,profile=baseline,level=30,keyint=30,ref=1},acodec=mp3,ab=96}:std{access=livehttp{seglen=10,delsegs=true,numsegs=5,index=/var/www/streaming/mystream.m3u8,index-url=http://mydomain.com/streaming/mystream-########.ts},mux=ts{use-key-frames},dst=/var/www/streaming/mystream-########.ts}'</nowiki>'''

	Create a VOD stream:		Create a VOD stream:
	(Non-live. When this command finishes, all the segments should have been created and the index file contain pointers to all of them)		(Non-live. When this command finishes, all the segments should have been created and the index file contain pointers to all of them)
	% '''vlc -I dummy /var/myvideos/video.mpg vlc://quit --sout='#transcode{width=320,height=240,fps=25,vcodec=h264,vb=256,venc=x264{aud,profile=baseline,level=30,keyint=30,ref=1},acodec=mp3,ab=96}:std{access=livehttp{seglen=10,delsegs=false,numsegs=0,index=/var/www/streaming/mystream.m3u8,index-url=http://mydomain.com/streaming/mystream-########.ts},mux=ts{use-key-frames},dst=/var/www/streaming/mystream-########.ts}' '''		% '''<nowiki>vlc -I dummy /var/myvideos/video.mpg vlc://quit --sout='#transcode{width=320,height=240,fps=25,vcodec=h264,vb=256,venc=x264{aud,profile=baseline,level=30,keyint=30,ref=1},acodec=mp3,ab=96}:std{access=livehttp{seglen=10,delsegs=false,numsegs=0,index=/var/www/streaming/mystream.m3u8,index-url=http://mydomain.com/streaming/mystream-########.ts},mux=ts{use-key-frames},dst=/var/www/streaming/mystream-########.ts}'</nowiki>'''

	Re-stream a live audio feed:		Re-stream a live audio feed:
	% '''vlc -I dummy --mms-caching 0 http://www.nasa.gov/55644main_NASATV_Windows.asx vlc://quit --sout='#transcode{acodec=mp3,ab=96}:duplicate{dst=std{access=livehttp{seglen=10,delsegs=true,numsegs=5,index=/var/www/streaming/mystream.m3u8,index-url=http://mydomain.com/streaming/mystream-########.mp3},mux=raw,dst=/var/www/streaming/mystream-########.mp3},select=audio}' '''		% '''<nowiki>vlc -I dummy --mms-caching 0 http://www.nasa.gov/55644main_NASATV_Windows.asx vlc://quit --sout='#transcode{acodec=mp3,ab=96}:duplicate{dst=std{access=livehttp{seglen=10,delsegs=true,numsegs=5,index=/var/www/streaming/mystream.m3u8,index-url=http://mydomain.com/streaming/mystream-########.mp3},mux=raw,dst=/var/www/streaming/mystream-########.mp3},select=audio}'</nowiki>'''

	'''Note:''' I found that these example don't work as written here; I won't edit them in place as they might work in different circumstances. I found two problems using the released version of VLC 2.0.0 on WinXP:		'''Note:''' I found that these example don't work as written here; I won't edit them in place as they might work in different circumstances. I found two problems using the released version of VLC 2.0.0 on WinXP:

	1. All examples need to have the single quotes surrounding the --sout parameter removed. Otherwise VLC complains "stream_out_standard stream out error: no mux specified or found by extension".		# All examples need to have the single quotes surrounding the --sout parameter removed. Otherwise VLC complains "stream_out_standard stream out error: no mux specified or found by extension".
			# The final example is audio-only, but does not specify the splitanywhere=true flag. As a result it writes one massive chunk waiting for a keyframe that never comes.
	2. The final example is audio-only, but does not specify the splitanywhere=true flag. As a result it writes one massive chunk waiting for a keyframe that never comes.

	Example commandline that did work for me:		Example commandline that did work for me:
	% vlc -I dummy x:\some\audio\here.ogg vlc://quit --sout=#transcode{acodec=mp3,ab=96}:duplicate{dst=std{access=livehttp{seglen=10,splitanywhere=true,delsegs=true,numsegs=5,index=c:\temp\mystream.m3u8,index-url=http://mydomain.com/streaming/mystream-########.mp3},mux=raw,dst=c:\temp\mystream-########.mp3},select=audio}		% <nowiki>vlc -I dummy x:\some\audio\here.ogg vlc://quit --sout=#transcode{acodec=mp3,ab=96}:duplicate{dst=std{access=livehttp{seglen=10,splitanywhere=true,delsegs=true,numsegs=5,index=c:\temp\mystream.m3u8,index-url=http://mydomain.com/streaming/mystream-########.mp3},mux=raw,dst=c:\temp\mystream-########.mp3},select=audio}</nowiki>

	[[User:Smowton\|Smowton]] 03:23, 27 February 2012 (CET)		[[User:Smowton\|Smowton]] 03:23, 27 February 2012 (CET)

DoesItReallyMatter: /* Possible improvements/fixes */ Claim about Linux is true

2019-03-18T07:45:21Z

Possible improvements/fixes: Claim about Linux is true

← Older revision		Revision as of 07:45, 18 March 2019
Line 83:		Line 83:
	from the developer:		from the developer:
	*Have the module auto-detect audio only streams, so the splitanywhere option is not required.		*Have the module auto-detect audio only streams, so the splitanywhere option is not required.
	*I'm not sure I am doing the right thing with the Win32 rename function. Linux ~~(I believe)~~ allows me to rename a file over an existing file, even if the existing file is in use. Win32 is not so friendly. This ability is useful for updating the index file at same time it may be currently being read by the HTTP server serving the files.		*I'm not sure I am doing the right thing with the Win32 rename function. Linux allows me to rename a file over an existing file, even if the existing file is in use. Win32 is not so friendly. This ability is useful for updating the index file at same time it may be currently being read by the HTTP server serving the files.
	*Break the dst= and index= parameter into seperate filename/directory entries, so you only need to specify the filename format once. (instead of once for the dst= parameter, and once for the index-url= parameter)		*Break the dst= and index= parameter into seperate filename/directory entries, so you only need to specify the filename format once. (instead of once for the dst= parameter, and once for the index-url= parameter)

DoesItReallyMatter: +:Category:iOS

2019-02-06T05:14:50Z

+Category:iOS

← Older revision		Revision as of 05:14, 6 February 2019
Line 94:		Line 94:

	{{Documentation}}		{{Documentation}}

			[[Category:iOS]]

Schou: /* Examples */ Adding a link to demo an HLS stream

2014-12-16T03:22:38Z

Examples: Adding a link to demo an HLS stream

← Older revision		Revision as of 03:22, 16 December 2014
Line 46:		Line 46:

	=== Examples ===		=== Examples ===
			[[File:FishCam.jpg\|thumb\|right\|alt=An HLS live feed from a camera pointed at a fish tank with multiple stream encoding qualities\|HLS Live Stream Example: Schou FishCam http://fish.schou.me]]
	All examples assume the following:		All examples assume the following:
	*The Web Server root directory is /var/www		*The Web Server root directory is /var/www

Edwardw at 23:10, 13 November 2012

2012-11-13T23:10:33Z

← Older revision		Revision as of 23:10, 13 November 2012
Line 1:		Line 1:
	{{RightMenu\|documentation streaming howto toc}}		{{RightMenu\|documentation streaming howto toc}}

	~~Note: this functionality is intended to be part of the 1.2 release, so at the time of writing it is only available in nightly builds.~~

	== Streaming for the iPhone ==		== Streaming for the iPhone ==

Smowton at 02:31, 27 February 2012

2012-02-27T02:31:18Z

← Older revision		Revision as of 02:31, 27 February 2012
Line 66:		Line 66:
	% '''vlc -I dummy --mms-caching 0 http://www.nasa.gov/55644main_NASATV_Windows.asx vlc://quit --sout='#transcode{acodec=mp3,ab=96}:duplicate{dst=std{access=livehttp{seglen=10,delsegs=true,numsegs=5,index=/var/www/streaming/mystream.m3u8,index-url=http://mydomain.com/streaming/mystream-########.mp3},mux=raw,dst=/var/www/streaming/mystream-########.mp3},select=audio}' '''		% '''vlc -I dummy --mms-caching 0 http://www.nasa.gov/55644main_NASATV_Windows.asx vlc://quit --sout='#transcode{acodec=mp3,ab=96}:duplicate{dst=std{access=livehttp{seglen=10,delsegs=true,numsegs=5,index=/var/www/streaming/mystream.m3u8,index-url=http://mydomain.com/streaming/mystream-########.mp3},mux=raw,dst=/var/www/streaming/mystream-########.mp3},select=audio}' '''

	'''Note:''' I found that these example don't work as written here~~, but~~ need to have the single quotes surrounding the --sout parameter removed. Otherwise VLC complains "stream_out_standard stream out error: no mux specified or found by extension". ~~This was using the released version of VLC~~ 2.0.~~0 on WinXP~~.		'''Note:''' I found that these example don't work as written here; I won't edit them in place as they might work in different circumstances. I found two problems using the released version of VLC 2.0.0 on WinXP:

			1. All examples need to have the single quotes surrounding the --sout parameter removed. Otherwise VLC complains "stream_out_standard stream out error: no mux specified or found by extension".

			2. The final example is audio-only, but does not specify the splitanywhere=true flag. As a result it writes one massive chunk waiting for a keyframe that never comes.

	Example commandline that did work for me:		Example commandline that did work for me:
	% vlc -I dummy x:\some\audio\here.ogg vlc://quit --sout=#transcode{acodec=mp3,ab=96}:duplicate{dst=std{access=livehttp{seglen=10,delsegs=true,numsegs=5,index=c:\temp\mystream.m3u8,index-url=http://mydomain.com/streaming/mystream-########.mp3},mux=raw,dst=c:\temp\mystream-########.mp3},select=audio}		% vlc -I dummy x:\some\audio\here.ogg vlc://quit --sout=#transcode{acodec=mp3,ab=96}:duplicate{dst=std{access=livehttp{seglen=10,splitanywhere=true,delsegs=true,numsegs=5,index=c:\temp\mystream.m3u8,index-url=http://mydomain.com/streaming/mystream-########.mp3},mux=raw,dst=c:\temp\mystream-########.mp3},select=audio}

	[[User:Smowton\|Smowton]] 03:23, 27 February 2012 (CET)		[[User:Smowton\|Smowton]] 03:23, 27 February 2012 (CET)

Smowton: Note possible error in documented command-line

2012-02-27T02:23:28Z

Note possible error in documented command-line

← Older revision		Revision as of 02:23, 27 February 2012
Line 65:		Line 65:
	Re-stream a live audio feed:		Re-stream a live audio feed:
	% '''vlc -I dummy --mms-caching 0 http://www.nasa.gov/55644main_NASATV_Windows.asx vlc://quit --sout='#transcode{acodec=mp3,ab=96}:duplicate{dst=std{access=livehttp{seglen=10,delsegs=true,numsegs=5,index=/var/www/streaming/mystream.m3u8,index-url=http://mydomain.com/streaming/mystream-########.mp3},mux=raw,dst=/var/www/streaming/mystream-########.mp3},select=audio}' '''		% '''vlc -I dummy --mms-caching 0 http://www.nasa.gov/55644main_NASATV_Windows.asx vlc://quit --sout='#transcode{acodec=mp3,ab=96}:duplicate{dst=std{access=livehttp{seglen=10,delsegs=true,numsegs=5,index=/var/www/streaming/mystream.m3u8,index-url=http://mydomain.com/streaming/mystream-########.mp3},mux=raw,dst=/var/www/streaming/mystream-########.mp3},select=audio}' '''

			'''Note:''' I found that these example don't work as written here, but need to have the single quotes surrounding the --sout parameter removed. Otherwise VLC complains "stream_out_standard stream out error: no mux specified or found by extension". This was using the released version of VLC 2.0.0 on WinXP.

			Example commandline that did work for me:
			% vlc -I dummy x:\some\audio\here.ogg vlc://quit --sout=#transcode{acodec=mp3,ab=96}:duplicate{dst=std{access=livehttp{seglen=10,delsegs=true,numsegs=5,index=c:\temp\mystream.m3u8,index-url=http://mydomain.com/streaming/mystream-########.mp3},mux=raw,dst=c:\temp\mystream-########.mp3},select=audio}

			[[User:Smowton\|Smowton]] 03:23, 27 February 2012 (CET)

	===Formats supported by the iOS===		===Formats supported by the iOS===

J-b: Reverted edits by ClairPeak (Talk) to last revision by Shahbaz

2011-09-28T09:10:15Z

Reverted edits by ClairPeak (Talk) to last revision by Shahbaz

← Older revision		Revision as of 09:10, 28 September 2011
Line 68:		Line 68:
	===Formats supported by the iOS===		===Formats supported by the iOS===
	See the [[iPhone]] article for a list of supported codecs as well as [http://developer.apple.com/iphone/library/documentation/networkinginternet/conceptual/streamingmediaguide/FrequentlyAskedQuestions/FrequentlyAskedQuestions.html Apple's HTTP Live Streaming FAQ].		See the [[iPhone]] article for a list of supported codecs as well as [http://developer.apple.com/iphone/library/documentation/networkinginternet/conceptual/streamingmediaguide/FrequentlyAskedQuestions/FrequentlyAskedQuestions.html Apple's HTTP Live Streaming FAQ].
	~~[http://www.708buy.com/deal/ipad-2-sleeve ipad 2 sleeve] - Apple Accessories Website~~

	===Possible improvements/fixes===		===Possible improvements/fixes===

ClairPeak: /* Formats supported by the iOS */

2011-09-28T06:48:31Z

Formats supported by the iOS

← Older revision		Revision as of 06:48, 28 September 2011
Line 68:		Line 68:
	===Formats supported by the iOS===		===Formats supported by the iOS===
	See the [[iPhone]] article for a list of supported codecs as well as [http://developer.apple.com/iphone/library/documentation/networkinginternet/conceptual/streamingmediaguide/FrequentlyAskedQuestions/FrequentlyAskedQuestions.html Apple's HTTP Live Streaming FAQ].		See the [[iPhone]] article for a list of supported codecs as well as [http://developer.apple.com/iphone/library/documentation/networkinginternet/conceptual/streamingmediaguide/FrequentlyAskedQuestions/FrequentlyAskedQuestions.html Apple's HTTP Live Streaming FAQ].
			[http://www.708buy.com/deal/ipad-2-sleeve ipad 2 sleeve] - Apple Accessories Website

	===Possible improvements/fixes===		===Possible improvements/fixes===

Shahbaz: /* Options */

2011-07-07T10:56:40Z

Options

← Older revision		Revision as of 10:56, 7 July 2011
Line 44:		Line 44:
	*This is the URL that corresponds to the dst above (how a browser would access the dst file). The # characters get replaced same as in the dst parameter. Note: The filename portion of this URL will most likely need to be in the exact same format as the dst parameter. So for example if dst=/www/seg-##.ts then the index-url should be something like index-url=http://mydomain.com/streams/seg-##.ts (Note the same number of # characters)		*This is the URL that corresponds to the dst above (how a browser would access the dst file). The # characters get replaced same as in the dst parameter. Note: The filename portion of this URL will most likely need to be in the exact same format as the dst parameter. So for example if dst=/www/seg-##.ts then the index-url should be something like index-url=http://mydomain.com/streams/seg-##.ts (Note the same number of # characters)

	~~rate-control~~=(default: false)		ratecontrol=(default: false)
	*If set to false the there is no rate control (the muxer sends the data as fast/slow as it can to the streamer). If set to true the muxer should do rate-control to control the speed to muxed audio/video is sent to the streamer. ~~I'm a little unsure what the "best"~~ setting ~~for this parameter~~ is ~~when re-streaming an existing video stream~~. I've ~~been leaving it at false..~~.		*If set to false the there is no rate control (the muxer sends the data as fast/slow as it can to the streamer). If set to true the muxer should do rate-control to control the speed to muxed audio/video is sent to the streamer. Recommended setting is false in most cases. The only time I've needed this set to true is while doing a live sliding window stream of a local media file.

	=== Examples ===		=== Examples ===