Source Modes

What Are Source Modes?

There are 3 primary things you can show with Ecamm Live on your broadcast: a camera, something on your Mac’s display, or a local video file. We call these Sources. Quickly access your Sources at the top center of the Main Window.


Screen Share

Video File


The leftmost icon in the Source bar accesses Camera mode. With this selected, video from a camera is displayed in the Main Window. If you have more than one camera source available (for example, a built-in webcam and an external video camera attached to your Mac via USB) then Ecamm Live will display a video source switcher at the bottom. When only one video source is detected by Ecamm Live, the video switcher on the Main Window will be hidden.

Support for HDMI and Canon DSLR Cameras

Ecamm Live can detect and use many types of cameras. We’ve built in special support for cameras connected to your Mac through Blackmagic Design capture devices. Amongst our community, the most popular HDMI input device is the Blackmagic Design UltraStudio Mini Recorder. Once you’ve connected this to your Mac, and connected your camera to it, you’ll be able to select your camera in the Camera sources of Ecamm Live.

For Canon DSLR cameras, if your camera is listed in this list of compatible Canon cameras, then you can use it without any extra hardware. To do this, install the free and open source Camera Live software. Once it’s installed, connect your Canon DSLR to your Mac’s USB port. Quit the Canon EOS Utility if it automatically opens, and then start Camera Live. It will recognize the camera. Your camera will now be an option in Ecamm Live’s Camera menu. Currently, no other DSLRs or mirrorless cameras are supported, unless it provides HDMI out, in which case you can use the Blackmagic method above.

Support for Newtek NDI® Cameras

Ecamm Live will automatically detect Newtek NDI® input sources, such as the NDICam iOS app. NDI sources will show up as camera in Ecamm Live’s camera list, and as a microphone in Ecamm Live’s microphone list.

Support for EpocCam Camera for iPhone and iPad

Customers also use the third-party iOS app, EpocCam by Kinoni. This requires installing both the Mac OS X beta drivers and EpocCam Viewer Pro for Mac OS on your Mac. These are both available toward the bottom of the Kinoni homepage.

Support for 360° Cameras

Ecamm Live supports streaming from 360° cameras to services like Facebook Live which support them. We have used the Ricoh Theta S camera successfully. If you need help setting that up, read our Streaming with a 360° Camera document. Other cameras that can produce a equirectangular image may also work.

Video Source Switcher

The video source switcher allows you to broadcast one or more video sources. Select one video source to fill the Main Window with that video. If you would like to display more than one video source at the same time, hold down the shift key on your keyboard, and click to select the video sources you wish to display. Ecamm Live will automatically split the screen to evenly display the videos at equal size—up to nine sources. The video sources will automatically be cropped equally on their sides to fit the space if necessary, centering the video. Before going live, if you plan to use split screen mode, you’ll want to ensure all participants are in the center of their camera view.

The video switcher bar can be dragged anywhere within the Main Window. When you’re not moving your cursor over the Main Window, this bar will fade away. Move your cursor over the Main Window, and it’ll reappear.

If you have video sources connected to your Mac that you do not want available to you during a broadcast, you may hide (or unhide) sources in CameraInclude In Switcher ➝ un/check sources listed here. Remember, if you remove all but one source, the video switcher will be hidden. All detected sources will always be displayed within the Camera menu at the top of the screen.

Screen Share

The center icon in the Source bar activates Screen Share mode. When this is selected, a Control Bar will be shown at the bottom of the Main Window to select one of 4 options for Screen Share mode:

  1. Current Application — this is the default mode. Whichever app on your Mac is currently in the foreground, (other than Ecamm Live), and all of its visible windows, will be broadcast.
  2. Entire Screen — select any attached display to show everything on that desktop.
    1. Or Display — if you have more than one display connected to your Mac, you’ll be able to select them here.
  3. Specific Application — select any one application and Ecamm Live will show all of its visible windows.
  4. Specific Application Window — select any one application window and Ecamm Live will only show that within in the Main Window, automatically fitting the selected app window to the Main Window. Choose a specific application window in the submenu to the right of the application name in the Control Bar’s Show menu.

The Control Bar is only visible when Ecamm Live is the foremost window, and the cursor has moved within the Main Window in the last 5 seconds. After 5 seconds, or if your cursor leaves the window, the bar will hide. To see it again, move your cursor anywhere within the Main Window.

Figure: Screen Share Mode Main Window Annotated

With Screen Share mode selected, you see what the audience sees within the Main Window, but to interact with the items you’re displaying, you must control them directly. You will not be able to interact with an app, for instance, by clicking on it within the Main Window.

System Audio

When using the Screen Sharing source mode, Ecamm Live will also broadcast the Mac’s system audio. For example, sound from a video in a web browser, or sounds in a presentation, will be broadcast to your audience. To adjust system audio levels, use the Sound Levels window.

Controlling Ecamm Live While Using Other Apps

While you’re live, if you switch to another app, a small floating control window will be displayed. To turn this on or off, use Options menu ➝ Show Controls in Other Apps. This control window allows you to see what’s being broadcast, and includes buttons to change Scenes and Source modes.

Note: In all Screen Share modes, Ecamm Live’s windows will only be visible to you, while it is invisible to your broadcast or recording. Stealthy.

