| Name | HoloCapture JSON |
| Version |
0.1.0
JSON |
| download |
| home_page | None |
| Summary | An easy way to capture and stream media from multiple cameras and from the screen |
| upload_time | 2025-08-06 01:20:18 |
| maintainer | None |
| docs_url | None |
| author | Tristan McBride Sr. |
| requires_python | >=3.10 |
| license | None |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
---
# HoloCapture
**HoloCapture** is a simple, production-ready Python utility for screen and camera capture, screen/camera streaming, multi-camera compositing, and media normalization—using only a few lines of code.
---
## Features
* Capture screenshots to file
* Record screen to video
* Capture images from one or more cameras (with optional normalization)
* Record video from multiple cameras to a single file (side-by-side)
* Real-time screen streaming (with auto-resize)
* Real-time multi-camera streaming (with auto-resize, optional normalization)
* Simple directory management
* No external dependencies beyond common imaging libraries
---
## Installation
```bash
pip install HoloCapture
```
---
## Usage
```python
from HoloCapture import HoloCapture
import cv2
import numpy as np
mediaCapture = HoloCapture()
# Capture a screenshot
mediaCapture.captureScreen('screenshots/screen.jpg')
# Record the screen for 10 seconds
mediaCapture.recordScreen('videos/screen.mp4', duration=10)
# Capture from two cameras and save side-by-side
mediaCapture.captureMedia('images/cameras.jpg', 0, 1, normalize=True)
# Record from two cameras for 15 seconds
mediaCapture.recordMedia('videos/cameras.mp4', 0, 1, duration=15, normalize=True)
# Stream live screen preview (press 'q' to exit)
for frame in mediaCapture.streamScreen(fps=15):
cv2.imshow("Screen", cv2.cvtColor(frame, cv2.COLOR_RGB2BGR))
if cv2.waitKey(1) & 0xFF == ord('q'):
break
cv2.destroyAllWindows()
# Stream from cameras (press 'q' to exit)
for frames, frameCount in mediaCapture.streamCameras(0, 1, normalize=True):
if any(f is None for f in frames):
break
combined = np.hstack(frames)
cv2.imshow("Combined Cameras", combined)
if cv2.waitKey(1) & 0xFF == ord('q'):
break
cv2.destroyAllWindows()
```
---
## Methods
| Method | Description |
| ------------------------------------------ | --------------------------------------------- |
| `captureScreen(mediaFile)` | Capture screenshot to file |
| `recordScreen(mediaFile, duration=10)` | Record the screen to video file |
| `captureMedia(combinedFile, *cameras)` | Capture side-by-side from one or more cameras |
| `recordMedia(combinedFile, *cameras, ...)` | Record video from one or more cameras |
| `streamScreen(fps=10, maxWidth=1280, ...)` | Generator: live screen frames (resized) |
| `streamCameras(*cameras, ...)` | Generator: live camera frames (resized) |
| `normalizeImage(image)` | Normalize contrast/gamma of a frame |
---
## Notes
* `ImageGrab` requires Windows/macOS or X11-based Linux.
* For multi-camera capture, you must have multiple camera devices attached.
* Streaming windows can be exited by pressing the `q` key.
* Output directories are created automatically if they don’t exist.
---
## License
This project is licensed under the [Apache License, Version 2.0](LICENSE).
Copyright 2025 Tristan McBride Sr.
---
## Acknowledgements
Project by:
- Tristan McBride Sr.
- Sybil
Raw data
{
"_id": null,
"home_page": null,
"name": "HoloCapture",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": null,
"author": "Tristan McBride Sr.",
"author_email": "\"Tristan McBride Sr.\" <142635792+TristanMcBrideSr@users.noreply.github.com>",
"download_url": "https://files.pythonhosted.org/packages/5d/3c/7412984a8bb8273ea0b686e2996f5c006e30f7db8b867505c75ef9f30522/holocapture-0.1.0.tar.gz",
"platform": null,
"description": "\ufeff\r\n---\r\n\r\n# HoloCapture\r\n\r\n**HoloCapture** is a simple, production-ready Python utility for screen and camera capture, screen/camera streaming, multi-camera compositing, and media normalization\u2014using only a few lines of code.\r\n\r\n---\r\n\r\n## Features\r\n\r\n* Capture screenshots to file\r\n* Record screen to video\r\n* Capture images from one or more cameras (with optional normalization)\r\n* Record video from multiple cameras to a single file (side-by-side)\r\n* Real-time screen streaming (with auto-resize)\r\n* Real-time multi-camera streaming (with auto-resize, optional normalization)\r\n* Simple directory management\r\n* No external dependencies beyond common imaging libraries\r\n\r\n---\r\n\r\n## Installation\r\n\r\n```bash\r\npip install HoloCapture\r\n```\r\n\r\n---\r\n\r\n## Usage\r\n\r\n```python\r\nfrom HoloCapture import HoloCapture\r\nimport cv2\r\nimport numpy as np\r\n\r\nmediaCapture = HoloCapture()\r\n\r\n# Capture a screenshot\r\nmediaCapture.captureScreen('screenshots/screen.jpg')\r\n\r\n# Record the screen for 10 seconds\r\nmediaCapture.recordScreen('videos/screen.mp4', duration=10)\r\n\r\n# Capture from two cameras and save side-by-side\r\nmediaCapture.captureMedia('images/cameras.jpg', 0, 1, normalize=True)\r\n\r\n# Record from two cameras for 15 seconds\r\nmediaCapture.recordMedia('videos/cameras.mp4', 0, 1, duration=15, normalize=True)\r\n\r\n# Stream live screen preview (press 'q' to exit)\r\nfor frame in mediaCapture.streamScreen(fps=15):\r\n cv2.imshow(\"Screen\", cv2.cvtColor(frame, cv2.COLOR_RGB2BGR))\r\n if cv2.waitKey(1) & 0xFF == ord('q'):\r\n break\r\ncv2.destroyAllWindows()\r\n\r\n# Stream from cameras (press 'q' to exit)\r\nfor frames, frameCount in mediaCapture.streamCameras(0, 1, normalize=True):\r\n if any(f is None for f in frames):\r\n break\r\n combined = np.hstack(frames)\r\n cv2.imshow(\"Combined Cameras\", combined)\r\n if cv2.waitKey(1) & 0xFF == ord('q'):\r\n break\r\ncv2.destroyAllWindows()\r\n```\r\n\r\n---\r\n\r\n## Methods\r\n\r\n| Method | Description |\r\n| ------------------------------------------ | --------------------------------------------- |\r\n| `captureScreen(mediaFile)` | Capture screenshot to file |\r\n| `recordScreen(mediaFile, duration=10)` | Record the screen to video file |\r\n| `captureMedia(combinedFile, *cameras)` | Capture side-by-side from one or more cameras |\r\n| `recordMedia(combinedFile, *cameras, ...)` | Record video from one or more cameras |\r\n| `streamScreen(fps=10, maxWidth=1280, ...)` | Generator: live screen frames (resized) |\r\n| `streamCameras(*cameras, ...)` | Generator: live camera frames (resized) |\r\n| `normalizeImage(image)` | Normalize contrast/gamma of a frame |\r\n\r\n---\r\n\r\n## Notes\r\n\r\n* `ImageGrab` requires Windows/macOS or X11-based Linux.\r\n* For multi-camera capture, you must have multiple camera devices attached.\r\n* Streaming windows can be exited by pressing the `q` key.\r\n* Output directories are created automatically if they don\u2019t exist.\r\n\r\n---\r\n\r\n## License\r\n\r\nThis project is licensed under the [Apache License, Version 2.0](LICENSE).\r\nCopyright 2025 Tristan McBride Sr.\r\n\r\n---\r\n\r\n## Acknowledgements\r\n\r\nProject by:\r\n- Tristan McBride Sr.\r\n- Sybil\r\n\r\n",
"bugtrack_url": null,
"license": null,
"summary": "An easy way to capture and stream media from multiple cameras and from the screen",
"version": "0.1.0",
"project_urls": {
"Homepage": "https://github.com/TristanMcBrideSr"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "cc54470adcaef140d3f9fade834c71244df06d84ef3aa1d0ba2eb83e774f5421",
"md5": "257768f8091ef49355e4181b67954dbc",
"sha256": "09dfcd335d3724aeb0c9641b4205cad8c6c4b2b285971cebac85ba5b29b42060"
},
"downloads": -1,
"filename": "holocapture-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "257768f8091ef49355e4181b67954dbc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 3480,
"upload_time": "2025-08-06T01:20:17",
"upload_time_iso_8601": "2025-08-06T01:20:17.603090Z",
"url": "https://files.pythonhosted.org/packages/cc/54/470adcaef140d3f9fade834c71244df06d84ef3aa1d0ba2eb83e774f5421/holocapture-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5d3c7412984a8bb8273ea0b686e2996f5c006e30f7db8b867505c75ef9f30522",
"md5": "a61319defc848a63fcc1f000694152b3",
"sha256": "222a1c58861d7134e46037ec2948eb2d77cb2b0edc018844c5bbf8693d46c341"
},
"downloads": -1,
"filename": "holocapture-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "a61319defc848a63fcc1f000694152b3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 3280,
"upload_time": "2025-08-06T01:20:18",
"upload_time_iso_8601": "2025-08-06T01:20:18.591018Z",
"url": "https://files.pythonhosted.org/packages/5d/3c/7412984a8bb8273ea0b686e2996f5c006e30f7db8b867505c75ef9f30522/holocapture-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-06 01:20:18",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "holocapture"
}
