The following is the GNU All-permissive License as recommended in https://www.gnu.org/licenses/license-recommendations.en.html

Copyright (C) 2024 Free Software Foundation sysadmin@fsf.org

Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved. This file is offered as-is, without any warranty.

Contributions are welcome. See https://savannah.gnu.org/maintenance/fsf/.

OBS Studio (formerly Open Broadcaster Software)

Installing through PPA on Trisquel

Official obs-studio PPA

sudo add-apt-repository ppa:obsproject/obs-studio
sudo apt-get update
sudo apt install -y obs-studio

You may need additional dependencies. If you need to pin additional packages, see the relevant chromium apt pinning script on brains.

Streaming to Icecast

Related reference: https://epir.at/2018/03/08/obs-icecast-streaming/

Profile Configuration

Enable Studio Mode button.

File > Settings

Below is a full list of settings on that page, if anything else appears in a newer version, add it to the list.

General

Check Hide cursor over projectors

Output

Recording tab

Output Mode drop-down: Advanced

  • Type: Custom Output (FFmpeg)
  • FFmpeg Output Type: Output to URL
  • File path or URL: icecast://source:PASSWORD@live-master.fsf.org:8000/stream-room-NAME.webm
    • Note: Password has an O as in Opal. Not a zero.
  • Container format: webm
  • Muster settings (if any): content_type=video/webm cluster_time_limit=5100 cluster_size_limit=2M
  • Video Bitrate: 1500 Kbps
  • Keyframe interval (frames): 150
  • Rescale Output: greyed out, not settable.
  • Show all codecs (even if potentially incompatible): checked
  • Video Encoder: libvpx
  • Video Encoder Settings (if any): rt cpu-used=5 threads=2 error-resilient=1 crf=30 g=150 minrate=1.5M maxrate=1.5M
  • Audio Bitrate: 96 Kbps
  • Audio Track: check mark on 1.
  • Audio Encoder: libvorbis
  • Audio Encoder Settings (if any): empty

Audio

  • Desktop Audio: (Set to your output device such that you see sound levels when there is audio playing on your system)
    • When using the Behringer U-CONTROL UCA222 USB audio device, it comes up as PCM2902 Audio Codec Analog Stereo

Video

Base (Canvas) Resolution: 1280x720

Hotkeys

  • Start Recording: F9
  • Stop Recording: F9
  • Transition: F8
  • BBB Capture Switch to scene: Super + 1
  • Interlude Switch to scene: Super + 2
  • Technical Difficulties Switch to scene: Super + 3
  • Prerecord Switch to scene: Super + 4
  • Desktop Audio Mute: F7
  • Desktop Audio Unmute F7

Scene Configuration

Config files are in /home/common/sysadmin/lp22/optLP-2022.tar.gz

Extract folder contents to /opt/LP/

Scene Collection > Import

Click on the ... button. Navigate to /opt/LP/LP2022scenes.json and click on the Open button.

Click on the Import button.

`Scene Collection > LP2022

In BBB Capture scene, double click on Window Capture and set it to your web browser that is on your other monitor.

Capturing non-fullscreen window

In the xcompsoite settings, top y: 74 pixels to remove the menubar.

Streaming

Start with the Interlude scene. Change the text in /opt/LP/text.txt to introduce your next talk.

To stream, use the recording button, not the streaming button. This can be set as a hotkey.

Queue up your BBB capture scene and transition when the time is right.

Say to the room, "I am going to count down from 5 and then you will be live. Wait another few seconds before you begin. 5-4-3-2-1- You're live!" Unmute Desktop Audio with F7. Transition with F8.

To avoid the "You are now muted" clip and to remove the distraction of the streaming room audio stream for the speakers, mute your mic with pavucontrol.

Removing the LP logo during stream

If the logo in the top-right is covering someone's face in a panel or something like that, you can remove it live.

Right-click on the current scene, select the Duplicate scene, keep the name the same and add without logo at the end, click on the eye icon beside logo and then transition to the new scene.

Prerecorded videos

Test prerecorded videos before starting the stream for the day.

At this time, you cannot preview and correct the video dimensions until the video is playing live. If the video is the wrong dimensions such as only showing the top-left portion of the video, queue up the same scene that is playing and you will have the red box that can be resized, correct the display size, and then transition to the same scene. Luckily this only takes a few seconds and continues to play the video.

Things that caused problems

In 2022, using i3 wm: having source of "Screen Capture (XSHM)" caused video chop. Instead, use Windows Capture (Xcomposite)