Live streaming setup - Revision history

Heerko at 08:51, 3 November 2020

2020-11-03T08:51:14Z

← Older revision		Revision as of 10:51, 3 November 2020
Line 88:		Line 88:
	By default Mux.com creates .m3u8 files that could be played back directly from our site. But you can't download those streams.		By default Mux.com creates .m3u8 files that could be played back directly from our site. But you can't download those streams.

	We have to ask mux.com to create a mp4 file ~~for us~~. To do that you issue the following command:		You have to ask mux.com to create a mp4 file. To do that you issue the following command:

	<code><pre>		<code><pre>

Heerko at 08:50, 3 November 2020

2020-11-03T08:50:27Z

← Older revision		Revision as of 10:50, 3 November 2020
Line 102:		Line 102:
	* ''api_token_secret'' - This is generated when the access token was created. If you don't have it ask Andre or Heerko.		* ''api_token_secret'' - This is generated when the access token was created. If you don't have it ask Andre or Heerko.

	Converting takes a while... When it is ~~down~~, you should be able to download the file in your browser by visting:		Converting takes a while... When it is done, you should be able to download the file in your browser by visting:

	<code>		<code>

Heerko at 08:49, 3 November 2020

2020-11-03T08:49:56Z

← Older revision		Revision as of 10:49, 3 November 2020
Line 84:		Line 84:

	You should then be muting and unmuting speakers regularly on the directors page of the room so that you selectively funnel audio streams into the virtual audio device and eventually out to the livestream. Keep an eye on the "Audio Mixer" window panel in OBS to see what the virtual audio device is outputting. If the device is not visible there, then you are either in the wrong scene or forgot to re-route audio from OBSN.		You should then be muting and unmuting speakers regularly on the directors page of the room so that you selectively funnel audio streams into the virtual audio device and eventually out to the livestream. Keep an eye on the "Audio Mixer" window panel in OBS to see what the virtual audio device is outputting. If the device is not visible there, then you are either in the wrong scene or forgot to re-route audio from OBSN.

			==Retrieving the files==
			By default Mux.com creates .m3u8 files that could be played back directly from our site. But you can't download those streams.

			We have to ask mux.com to create a mp4 file for us. To do that you issue the following command:

			<code><pre>
			curl https://api.mux.com/video/v1/assets/<asset_id>/mp4-support \
			-H "Content-Type: application/json" \
			-X PUT \
			-d '{ "mp4_support": "standard" }' \
			-u <api_access_token>:<access_token_secret>
			</pre></code>

			* ''asset_id'' - You can find on the asset page on mux.com.
			* ''api_access_token'' - also on mux.com, under Settings - Access Tokens.
			* ''api_token_secret'' - This is generated when the access token was created. If you don't have it ask Andre or Heerko.

			Converting takes a while... When it is down, you should be able to download the file in your browser by visting:

			<code>
			https://stream.mux.com/<playback_id>/high.mp4?download=<filename>.mp4
			</code>

			* ''playback_id'' - You can find on the asset page on mux.com<br />
			* ''filename'' - this can be anything

Karl at 10:43, 19 October 2020

2020-10-19T10:43:29Z

← Older revision		Revision as of 12:43, 19 October 2020
Line 57:		Line 57:
	Save both. Send the speaker link to the speaker.		Save both. Send the speaker link to the speaker.

			==OBS Ninja Rooms==
	In the case that you want to invite a speaker to have a conversation, you should consider setting up an OBS Ninja "room".		In the case that you want to invite a speaker to have a conversation, you should consider setting up an OBS Ninja "room".
	Go to https://obs.ninja/; click on add group chat to OBS and give your room a name.		Go to https://obs.ninja/; click on add group chat to OBS and give your room a name.

Karl at 10:38, 19 October 2020

2020-10-19T10:38:24Z

