summaryrefslogtreecommitdiffstats
path: root/playbook.md
diff options
context:
space:
mode:
authorSacha Chua <sacha@sachachua.com>2021-11-20 19:56:46 -0500
committerSacha Chua <sacha@sachachua.com>2021-11-20 19:56:46 -0500
commitfd4aa97b1f39cc0d696e382b66f01cc6bc6f9d1e (patch)
tree0040faf807828e318a0d3e52bc5d5b713fbfeaca /playbook.md
parent7b87af6111e8c4ddf8ca6a9c9ff12f067f7cb705 (diff)
downloademacsconf-wiki-fd4aa97b1f39cc0d696e382b66f01cc6bc6f9d1e.tar.xz
emacsconf-wiki-fd4aa97b1f39cc0d696e382b66f01cc6bc6f9d1e.zip
Update playbook for restreaming
Diffstat (limited to 'playbook.md')
-rw-r--r--playbook.md160
1 files changed, 86 insertions, 74 deletions
diff --git a/playbook.md b/playbook.md
index b8acb94a..9a509c39 100644
--- a/playbook.md
+++ b/playbook.md
@@ -56,7 +56,7 @@
<tr>
<td class="org-left">${stream-status}</td>
-<td class="org-left"><a href="file://ssh:live:/var/www/html/index.html">file://ssh:live:/var/www/html/index.html</a></td>
+<td class="org-left"><a href="file://ssh:front:/var/www/live.emacsconf.org/index.html">file://ssh:front:/var/www/live.emacsconf.org/index.html</a></td>
</tr>
@@ -73,6 +73,12 @@
<tr>
+<td class="org-left">${playbook}</td>
+<td class="org-left">playbook.org shared over CRDT</td>
+</tr>
+
+
+<tr>
<td class="org-left">${dump}</td>
<td class="org-left"><a href="file://ssh:live:/data/">file://ssh:live:/data/</a></td>
</tr>
@@ -88,14 +94,23 @@
# Pre-conference dry run
-- [ ] [Start streaming](#org653abcb)
-- [ ] [Check in a speaker](#org3e96be5)
+- - DONE Working together via upcoming.org
+ - DONE Streaming [main.webm](https://live0.emacsconf.org/main.webm)
+ - DONE Streaming [main-480p.webm](https://live0.emacsconf.org/main-480p.webm")
+ - CXLD Streaming [alt.webm](https://live0.emacsconf.org/alt.webm")
+ - Doesn’t really work for corwin because of some weird setting problem
+ - STRT Streaming to YouTube
+
+- [X] [Start streaming](#org0bb33b4)
+ - Ugh, need to figure out ffmpeg for streaming
+- [ ] [Check in a speaker](#orgd6f46ac)
- [ ] Try streaming the organizer room, HOST rehearses opening remarks
-- [ ] Play a prerec
+- [X] Play a prerec with subtitles
- [ ] Try switching to talk room and streaming pretend Q&A
- [ ] Try playing another prerec
- [ ] Try publication process
- [ ] Start alternate stream and check (?)
+ - No alternate streams at the moment
- [ ] Review the playbook
@@ -113,10 +128,16 @@
### Arrange screens
- CHECK:
- - Share ${upcoming} and ${conf} via CRDT: `conf-crdt-connect-and-share`
+ - Share ${upcoming}, ${playbook}, and ${conf} via CRDT: `conf-crdt-connect-and-share`
- Current schedule, filenames/commands for playing, Q&A preference, IRC nick, pronunciation, intro notes, prerec duration, emergency contact information
- `conf-upcoming-add-subtree`
- Have #emacsconf-org and #emacsconf open
+ - Start backup process for pad
+
+ while true; do
+ curl https://etherpad.wikimedia.org/p/emacsconf-2021/export/html > emacsconf-$(date +"%Y%m%d-%H%M%S").html
+ sleep 15m
+ end
- HOST:
- Check OBS scenes for sharing windows/tabs as a virtual camera:
- chat.emacsconf.org with #emacsconf
@@ -129,7 +150,6 @@
- \#emacsconf-org and #emacsconf channels
- Join organizer room S
- STREAM:
- - Set up MPV with the profile
- Join organizer BBB room
- Check OBS scenes
- MPV and audio from MPV
@@ -137,48 +157,38 @@
- Browser window with organizer room, audio from organizer room
- Browser window that will have talk room, audio from talk room
- Backchannel for easy viewing
-- CHECK:
- - Start backup process for pad
-
- while true; do
- curl https://etherpad.wikimedia.org/p/emacsconf-2021/export/html > emacsconf-$(date +"%Y%m%d-%H%M%S").html
- sleep 15m
- end
-<a id="org653abcb"></a>
+<a id="org0bb33b4"></a>
### Start streaming :stream:
- HOST: Display getting-ready message
- STREAM: Set up BBB view in organizer room to have HOST's webcam maximized
- STREAM: Start streaming from OBS to local Icecast, relay to live0 icecast
-- CHECK: Confirm that the stream is live at <https://live.emacsconf.org/main.webm>, update <file://ssh:live:/var/www/html/index.html>
+- CHECK: Confirm that the stream is live at <https://live.emacsconf.org/main.webm>
+- STREAM: Update the status page to say that the stream is live
- CHECK: Start low-resolution stream, confirm at <https://live.emacsconf.org/main-480p.webm>
- Call this on live0 with the password as the first parameter. The Icecast configuration is on `live0` at `/etc/icecast2/icecast.xml`.
+ Call this on live0 with $CONF480PASS as the first parameter. The Icecast configuration is on `live0` at `/etc/icecast2/icecast.xml`.
PASS=$1
- while true; do ffmpeg -f webm -reconnect_at_eof 1 -reconnect_streamed 1 -re -i http://localhost:8000/main.webm -vf scale=854:480 -f webm -c:a copy -b:v 500k -maxrate 1M -bufsize 1M -content_type video/webm -c:v libvpx icecast://ec2020main480pmu:$PASS:8000/main-480p.webm; done
-- CHECK: Start Youtube stream. Call this with the Youtube streaming key as the first parameter.
+ while true; do ffmpeg -loglevel 24 -f webm -reconnect_at_eof 1 -reconnect_streamed 1 -re -i http://localhost:8000/main.webm -vf scale=854:480 -f webm -c:a copy -b:v 500k -maxrate 1M -bufsize 1M -content_type video/webm -c:v libvpx icecast://ec2020main480pmu:$PASS@localhost:8000/main-480p.webm; done
+- CHECK: Start Youtube stream. Call this with $YOUTUBE1PASS, $YOUTUBE2PASS, or $TOOBNIX as the parameter
- KEY=$1
- while true; do ffmpeg -f webm -reconnect_at_eof 1 -reconnect_streamed 1 -re -i http://localhost:8000/main.webm -f webm -c:a copy -c:v copy rtmp://a.rtmp.youtube.com/live2/$KEY; done
-- CHECK: Try toobnix stream. Call this with the Toobnix streaming key as the first parameter. (key from <https://toobnix.org/videos/upload#go-live>)
-
- KEY=$1
- while true; do ffmpeg -f webm -reconnect_at_eof 1 -reconnect_streamed 1 -re -i http://localhost:8000/main.webm -f webm -c:a copy -c:v copy rtmp://toobnix.org:1935/live/$KEY; done
-- CHECK: Verify the load on live0.
+ MOUNT=$1
+ while true; do ffmpeg -loglevel 24 -i http://localhost:8000/main.webm -cluster_size_limit 2M -cluster_time_limit 5100 -b:v 1M -crf 30 -g 125 -deadline good -threads 4 -vcodec libx264 -acodec libmp3lame -f flv $MOUNT; done
+- CHECK: Verify the alternate streams and the load on live0.
- CHECK: Verify with #emacsconf that the stream is active
## Talk process
-<a id="org3e96be5"></a>
+<a id="orgd6f46ac"></a>
### Check in a speaker
-Exception: [CHECK is unavailable](#org83454f0)
+Exception: [CHECK is unavailable](#orga2b0fce)
- Speaker checks in on #emacsconf-org via IRC or via e-mail ~30m before
- CHECK notes IRC nick for speaker.
@@ -198,7 +208,8 @@ Exception: [CHECK is unavailable](#org83454f0)
- check screen readability
- CHECK briefs speaker on process, including:
- live Q&A: reading questions themselves (can do in any order,
- can skip) or asking HOST to read questions to them
+ can skip; coach possible responses for awkward things) or asking HOST to read questions to them
+ - HOST can share the pad or IRC; speaker shares screen only if doing demo
- encouragement of webcam, although it's optional
- how STREAM will join shortly before the prerec ends and then
give them the go-ahead
@@ -208,53 +219,39 @@ Exception: [CHECK is unavailable](#org83454f0)
collects emergency contact information (in case of technical
issues) and shares it with HOST in the CRDT buffer
- Okay to do other things until the prerec ends
- - CHECK notifies STREAM and HOST with link to the talk room and preferences for Q&A-.
+ - CHECK updates ${upcoming} with link to the talk room and preferences for Q&A-. CHECK will also /msg the relevant information.
-<a id="org00547c8"></a>
+<a id="org6aeec48"></a>
-### Transition to talk
+### Present talk
- CHECK marks previous talk as done and notes the time finished:
- ${conf}
- ${upcoming} - remove finished one
- wiki
-- [? next talk is prerec]
- - HOST introduces next talk.
- - STREAM switches OBS scene to MPV.
- - STREAM plays prerec in MPV.
-- [? next talk is live]
- - HOST and STREAM switch to the talk BBB room.
- - HOST starts recording or confirms that it's already on.
- - STREAM gives the go-ahead.
- - HOST introduces next talk.
- PAD clears pad colours.
-- Exception: [Speaker does not have a prerec and has not checked in](#org8618b0e)
-
-
-### Present talk
-
- [? prerec]
- STREAM and HOST switch to the organizer room in BBB.
- STREAM switches to MPV scene in OBS and plays the video (with captions if available).
- - Exception: [Last-minute prerecording submission](#org55fd5da)
- - Exception: [Last-minute caption update](#org4b9364c)
- - [CHECK publishes information](#org65abe69)
- - [HOST gets a head start on handling Q&A](#orgb1598e9)
- - When prerec finishes, [STREAM joins Q&A](#orgb1598e9)
+ - Exception: [Last-minute prerecording submission](#org154e440)
+ - Exception: [Last-minute caption update](#orgc98e265)
+ - [CHECK publishes information](#org48b1df1)
+ - [HOST gets a head start on handling Q&A](#org5a65313)
+ - When prerec finishes, [STREAM joins Q&A](#org5a65313)
- [? live]
- - Exception: [Speaker does not have a prerec and has not checked in](#org8618b0e)
+ - Exception: [Speaker does not have a prerec and has not checked in](#orgf5536c3)
- HOST joins the BBB room and double-checks that recording is on
- STREAM joins the BBB room and gives the go-ahead
- CHECK notes that this is a live presentation and that the recording will be posted after the conference.
- CHECK notes the time that the presentation started, recalculates schedule, and publishes it.
- Speaker presents.
- - Exception: [Technical issues during a live presentation](#org23a132d)
+ - Exception: [Technical issues during a live presentation](#org489104b)
- [? talk needs to be wrapped up]
- HOST nudges speaker verbally.
-<a id="org65abe69"></a>
+<a id="org48b1df1"></a>
### Publish information
@@ -275,7 +272,7 @@ Exception: [CHECK is unavailable](#org83454f0)
${url}
${description}
- - Reupload subtitles.
+ - Reupload subtitles if needed.
- Mark it as public.
- Add it to EmacsConf 2021 playlist.
- CHECK publishes the video on ToobNix.
@@ -290,13 +287,13 @@ Exception: [CHECK is unavailable](#org83454f0)
- wiki page for talk
-<a id="orgb1598e9"></a>
+<a id="org5a65313"></a>
### Handle Q&A
Exceptions:
-- [Speaker has not checked in](#org01714e9)
+- [Speaker has not checked in](#org686cb61)
- [? live]
- HOST joins the BBB room
@@ -315,7 +312,7 @@ Exceptions:
- HOST and STREAM switch to organizer BBB meeting (room S)
- HOST describes Q&A method and shows it on the screen
- While there's buffer time before the next talk, HOST can read out
- questions and answers
+ questions and answers, or transition to the next talk early
- HOST: It's time for the next talk, but if you want to keep
discussing the previous talk, please feel free to continue doing
so on IRC or the pad.
@@ -324,16 +321,17 @@ Exceptions:
- HOST says the speaker is not available right now, but we'll
forward the questions to the speaker and we'll post the speaker's
answers on the wiki page. Leave your contact information if you
- want to be notified, or subscribe to the emacsconf-org mailing
+ want to be notified, or subscribe to the emacsconf-? mailing
list to get the announcement. Please feel free to continue
discussing the talk on IRC or the pad.
-- [Transition to next talk](#org00547c8)
+- [Present next talk](#org6aeec48)
## Break time
- CHECK stops and restarts the Toobnix restreaming process, and re-checks the stream
- CHECK uses `conf-upcoming-add-subtree` to add the afternoon talks to upcoming.org
+- HOST doublechecks network transfer limit and server health
## End of stream
@@ -346,7 +344,7 @@ Exceptions:
## In case of&#x2026;
-<a id="org55fd5da"></a>
+<a id="org154e440"></a>
### Last-minute prerecording submission
@@ -354,7 +352,7 @@ Exceptions:
- CHECK will notify STREAM with the scp command and the mpv command so that STREAM can choose.
-<a id="org4b9364c"></a>
+<a id="orgc98e265"></a>
### Last-minute caption update
@@ -363,7 +361,7 @@ Exceptions:
- STREAM uses the provided commands to download the VTT file and load it into MPV with `--sub-file`
-<a id="org01714e9"></a>
+<a id="org686cb61"></a>
### Speaker has not checked in
@@ -374,7 +372,7 @@ Exceptions:
- Can play next prerec a few minutes early
-<a id="org8618b0e"></a>
+<a id="orgf5536c3"></a>
### Speaker does not have a prerec and has not checked in
@@ -384,17 +382,18 @@ Exceptions:
- HOST: The next speaker might be having some difficulty connecting. In the meantime, let's&#x2026;
- OR:
- highlight ongoing discussions
- - invite another speaker for an impromptu extension
+ - invite another speaker for an impromptu extension; mplsCorwin will keep a list of possible speakers who are still active
- replay a short prerec
+ - let mplsCorwin or zaeph fill in
-### Speaker whose talk was reallocated shows up and has a prerec
+### CANCELLED Speaker whose talk was reallocated shows up and has a prerec
- CHECK copies it to ${protected}
- Plan to play prerec at the end of the day, or in any gaps if a live talk falls through
-### Speaker whose talk was reallocated shows up and wants to do it live
+### CANCELLED Speaker whose talk was reallocated shows up and wants to do it live
- See if there's enough time if buffers are shuffled back; if so, set up for a live presentation
- Check for alternate stream volunteers
@@ -403,9 +402,9 @@ Exceptions:
post-conference communication
-### Alternate stream volunteer wants to stream
+### Alternate stream volunteer wants to stream (nice to have, at risk)
-- CHECK gives ALTERNATE the BBB room URL for the talk they are interest in
+- CHECK gives ALTERNATE the BBB room URL for the talk they are interested in
- ALTERNATE starts streaming to assigned end point
- CHECK confirms stream
- CHECK updates ${stream-status}
@@ -433,10 +432,10 @@ Exceptions:
### Conduct guidelines issue
-- HOST addresses it (on-camera if needed) with a reminder
+- HOST addresses it (on-camera if needed) with a reminder and/or a kick or a ban
-<a id="org83454f0"></a>
+<a id="orga2b0fce"></a>
### CHECK is unavailable
@@ -453,14 +452,14 @@ Exceptions:
- Either STREAM or CHECK does hosting
-<a id="org23a132d"></a>
+<a id="org489104b"></a>
### Technical issues during a live presentation
- HOST tries to contact the speaker
- [? back on track]
- [? can be squeezed into remaining time]: Continue
- - [? need extra time]: CHECK fiddles with buffer of following talks
+ - [? need extra time]: CHECK fiddles with buffer of following talks in conf.org and updates schedule
- [? need too much extra time (ex: 10min)]: HOST acknowledges
technical issues and says we may be able to follow up after the
conference
@@ -470,7 +469,7 @@ Exceptions:
### Big technical issues with streaming
-- CHECK notifies #emacsconf and #emacsconf-org
+- HOST notifies #emacsconf and #emacsconf-org and pad
- HOST updates the 2021.md wiki page
- CHECK publishes prerecordings
- media.emacsconf.org
@@ -484,9 +483,10 @@ Exceptions:
- OR:
- Redirect some viewers via asking in #emacsconf:
- - watch via Toobnix
- watch via main-480p
+ - watch via Toobnix (if we can get that working)
- Consider dropping the restream to Toobnix (lower audience?) or to Youtube
+ - Add additional node to Linode account for shared transfer pool (TODO: doublecheck)
# Before the conference
@@ -528,3 +528,15 @@ Exceptions:
## TODO STREAM: Scale up the server and doublecheck the setup
+
+## sachac
+
+
+### TODO Figure out the YouTube/Toobnix stuff
+
+
+## bandali
+
+
+###
+