Online Conference Volunteers

An online conference presents a different set of challenges from a conference held in person. DebConf uses the following setup when running an online conference. The largest difficulty is getting things setup. This requires a fairly involved process of getting the required services up and running. While explaining how to set it up is beyond the scope of the guide, the Ansible roles and playbooks required are found in The DebConf video team Ansible documentation. The general setup is described under Room setup.

Points of Contact

  • Orga: #debconf-team

  • Video: #debconf-video

  • Content: #debconf-content

  • Website: #debconf-team

Operating Volunteer Setup/Requirements

  • 8mbps dedicated Internet connection. Jitsi and stream monitoring take the most bandwidth, so if you are struggling, try monitor a lower quality version of the stream or lower the quality in your Jitsi client.

  • Headphones (if not, use push-to-talk by pressing the space bar, to avoid echo)

  • Microphone (for Talkmeister: external ideal)

  • Software installed:

    • Internet browser - Chrome, Chromium or Firefox. Firefox ESR may cause local performance issues for people using it.

    • VLC - monitor the stream

    • IRC client - hexchat, weechat, Quassel. Matrix is good for people who aren’t familiar with IRC.

  • Credentials / accounts required:

    • IRC

    • Jitsi streaming keys (for streaming to Vogol)

    • Salsa

    • Conference Website - ask on #debconf-team for access to the video team group

  • Useful links/URLs (these are conference specific, available in the wiki):

    • Jitsi

    • Streaming endpoints/stream website

    • Q&A pads

    • Schedule

    • Vogol

    • Conference website

    • SReview

Running a Talk (Director)

The Director controls what is recorded and what goes out onto the stream. They decide what video sources should be shown on stream and are in charge of the pre-recorded video playback, when applicable. They are also responsible for monitoring the stream for quality assurance.

Go to Vogol and log in with Salsa SSO. A larger DebConf will have one Vogol instance for each room. You will be prompted to authorize the application and will be redirected back to Vogol when you do.

Vogol is a web frontend to Voctomix, the same system we use for in-person DebConfs. All changes you make there will be visible on the stream. The previews are images updated once a second, so they will look quite jumpy. The Mixed Output section shows what is is going out on stream if the stream output is live. The current status of the stream is indicated by the colour of the banner:

  • Green - stream is live

  • Red - the stream is showing the maintenance loop or is blank. Any changes made in sources or layout, below, will not affect the stream output.

The banner allows you to select between Live and Maintenance Loop for the current stream state.

When the stream is Live, the video from one (or two) of the sources below (Loop, Grabber, Recording, Jitsi, etc.) will be shown on the output.

Vogol provides four layouts that you can select between in the banner. The colours indicate source A (blue) or B (red). During a talk, you should have the active source fullscreen (first layout), while the picture-in-picture (last layout) works well for the Q&A section of a talk with a Grabber.

vogol-screenshot

DebConf encourages presenters to submit their pre-recorded talks to sReview. These are processed and can be played in the Recordings section of Vogol. The file must be loaded for play-out using the Select File button and then played it when appropriate. This will automatically select the Recording source and start playing the file.

You can set a source to be Source A or B by clicking on the appropriate button in the Video controls. This will be visible immediately on the stream, but won’t change the audio sources. You can mute or un-mute the sound from a source with the buttons below. Un-muted sources have a Green title.

The “Select” button will make a source full-screen and un-muted, muting all other sources, in a single click. Most of the time, this is the only control you need.

Vogol has keyboard shortcuts, press ? to see a list.

A talk has the following flow:

  1. Setup - Join the Jitsi room for the talk and start streaming from Jitsi (More Actions -> Start Live Streaming -> Enter Stream Key). Set Everyone follows me (More Actions -> Settings -> More -> Everyone follows me).

  2. Introduction - Jitsi source fullscreen and unmuted with the Talkmeister in focus. Coordinate with the Talkmeister and speaker. Before switching to Jitsi, give them a count-down so they know when to start speaking.

  3. Pre-recorded Talk - Recording source fullscreen with the Jitsi scene muted. Configure Vogol to jump to the desired layout (below) when playback ends.

  4. Q&A

    • Use the Q&A Preset. This makes Grabber source A and Jitsi source B with one of the picture-in-picture layouts active. Jitsi unmuted.

    • In small events without a Grabber: The talkmeister should share the pad to Jitsi. Select Jitsi in Vogol.

    • You select what is active on the stream by clicking on users in the Jitsi call.

  5. Loop - Set the stream back to loop.

Running a Talk (Talkmeister)

The Talkmeister is responsible for introducing the talk and handling the question-and-answer session with the speaker.

Before you start:

  • Arrive 5 minutes early for your talk, ensure that the director and speakers are ready.

  • The link for your talk’s Jitsi call is available from the individual talk page on the DebConf website, visible to the speaker and the volunteers working on the talk once they’re logged in.

  • Please do not give the Jitsi link to anyone not involved in the talk, as that effectively puts them “on stage” with you.

  • The Grabber source in Vogol (for events that have it) shows everything you see in VNC, so if the Grabber is selected, any changes made to the VNC viewer will be seen on the stream.

Before the talk:

  1. Join the Jitsi room for the talk a few minutes before it starts, and coordinate with the speaker there.

  2. It’s nice to introduce speakers. Tell the director that you want to introduce the speaker, and the director will tell you when to start speaking. Keep the introduction short.

