Skip to main content

cvplayer

cvplayer is a video player written in python that provides easy video playback using ffpyplayer and OpenCV

Installation

pip install cvplayer

there are two ways to use cvplayer, either through

  • starting interactive (direct) playback of a video from the command-line:
    cvplay filaname
    simply starts the video in a different window where it's playback can be controlledby using keymaps
    the default keymaps for controlling the video playback are -

  • scripts (getting a VideoPlayer instance and doing whatever you want to)

scripted access

cvplayer provides the VideoPlayer class which is the main wrapper around ffpyplayer's MediaPlayer.
Initializing a VideoPlayer instance will start playing the video according to the options specified. The Playback can be controlled from within the script as well as using keymaps.

the VideoPlayer class initiates playback and provide methods to control/access the state of the player.

Here's and example to play a video

from cvplayer import VideoPlayer

player = VideoPlayer(filename)

while player.state != 'eof':
    print(player.get_pts())
    time.sleep(1)

parameters for a VideoPlayer instance:

parameter type Description
filename str The filename of the media
paused bool If True, the player will be in a paused state after creation, otherwise it will immediately start playing. Defaults to False
fullscreen bool If True, the video playback will be in fullscreen mode immediately after it's creation. Defaults to True
key_controls bool If True, the video playback can be controlled using specified keymaps. Defaults to True
skip_interval int Specify the numebr of seconds to move ahead or beind when navigating the video using the keymaps
volume float The default volume. A value between 0.0 - 1.0. Defaults to 1.0
mute bool If True, the player will be muted by default after creation. Defaults to False
t int Play only t seconds of the audio/video. Defaults to the full audio/video. Defaults to the full audio/video
ss int Seek to pos ss into the file when starting. Defaults to the beginning of the file
blocking bool If True, the playback will block the current thread (the one it's being run from) until the playback ends. Defaults to False
playback bool If False, only the player will be initialized and no video/audio will be played, only audio can be played by unmuting the player. Useful for just reading the frames form a video to display them using something else

Metadata

Release files for cvplayer 1.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cvplayer 1.2.0
File Size Uploaded
cvplayer-1.2.0.tar.gz 6.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for cvplayer 1.2.0
File Interpreter ABI Platform
cvplayer-1.2.0-py3-none-any.whl Python 3 none any Details

Total release size: 13.2 kB

Release files / cvplayer-1.2.0.tar.gz

Download URL cvplayer-1.2.0.tar.gz
Size 6.3 kB
Tags Source
SHA-256 checksum
How to use checksums
a5e5a45b2d6db7b67d48cc0ceafa32c16139c6d047148ba7cba4eaa34edd3b05
BLAKE2b-256 checksum
How to use checksums
047cab310a14b4c1295e25c095173f32d7c85c10dc0e8f622e7945b1e4f03468
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.7.1 importlib_metadata/4.10.0 pkginfo/1.8.2 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.5

Release files / cvplayer-1.2.0-py3-none-any.whl

Download URL cvplayer-1.2.0-py3-none-any.whl
Size 6.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a93d6d2ebe5f35ec9e8dbb7b53ba75ba1f6af4477733f83a1209d55ae20f9cbe
BLAKE2b-256 checksum
How to use checksums
103773f1fe7c0a5d84d2af178b6914609c401a2675b9cbf40282399d6a71a297
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.7.1 importlib_metadata/4.10.0 pkginfo/1.8.2 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.5

Release history Release notifications | RSS feed

This release

1.2.0 This release

2 release files

1.1.0

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page