1 files changed, 90 insertions, 0 deletions
diff --git a/2023/volunteer/stream.md b/2023/volunteer/stream.md
new file mode 100644
index 00000000..fdb05183
--- /dev/null
+++ b/2023/volunteer/stream.md
@@ -0,0 +1,90 @@
+[[!meta title="Stream volunteer"]]
+
+# Responsibilities
+
+As the stream volunteer, you'll be in charge of managing the
+livestream: playing the talk video at the right time, updating the
+stream overlays, joining the Q&A (live or IRC) when it finishes,
+arranging the windows so that the Etherpad can be seen, adjusting the
+volume, etc.
+
+# Preparation
+
+We will give you a list of talks with the times, speaker info, pad
+URL, and URL for the live Q&A session. Please keep the Q&A URLs secret.
+
+You can use OBS on your system or you can use VNC to connect to the
+OBS setup on res.emacsconf.org. We will e-mail the connection details
+to you. Add an entry for res.emacsconf.org to your ~/.ssh/config so
+that you don't have to specify the port. Use `export TRACK=gen` or
+`export TRACK=dev` in your shell to set the variable for your stream.
+
+Copy the password file:
+`scp emacsconf-$TRACK@res.emacsconf.org:~/.vnc/passwd vnc-passwd-$TRACK`
+   
+# Process
+
+## Setting up the stream
+
+1. Start up the VNC server if it's not already running
+   `ssh emacsconf-$TRACK@res.emacsconf.org -L 5905:127.0.0.1:5905 -L 6005:127.0.0.1:6005 -L 5906:127.0.0.1:5906 -L 6006:127.0.0.1:6006 "~/bin/track-vnc; sleep infinity"`
+2. Connect via VNC viewer to the appropriate forwarded port from your laptop
+   - Gen: xvncviewer 127.0.0.1:5905 -shared -geometry 1280x720 -passwd vnc-passwd-gen
+   - Dev: xvncviewer 127.0.0.1:5906 -shared -geometry 1280x720 -passwd vnc-passwd-dev
+3. Switch to OBS and **start recording** (not streaming) when you're ready.
+
+## Playing the talk video
+
+### From conf.org with a todo state change hook
+
+If things go well, an organizer should be able to start the video from
+the conf.org setup in orga@res.emacsconf.org. Here are the steps in
+case you are in charge of it and have access:
+
+Set up:
+
+1. ssh orga@res.emacsconf.org
+2. `emacsclient -c -nw emacsconf-2022-private/conf.org`   (or `emacs emacsconf-2022-private/conf.org` if there's no server yet)
+3. `M-x emacsconf-add-org-after-todo-state-change-hook` unless you've already done so this session
+
+Play talk:
+
+1. Use `M-g t` (`emacsconf-go-to-talk`) to find the talk, or use another way to navigate to the talk heading. (Org agenda?)
+2. Use `C-c C-t` (`org-todo`) to mark the talk as `m` (PLAYING - *m*pv).
+
+This should make MPV appear. If it does not appear, you can manually
+play it with one of the backup plans below:
+
+### Backup plan: emacsconf-stream-play-video from conf.org
+
+1. Use `M-x emacsconf-stream-set-talk-info` to update the overlay. If
+this does not update the overlay, play the video and then manually
+copy the right overlays over `~/video.png` and `~/other.png`.
+
+2. Use `M-x emacsconf-stream-play-video` to play the video for the talk.
+
+### Backup plan: Use track-mpv
+
+1. ssh emacsconf-$TRACK@res.emacsconf.org
+2. cd /data/emacsconf/cache
+3. ~/bin/track-mpv file-to-play.webm
+
+This should make the file play in the correct display. 
+
+## Updating the overlay
+
+If the overlay wasn't automatically updated by the todo state change
+hook in conf.org, you can set it from conf.org if you have access. Use
+`M-x emacsconf-stream-set-talk-info`. If that doesn't work, manually
+copy the right overlays over `~/video.png` and `~/other.png`. The
+overlays will be in `/data/emacsconf/overlays`.
+
+## Displaying an emergency announcement
+
+echo Your emergency announcement here > ~/news.txt
+
+Be sure to clear it with `echo > ~/news.txt` when done.
+
+From conf.org on res, you can also use `M-x
+emacsconf-stream-broadcast` to announce something on both streams or
+`M-x emacsconf-stream-set-news` to set the news on one stream.