For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
StatusSupportDiscussionsLog inSign Up
Docs HomeAPI ReferenceVideo on DemandAI FeaturesLive StreamingVideo PlayerVideo DataCloud PlayoutRecipes
Docs HomeAPI ReferenceVideo on DemandAI FeaturesLive StreamingVideo PlayerVideo DataCloud PlayoutRecipes
  • Player SDKs
    • Introduction
  • Web player
    • Install the FastPix web player
    • Play uploaded videos
    • Handle playback errors
      • Changelog
  • Android player
    • Install FastPix Android player
    • Set up the player
    • Play uploaded videos
    • Handle playback errors
  • iOS player
    • Install FastPix iOS player
    • Play uploaded videos
    • Handle playback errors
  • Flutter player
    • Install FastPix Flutter player
    • Play uploaded videos
    • Handle playback errors
LogoLogo
StatusSupportDiscussionsLog inSign Up
On this page
  • Current version
  • [1.0.16]
  • Updated
  • Live playback
  • On-demand playback
  • Performance & stability
  • Previous versions
  • [1.0.15]
  • Audio & Subtitle UX (tracks + subtitles)
  • Programmatic seek
  • v1.0.14
  • Audio & Subtitle Tracks
  • v1.0.13
  • Readme.md
  • v1.0.12
  • Changed
  • v1.0.11
  • Features you can use
  • Fixed
  • v1.0.10
  • Changed
  • v1.0.9
  • v1.0.8
  • New & Improved: Playlist
  • iOS Volume Behavior
  • Menu Bugs fixed
  • v1.0.7
  • v1.0.6
  • v1.0.5
  • New Feature: Shoppable Video Support
  • v1.0.4
  • DRM Support & Chapters updation
  • v1.0.3
  • v1.0.2
  • v1.0.1
  • v1.0.0
Web playerReference

Changelog

Was this page helpful?
Previous

Build a custom track switcher UI

Next
Built with

All notable changes to the FastPix Player is documented below.


Current version

[1.0.16]

Updated

  • Analytics / Video Data – @fastpix/video-data-core dependency range updated to ^1.0.7.

Live playback

  • Cleaner live UI – For stream-type="live-stream", the duration-style time readout stays hidden so the experience matches open-ended live viewing.

On-demand playback

  • Smarter background loading on VOD – On-demand streams use settings tuned for typical recorded playback; live streams use a lighter profile suited to the live edge.

Performance & stability

  • Smoother day-to-day use – Less chance of the browser reporting long scripting tasks during normal actions (timeline updates, audio track changes, subtitle changes, and Chromecast handoff).
  • Programmatic audio – When you switch tracks via setAudioTrack(...), the built-in audio menu stays aligned with fewer redundant updates.

Previous versions

[1.0.15]

Audio & Subtitle UX (tracks + subtitles)

— New attribute: hide-native-subtitles

  • When present, the internal subtitle container never paints text, so the built‑in overlay stays visually hidden even when a track is enabled.

  • All subtitle APIs still work as usual: fastpixsubtitlecue continues to fire with { text, language, startTime, endTime } and the native TextTrack state is unchanged.

  • Recommended when you render subtitles in your own UI (React overlay, custom HTML) and want to guarantee there is no duplicate text from the built‑in overlay.

  • Clarified behavior: disable-hidden-captions

    • Now applied as an initial state only: on load, the player disables all subtitles/captions without emitting fastpixsubtitlechange.
    • After load, users (or your code) can still turn subtitles on via the built‑in menu or setSubtitleTrack(...); the internal overlay is allowed to show again unless hide-native-subtitles is also set.

Programmatic seek

  • seekForward(seconds) and seekBackward(seconds) – New methods on the <fastpix-player> element to jump the playhead forward or back by a given number of seconds (clamped to the media range). Use them for custom “+10s” / “−10s” buttons or app shortcuts; the built-in skip buttons still follow forward-seek-offset / backward-seek-offset when set. Documented in README (Programmatic playback control and section 1.3 custom-controls example).