Zooming in Screen Share Mode

Zoom by using the + and buttons in the Control Bar. The zoom will move in (or out) from the center of the Main Window. You can also zoom using the scroll function of your mouse or zoom gesture on a trackpad, while your cursor is over the Ecamm Live Main Window. Using a mouse or trackpad allows you to zoom to the current position of the cursor.

If you use a mouse, scroll “up” to zoom in, or scroll “down” to zoom out.

If you use a trackpad, you can use the pinch-to-zoom gesture. With your cursor placed over the Ecamm Live Main Window, spread two fingers apart to zoom in towards your cursor. Pinch two fingers together to zoom out. Once zoomed, move around the screen using the scroll gesture on the trackpad (move two fingers).

Pinch to shrink —Pinch to shrink

Spread to enlarge —Spread to enlarge

You can show your live camera in the broadcast while screen sharing with the Picture-in-Picture tool.

Video Files

When you need to play a video file within your live broadcast, use the third icon in the Sources Bar, the icon. Clicking this the first time will display a file browser, allowing you to locate and select a video file for feedback.

On subsequent clicks of the Video icon, you’ll see a menu appear instead, with additional options. Choose File brings up the File Browser to choose a new video. A Recent section lists any videos you’ve previously selected during this broadcast. Selecting a video from this list will immediately play the video filling your broadcast window. If your Recent Videos section needs a clean up, select Clear Recent Items.

Your video will begin playing immediately after selection. If you would prefer to disable autoplay, you may do so in the Options menu ➝ Auto-Play Videos. If you’d like to have the selected video start over automatically as soon as it finished, choose Options menu ➝ Loop Video Files.

Audio from the video will be broadcast automatically, but your microphone will be automatically muted if a Picture in Picture box for your camera is not present. Read the Picture-in-Picture section for full details.

While the video plays, you can control it with the Video Control Bar. Only you can see the controller, it is invisible to your audience. You can drag this control bar around the window if it’s blocking your view. The bar fades in and out depending on the movement of your cursor. Audio from the video file can be monitored and adjusted in the Sound Levels Window.

Figure: Video Playback Mode Annotated Main Window

We are not lawyers, but when playing videos you did not create yourself, be aware of copyright law and usage rights in your jurisdiction.

Picture in Picture for Screen Share and Video Mode

In Screen Share Mode

The leftmost icon of the Screen Share control bar toggles the visibility of the camera Picture-in-Picture (PiP) box.

In Screen Share mode, your microphone is automatically enabled whether or not the PiP window is not on screen. You can mute or unmute your mic audio by clicking the icon within the Screen Share control bar.

In Video Mode

To use or hide the PiP box, click the leftmost icon in the video control bar.

In video playback mode, your microphone is automatically muted when the PiP window is not on screen. Only the video’s audio will play. When the PiP window is brought back, your audio is automatically unmuted. You can unmute (and mute again) your mic audio while a video is playing and the PiP is hidden by clicking the microphone icon within the video control bar.

In Screen Share and Video mode

Picture-in-Picture can be summoned or dismissed with the Options menu ➝ Show Picture-in-Picture or shiftP. The PiP box can be moved anywhere within the Main Window. It features a mute toggle button only visible to you, for your microphone. You can change the size of the PiP by dragging the bottom right corner of it. You can change the shape of the PiP window OptionsPicture-in-Picture Shape.

When switching between Camera mode and other source modes with Picture-in-Picture turned on, the OptionsAnimate Transitions setting adds a zoom transition. The transition will only animate if the same camera source is being used in both Scenes and the Picture-in-Picture shape matches the broadcast’s shape.

The Sound Levels Window

The Sound Levels Window shows what audio source is in use. Clicking on the name of the source will show you any other available sources. The Microphone menu at the top of your display also provides options, including the Mute Microphone tool—shiftM.

Sound Levels Window in Video Playback Mode

A meter in the Sound Levels Window will show the currently selected source’s volume level. You can adjust this with the slider. When a Skype call is in progress, you can also adjust its levels with the Sound Levels Window. More on Skype Interviews later in this manual. When sharing your screen, you’ll also see a sound level adjustment for System Audio.

How Ecamm Live Deals with Audio

Ecamm Live accommodates one audio input source at a time. For example, if you wanted to interview someone in person, and you plug in more than one USB mic, Ecamm Live will only allow you to select one of these mics at a time.

If you need multiple external audio sources for your broadcast, use a hardware device that accepts more than one microphone in, like a mixer. If your device supports more than one channel of audio, Ecamm will mix all input channels together.

Echo Cancellation

If you are using your Mac’s speakers during your broadcast, that may cause an echo if your mic picks up speaker audio. To prevent this, Ecamm Live has Echo Cancellation, which you can enable or disable in the Sound Levels window, or Options menu ➝ Echo Cancellation. Echo Cancellation listens for sounds produced by your speakers and removes it from your broadcast. It works remarkably well, most of the time. If your audience is reporting missing sound, try turning off this feature. If you are using headphones, echo cancellation is disabled automatically.

When Echo Cancellation is enabled, Ecamm will only use audio on channel 1 of multi-channel audio input devices. If your audio interface has more than one channel, be sure to turn off Echo Cancellation.