Loading
Loading
Loading
mobile footer

Build the Interaction Layer Your Website is Missing.

Browse All EffectsBrowse All EffectsBrowse All EffectsUpgrade to ProUpgrade to ProUpgrade to Pro

70+ effects free, forever. No credit card.

© 2026 Hyperiux. All Rights Reserved.

AI Component CatalogueHey AI, Learn About Us
Platform

Vault

  • Documentation
  • Pricing
  • Blog
  • Community
  • NPM
  • MCP

Categories

  • All Effects
  • WebGL
  • Text
  • Backgrounds
  • Buttons
  • Carousels
  • Scroll
  • Components
  • Navigation
  • Cursor
  • Transitions
  • Loaders

Documents

  • Introduction
  • Installation
  • CLI
  • Dependencies
  • License

Legal

  • License Agreement
  • Terms of Service
  • Privacy Policy
  • Refund Policy
Socials
  • Twitter / X
  • LinkedIn
  • GitHub
  • Instagram
Contact Us
  • hello@hyperiux.com
New effects, in your inbox

Every new drop, plus the occasional behind-the-scenes build. No spam. Unsubscribe anytime.

All Effects
Featured ComponentsText AnimationsAnimated BackgroundsAnimated ButtonsCarousel EffectsScroll EffectsCreative ComponentsNavigationsCursor EffectsTransitionsLoadersWebGL & 3D Effects
Templates
IntroductionInstallationCLIDependenciesLicense
PricingBlogGithubNPMMCP Doc
Loading
Home/effects/Video Player

Video Player

A minimal branded video player with play, pause, mute, scrubbing and fullscreen controls for demos, case-study videos, and product proof.

Lucide-react
DemoDemoDemo

Tune the Real Props

Overview

Custom Video Player gives product demos and case-study videos branded controls without making playback harder.

Use it when a video section needs a poster and branded controls: a centre play/pause button and a bottom bar with play/pause, elapsed time, a scrub bar, duration, mute and fullscreen. The controls fade out after 1.8 seconds without pointer movement (hideControlsDelay) and return on mouse move or touch. The default export plays a built-in showreel and poster, so using your own video means editing those sources in the file. The page job is watched proof: the player should make the demo easier to trust and operate.

The thing to watch is inaccessible media chrome. The play, mute and fullscreen buttons are labelled and keyboard-focusable, but the scrub bar is a pointer-only div, there are no keyboard shortcuts beyond Escape to leave fullscreen, there is no captions track or control, and there is no loading or buffering state. Add those before using it for proof that must be accessible.


Usage Code

page
1import VideoPlayer from "@/components/effects/video-player";2 3export default function Page() {4  return (5    <>6        <div className="aspect-video h-[27vw] w-[43vw] max-md:h-auto max-md:w-full">7          <VideoPlayer />8        </div>9    </>10  );11}12 

Example Production Use Case

A product demo page can use Custom Video Player when the video is a proof asset: the poster shows straight away, the video preloads only metadata, and the main controls are labelled buttons. If the video needs captions or keyboard seeking, add a captions track and a focusable seek control first.


Best Used For

  • Product demo sections where branded play, mute and fullscreen controls suit the design.
  • Case-study pages where a poster and clean playback states affect trust.
  • Landing pages where media loading should not block the rest of the page.

Not For

Not for videos that need native reliability more than branded chrome, or for pages where captions, controls, or fallback playback cannot be verified.


Performance Budget

The player sets a poster and preload="metadata", but autoPlay is on by default, so the video starts downloading as soon as it mounts. If the file is heavy, turn autoPlay off or mount the player only when the section is likely to be used.


Accessibility and Mobile

The play/pause, mute and fullscreen controls are real buttons with aria-labels that change with state. The scrub bar has no focus or keyboard support, captions are not supported, and the controls hide by opacity after 1.8 seconds even while a button has keyboard focus. On touch screens a tap anywhere on the player brings the controls back, and the video uses playsInline so it plays inline on iOS.


Common Mistakes

  • Styling controls so heavily that play, pause, mute, seek, or captions become unclear.
  • Autoplaying proof video without user control (autoPlay is on, and muted, by default).
  • Letting media loading block the rest of the page.

Changelog

Replaced the rAF progress loop with native timeupdate events.
Initial release

API Reference

PropTypeDefaultDescription
autoPlaybooleantrueStarts playback automatically when allowed.
startMutedbooleantrueInitial muted state.
showCloseButtonbooleantrueShows the close button on the player.
roundedbooleanfalseRounds the player frame when not fullscreen.
preserveAspectRatiobooleantrueUses object-contain instead of object-cover for the video.
hideControlsDelaynumber1800Delay before controls auto-hide, in milliseconds.

Questions, Answered.

What makes Custom Video Player different from a decorative component?

It controls actual media. Playback, captions, focus, and loading behavior matter more than the animation around the controls.

Which accessibility details are required?

The buttons already have accessible names that switch with state (Play video, Pause video, Mute video, Unmute video, Open fullscreen, Exit fullscreen). You still need to add a keyboard-operable seek control, captions through a track element, and a way to keep the controls visible while one has focus.

Should the video autoplay?

It autoplays muted by default (autoPlay and startMuted are both true) and does not check prefers-reduced-motion. Keep that only when the video is muted and non-essential; otherwise set autoPlay={false}.

Can Hyperiux adapt Custom Video Player for a real brand system?

Yes. A custom version should define content structure, accessibility behavior, motion rules, reduced-motion behavior, source handoff, and implementation notes for the specific page job.

Request a Custom Animation

Need a custom effect? Tell us what to create.

Related Effects

Explore All EffectsExplore All EffectsExplore All Effects
Grid Tunnel
Pro
Three.js@react-three/drei@react-three/fiber

Grid Tunnel

WebGL

Interactive List Preview
GSAP

Interactive List Preview

Components

Hyperiux Glitter
Pro
Three.js@react-three/fiber@react-three/drei

Hyperiux Glitter

WebGL

Text Stream
Pro
GSAP

Text Stream

Text