Metadata-Version: 2.4
Name: yoloplayer
Version: 0.1.1
Summary: An OpenCV video player wrapper with YOLO detection support
Home-page: https://github.com/raunitsingh/yoloplayer
Author: Raunit Singh
Author-email: raunitsingh33@email.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: opencv-python>=4.5.0
Requires-Dist: ultralytics>=8.0.0
Requires-Dist: numpy
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

YOLOPlayer 🎥

A OpenCV wrapper for video playback, detection overlays, and future extensions (YOLO, DeepSORT, SAM, Faster-RCNN).    #right now only tested on YOLO


✨ Features:
✅ Replace cv2.imshow with a more usable player
⏯️ Pause/Play with Spacebar
🔁 Forward/Rewind with Arrow Keys
🖥️ Toggle Fullscreen with F
🚪 Quit with Q
🤖 (Optional) YOLO integration for human detection
📦 Easy to extend with tracking (DeepSORT), segmentation (SAM), Faster-RCNN, etc.



⌨️ Controls

| Key     | Action            |
| ------- | ----------------- |
| `SPACE` | Pause / Play      |
| `Q`     | Quit              |
| `F`     | Fullscreen toggle |
| `→`     | Forward 1 seconds |
| `←`     | Rewind 1 seconds  |
    



Installation-

Clone the repo:

git clone https://github.com/raunitsingh/cvplayer.git
cd yoloplayer


create and activate a virtual environment:

python -m venv venv
source venv/bin/activate   # Linux/Mac
venv\Scripts\activate      # Windows


install dependencies:

pip install -r requirements.txt





🚀 Usage:

Basic video player:

from yoloplayer import YOLOPlayer

# Play a video file
player = YOLOPlayer("video.mp4")
player.run()



for webcam:

player = YOLOPlayer(0)
player.run()



For YOLO detection:

from yoloplayer import YOLOPlayer

player = YOLOPlayer("video.mp4", use_yolo=True, model_path="yolov8n.pt")
player.run()



