Reference
Changelog
All notable changes to ytcn.
v1.0.0 — Initial Release
May 2026
Components
- +
YtcnPlayer— Full composed player with thumbnail-first loading - +
YtcnControls— Complete controls bar with progress, volume, speed, fullscreen - +
YtcnProgress— Timeline scrub bar with hover tooltip and drag-to-seek - +
YtcnVolume— Volume slider with mute toggle, expand-on-hover - +
YtcnSpeed— Playback speed picker with fullscreen-safe popover - +
YtcnFullscreen— Fullscreen toggle button - +
YtcnLoader— Loading state with blurred thumbnail backdrop - +
YtcnOverlay— Click-to-play overlay with thumbnail
Hooks
- +
useYtcnPlayer— Core hook with state machine, imperative controls, ref-sync pattern - +
useThumbnail— Priority-ordered thumbnail probing - +
useIdleControls— Auto-hide controls in fullscreen after 3s idle - +
useKeyboardShortcuts— Space, F, M, ←, → keyboard shortcuts
Features
- +Thumbnail-first loading — eliminates black flash and YouTube branding on load
- +shadcn registry compatible — install via
npx shadcn@latest add - +Full TypeScript with strict mode
- +SSR/Next.js compatible — all components are "use client"
- +Zero YouTube branding via cover div, iframe offset, and caption suppression