November 2022
Mux Real-Time Video (Spaces) has been released to General Availability. This update includes updated SDKs for all platforms, multi-region support, user experience report collection, and additional improvements and bug fixes. Please refer to the following for more details:
Version 1.0.0 of the Spaces Web SDK has been released. This version adds user experience reporting, QoS tracking, automatic reconnect handling on poor networks, and additional improvements and bug fixes. For more information: Spaces Web SDK 1.0.0 Release Notes
Mux has released version 7.0.0 of its NodeJS SDK. This release fixes some type issues for customers using TypeScript, and adds some missing module exports. In addition, it adds support for signing JavaScript Web Tokens (JWTs) for Mux Real-Time Spaces. In order to support signing of Spaces, the JWT.sign method has been deprecated in favor of separate JWT.signPlaybackId and JWT.signSpaceId methods.
Mux Player v1.4.0 is released. This update includes a prefer CMCD prop and UI updates to improve: overlay behavior, icon size, control spacing and behavior, and positioning of the Live indicator.
Version 3.1.0 of the Mux Data SDK is now available. This update adds APIs to override the detected category of a user’s device (phone, tablet, kiosk, drone, or anything), as well as things like OS version or device manufacturer. This version also includes a fix for renditionchange events on ExoPlayer r2.11.x, as well as a fix related to verbose beacon logging.
See our release notes for more information! Full changes can be found here as well.
Version 3.0.0 of the Mux Data SDK for AVPlayer is now available on SwiftPM and Cocoapods. This version adds support for overriding device-related metadata, such as OS name and version, device type, and so on. This update also adds official support for iOS 16, although apple updates have forced us to remove support for iOS versions 9 and 10.
For more information, see our release notes and our development guide
Version 0.9.0 of the Mux Data SDK for IMA Ads is now available. This update also adds official support for iOS 16, although recent updates to Google’s IMA SDKs have removed support for all iOS versions before 12.0
For more information, see our release notes and our development guide, and full changes.
October 2022
The Mux Data View Details page has been enhanced to show the detailed metadata in the view timeline for renditionchange events. See here for information on the metadata that may appear: https://docs.mux.com/guides/data/mux-playback-events#renditionchange-optional
The Mux Data View Details page has been enhanced to provide detailed information on failed or canceled requests. This is provided in the user interface for clients that track network level requests. See our documentation for more detail.
A single playback restriction contains a list of domains allowed to play your videos. You may allow up to 10 unique domains or sub-domains where your videos will be embedded. We’ve raised the limit for the number of playback restrictions per environment from 5 to 100. You can read more in our Docs.
We have enhanced the Mux Data UI with a new date time picker. The new component allows choosing the date and time. You may precisely select a time range via click and drag in the metrics view.
New sign-up and log-in visuals that help users quickly understand and complete account creation.
Transparent Pay as You Go Video pricing provides lower per-unit pricing as your usage of Mux grows. Read more on our pricing page.
Performance improvements to the usage system that mean faster responses and fewer timeouts when you access the usage API or view your bill.
Mux Player v1.0.0 (General Availability) is released. This update includes focus, default width, keyboard shortcut, and additional improvements and bug fixes. Please refer to the Release Notes for details.
You can now find Settings, Docs and Support, and account management separated into distinct menus in the Mux dashboard navigation.
September 2022
This update includes support for adding and removing captions and subtitles within the app, getting the Mux Player code, and displaying the data saved for developers. For adding content, we have added drag and drop uploading support via the Mux Uploader which can be added with the URL and Mux Asset ID. Additional goodies include a global option for audio normalization, a toggle for signed or public playback IDs per field, buttons to manually resync with Mux, separate 'remove' and 'delete' buttons, and UI improvements. Under the hood, other updates include React, UI, and testing libraries plus more graceful error handling. You can read more in the Contentful Marketplace.
We are announcing the exciting and extensive release of the Mux Data SDK v3.0.0 for ExoPlayer. This update converts most of the SDK to Kotlin, removes long-deprecated methods, and adds API changes. A more simple SDK setup process no longer requires you to specify the screen size of your device. You may now pass your `ENV_KEY` through a constructor instead of supplying it to `CustomerPlayerData`. Finally, we removed exposed internal callback methods that likely will not impact you.
For the full list of API changes, check out the release notes on GitHub.
Since we released Mux Player (HTML Element and React) to public beta, we’ve made a variety of improvements including additional control customizations, keyboard shortcuts, video titling, and fixes. Refer to the release notes below for more information.
Additional Links
August 2022
You can now use npm to integrate most Mux Data web player SDKs. SDKs are now available in the npm repository for Shaka Player, JW Player, React Native Video, Kaltura, Bitmovin, Akamai Media Player, THEOplayer, Flowplayer, and Chromecast, in addition to the existing SDKs for HTML5 Video Element, HLS.js, Dash.js, and Video.js. Please visit the Mux docs page for the specific player SDK to learn more about how to integrate and deploy Mux Data with your player.
We’ve released Reconnect Window support to general availability for all modes of live streams, including reduced & low latency, in Beta. Reconnect Window is the time in seconds you want Mux to wait for the live stream to reconnect before considering it completed and generating a recorded asset. Slate image is also in general availability. Add a slate image as a video frame during live stream interruptions to let your viewers know the video isn’t over and you’re trying to reconnect. During beta, we stabilized the feature by fixing problems that were causing occasional crashes.
This update fixes player size and full-screen detection for users who are using MuxStatsExoPlayer.setPlayerSize() to manually override the detected size of their player. The method now takes physical pixels, as documented. If you are using MuxStatsExoPlayer.setPlayerSize(), you may need to update your code to supply physical pixels instead of density-independent pixels.
If you want billing emails to go to more than one email address, your users with the admin role can now specify up to 5 email addresses on the payments page without contacting Mux support.
If your company uses Okta for Single-Sign On, you can now log into the Mux dashboard using Okta as an SSO provider.
We’re excited to announce that Mux Player is now released to Public Beta! Mux Player is already integrated with Mux Video and Mux Data, and supports a variety of features such as adaptive controls based on stream type, timeline hover previews, Chromecast & Airplay, Signed URLs, Custom Domains, and more.
For more details, check out our Blog Post and Player documentation.
This release of the Mux Data SDK for ExoPlayer adds support for ExoPlayer v2.18.1 and a couple of bug fixes related to uncommon use cases. The SDK should be more stable when used with custom builds of ExoPlayer. We also fixed a data integrity issue related to views with very long periods of user inactivity.
July 2022
Mux Data is changing the way it tracks video views that are stopped for an extended period of time. Going forward, if a video player stops sending events (for example by explicitly stopping playback or backgrounding an app) and then playback is started again after one hour or more, the playback session will be considered a new view. A new view_id will be generated on the SDK client and the metrics will be aggregated as a different view. If playback continues within one hour of being stopped, it will be considered part of the same view and will be appended to the existing view.
This behavior has changed in the following releases:
mux-embed v4.12.0+Mux Data is changing the way ids are generated for Video Views in the Mux Data API. The view id returned from the List Videos Views API will now be the same as the id and view_id returned from the Get Video View API for any views ending on or after July 28, 2022 UTC. Previously, these ids were different. The format will still be a string and users that are treating the view id from the Video Views API as an opaque string can continue using the id in the same way with no changes. This change allows you to reference the views with a consistent id from the List and Get Video View APIs.
This update for the Mux Data SDK for Exoplayer allows you to override metadata about the device that is playing your video. This feature is has not been implemented on Mux Data backend yet, but you can start using it in the Mux Data SDK with this latest release.
Additional Links:
We’ve increased the maximum value of the live stream’s reconnect_window parameter from 5 minutes (300 seconds) to 30 minutes (1800 seconds). Reconnect Window is the time in seconds you want Mux to wait for the live stream to reconnect before considering it completed and generating a recorded asset. For many scenarios, Reconnect Window of 5 minutes just was not long enough, like an encoder machine reboot. You can set the reconnect_window parameter with live stream Create API and Update API endpoints.
We’ve released Reconnect Window support for all modes of live streams, including reduced & low latency, in Beta. Reconnect Window is the time in seconds you want Mux to wait for the live stream to reconnect before considering it completed and generating a recorded asset. You can also add a slate image as a video frame during live stream interruptions to let your viewers know the video isn’t over and you’re trying to reconnect. You can read more on docs and the blog post.
We’ve released Custom Domain for Mux Video to Beta. You can stream videos or serve images from your branded domain instead of from stream.mux.com and image.mux.com. You can learn more about Custom Domains, reasons to use, and information on requesting access from the announcement blog.
We have released the Streaming Exports for Mux Data Video Views to General Availability. This feature allows you to export Video Views, as they are completed by viewers, to your data infrastructure using a streaming data service, either Amazon Kinesis or Google Pub/Sub. Currently, Streaming Exports are available to customers on Media or custom plans. The docs have more detailed information on integrating and using the Streaming Exports data.
By providing technical terms and proper names to us before a live stream, we can increase the accuracy of auto-generated live closed captions. Create a transcription library by making a POST request to the /transcription-vocabularies endpoint and define the input parameters.
Closed captions refer to the visual display of the audio in a program. Auto-generated live closed captions use Artificial Intelligence based speech-to-text technology to generate closed captions. You can enable live auto-generated captions by adding the generated_subtitles array at time of stream creation or to an existing live stream.
June 2022
This update includes the debut of Mux Player for dashboard playback, the addition of several metadata tags for developers to use, and custom domain support for Mux Video. An update to UpChunk should show faster uploading times and bug fixes. Last, additional bug fixes sprinkled all-around.
Mux on the Contentful Marketplace
We’ve updated the theoplayer-mux Web SDK to support the npm-based installation for THEOplayer. The theoplayer-mux Web SDK can now be initialized with an existing THEOplayer instance instead of relying on the `window.THEOplayer` instance that is not present when using the npm-based THEOplayer. Read the Release Notes for more information.
We have deprecated the add_audio_only query parameter on stream.mux.com. The add_audio_only parameter added an audio-only variant to the HLS manifest. However, this audio-only variant is no longer required as Apple’s HLS authoring spec no longer mandates this. In addition, many video players across web and mobile do not support this audio-only variant. For these reasons, Mux has chosen to deprecate this feature.
We’ve updated the bitmovin-mux Web SDK to support the module-based Bitmovin player. The Bitmovin web player can be instantiated as a single player package or as individual player modules. Previously, the bitmovin-mux Web SDK would throw an error if it was used with the module-based player but it now works as expected. Read the Release Notes for more information.
May 2022
We have updated our beta version of the Mux Data SDK for THEOplayer to support THEOplayer v2.92.0. Support for THEOplayer 3.x is planned soon. For more information, see Github Release for v0.1.3 and the Github repo: Mux Data SDK for THEOplayer.
This update of the Mux Data SDK for Exoplayer fixes some build issues experienced by customers that are using custom ExoPlayer builds, or are only using exoplayer-core. If you’re using the full ExoPlayer library and getting it via Maven Dependency, then your build should be unaffected. For more information, see the Github Issue regarding this issue, the Github Release for v2.7.2, the Github repo: mux-stats-sdk-exoplayer, and the Guide: Monitor Exoplayer.
We have updated the Mux Data API timeframe rounding behavior of the Data APIs to support higher granularity and greater consistency in the Data API endpoints, including: List Breakdown Values, List Insights, List All Metric values, List Filters, List Breakdown values. If the timeframe parameter of the query is 6 hours or less, the interval will round to a ten_minute boundary; if the timeframe of the query is 15 days or less, the interval will round to an hour boundary; if the timeframe is greater than 15 days, the interval will round to an day boundary.
We've added version 0.1.0 of our mux-java SDK. This is the initial release of the Mux Java SDK. New SDK versions typically introduce new features, bug fixes, and updates. You can read more in the 0.1.0 Release Notes and also on the package manager Maven. This is a release that we're confident is stable and usable in production, but we would love any customer feedback! To submit feedback, please email sdks@mux.com.
We’ve updated the mux-embed web SDK to support the collection of the Live Stream Latency metrics on native Safari web. We have also added a maximum beacon payload size to limit the number of request events that will be sent to Mux Data in the event the player makes many unnecessary requests. Read the Release Notes for more information.
We've added version 3.4.0 of our mux-php SDK. New SDK versions typically introduce new features, bug fixes, and updates. You can read more on the 3.4.0 Release Notes.
April 2022
We've added version 0.1.0 of our mux-csharp SDK. This is the initial release of the Mux C# SDK and it reflects the current state of the Mux API. You can read more on the 0.1.0 Release Notes. You can also view the NuGet package and GitHub repository. This is a release that we're confident is stable and usable in production, but we would love any customer feedback! To submit feedback, please email sdks@mux.com.
This release of the Mux Data SDK for ExoPlayer fixes a packaging error that caused build issues for some customers. We’re sorry about that. You can read more about this update in the Release Notes.
We’ve released v2.7.0 of our Mux Data SDK for ExoPlayer, and it’s a big one. We added support for setting dimension values from HLS session data, and fixed some bugs related to CDN detection. We also added support for ExoPlayer 2.17.1, and the Official Port of ExoPlayer for Amazon Devices. You can update to either version by following Step 1 of our Dev Guide. You can read more about this update in the Release Notes.
If you are a new Mux Video user, you can enjoy an updated getting started experience. The new Assets and Live Streams pages make it easy to upload your first video, find in-context onboarding guidance and get quick links to support and documentation. Users who have already uploaded a video no longer see the Getting Started link in the navigation.
We've added version 3.4.0 of our mux-ruby SDK. New SDK versions typically introduce new features, bug fixes, and updates. You can read more on the 3.4.0 Release Notes.
We've added version 4.1.0 of our mux-go SDK. New SDK versions typically introduce new features, bug fixes, and updates. You can read more on the 4.1.0 Release Notes.
We've added version 3.4.0 of our mux-python SDK. New SDK versions typically introduce new features, bug fixes, and updates. You can read more on the 3.4.0 Release Notes.
We have added new fields to the daily CSV and Streaming View exports for Mux Data: asset_id, environment_id, live_stream_id, live_stream_latency, playback_id, and viewer_device_model. If you are using Streaming View Exports you may now access these fields; an updated protobuf definition is available that contains the new fields. Please contact Support to enable the new version for your daily CSV exports.
We’re pleased to announce the initial release of the Mux Data SDK for Bitmovin Player for Android. The first public version is v0.5.1, and it reports all playback events. Support for Bandwidth, Experiments, and Live Latency is being planned or investigated for the v1.0.0 release. Read more in our Integration guide for the Bitmovin Player Data SDK or the GitHub repository.
We’ve updated the mux-embed web SDK to allow developers to disable the automatic tracking of rebuffering metrics. Developers who are building custom SDKs on top of mux-embed can use this option to manually track rebuffering using APIs or events from the player. mux-embed is no longer emitting an empty error when an error with code 1 is thrown. “No Versions” is no longer being set for the default Player Software Version. Read the Release Notes for more information.
No matter what Mux plan you are on - understand your bill, access your invoices and update your payment information through our new, more transparent, billing pages. You can view the new pages in your Account Settings under the Billing section.
You can now measure the amount of time from content ingestion to playback on the client using the Mux Data SDK. The Live Stream Latency metric reports on the average stream latency experienced by each viewer. The metric is also available for historical reporting. Latency can be aggregated by country, type of stream, video title, as well as the other dimensions available in the Mux Data Metrics reporting. To collect this data, you'll need to use Mux Data with your HLS live streams, insert EXT-X-PROGAM-DATE-TIME tags in your manifests, and have an up-to-date SDK release. You can learn more in the Blog Post.
March 2022
You will now see a Get Started page when viewing the Overview page for an environment that has not previously collected video view data. The Get Started page makes it easy to find the Mux SDK for your player, provides links to documentation, and makes the environment key that is needed for SDK integration easier to find.
We’ve added support for tracking experiment values via metadata such as X-SESSION-DATA HLS tags. The tags override values of the dimensions we track. Once the session data tags on the main playlist are loaded by your player, you may pass them to MuxStats::setSessionData(List<SessionTag>) in order to track the experiment values. Currently experiments are only supported for HLS streams.
We now support 5fps to 10fps as standard input which means you do not need to wait as long for ingest. Previously, all assets with a frame rate of less than 10fps were considered non-standard inputs. See our guide about why non-standard inputs take longer to process
We’ve added the max_continuous_duration parameter to Live Streams. You can now set the maximum duration for recording a single live stream event lower than 12 hours. Set the max_continuous_duration parameter during Live Stream creation or update an existing live stream. On hitting the duration, the behavior is the same as signaling the live stream has finished. For more information, see the Live Stream API and the Signal a live stream has finished API.
February 2022
We've added the ability to extract Session Data from the HLS manifest that is submitted as dimension metadata. This will be available for use in a future release of Mux Data. Read the Release Notes for more information.
We've changed the handling of errors in HLS.js and now immediately send an error event to Mux Data when a fatal error occurs. If you do not want to treat some fatal errors as fatal, you should provide an errorTranslator function to filter which errors are tracked or disable automaticErrorTracking and handle errors manually. Read the Release Notes for more information. You can also read more about specifying an error translator function or disabling automatic error tracking in our docs.
We've updated the AVPlayer SDK to make it possible to build the SDK into an application extension without generating an XCode warning. We have also reduced the number of rendition change events that are reported before a video starts playing. Read the Release Notes for more information.
You can now use your GitHub login when signing up for a Mux account or signing into the Mux Dashboard. You can read more on the Blog Post.
We’ve added a new status filter to the List Live Streams API endpoint. With this new filter, you can get a list of all live streams that have active or idle or disabled status. This list is sorted by live stream’s creation time from most recent to oldest. You can learn more in the API Reference.
You can now use the Overview page, the new landing page for Mux Data. This page contains an overall snapshot of the engagement, real-time viewership, and quality of experience for your video view activity. This change is rolling out to all users over the next few weeks.
We've added version 4.0.0 of our mux-go SDK. New SDK versions typically introduce new features, bug fixes, and updates. You can read more on the 4.0.0 Release Notes.
We updated hls.js to v1.1.5 for videojs-mux-kit. See the Release Notes for more info.
As part of 0.7.0, tighter error handling integration with hls.js made all errors be triggered on the player. This meant that errors that don't inhibit playback and that hls.js handled automatically were treated the same as fatal errors that hls.js doesn't handle automatically. Now, only errors that hls.js considers fatal will trigger an error event. See the Release Notes for more info.
You can have a quality level picker that uses videojs-contrib-quality-levels behind the scenes. Read the Release Notes for more information.
Videojs-Mux-Kit v0.8.0 now supports Video.js HTTP Streaming (VHS). You can import the new build file to use VHS, the playback engine that Video.js ships with. See our README section on Importing for documentation on how to use the new build file and read the Release Notes for more information.
We've updated mux-embed with an enumeration of the events that can be submitted by the SDK in order to make it easier for you to build on top of the web SDK framework. In addition, we've updated the viewend detection to use page visibility change rather than the unload handler, which is no longer supported in most browsers. Read the Release Notes for more information.
January 2022
We've added version 3.3.0 of our mux-ruby SDK. New SDK versions typically introduce new features, bug fixes, and updates. You can read more on the 3.3.0 Release Notes.
We've added version 3.3.0 of our mux-php SDK. New SDK versions typically introduce new features, bug fixes, and updates. You can read more on the 3.3.0 Release Notes.
We've added version 3.3.0 of our mux-python SDK. New SDK versions typically introduce new features, bug fixes, and updates. You can read more on the 3.3.0 Release Notes.
You are now able to register a specific instance of Video.js to monitor with Mux Data instead of relying on the global instance. This makes it easier to use videojs-mux when there is more than one instance of a Video.js player on a page. Read the Release Notes for more information.
You can now export Mux Data views to Amazon Kinesis or Google Pub/Sub. As views are completed they are immediately streamed to the service of your choice to ingest into your data warehouse for further processing. This feature is currently available for Media customers as a beta release. See the documentation for information on how to configure a stream and the data that is available.
We've updated mux-embed to version v4.4.0, which includes the ability to collect the live stream latency metric. This will be available for use in a future release of Mux Data. Read the Release Notes for more information.
We have fixed an issue that could cause missing seek events in Mux Data when seeking in a video using the player API in iOS 15. Read the Release Notes for more information and a list of additional fixes.
We've added support for Android ExoPlayer 2.16.1. Read the Release Notes for more information and a list of additional fixes.
We now support non-square pixels as standard input which means you do not need to wait as long for ingestion. Previously, we supported non-square pixels as non-standard input. See our Guide to learn more about this change and why non-standard inputs take longer to process.
We've fixed an issue that could cause incorrect playback reporting when seeking occurs during a view and updated the SDK testing infrastructure. Read the Release Notes for more information and a list of additional fixes.
We've added support for including the AVPlayer SDK XCFramework into your application using Carthage. Read the Release Notes for more information and a list of additional fixes.
December 2021
We've added version 3.2.0 of our mux-ruby SDK. New SDK versions typically introduce new features, bug fixes, and updates. You can read more on the 3.2.0 Release Notes.
We've added the ability to collect the live stream latency metric. This will be available for use in a future release of Mux Data. Read the Release Notes for more information.
We've added version 3.2.0 of our mux-go SDK. New SDK versions typically introduce new features, bug fixes, and updates. You can read more on the 3.2.0 Release Notes.
We've added version 3.2.0 of our mux-php SDK. New SDK versions typically introduce new features, bug fixes, and updates. You can read more on the 3.2.0 Release Notes.
We've added version 3.2.0 of our mux-python SDK. New SDK versions typically introduce new features, bug fixes, and updates. You can read more on the 3.2.0 Release Notes.
We’ve introduced Referrer Validation, a new method of Playback Restrictions to secure your videos. You can restrict your videos to play only on your approved websites with Referrer Validation. Mux validates the requesting website against your approved list by examining the HTTP Referrer header sent by the Web browser. This feature requires the use of Signed URLs. You can read more on the Blog Post, API Reference, and Guide.
We’ve added the PATCH method to several API endpoints for updating Assets & Live Streams. You can update the passthrough parameter value of Assets & Live Streams anytime after creating them. Similarly, you can update the latency_mode and reconnect_window parameter values of Live Streams. For more details, see the Live Streams PATCH API or Assets PATCH API documentation.
We have fixed an issue that could cause missing seek events in Mux Data when seeking in a video using the player API. Read the Release Notes for more information.
We've fixed an issue where playerID is null when the react-native-video component is wrapped with react-native-video-controls, which caused an error during video playback. Read the Release Notes for more information.
We have introduced playback-core, which contains utilities and logic shared by the following playback elements: mux-video, mux-video-react, mux-audio, and mux-audio-react. See the Release Notes and playback-core README for more details.
You can now pass in the start-time attribute to make playback start at a certain timestamp. For example <mux-video start-time="4" ...> will start playback at the 4 second mark. See the Release Notes for additional information.
You can now pass in the startTime prop to make playback start at a certain timestamp. For example <MuxVideo startTime={4} ...> will start playback at the 4 second mark. See the Release Notes for additional improvements.
You can now pass in the start-time attribute to make playback start at a certain timestamp. For example, <mux-audio start-time="4" ...> will start playback at the 4 second mark. See the Release Notes for additional improvements.
We've added the ability to collect the live stream latency metric. This will be available for use in a future release of Mux Data. Read the Release Notes for more information.
We’ve added a new Mux Element: <MuxAudio /> React component is the counterpart to <MuxVideo />. See the Release Notes for more info.
We have added a new API that allows you to override the automatic fullscreen detection and specify that a video is playing fullscreen even if it is not taking up the complete bounds of the screen. Read the Release Notes for more information and a list of additional fixes.
We've updated mux-embed to version v4.3.0, which no longer assigns a default video_id if it is not specified by the developer. The default video_id will now be assigned on the server if one is not specified. Read the Release Notes for more information.
Streamers can broadcast on the same Live Stream multiple times, each time creating a new video asset. We’ve added a new live_stream_id filter to the Delivery Usage API. With this new filter, you can get delivered minutes usage information for all the video assets created from a single live stream. You can learn more from the API Reference.
You can now use your Google login when signing up for a Mux account or signing into the Mux Dashboard.
November 2021
You can now use Mux Data with Kaltura video players to collect engagement and quality of experience metrics. We’ve added new Mux Data SDKs for Kaltura web, iOS, and Android players. To configure and use the SDKs refer to the documentation: Kaltura web SDK, Kaltura iOS SDK, Kaltura Android SDK.