← Older revision		Revision as of 12:38, 19 October 2020
Line 71:		Line 71:
	* Audio: IMPORTANT! The room call should function like a "waiting room" so speakers can prepare and ask questions internally before you take them live. There is a button under each speaker in the director's page that mutes their audio in OBS. Please keep everyone muted until you take them live. They can still hear each other in the call and ask questions, but this won't go through to the public. You can leave all screenshares muted as you are already receiving their audio through the video share.		* Audio: IMPORTANT! The room call should function like a "waiting room" so speakers can prepare and ask questions internally before you take them live. There is a button under each speaker in the director's page that mutes their audio in OBS. Please keep everyone muted until you take them live. They can still hear each other in the call and ask questions, but this won't go through to the public. You can leave all screenshares muted as you are already receiving their audio through the video share.
	* Please ask speakers to join the rooms at least 5 minutes before they go live. Like this, you will have time to test their video, screenshare, and audio, mute them, and import their stream(s) into OBS.		* Please ask speakers to join the rooms at least 5 minutes before they go live. Like this, you will have time to test their video, screenshare, and audio, mute them, and import their stream(s) into OBS.
			* Here is a template for communicating to guest speakers how to participate: https://etherpad.hackersanddesigners.nl/p/livestream-guest-instructions-template

	===On Mac===		===On Mac===

Karl at 10:30, 19 October 2020

2020-10-19T10:30:33Z

← Older revision		Revision as of 12:30, 19 October 2020
Line 67:		Line 67:
	* The preferred browser for everyone to use is Chrome.		* The preferred browser for everyone to use is Chrome.
	* You have several options for importing the room into OBS and live streaming it from there:		* You have several options for importing the room into OBS and live streaming it from there:
	* Importing the entire room as it is with the link: https://obs.ninja/?room=h_d&view ; this will show everyone at all times; not the most desirable option.		** Importing the entire room as it is with the link: https://obs.ninja/?room=h_d&view ; this will show everyone at all times; not the most desirable option.
	* Importing individual speakers videos and screens with the links that appear under them in the room; this is much more desirable because you can then construct scenes in OBS with different video / screenshare streams. For instance, you can share a speakers screen and also their video in one scene; and after their talk you can transition to a scene where it is only their video stream and video stream from H&D so they can have a Q&A. (please contact Karl if you want templates for speaker alone, speaker and screen, speaker and speaker, etc...)		** Importing individual speakers videos and screens with the links that appear under them in the room; this is much more desirable because you can then construct scenes in OBS with different video / screenshare streams. For instance, you can share a speakers screen and also their video in one scene; and after their talk you can transition to a scene where it is only their video stream and video stream from H&D so they can have a Q&A. (please contact Karl if you want templates for speaker alone, speaker and screen, speaker and speaker, etc...)
	* Audio: IMPORTANT! The room call should function like a "waiting room" so speakers can prepare and ask questions internally before you take them live. There is a button under each speaker in the director's page that mutes their audio in OBS. Please keep everyone muted until you take them live. They can still hear each other in the call and ask questions, but this won't go through to the public. You can leave all screenshares muted as you are already receiving their audio through the video share.		* Audio: IMPORTANT! The room call should function like a "waiting room" so speakers can prepare and ask questions internally before you take them live. There is a button under each speaker in the director's page that mutes their audio in OBS. Please keep everyone muted until you take them live. They can still hear each other in the call and ask questions, but this won't go through to the public. You can leave all screenshares muted as you are already receiving their audio through the video share.
	* Please ask speakers to join the rooms at least 5 minutes before they go live. Like this, you will have time to test their video, screenshare, and audio, mute them, and import their stream(s) into OBS.		* Please ask speakers to join the rooms at least 5 minutes before they go live. Like this, you will have time to test their video, screenshare, and audio, mute them, and import their stream(s) into OBS.

Karl at 10:29, 19 October 2020

2020-10-19T10:29:24Z

