Add more details, update status for pattern

1 files changed, 228 insertions, 49 deletions

diff --git a/playbook.md b/playbook.md
index 04645e33..2ddd0dab 100644
--- a/playbook.md
+++ b/playbook.md
@@ -58,25 +58,50 @@
 <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>
 </tr>
+
+
+<tr>
+<td class="org-left">${upcoming}</td>
+<td class="org-left">upcoming.org shared over CRDT</td>
+</tr>
+
+
+<tr>
+<td class="org-left">${conf}</td>
+<td class="org-left">conf.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>
+
+
+<tr>
+<td class="org-left">${media}</td>
+<td class="org-left"><a href="file://ssh:front:/var/www/media.emacsconf.org/2021/">file://ssh:front:/var/www/media.emacsconf.org/2021/</a></td>
+</tr>
 </tbody>
 </table>
 
 
 # Pre-conference dry run
 
--   [ ] [Start streaming](#org264efc8)
--   [ ] [Start low-resolution stream](#org46f6925)
--   [ ] [Start Youtube stream](#orgcfa71d3)
--   [ ] Check in a speaker
--   [ ] Try alternate stream
+-   [ ] [Start streaming](#org3e15cdd)
+-   [ ] [Check in a speaker](#orgd201d88)
+-   [ ] Try streaming the organizer room, HOST rehearses opening remarks
+-   [ ] Play a prerec
+-   [ ] Try switching to talk room and streaming pretend Q&A
+-   [ ] Try playing another prerec
 -   [ ] Try publication process
+-   [ ] Start alternate stream and check (?)
 -   [ ] Review the playbook
--   [ ] Sort out CRDT
 
 
 # Thursday or Friday before the conference
 
--   STREAM: Download prerecorded videos from front:/var/www/media.emacsconf.org/2021/protected
+-   STREAM: Download prerecorded videos from ${protected}
 
 
 # On the day of the conference
@@ -85,41 +110,77 @@
 ## Set up
 
 
-<a id="org264efc8"></a>
+### Arrange screens
+
+-   CHECK:
+    -   Share ${upcoming} and ${conf} via CRDT
+        -   Current schedule, filenames/commands for playing, Q&A preference, IRC nick, pronunciation, intro notes, prerec duration, emergency contact information
+    -   Have #emacsconf-org and #emacsconf open
+-   HOST:
+    -   Check OBS scenes for sharing windows/tabs as a virtual camera:
+        -   chat.emacsconf.org with #emacsconf
+        -   Etherpad
+        -   Schedule
+        -   next talk page
+        -   Clock with current time on screen: `watch TZ=America/Toronto date`
+    -   Set up backchannel for easy viewing
+        -   ${upcoming}
+        -   \#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
+        -   Web browser with BBB
+        -   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="org3e15cdd"></a>
 
 ### Start streaming     :stream:
 
--   Start streaming from OBS to local Icecast, relay to live0 icecast
--   Display current time on screen: `watch TZ=America/Toronto date`
-
-Update <file://ssh:live:/var/www/html/index.html>
-
-
-<a id="org46f6925"></a>
-
-### Start low-resolution stream     :check:
-
-Call this on live0 with the password as the first parameter. The Icecast configuration is on `live0` at `/etc/icecast2/icecast.xml`.
-
-    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:${1}:8000/main-480p.webm; done
+-   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: 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`.
+    
+        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.
+    
+        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.
+-   CHECK: Verify with #emacsconf that the stream is active
 
 
-<a id="orgcfa71d3"></a>
-
-### Start Youtube stream     :check:
-
-Call this on live0 with the Youtube RTMP streaming key as the first parameter.
+## Talk process
 
-    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/$1; done
 
+<a id="orgd201d88"></a>
 
-## Talk process
+### Check in a speaker
 
-
-### Check in speaker
+Exception: [CHECK is unavailable](#org7d6c756)
 
 -   Speaker checks in on #emacsconf-org via IRC or via e-mail ~30m before
--   CHECK notes IRC nick for speaker.  `M-g t <slug> C-. p IRC <nick>`  (using Embark and conf-go-to-talk)
+-   CHECK notes IRC nick for speaker.
 -   CHECK confirms Q&A preference: live/IRC/Etherpad, preferred way of getting questions
 -   [? unknown] How would you like to handle questions today? Live video, #emacsconf, Etherpad?
 -   [? IRC] You can keep an eye on #emacsconf for questions and discussions related to your talk. Feel free to answer, skip answering, tell people that you'll follow up afterwards, etc. We'll also copy questions from the Etherpad so that you can see them in one place. Let us know if you need help or if you want to get set up for live Q&A! (If the volume gets overwhelming, we can copy questions into #emacsconf-questions for you.)
@@ -144,15 +205,19 @@ Call this on live0 with the Youtube RTMP streaming key as the first parameter.
                 (otherwise the audio is confusing)
         -   If the speaker will be giving a live presentation, CHECK
             collects emergency contact information (in case of technical
-            issues) and /msgs it to HOST
+            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-.
 
 
-<a id="orgeae9b5c"></a>
+<a id="orgba71285"></a>
 
 ### Transition to 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.
@@ -162,9 +227,8 @@ Call this on live0 with the Youtube RTMP streaming key as the first parameter.
     -   HOST starts recording or confirms that it's already on.
     -   STREAM gives the go-ahead.
     -   HOST introduces next talk.
--   PAD backs up a copy of the pad.
 -   PAD clears pad colours.
--   Exception: [Speaker does not have a prerec and has not checked in](#org03ea047)
+-   Exception: [Speaker does not have a prerec and has not checked in](#org3ea273d)
 
 
 ### Present talk
@@ -172,26 +236,66 @@ Call this on live0 with the Youtube RTMP streaming key as the first parameter.
 -   [? 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](#org1c7436f)
+        -   Exception: [Last-minute prerecording submission](#org82b860f)
     -   CHECK notes the time that the presentation started, recalculates schedule, and publishes it.
-    -   CHECK publishes the video to media.emacsconf.org
-    -   CHECK updates the wiki page to include the video and any other published files.
+    -   [CHECK publishes information](#org0f20490)
+    -   [HOST gets a head start on handling Q&A](#org529029f)
+    -   When prerec finishes, [STREAM joins Q&A](#org529029f)
 -   [? live]
-    -   Exception: [Speaker does not have a prerec and has not checked in](#org03ea047)
+    -   Exception: [Speaker does not have a prerec and has not checked in](#org3ea273d)
     -   HOST joins the BBB room and double-checks that recording is on
-    -   STREAM joins the BBB room from the IRC /msg and gives the go-ahead
+    -   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](#org948a020)
     -   [? talk needs to be wrapped up]
         -   HOST nudges speaker verbally.
 
 
+<a id="org0f20490"></a>
+
+### Publish information
+
+-   CHECK updates the schedule in:
+    -   ${conf}
+    -   ${upcoming}
+    -   wiki
+-   CHECK publishes the video to media.emacsconf.org
+-   CHECK updates the wiki page to include the video and any other published files.
+-   CHECK publishes the video on YouTube.
+    -   Update description:
+        
+            This video is available under the terms of the
+            Creative Commons Attribution-ShareAlike 4.0 International (CC
+            BY-SA 4.0) license.
+            
+            You can view it using free and open source software at
+            talk page URL
+            
+            description from wiki page
+    -   Reupload subtitles.
+    -   Mark it as public.
+    -   Add it to EmacsConf 2021 playlist.
+-   CHECK publishes the video on ToobNix.
+    -   Copy title and description.
+    -   Mark it as public.
+    -   Add it to the EmacsConf 2021 playlist.
+-   [? live sections ]
+    -   CHECK does a rough-cut of the recording from ${dump} to get the last X minutes or by time range
+    -   When there's an opportunity to do so:
+        -   CHECK finetunes the rough-cut recording (trim start and end) and posts it to:
+            -   media.emacsconf.org/2021
+            -   wiki page for talk
+
+
+<a id="org529029f"></a>
+
 ### Handle Q&A
 
 Exceptions:
 
--   [Speaker has not checked in](#orgf9944ea)
+-   [Speaker has not checked in](#org4002294)
 
 -   [? live]
     -   HOST joins the BBB room
@@ -200,8 +304,12 @@ Exceptions:
     -   HOST describes how to ask questions
     -   [? No questions yet]
         -   HOST thanks speaker, says nice things about talk, and asks a couple of prepared questions
+    -   [? Awkward question]
+        -   HOST can try rephrasing the question.
+        -   HOST adds note to IRC/Etherpad that speakers can answer in any order, skip questions, answer afterwards, etc.
     -   [? Q&A needs to be wrapped up]
         -   HOST writes in Etherpad/IRC or nudges speaker verbally.
+    -   CHECK notes the time that the live Q&A finished.
 -   [? IRC/pad]
     -   HOST and STREAM switch to organizer BBB meeting (room S)
     -   HOST describes Q&A method and shows it on the screen
@@ -218,25 +326,28 @@ Exceptions:
         want to be notified, or subscribe to the emacsconf-org mailing
         list to get the announcement. Please feel free to continue
         discussing the talk on IRC or the pad.
--   [Transition to talk](#orgeae9b5c)
+-   [Transition to next talk](#orgba71285)
+
+
+## End of stream
+
+-   CHECK stops ffmpeg process for Youtube
+-   CHECK stops ffmpeg process for main-480p
+-   STREAM stops streaming
 
 
 ## In case of&#x2026;
 
 
-<a id="org1c7436f"></a>
+<a id="org82b860f"></a>
 
 ### Last-minute prerecording submission
 
 -   CHECK will copy it from the FTP upload server to ${protected} and name it appropriately.
 -   CHECK will notify STREAM with the scp command and the mpv command so that STREAM can choose.
 
--   TODO Shortcut for moving things around
-
--   TODO Shortcut for notifying STREAM
-
 
-<a id="orgf9944ea"></a>
+<a id="org4002294"></a>
 
 ### Speaker has not checked in
 
@@ -247,7 +358,7 @@ Exceptions:
     -   Can play next prerec a few minutes early
 
 
-<a id="org03ea047"></a>
+<a id="org3ea273d"></a>
 
 ### Speaker does not have a prerec and has not checked in
 
@@ -297,6 +408,71 @@ Exceptions:
     -   PAD reimports the pad from backup
 
 
+### CRDT malfunctions
+
+-   HOST notifies CHECK and tries reconnecting
+-   [? still doesn't work]
+    -   Switch to backup Etherpad
+
+
+### Conduct guidelines issue
+
+-   HOST addresses it (on-camera if needed) with a reminder
+
+
+<a id="org7d6c756"></a>
+
+### CHECK is unavailable
+
+-   HOST does check-ins
+-   HOST refers to conf.org for Q&A preference etc.
+-   STREAM checks conf.org for prerec filenames etc.
+-   Dropped goals:
+    -   Publishing recordings ASAP
+    -   Updating schedule/wiki on the fly
+
+
+### HOST is unavailable
+
+-   Either STREAM or CHECK does hosting
+
+
+<a id="org948a020"></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 too much extra time (ex: 10min)]: HOST acknowledges
+        technical issues and says we may be able to follow up after the
+        conference
+-   [? can't resume]: HOST acknowledges technical issues and says we may
+    be able to follow up after the conference
+
+
+### Big technical issues with streaming
+
+-   CHECK notifies #emacsconf and #emacsconf-org
+-   HOST updates the 2021.md wiki page
+-   CHECK publishes prerecordings
+    -   media.emacsconf.org
+    -   wiki
+    -   Toobnix
+    -   Peertube
+-   STREAM e-mails the mailing list
+
+
+### live0 can't handle the load or is close to network transfer limit
+
+-   OR:
+    -   Redirect some viewers via asking in #emacsconf:
+        -   watch via Toobnix
+        -   watch via main-480p
+    -   Consider dropping the restream to Toobnix (lower audience?) or to Youtube
+
+
 # Before the conference
 
 
@@ -333,3 +509,6 @@ Exceptions:
 
 ## Review Youtube videos
 
+
+## TODO STREAM: Scale up the server and doublecheck the setup
+