[[!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-2024-private/conf.org`   (or `emacs emacsconf-2024-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.