← Older revision		Revision as of 12:29, 19 October 2020
Line 67:		Line 67:
	* The preferred browser for everyone to use is Chrome.		* The preferred browser for everyone to use is Chrome.
	* You have several options for importing the room into OBS and live streaming it from there:		* You have several options for importing the room into OBS and live streaming it from there:
	* Importing the entire room as it is with the link: https://obs.ninja/?room=h_d&view ; this will show everyone at all times; not the most desirable option.		* Importing the entire room as it is with the link: https://obs.ninja/?room=h_d&view ; this will show everyone at all times; not the most desirable option.
	* Importing individual speakers videos and screens with the links that appear under them in the room; this is much more desirable because you can then construct scenes in OBS with different video / screenshare streams. For instance, you can share a speakers screen and also their video in one scene; and after their talk you can transition to a scene where it is only their video stream and video stream from H&D so they can have a Q&A. (please contact Karl if you want templates for speaker alone, speaker and screen, speaker and speaker, etc...)		* Importing individual speakers videos and screens with the links that appear under them in the room; this is much more desirable because you can then construct scenes in OBS with different video / screenshare streams. For instance, you can share a speakers screen and also their video in one scene; and after their talk you can transition to a scene where it is only their video stream and video stream from H&D so they can have a Q&A. (please contact Karl if you want templates for speaker alone, speaker and screen, speaker and speaker, etc...)
	* Audio: IMPORTANT! The room call should function like a "waiting room" so speakers can prepare and ask questions internally before you take them live. There is a button under each speaker in the director's page that mutes their audio in OBS. Please keep everyone muted until you take them live. They can still hear each other in the call and ask questions, but this won't go through to the public. You can leave all screenshares muted as you are already receiving their audio through the video share.		* Audio: IMPORTANT! The room call should function like a "waiting room" so speakers can prepare and ask questions internally before you take them live. There is a button under each speaker in the director's page that mutes their audio in OBS. Please keep everyone muted until you take them live. They can still hear each other in the call and ask questions, but this won't go through to the public. You can leave all screenshares muted as you are already receiving their audio through the video share.
	* Please ask speakers to join the rooms at least 5 minutes before they go live. Like this, you will have time to test their video, screenshare, and audio, mute them, and import their stream(s) into OBS.		* Please ask speakers to join the rooms at least 5 minutes before they go live. Like this, you will have time to test their video, screenshare, and audio, mute them, and import their stream(s) into OBS.

Karl at 10:26, 19 October 2020

2020-10-19T10:26:00Z

@@ Line 56: / Line 56: @@
 Save both. Send the speaker link to the speaker.
 ===On Mac===
@@ Line 61: / Line 76: @@
 The browser source in OBS can't capture the OBS.Ninja audio. As a work around we use the OBS.Ninja app.
 There's a really good explanation on how to set it up on their github: https://github.com/steveseguin/electroncapture

Heerko at 07:07, 12 October 2020

2020-10-12T07:07:16Z

← Older revision		Revision as of 09:07, 12 October 2020
Line 30:		Line 30:

	Then:<br>		Then:<br>
	* <code>rm .data/stream</code>		* <code>rm /var/www/live/.data/stream</code>
	then restart the server:		then restart the server:
	* <code>npm run start</code>		* <code>npm run start</code>

Heerko at 20:40, 11 October 2020

2020-10-11T20:40:51Z

← Older revision		Revision as of 22:40, 11 October 2020
Line 26:		Line 26:
	'''Copy the Stream Key.'''		'''Copy the Stream Key.'''

	If you are having problems with the stream key you can force the server to create a new key by deleting the cache:<br>		If you are having problems with the stream key you can force the server to create a new key by deleting the cache.<br>
	Quit the server, if running, by pressing [ctrl]+[c].~~<br>~~		Quit the server (if running) by pressing [ctrl]+[c].

	Then:<br>		Then:<br>
	* <code>rm .data/stream</code>		* <code>rm .data/stream</code>
Line 48:		Line 49:
	To get a speaker in the stream we use OBS Ninja: https://obs.ninja/		To get a speaker in the stream we use OBS Ninja: https://obs.ninja/

	Click on 'Create reusable invite', use the speaker's name a the name and click the 'generate the invite link' button.		Click on 'Create reusable invite', use the speaker's name as the name and click the 'generate the invite link' button.

	The next screen gives you two links:		The next screen gives you two links: