Wowza™ Media Systems provides Wowza ClearCaster™ software updates that have new features and functionality as well as bug fixes. This article provides details about ClearCaster software updates and describes known issues with the software.
Note: See Update Wowza ClearCaster Software to learn how to update your ClearCaster device to the latest software version.
The latest build, Wowza ClearCaster 2.0.0 build 07 (2.0.0.07), is available as a software upgrade for all compatible Wowza ClearCaster appliances.
Wowza ClearCaster 2.0.0.07
Wowza ClearCaster 2.0.0 build 07 (2.0.0.07) was released on May 21, 2019.
Note: Upgrading your appliance to version 2.0.0.07 or later is only available for ClearCaster appliances on hardware build 06 or higher. If you're not sure of your hardware build number, check the underside of the appliance.
New features and functionality in Wowza ClearCaster 2.0.0
Wowza ClearCaster 2.0.0.07 includes several enhancements and bug fixes.
Broadcasting to any RTMP destination with universal mode - Wowza ClearCaster version 2.0.0.07 introduces the ability to broadcast to a wide variety of destinations including the Wowza Streaming Cloud service; Wowza Streaming Engine instances; video-sharing websites such as Facebook, YouTube, Twitch, and Twitter; and other RTMP-based destinations. Pre-tuned encoding templates are provided for each destination option to help provide the best streaming experience possible. For more information, see Create and manage Wowza ClearCaster broadcasts in universal mode.
Wowza ClearCaster 2.0.0 updates to the encoder software
Changes (since 22.214.171.124):
- Fixed an audio-synchronization issue by limiting QuickSync reference frames to 1.
- Reworked the QuickSync H.264 encoder so that it properly switches bitrates to drain the encoder before switching.
- Added support for broadcasting to RTMP-based desintations in addition to Facebook Live.
- Improved the talent view help text for pairing and streaming to Facebook Live.
- Increased the heap size to avoid running out of memory.
- Updated the LCD screens to support universal mode broadcasts.
- Fixed a problem with the x264 encoder that prevented some tuning parameters from being available.
- Removed the printIn when unpairing an encoder from Wowza.
- Reconfigured the systemd service script to restart on Java OutOfMemory.
- Separated recording folders for recordings.
- Improved the logging of bitrate switching.
- Fixed a problem with bitrate throttling where we were improperly capping down the increment, which could lead to significant drops in bitrate.
- Added a new bitrate measurement to see if the bitrate of the last full GOP is a more consistent bitrate measurement.
- Added tracking of frame counts for video, video keys, and audio.
- Fixed an issue with pairing ClearCaster devices to Wowza.
- Improved the startup process to avoid a connected HDMI monitor from going into power saving mode.
- Added unique IDs to broadcastSession.
- Fixed an issue with an HDMI-connected monitor display by turning off DPMS for xdummy.
Wowza ClearCaster 2.0.0 updates to ClearCaster Manager
The following changes to Wowza ClearCaster Manager were released on or after May 21, 2019.
- Fixed high-motion and Facebook path optimization settings so that they return the results faster.
- Added support for the user interface to use GraphQL queries.
- Updated the optimize Facebook path help text.
- Added universal mode to the user interface.
- Updated engineering view on the HDMI-connected monitor to support universal mode.
- Updated to use Wowza JWT for authentication.
- Added predefined encoding templates for universal mode.
- Added more encoding templates.
- Added a toggle in the ClearCaster Manager header to switch between Facebook mode and universal mode.
- Added a check to determine the encoder software version to properly enable or disable switching to universal mode.
- Improved the encoding template settings.
- Improved the design and usability of the universal mode user interface.
- Modified the stop broadcast behavior so that it immediately ends the broadcast. There isn't a confirmation dialog associated with stopping the broadcast anymore.
- Added the ability for Wowza to display notification banners in universal mode.
Review previous updates to Wowza ClearCaster for information about specific releases.
Wowza ClearCaster 126.96.36.199
Wowza ClearCaster 1.0.7 build 15 (188.8.131.52) was released on March 19, 2019.
New features and functionality in Wowza ClearCaster 1.0.7
Wowza ClearCaster 184.108.40.206 includes several enhancements and bug fixes.
DNS path optimization - Wowza ClearCaster 220.127.116.11 adds support for optimizing the network path used to send the stream from the ClearCaster to Facebook. Path optimization should increase network and stream reliability, improving the viewer experience. This is enabled by default but can be configured from the ClearCaster Settings dialog.
Wowza ClearCaster 1.0.7 updates to the encoder software
Changes (since 18.104.22.168):
- Removed monetization_status from Facebook metrics query because we don't have app permissions to ask for this data.
- Updated the video adjustment of encoding to use QuickSync on ClearCaster hardware build 1.0.5 and earlier if the frame size is greater than 1280 x 720.
- Fixed some issues that prevented the node script from running properly on ClearCasters.
- Reduced the total number of reference frames to 1 and B-frames to 1 when using the X.264 or QuickSync encoders at 1080p60 to improve performance.
- Made minor adjustments to the internal minimum bitrates.
- Added support for GPT-formatted USB drives, which should improve the performance of USB drives formatted on macOS devices.
- Added new fields to the incremental log data so that we can calculate (in milliseconds) for audio.
- Added network path optimization for broadcasting to Facebook.
- Updated the Vidpresso URL to point to the new Facebook-based URL.
Wowza ClearCaster 1.0.7 updates to ClearCaster Manager
The following changes to Wowza ClearCaster Manager were released on or after March 7, 2019.
- Improved custom monitoring view to include units for bitrates and ping time.
- Improved monitoring so that if the ping time isn't available, the Manager displayed N/A.
- Fixed a problem with monitoring.
- Fixed an issue with custom monitoring views that dropped frames and caused problems with the way other fields are displayed.
- Improved ability to identify which redundant encoder is active.
- Added support for a new URL structure.
- Added an indicator for the encoder path optimization.
- Added animated ellipses to the indicator for path optimization.
- Added a setting to enable Facebook path optimization.
- Fixed an issue with some settings updating to incorrect values sometimes.
Wowza ClearCaster 22.214.171.124
Wowza ClearCaster 1.0.5 build 17 (126.96.36.199) was released on December 20, 2018.
New features and functionality in Wowza ClearCaster 1.0.5
Wowza ClearCaster 188.8.131.52 includes several enhancements and bug fixes.
Custom broadcast monitoring view (beta) - Wowza ClearCaster 184.108.40.206 adds public preview support for using a customized monitoring view to monitor broadcasts. The custom monitoring view is displayed on a local monitor connected to the ClearCaster via HDMI. A custom monitoring view is a great way to ensure visibility of the data you care about most. Because this is a preview feature, please contact Wowza Support if you'd like to build your own custom monitoring view.
Support for multiple audio channels - Wowza ClearCaster 220.127.116.11 adds support for multiple audio channels. This can be configured at the appliance level and serve as a default for all broadcasts associated with the ClearCaster, or on a per-broadcast basis. If multiple audio channels aren't specified, a single audio channel is used for the broadcast.
Support for default titling and graphics - With Wowza Clearcaster 18.104.22.168 and later, titling and graphics can now be configured at the appliance level. In addition to being able to configure broadcast-specific titling and graphics, which would override any default configuration, you also have the ability to configure your ClearCaster to apply default titling and graphics to all broadcasts associated with the appliance. When using this feature, the video source is encoded, and then the graphics overlays are superimposed on top of the video. This ensures that even if something happens to your graphics application during a broadcast, the video stream will continue without interruption. We are most closely integrated with Vidpresso:LIVE, but you can also configure a broadcast to use other graphics applications as long as they output a URL. For more information, see Add titling and graphics to a Wowza ClearCaster broadcast.
Support for recording broadcasts on your ClearCaster (beta) - Wowza ClearCaster 22.214.171.124 adds public preview support for recording high-quality H.264 renditions of broadcasts. Note that this is a preview feature and storage is limited to a single event. When you need to make room for a new recording, you can use a USB flash drive to archive it. Please contact Wowza Support if you need assistance with this feature.
Wowza ClearCaster 1.0.5 updates to the encoder software
Changes (since 126.96.36.199):
- Updated the MQTT port from 1883 to 1884.
- Added a new driver environment to setenv.sh.
- Fixed an issue that occurred when running a version of Java earlier than Java 10 and trying to get the CPU load using the system MBean.
- Restored the Quick Sync libraries to the lib-native folder.
- Added the NGCodec demo encoders plugins, limiting the reference frames for Quick Sync encodes to two because anything more causes issues.
- Updated to the latest version of x264 and recompiled on Ubuntu 18.04.1
- Fixed an issue with osupdate updates.
- Enabled support for manually entering and editing a second DNS server in the network configuration file.
- Updated the LCD screens to support other personalities, such as Workplace by Facebook.
- Fixed a typo on the LCD screens.
- Added captureSessionAudioLevel data to system monitor event.
- Updated the capture card limit to 30 frames per second (fps) when encoding to 30 fps or lower. In that case, the frame rate is reduced by half for anything that is greater than 30 fps.
- Fixed issue so that the Quick Sync libraries are included in the ClearCaster software builds.
- Added a model for multiple renditions (adaptive bitrate streaming).
- Removed a dependency on DataTypeConverter, which isn't included in Java 9.
- Added a check to ensure that, when editing an IPv4 IP address with the LCD screen, each triplet value doesn't exceed 255. If you attempt to change a value to something greater than 255, the change isn't saved.
- Refactored code to support multiple renditions and stream targets. Currently, only the largest frame size and one of the stream targets is used for bitrate adjustments.
- Fixed an issue with automatically adjusting the frame rate when the source stream changes.
- Fixed an issue that prevented titling and graphics overlays from displaying properly after a reboot.
- Added support for expanding a 4x3 video source to 16x9 (anamorphic squeeze).
- Added an aspectRatioMode setting, where 0 is cropped and 1 is stretched.
- Enhanced the log collection to ensure that */etc/resolv.conf is copied to the system-info folder.
- Added a ClearCasterBroadcastSession.goKuveRecording method to signify for Facebook recording when to start recording.
- Added the overlay graphics configuration into CommandDeviceGetStatus.
- Map devices to overlay graphics so that they are recognized.
- Updated to ensure default settings work when the encoder is first added to a broadcast.
- Added support for broadcast-specific settings that override appliance-level settings.
- Added a fragmented MP4 writer so that files can play in QuickTime.
- Update the LCD to use the CaptureState to calculate FPS on the Stream Health screens.
- Added intrinsic scaler by half scaling and better.
- Added transcoder support for minQP, maxQP, and constantQP to the NVENC encoder.
- Added additional fields to the system monitor to track overheating events: cpuCoreInfo, coreThrottleCount, packageThrottleCount, and scalingCurrentFrequency.
- Added initial support for pushing MPEG-DASH to Facebook.
- Added support for audio channel mapping in the transcoder capture system. Added audio channel level data to capturesessioninfo, and added devicesetaudiochannelmap to change the channel mapping.
- Added the title field to the system monitor data.
- Fixed an issue with the titling and graphics overlays not updating when the URL was changed.
- Added the field monitorBrowserGraphics to the system monitor data.
- Added new telemetry data fields and propagated some to the incremental data.
- Added support for parsing the new audio data sent by the encoder.
- Added a way to turn on and off SSH validation.
- Fixed a problem with capture settings being propagated to the LCD screen.
- Added support for a single ClearCaster recording.
- Switched the WebSocket implementation from Neovisionaries to Netty to get support for socks4/5 proxies.
- Added support for SOCKS/HTTP proxy to ClearCaster.
- Fixed a problem with the channel map and volume not being applied when set at the start of a broadcast.
Wowza ClearCaster 1.0.5 updates to ClearCaster Manager
The following changes to Wowza ClearCaster Manager were released on or before January 29, 2019.
- Fixed and improved the Engineering View.
- Added an option to set default titling and graphics for all broadcasts associated with a ClearCaster appliance.
- Fixed a bug that prevented the FPS from being reported in the Wowza ClearCaster Manager.
- Added an option to create a custom broadcast monitoring view over HDMI.
- Added ability to configure default and per-broadcast audio channel mappings.
- Fixed an issue with pairing a ClearCaster appliance with Facebook for the first time.
- Fixed an issue that caused both ClearCaster appliances to be labeled as active in some redundancy use cases.
Wowza ClearCaster 188.8.131.52
Wowza ClearCaster 1.0.4 build 23 was released on October 4, 2018.
New features and functionality in Wowza ClearCaster 1.0.4
Wowza ClearCaster 184.108.40.206 includes several enhancements and bug fixes.
Support for adding titling and graphics to Facebook Live broadcasts - With Wowza Clearcaster 220.127.116.11 and later, titling and graphics is fully supported and available out of preview. This was previously a beta feature. When configuring Wowza ClearCaster broadcasts to Facebook Live in Wowza ClearCaster Manager, you can add browser-based graphics overlays to the broadcasts. When using this feature, the video source is encoded, and then the graphics overlays are superimposed on top of the video. This ensures that even if something happens to your graphics application during a broadcast, the video stream will continue without interruption. We are most closely integrated with Vidpresso:LIVE, but you can also configure a broadcast to use other graphics applications as long as they output a URL. For more information, see Add titling and graphics to a Wowza ClearCaster broadcast.
High-motion video - Wowza ClearCaster 18.104.22.168 fully supports high-motion video at 60 frames per second (fps). This was previously a beta feature. For more information, see Stream Wowza ClearCaster high-motion video.
Enhanced bitrate reporting - Wowza ClearCaster 22.214.171.124 includes improvements to the bitrate statistics reported for Live and Preview broadcasts. For more information, see Monitor Wowza ClearCaster live stream health.
Wowza ClearCaster 1.0.4 updates to the encoder software
Changes (since 126.96.36.199):
- Added validation for IPv4 addresses entered from the LCD screen to ensure that now triplet exceeds 255. If the number entered is great than 255, it's not updated.
- Removed comments and reactions from the system monitoring data because of Kibana collection limits.
- Added a simple operation at startup that updates the capture card firmware if necessary.
- Added a delay in prepareStream to allow time to recognize capture settings before continuing to set up the encoding. This fixes a problem with broadcasting 1080p60 sources as 1080p30 broadcasts.
- Updated Wowza Transcoder to use x.264 for 1080p60 sources if the hardware version is 1.1 or greater.
- Removed VAAPI B-frames because there was a bug in the VAAPI driver that caused low bitrate and quality when B-frames were enabled.
- Fixed a problem with redundancy that caused any encoder that was restarted to use the broadcast URL rather than the live_encoder API URL.
Changes (since 188.8.131.52)
- Added support for the Vidpresso:LIVE API.
- Connected the Vidpresso remote API calls to set a broadcast ID.
- Improved the way ClearCasters handle interlaced frames.
- Added a progress bar to be displayed on the LCD screen during an update.
- Improved the update progress bar so that it now includes any necessary additional steps and pauses for clarity.
- Added the update progress bar view to the Talent View display.
- Fixed the encoder so that if it's interrupted mid-stream, the LIVE timer will pick up where it left off before the interruption.
- Added the ability for Blackmagic transcoders capture to set the frame size for a frame that is generated when no source is connected.
- Added the ability to track the frame size of the last captured frame, including any scaling applied because of target frame size or "no-source" frames being scaled.
- Configured the default frame size for "no-source" frames to be 1920x1080.
- Updated the simulcast start/stop logging to include the name of the simulcast target.
- Added support for vertical video aspect ratios that are rotated left or right.
- Fixed an issue with the Go Live where the encoder was not fetching the encoding settings when the state machine switched from capture to live.
- Improved the countdown timer.
- Improved the color conversion from BT 709 YUV to RGB on the Talent View.
- Fixed osupdate updates.
- Enabled manual editing of two DNS servers in the LCD Settings > Network Info menu.
- Added a Workplace by Facebook 'personality' to the ClearCaster and LCD settings.
- Updated how we handle timecodes to increase accuracy and improve reliability for scheduled broadcasts.
Wowza ClearCaster 1.0.4 updates to ClearCaster Manager
The following changes to Wowza ClearCaster Manager were released on or before November 12, 2018:
- Fixed an issue that caused cross-posted broadcasts to appear incorrectly in the list of broadcasts.
- Removed beta tags from the high-motion video (60fps) and titling and graphics features.
- Enhanced the stream health monitoring bitrate statistics.
- Enacted limited editing of broadcasts created from facebook.com/live/create to prevent any breaking changes to these broadcasts.
- Miscellaneous other bug fixes.
- Enabled previews of streams attached to the redundant ClearCaster devices associated with broadcasts.
- Updated broadcast monitoring to include stream health metrics from Facebook.
- Other minor changes and bug fixes.
- Updated the device information and options displayed on the ClearCasters page, including removing the option to Go Live and End Broadcasts from here. Instead, if a ClearCaster is associated with a broadcast, a link to the broadcast is provided.
- Added several new options to the Facebook Live broadcast workflow: redundancy, aspect ratios, tags, donate, and overlays/Vidpresso integration.
- Added support for using a ClearCaster to broadcast to Workplace by Facebook.
- Added an option to enable simulcast targets to start simulcasting to Wowza Streaming Cloud while the Facebook Live broadcast is still in preview.
Known issues associated with Wowza ClearCaster 1.0.4
Incorrect link provided to pair with Workplace by Facebook in the Talent View - If you're using an encoder build earlier than Wowza ClearCaster 184.108.40.206, the link and instructions provided on the Talent View for pairing your device with Facebook or Workplace will always link to www.facebook.com/device. If you're trying to pair with a Workplace account, you must navigate to work.facebook.com/device. For more information about pairing with Facebook and Workplace, see Pair Wowza ClearCaster with Facebook.
Wowza ClearCaster 220.127.116.11
Wowza ClearCaster 1.0.3 build 10 (18.104.22.168) was released on June 14, 2018.
New features and functionality in Wowza ClearCaster 1.0.3
New and improved Broadcast workflow - The addition of a Broadcast page in the ClearCaster Manager gives you enhanced options for configuring and managing live streams. The Go Live workflow has been updated and is now called Create Broadcast, which aligns with the enhanced options on the Broadcast page. Additionally, as part of the Broadcast workflow, you'll be able to configure simulcasting, audience restrictions, and other broadcast-specific settings. See Create a Wowza ClearCaster Live Stream for Facebook for more information about creating broadcasts and Manage your Wowza ClearCaster broadcasts for more information about managing broadcasts.
Support for simulcasting to Wowza Streaming Cloud -With ClearCaster version 22.214.171.124, you can now simultaneously broadcast (simulcast) a stream from your Wowza ClearCaster device to Facebook Live and Wowza Streaming Cloud. For more information, see Simulcast a Wowza ClearCaster Live Stream on Facebook Live and Wowza Streaming Cloud.
Wowza ClearCaster 1.0.3 updates to the encoder software
Changes (since 126.96.36.199):
- Added support for 60 frames per second and aspect ratio settings for individual broadcasts.
- Fixed the maximum frame rate system so it applies only when going into a preview.
- Added a startup delay to wait for healthy capture frames and avoid using an incorrect frame size.
- Added support for comments without user information.
- Added a custom simulcast Flash connection version string with the format: FMLS/3.0 (WowzaClearCaster [version]).
- Removed user_actions.video scope because it's been deprecated.
- Fixed an issue that prevented broadcast information from being received after the broadcast was received from the live encoder API.
- Changed the ClearCaster behavior so that if no source is found, the ClearCaster will default to 1080p output.
- Improved the software update process. The LCD and TalentView screens now indicate when an update is in process.
- Fixed an issue that prevented ClearCaster devices from recovering if it is rebooted or turned off during an update.
Wowza ClearCaster 1.0.3 updates to ClearCaster Manager
The following changes to Wowza ClearCaster Manager were released on June 12, 2018:
- Updated the Wowza ClearCaster Manager header to have page tabs: ClearCasters, Broadcasts, and Simulcast.
- Added a Broadcasts page for adding, monitoring, and managing broadcasts.
- Modified the Go Live dialog Create Broadcast and aligned with new broadcast functionality.
- Added a Simulcast page for adding and managing Wowza Streaming Cloud live streams for simultaneous broadcasting.
- Added the option to enable simulcasting to a configured Wowza Streaming Cloud live stream for broadcasts.
- Updated privacy settings and added a tooltip.
- Fixed an issue that caused the live stream broadcast preview to freeze when published (go live).
- Re-enabled broadcasting to Facebook Groups.
- Fixed an issue that allowed the creation of broadcasts without titles.
Wowza ClearCaster 188.8.131.52
Wowza ClearCaster 1.0.2 build 26 was released on March 22, 2018.
Changes (since 184.108.40.206):
- Fixed several issues with ClearCaster network IP settings configuration.
- Added support for vertical (9:16) video.
Wowza ClearCaster 220.127.116.11
Changes (since 18.104.22.168):
- Enabled support in ClearCaster for 1080p60 video streaming. You can send 1080p60 source video from ClearCaster to Facebook at 30 frames-per-second (fps) by default, or at 60 fps by using a High motion option. Facebook doesn't support 1080p60 video playback at this time.
- Enabled support for ingesting CEA-608 captions in video sent to the ClearCaster SDI input port. (Note: Captions cannot be sent to the HDMI input port.)
- Added ability to crop and send square video to Facebook Live for optimal playback on mobile devices.
- Enabled monitoring statistics to be displayed in ClearCaster Remote Admin (clearcaster.wowza.com): video resolution, bitrate, network ping time, bytes waiting to be sent, and %CPU load.
- Fixed an issue that prevented proper use of the Facebook Live scheduling feature for scheduling ClearCaster live video.
- Added general improvements and fixes to Talent View.
- Fixed an issue that prevented network settings from persisting when configured in the ClearCaster LCD.
- Fixed an issue where changing the source video signal format from YUV to RGB without changing the frame size caused the ClearCaster to stop responding.
Wowza ClearCaster 22.214.171.124
Note: You may receive two update notifications, and must install two updates, in order to upgrade your ClearCaster to version 126.96.36.199. The first update installs software that enables the second update (which includes the new features, enhancements, and bug fixes described below) to be installed.
Changes (since 188.8.131.52):
- Added user-selectable Talent View layouts that show or hide comments.
- Added ability to ClearCaster LCD and Remote Admin (clearcaster.wowza.com) to adjust countdown clock increments.
- Added support to ClearCaster LCD and Remote Admin for displaying input/output video resolution and frame rate.
- Added ability to ClearCaster LCD to adjust audio levels.
- Enabled ClearCaster-to-Facebook pairing on Remote Admin without pairing code.
- Enabled view on Remote Admin that shows ClearCasters paired with Facebook that aren't owned by the user.
- Other enhancements and bug fixes:
- Fixed emojis display on Talent View
- Added ability to ClearCaster LCD to cancel stream before countdown ends
- Changed Broadcast Status light on ClearCaster front panel to only illuminate when the video is Live (not in Preview)
- Fixed network timeout issue where network didn't time out after 90 seconds
- Fixed issue where live video ended 5 seconds early
- Fixed issue that prevented ClearCaster from recovering after network loss
- Improved ClearCaster registration experience
Known issues in version 184.108.40.206
- If you change the video signal format for the video source connected to the ClearCaster from YUV to RGB without changing the frame size, the ClearCaster may stop responding. This occurs because the memory that the ClearCaster allocates to store the YUV format isn't sufficient when switching to RGB. If you change the video signal from YUV to RGB, also change the frame size to avoid this issue. This issue will be fixed in a future software update.
Wowza ClearCaster 220.127.116.11
- Wowza ClearCaster 18.104.22.168 is the first release of the software.