v1.0.14

Audio & Subtitle Tracks
  • Switch by name (label) – setAudioTrack(languageName) / setSubtitleTrack(languageName | null) switch tracks by label/name (no numeric ids required).
  • Set defaults by name – New attributes:
    • default-audio-track="French"
    • default-subtitle-track="English"
  • Cleaner track lists – getAudioTracks() / getSubtitleTracks() now avoid duplicate entries when multiple tracks share the same label.
  • Better events for integrations
    • fastpixtracksready includes the full current track objects (currentAudioTrackLoaded, currentSubtitleLoaded) in addition to the track lists.
    • fastpixaudiochange / fastpixsubtitlechange include the current track object (currentTrack) so you can log/update UI easily.

v1.0.13

Readme.md
  • Updated Readme.md file

v1.0.12

Changed
  • Build & package – ESM build is now a single bundled file (dist/player.esm.js), so import '@fastpix/fp-player' works in React, Vite, and other bundlers without “Could not resolve ./utils/…” errors. CDN build stays at dist/player.js for backward compatibility with existing script-tag and CDN URLs.
  • Exports – "import" resolves to player.esm.js; "require" and main resolve to player.js (IIFE).
  • Build size – Stripped legal comments and debugger statements in both builds for slightly smaller output.

v1.0.11

Features you can use
  • Programmatic playback control – JavaScript API: play(), pause(), mute(), and unmute() for controlling playback and volume from your code (e.g. custom controls, Shorts-style UI, or framework integrations). mute()/unmute() sync with Chromecast when casting.
  • Seekbar position – Use CSS variable --seekbar-bottom (e.g. 0px) to move the progress bar to the very bottom. Thumbnail preview stays above it.
  • Invisible bar, keep preview & seek – Set --progress-bar-invisible: 1 to hide the bar visually while keeping hover thumbnail/timestamp preview and click-to-seek. Use your own progress bar on top.
  • Style the bar – Use --progress-bar-track-unfilledto style the track.
  • Thumbnail hover on seekbar – Hover or drag on the seekbar to see a frame preview (spritesheet) or timestamp pill when no thumbnails are available.
  • Shorts mode – Attribute autoplay-shorts for muted autoplay, loop, and feed-friendly behavior.
  • Free keyboard keys – Attribute disable-keyboard-controls so your app can use Arrow Up/Down (e.g. next/prev) without the player capturing them.
  • Accent color – Attribute accent-color or CSS --accent-color for theming; your app can read it to match a custom progress bar.
Fixed
  • Chromecast – Fixed casting with m4s segments for both private and public playback;DRM playback casting remains unresolved and is still being worked on.
  • DRM Playback - DRM Playback issue in player is fixed..

v1.0.10

Changed
  • Updated npm authentication from Classic token to Granular token for improved security and fine-grained permissions.

v1.0.9

  • Added skip-intro-start and skip-intro-end and next-episode-button-overlay buttons support.
  • Fixed shoppable video hotspot issue
  • Added player-buttons slot

v1.0.8

New & Improved: Playlist
  • Added playlist APIs: addPlaylist(playlist), next(), previous(), selectEpisodeByPlaybackId(playbackId)
  • Supported attributes: default-playback-id, hide-default-playlist-panel, loop-next
  • Events: playbackidchange, playlisttoggle
  • Custom navigation hooks: customNext(handler), customPrev(handler); call i.next()/i.previous() inside your handlers
  • Default playlist panel can be hidden to build a fully custom panel via slot="playlist-panel"
  • Introduced destroy() for lightweight teardown before custom source-switching flows

iOS Volume Behavior

  • When iOS-specific volume button is active, standard slider/button are hidden

Menu Bugs fixed

  • Fixed playlist panel toggle inconsistencies (open/close state and pointer events)
  • Ensured external custom panel shows/hides reliably with playlisttoggle
  • Resolved menu overlap by closing rate/audio/subtitle/resolution menus when opening playlist panel

