| Name | HoloCapture JSON |
| Version |
0.1.1
JSON |
| download |
| home_page | None |
| Summary | An easy way to capture and stream media from multiple cameras, from the screen and urls |
| upload_time | 2025-08-17 20:18:33 |
| 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/1c/0f/ae927861902408a58829f25e7b00d4072e7b72284d923015d7ad4ce74b56/holocapture-0.1.1.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, from the screen and urls",
"version": "0.1.1",
"project_urls": {
"Homepage": "https://github.com/TristanMcBrideSr"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d2e0da2e180b1bf3472006b88e6f68c5c47611604e19d5367e2986d861c7e03f",
"md5": "f86e15dc1cb67f4e8a5c37869719df98",
"sha256": "80f219304c8e758b3cee10f20f54ea64e8eff38f71bdd641f524c2c2cd7540e3"
},
"downloads": -1,
"filename": "holocapture-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f86e15dc1cb67f4e8a5c37869719df98",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 6794,
"upload_time": "2025-08-17T20:18:32",
"upload_time_iso_8601": "2025-08-17T20:18:32.512455Z",
"url": "https://files.pythonhosted.org/packages/d2/e0/da2e180b1bf3472006b88e6f68c5c47611604e19d5367e2986d861c7e03f/holocapture-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1c0fae927861902408a58829f25e7b00d4072e7b72284d923015d7ad4ce74b56",
"md5": "e1d76d2aefbf35d11e50e2ff95581e7c",
"sha256": "c93b521eb9b565517ae5a647c2f084a1dd12f64cee0fbb282fc7954c783d5569"
},
"downloads": -1,
"filename": "holocapture-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "e1d76d2aefbf35d11e50e2ff95581e7c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 6303,
"upload_time": "2025-08-17T20:18:33",
"upload_time_iso_8601": "2025-08-17T20:18:33.712648Z",
"url": "https://files.pythonhosted.org/packages/1c/0f/ae927861902408a58829f25e7b00d4072e7b72284d923015d7ad4ce74b56/holocapture-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-17 20:18:33",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "holocapture"
}