During the talk:

  1. Sit in the Jitsi room with the presenter. Jitsi will stop streaming if everybody is on mute for a long time, so talk to each other a bit.

  2. Monitor IRC for questions, and collect them in the pad.

  3. Edit the questions, if appropriate, and organise them into a logical order. You have editorial power, prioritise the questions you think are most important to get to.

At the end of the talk:

  1. Lead the Q&A session, working from the pad.

  2. Keep an eye on the time, and end the session on schedule.

  3. Thank the speaker.

For events with the Grabber, you can open etherpad in the Grabber, and it will be available to the director as a source to mix in the video. It can be useful to show the questions to the pad audience in a BoF, or if there is a typed discussion the pad. See The VNC Grabber. For events without the Grabber, you can share the pad from your own computer to Jitsi, see Screen Sharing to Jitsi.

The VNC Grabber

The Grabber machine is a desktop in the cloud that is screen-captured into the video mix. You can use this to display etherpad or gobby on the video stream.

  1. Connect to the Grabber machine via VNC. The video team recommends TigerVNC as the VNC viewer:

    $ sudo apt install tigervnc-viewer
    $ cp /etc/ssl/certs/DST_Root_CA_X3.pem ~/.vnc/x509_ca.pem
    $ xtigervncviewer -SecurityTypes X509Vnc grabber1.online.debconf.org
    
  2. The viewer will prompt you for the grabber password, and then give you access to the machine.

  3. Open the Q&A pad for the talk. You may need to exit the fullscreen view of the previous pad using F11.

  4. Increase the size to 190% so that it can be seen easily on stream.

  5. Press F11 to go back to full screen.

  6. If you are managing a BoF, and they are using Gobby, open Gobby on the Grabber (Applications -> Internet -> Gobby).

If you find the VNC viewer is slow or not updating your view of the grabber, you can start it with a compression level between 1 (little compression) and 6 (high compression):

$ xtigervncviewer -SecurityTypes X509Vnc -CompressLevel 5 grabber1.online.debconf.org

Screen Sharing to Jitsi

You can screen share from your browser to Jitsi. Chromium/Chrome can a full monitor, window, or even a browser tab. Firefox can only share a monitor or window.

For best results, resize the window that you will be sharing to around 1280x720, so that the text is readable on the stream, even for clients viewing the low resolution version.

When you share your screen, your camera will turn off. But you can turn it on again, by clicking the Start Camera button, and it will overlay in the bottom right corner of your shared screen.

Review Video using SReview

  1. Open review link provided by video team or in your email (for presenters)

  2. Watch the video in the video player.

    1. If it is correct, don’t change anything and hit the “Send your video review to …” button.

    2. If it is not correct, select the “The video has problems” option, and enter the corrections necessary in the provided form (see below).

  3. The video should start just before the presenter is introduced, or (in case there is no introduction) just before they start talking. If that is not the case, choose the correct option under the “Start time” header, and position the newly shown video element to where the video should start. Then hit the “Set new start time” button.

  4. The video should end just after any “thank you” by the talkmeister, or applause by the audience (if any). If that is not the case, correct with the controls under the “End time” header, which work the same way as the “Start time” controls.

  5. If there are audio issues, correct them with the audio controls: choose the correct channel, and/or enter an A/V sync correction value.

  6. After entering all correction values, hit the “Send your video review to …” button. The system will prepare another review, which you will then need to re-review.

  7. If there are problems that cannot be fixed using the web form, there are two options:

    1. In case the problem cannot be fixed but is not fatal (e.g., an annoying audio hum that does not make the video unusable), an apology slide can be added to the video just after the title slide.

    2. In case of a problem that makes the video useless, the video should not be released.

    You can either use the “other brokenness” option in the web form to signal these problems, or just talk to the video team.

Subtitles are done manually for DebConf: https://wiki.debian.org/Teams/DebConf/Video/Subtitles

Troubleshooting

General

  • Keep an eye on the IRC to track and respond to any potential problems.

  • Keep the streaming key copied or close at hand in case the live stream drops, to enter it fast.

  • Before the talk:

    • Make sure the session host and speaker are in the Jitsi room (via IRC for example)

    • Confirm that the file is loaded into the file player section of Vogol.

  • Talk start:

    • If you press the wrong button while directing, you can correct it by applying the action you intended to perform afterwards. For example, if you switch to the wrong source, you can switch back to the correct one by clicking on the appropriate Select button

    • Don’t be afraid to tell the audience that there is a problem that you are working on. It’s better than having them frustrated and not sure what is going on.

    • You hear ‘the live stream has stopped’ when you are pretty sure it should not. Inform the speaker to wait, try start it again. If it keeps dropping, inform the video team to try find a work around.

Jitsi

Test Jitsi with a few people in a call. If it doesn’t work, try these options. From best to worst quality:

  • Use current Chrome, Chromium or Firefox.

  • Press More Actions -> Manage Video Quality to manage call quality, Try Low, or even Audio Only.

  • Turn off Outgoing Video.

  • Try a second device (Phone or tablet).

  • If that’s also having connection problems, try the cellular network, rather than WiFi.

  • Dial into Jitsi over the phone network. If you click on the “invite people” button in the bottom right corner, Jitsi will display the dial in number and PIN.