How henzfdev/hc-player works
HC Player is a native Windows media player: users open media, control playback and its queue, inspect media details, and customize playback through a WinUI interface backed by mpv. The graph preserves documented playback, subtitle/audio, HDR/shader, playlist, information, and Windows-integration capabilities. MainPage and several managers were sampled or indexed; the README supports the broader feature branches, but unsampled implementation details and call ownership are not assumed.
Main entry points: MainPage.cpp Player window · SettingsPage.cpp Settings UI · PlayerBridge.h Player command bridge · StoragePaths.cpp User data paths
Components 20
Player interface
- Player window
HC Player/MainPage.cpp - Playback queue
HC Player/PlaylistPage.cpp - Settings UI
HC Player/SettingsPage.cpp - Media details UI
HC Player/MediaInfoPage.cpp - Playback context menu
HC Player/ContextMenuPage.cpp - UI localization
HC Player/LocalizationManager.cpp
Playback and media
- mpv playback engine
HC Player/HCPlayer.cpp - Player command bridge
HC Player/PlayerBridge.h - MediaInfo analysis
HC Player/MediaInfoBridge.cpp - Timeline thumbnails
HC Player/ThumbnailBridge.cpp - Thumbnail requests
HC Player/ThumbnailController.cpp
Playback configuration
- mpv options and import
HC Player/MpvSettingsManager.cpp - Shader management
HC Player/ShaderManager.cpp - Optional tools
HC Player/ExternalToolsManager.cpp
Windows integration
- Windows media controls
HC Player/SystemMediaControlsManager.cpp - File associations
HC Player/FileAssociationManager.cpp - Portable registration
HC Player/PortableRegistrationManager.cpp
User data
- Recent media
HC Player/RecentMediaManager.cpp - User data paths
HC Player/StoragePaths.cpp
Other components
- Media user
Connections 25
- Media user → Player window: opens and controls
README.md - Player window → Player command bridge: issues player commands
HC Player/MainPage.cpp - Player command bridge → mpv playback engine: controls playback
- Player window → Playback queue: opens queue
- Player window → Settings UI: opens settings
- Player window → Media details UI: shows details
- Player window → Playback context menu: opens context menu
- Playback queue → Player command bridge: manages queue
- Settings UI → mpv options and import: configures playback
- Settings UI → Shader management: manages shaders
- Settings UI → Optional tools: imports optional tools
- Media details UI → MediaInfo analysis: requests analysis
- Player window → Thumbnail requests: requests previews
- Thumbnail requests → Timeline thumbnails: decodes frames
- Player window → Recent media: tracks recent media
- Shader management → mpv playback engine: applies shader list
HC Player/ShaderManager.cpp - Shader management → User data paths: resolves managed paths
HC Player/ShaderManager.cpp - mpv options and import → User data paths: resolves config paths
HC Player/MpvSettingsManager.cpp - Optional tools → User data paths: resolves tool paths
HC Player/ExternalToolsManager.cpp - Recent media → User data paths: resolves data root
HC Player/RecentMediaManager.cpp - Player window → Windows media controls: publishes playback state
HC Player/MainPage.cpp - Windows media controls → Player command bridge: receives transport commands
HC Player/SystemMediaControlsManager.cpp - Media user → File associations: registers media types
- Media user → Portable registration: registers portable app
- Player window → UI localization: resolves UI text