How hoangviet24/film-library works
Fluent Media Player is a Windows desktop video player. Users open a file or scan a folder, browse grouped episodes, play and control video, and resume from saved progress; they can also use seek previews, floating playback, and Windows Open With. The graph combines sampled call wiring with README-documented capabilities. Some widget and integration internals were not sampled, so documented but unverified connections are dashed.
Main entry points: main_window.py Main Window · controls_bar.py Playback Controls · sidebar_widget.py Episode Sidebar · app.py App Startup
Components 22
Application
- App Startup
app.py - Main Window
main_window.py - Runtime Config
config.py - Fluent Styling
styles.py
Playback
- Player Controller
player_controller.py - libVLC
- Playback Controls
widgets/controls_bar.py - Playback Overlay
widgets/overlay_panel.py - Seek Slider
widgets/clickable_slider.py - Floating Player
widgets/floating_window.py
Library & History
- Episode Sidebar
widgets/sidebar_widget.py - Episode Item
widgets/episode_item.py - Landing Page
widgets/landing_widget.py - Watch History
utils/history.py - Video Files
Preview & Thumbnails
- Seek Preview Worker
utils/preview_manager.py - Preview Popup
widgets/preview_popup.py - Thumbnail Generator
utils/thumbnail.py
Windows Integration
- Open With Setup
utils/open_with_installer.py - Windows Explorer
- Window Icon
utils/window_icon.py
Other components
- Viewer
Connections 31
- Viewer → App Startup: launches
README.md - App Startup → Main Window: starts
app.py - App Startup → Runtime Config: imports
app.py - Viewer → Main Window: opens media
README.md - Main Window → Player Controller: controls playback
main_window.py - Player Controller → libVLC: drives playback
player_controller.py - Main Window → Playback Controls: updates controls
- Playback Controls → Seek Slider: uses
widgets/controls_bar.py - Main Window → Playback Overlay: shows modes
- Playback Overlay → Seek Slider: uses
widgets/overlay_panel.py - Playback Overlay → Preview Popup: displays
widgets/overlay_panel.py - Playback Controls → Preview Popup: displays
widgets/controls_bar.py - Viewer → Episode Sidebar: selects episodes
README.md - Main Window → Episode Sidebar: routes playback
- Episode Sidebar → Episode Item: renders items
widgets/sidebar_widget.py - Viewer → Landing Page: chooses files
README.md - Landing Page → Main Window: sends selections
main_window.py - Main Window → Video Files: opens and scans
README.md - Main Window → Watch History: loads and saves progress
README.md - Watch History → Runtime Config: uses data path
utils/history.py - Viewer → Playback Controls: seeks timeline
README.md - Playback Controls → Seek Preview Worker: requests frames
- Seek Preview Worker → Preview Popup: provides images
- Episode Sidebar → Thumbnail Generator: requests thumbnails
widgets/sidebar_widget.py - Thumbnail Generator → Video Files: reads video
- Viewer → Windows Explorer: chooses Open With
README.md - Windows Explorer → Open With Setup: invokes registration
- Open With Setup → Main Window: opens selected media
- Main Window → Window Icon: sets window icon
main_window.py - Main Window → Floating Player: supports pop-out mode
- Main Window → Fluent Styling: applies styling
main_window.py