v1.0.7

  • Fixed “OpenOnPlay” and “autoClose” issue for shoppable-video-player theme

v1.0.6

  • Removed unnecessary console logs

v1.0.5

New Feature: Shoppable Video Support
  • Shoppable Video Player Theme: Introduced shoppable-video-player theme with full-featured product sidebar, interactive hotspots, and comprehensive product catalog functionality
  • Shoppable Shorts Theme: Added shoppable-shorts theme for simplified external link integration optimized for social media and mobile-first content
  • Product Integration: Support for product data configuration with hover effects, click actions, and time-based product activation
  • Interactive Hotspots: Clickable markers on video timeline that link to specific products
  • Post-Play Overlay: Product carousel that appears when video ends to encourage continued engagement
  • Responsive Design: Cart button and sidebar adapt to different screen sizes with theme-specific visibility rules
  • Developer Documentation: Comprehensive developer guide with configuration examples, troubleshooting section, and best practices

v1.0.4

DRM Support & Chapters updation
  • DRM support included
  • Chapters feature updated

v1.0.3

  • Fixed the spritesheet issue.

v1.0.2

Beta Feature: Chromecast Integration

  • Initial Chromecast Support (Beta): Added foundational support for Google Chromecast. This includes:
    • Chromecast session detection and management.
    • Remote playback toggling with fallback to local player.
    • Volume and mute sync between player and Chromecast.
    • Session cleanup on load and playback resume logic.

v1.0.1

Enhancements & Bug Fixes:

  • PIP Control Removed in Firefox Mobile: Fixed an issue where the Picture-in-Picture (PIP) control was displayed on Firefox mobile browsers when it shouldn’t be.
  • Subtitle Menu UI Fixes:
    • Fixed an issue where the subtitle menu was cropped, and scrolling was unavailable for videos with over 10 subtitles.
    • Ensured that if multiple subtitles exist, the list is scrollable and properly displayed in the UI.
  • Subtitle Overlay Fix: Resolved an issue where, after turning off subtitles, the background overlay remained visible instead of disappearing.
  • Data Metrics Integration: Added Quality of Experience (QoE) scoring in the FastPix dashboard, allowing users to monitor streaming quality.
  • Enable Cache Busting (Beta): Introduced an experimental cache-busting feature to ensure that when tracks are added dynamically, the player checks for an updated manifest.

v1.0.0

Initial Release:

  • Playback: Introduced basic video playback functionality.
  • Signed Playback: Enabled secure signed playback options.
  • Stream Types: Added support for various stream types.
  • Responsiveness: Ensured responsive design for different devices.
  • Error Handling: Implemented robust error handling mechanisms.
  • Customizability: Provided extensive customization options for users.
  • Keyboard Accessibility Controls: Added keyboard shortcuts for better accessibility.
  • Lazy Loading: Implemented lazy loading for improved performance.
  • Chapters: Enabled chapter functionality for video navigation.
  • Script Support for Video Events:: Added support for listening to video events via scripts.
  • Poster customizations: Allowed customization of video posters.
  • Thumbnail Customization: Enabled custom thumbnails for videos.
  • Forward and Rewind Playback Customizations:: Provided options for customizable forward and rewind playback.
  • Playback Rates: Allowed adjustment of playback rates.
  • Styling Options: Added various styling options for UI elements.
  • Volume Management: Implemented advanced volume control features.
  • Subtitle Switching: Enabled switching between available subtitles.
  • Audio Track Switching:: Allowed switching between different audio tracks.
  • Thumbnail Hover Previews: Introduced thumbnail previews on hover.
  • Customizing Time Display: Allowed customization of time display formats.
  • Start Time: Implemented functionality to set a specific start time for playback.
  • Placeholder: Added placeholder support for loading states.
  • offline/online control: Provided control mechanisms for offline/online scenarios.
  • Title Display: Implemented title display options for videos.
  • Overriding Default Behaviors: Allowed users to override default player behaviors.