QCustomVideoPlayer
QCustomVideoPlayer ships in Custom Widgets Pro. It is not part of the free GPLv3 package from 2.6.0 onward — the free package keeps the import path so Qt Designer forms still load, and installing Pro activates the widget with no code change. Releases up to 2.5.0 included it under the GPLv3.
Pro is licensed software and is not installable from PyPI — the name there is a pointer package with no widgets in it. Licence holders download the wheel from their account:
# https://portal.customwidgets.org/downloads
pip install <the downloaded .whl>
A poster-framed media/video player card.
A rounded poster image with a big centred play button and a bottom control
bar (play / pause, elapsed / total time, a seek track). Feed it a poster
with setPoster(pm) and a length with duration ("mm:ss"); pressing play
advances a simulated playhead (a QTimer) so it demos without any media
backend, and clicking the track seeks. It emits playToggled(bool) and
seeked(float 0..1). Everything is painted (crisp at any size, no assets) and
every colour is a qproperty so it tracks the theme.
At a glance
| Tier | Pro |
| Import | from Custom_Widgets.QCustomVideoPlayer import QCustomVideoPlayer |
| Qt Designer | Yes — drag it from the palette |
Quick start
from Custom_Widgets.QCustomVideoPlayer import QCustomVideoPlayer
widget = QCustomVideoPlayer()
Dark theme
Colours come from the design tokens, so the widget follows the app theme with no extra work.
Properties
Every property below is settable in code and in Qt Designer.
| Property | Type | Default |
|---|---|---|
duration | string | 02:45 |
progress | float | 0.0 |
playing | bool | False |
radius | int | 18 |
accentColor | color | #1b74e4 |
posterColor | color | #222838 |
barColor | color | #e6ffffff |
trackColor | color | #4dffffff |
textColor | color | #ffffff |
Signals
| Signal |
|---|
playToggled(bool) |
seeked(double) |
Methods
| Method | Description |
|---|---|
accentColor(*args, **kwargs) | Accent color. |
barColor(*args, **kwargs) | Bar color. |
duration(*args, **kwargs) | Duration. |
playToggled(...) | Play toggled. |
playing(*args, **kwargs) | Playing. |
posterColor(*args, **kwargs) | Poster color. |
progress(*args, **kwargs) | Progress. |
radius(*args, **kwargs) | Radius. |
seeked(...) | Seeked. |
setPlaying(v) | Set the playing. |
setPoster(pm) | Set the poster. |
textColor(*args, **kwargs) | Text color. |
toggle() | Toggle. |
trackColor(*args, **kwargs) | Track color. |
Related
QCustomCoverFlow · QCustomImageViewer · QCustomMediaGrid · QCustomMediaTimeline · QCustomPlayerBar · QCustomVoiceMessage · QCustomWallpaper