<p align="center">
<img src="https://github.com/freemocap/skellycam/blob/main/skellycam/assets/logo/skelly-cam-logo.svg" height="128" alt="Project Logo">
</p>
<h3 align="center">SkellyCam</h3>
<p align="center"> An easy and efficient way to connect to one or more cameras and record synchronized videos 💀📸</p>
<p align="center">
<a href="https://github.com/freemocap/fast-camera-capture/releases/latest">
<img src="https://img.shields.io/github/release/freemocap/fast-camera-capture.svg" alt="Latest Release">
</a>
<a href="https://github.com/freemocap/fast-camera-capture/blob/main/LICENSE">
<img src="https://img.shields.io/badge/license-AGPLv3+-blue.svg" alt="AGPLv3+">
</a>
<a href="https://github.com/freemocap/fast-camera-capture/issues">
<img src="https://img.shields.io/badge/contributions-almost-ff69b4.svg" alt="Contributions Welcome">
</a>
<a href="https://github.com/psf/black">
<img alt="https://img.shields.io/badge/code%20style-black-000000.svg" src="https://img.shields.io/badge/code%20style-black-000000.svg">
</a>
</p>
---
## Motivation
Connecting to cameras on multiple platforms in a way that is not slow is a difficult challenge, especially for new developers.
There are a bunch of tools out there (e.g. OpenCV) and other open source libraries that give just enough to support hardware manipulation,
but they need to be use in concert in order to be useful.
This library attempts to string those things together, and provide an interface for everyone to use in python with a simple `pip install`.
The primary focus is to provide an easy method to connect to one or more cameras and provide methods for streaming/recordig synchronized frames from the connected cameras.
> **NOTE** - The SkellyCam package is the primary camera backend for the `freemocap` markeless motion capture software 💀✨
>
> [https:github.com/freemocap/freemocap](https:github.com/freemocap/freemocap)
>
>[https://freemocap.org](https://freemocap.org)
---
## Installation and Usage
### 0. Open a terminal (ideally with a `python` virtual environment activate)
### 1. Install from Pip
Enter the command below and press 'Enter'
```bash
pip install skellycam
```
### 2. Launch SkellyCam GUI
Enter the command below and press 'Enter'
```bash
skellycam
```
### 3. Success! 💀📸✨
Hopefully a bunch of text scrolled by and a GUI popped up!
If not, please [open an issue on the github repo](https://github.com/freemocap/skellycam/issues) and we'll try to help you out :)
## Limitation (aka TO DO) -
- Currently uses `opencv` to connect to cameras, so it won't recognize hardware that can't be connected with `cv2.VideoCapture` - Support for other camera hardware (e.g. FLIR) coming soon
- Camera streams are not synchronized at run time, but are saved and synchronized after the fact. This is time-consuming process that requres frames be saved in RAM until the recording is done. Both of these weaknesses have solutions in the works.
### New Python developers
1) Install Python 3.10
2) Create Virtual Environment
3) Install `skellycam`
#### To install Python 3.10
[Windows Python3 Installation Guide](https://realpython.com/installing-python/#how-to-install-from-the-full-installer)
[MacOSX Python3 Installation Guide](https://realpython.com/installing-python/#step-1-download-the-official-installer)
[Linux Python3 Installation Guide](https://computingforgeeks.com/how-to-install-python-on-ubuntu-linux-system/)
### How to use
#### RECOMMENDED - Use the GUI!
Launch the GUI by running `skellycam` in a terminal.
This is currently the most tested method for interacting with the cameras.
#### Example 1 - Connecting to a single Camera and showing the video feed
[Example 1 Python Fle](skellycam/examples/example1_single_camera_connection.py)
In this example, we connect a camera at index 0. Calling `show` allows us to view the cameras frames allowing us
to see video.
> NOTE - Work in progress, no clean way to kill this window yet
```python
from skellycam import CameraConfig, Camera
if __name__ == "__main__":
cam1 = Camera(CameraConfig(cam_id=0))
cam1.connect()
cam1.show()
```
#### Example 2 - Connect to all available cameras and record synchronized videos
> NOTE - Experimental and under development, might be unstable
[Example 2 Python Fle](skellycam/examples/example1_single_camera_connection.py)
```python
from skellycam.experiments import MultiCameraVideoRecorder
if __name__ == "__main__":
synchronized_video_recorder = MultiCameraVideoRecorder()
synchronized_video_recorder.run()
```
### Contribution Guidelines
Please read our contribution doc: [CONTRIBUTING.md](CONTRIBUTING.md)
## Maintainers
* [Jon Matthis](https://github.com/jonmatthis)
* [Endurance Idehen](https://github.com/endurance)
## License
This project is licensed under the APGL License - see the [LICENSE](LICENSE) file for details.
If the AGPL does not work for your needs, we are happy to discuss terms to license this software to you with a different agreement at a price point that increases exponentially as you move [spiritually](https://www.gnu.org/philosophy/open-source-misses-the-point.en.html) away from the `AGPL`
Raw data
{
"_id": null,
"home_page": null,
"name": "skellycam",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.9",
"maintainer_email": null,
"keywords": "camera, stream, video, image, opencv, skelly, freemocap, motion capture, synchronization, computer vision",
"author": "Endurance Idehen, Jonathan Samir Matthis",
"author_email": "Skelly FreeMoCap <info@freemocap.org>",
"download_url": "https://files.pythonhosted.org/packages/03/ef/c8a6907b31585c0a8a982f034ba1075e746ba20b5f3ce5307dd5d637124d/skellycam-2024.9.1094.tar.gz",
"platform": null,
"description": "\n<p align=\"center\">\n <img src=\"https://github.com/freemocap/skellycam/blob/main/skellycam/assets/logo/skelly-cam-logo.svg\" height=\"128\" alt=\"Project Logo\">\n</p>\n<h3 align=\"center\">SkellyCam</h3>\n<p align=\"center\"> An easy and efficient way to connect to one or more cameras and record synchronized videos \ud83d\udc80\ud83d\udcf8</p>\n<p align=\"center\">\n <a href=\"https://github.com/freemocap/fast-camera-capture/releases/latest\">\n <img src=\"https://img.shields.io/github/release/freemocap/fast-camera-capture.svg\" alt=\"Latest Release\">\n </a>\n <a href=\"https://github.com/freemocap/fast-camera-capture/blob/main/LICENSE\">\n <img src=\"https://img.shields.io/badge/license-AGPLv3+-blue.svg\" alt=\"AGPLv3+\">\n </a>\n <a href=\"https://github.com/freemocap/fast-camera-capture/issues\">\n <img src=\"https://img.shields.io/badge/contributions-almost-ff69b4.svg\" alt=\"Contributions Welcome\">\n </a>\n <a href=\"https://github.com/psf/black\">\n <img alt=\"https://img.shields.io/badge/code%20style-black-000000.svg\" src=\"https://img.shields.io/badge/code%20style-black-000000.svg\">\n </a>\n</p>\n\n\n---\n## Motivation\n\nConnecting to cameras on multiple platforms in a way that is not slow is a difficult challenge, especially for new developers.\n\nThere are a bunch of tools out there (e.g. OpenCV) and other open source libraries that give just enough to support hardware manipulation,\nbut they need to be use in concert in order to be useful.\n\nThis library attempts to string those things together, and provide an interface for everyone to use in python with a simple `pip install`.\n\nThe primary focus is to provide an easy method to connect to one or more cameras and provide methods for streaming/recordig synchronized frames from the connected cameras.\n\n\n\n> **NOTE** - The SkellyCam package is the primary camera backend for the `freemocap` markeless motion capture software \ud83d\udc80\u2728\n> \n> [https:github.com/freemocap/freemocap](https:github.com/freemocap/freemocap)\n> \n>[https://freemocap.org](https://freemocap.org)\n\n---\n## Installation and Usage\n\n### 0. Open a terminal (ideally with a `python` virtual environment activate) \n\n### 1. Install from Pip\nEnter the command below and press 'Enter'\n```bash\npip install skellycam\n```\n\n### 2. Launch SkellyCam GUI\nEnter the command below and press 'Enter'\n```bash\nskellycam\n```\n\n\n### 3. Success! \ud83d\udc80\ud83d\udcf8\u2728\nHopefully a bunch of text scrolled by and a GUI popped up! \n\nIf not, please [open an issue on the github repo](https://github.com/freemocap/skellycam/issues) and we'll try to help you out :) \n\n\n## Limitation (aka TO DO) -\n- Currently uses `opencv` to connect to cameras, so it won't recognize hardware that can't be connected with `cv2.VideoCapture` - Support for other camera hardware (e.g. FLIR) coming soon\n- Camera streams are not synchronized at run time, but are saved and synchronized after the fact. This is time-consuming process that requres frames be saved in RAM until the recording is done. Both of these weaknesses have solutions in the works.\n\n### New Python developers\n\n1) Install Python 3.10\n2) Create Virtual Environment\n3) Install `skellycam`\n\n#### To install Python 3.10\n\n[Windows Python3 Installation Guide](https://realpython.com/installing-python/#how-to-install-from-the-full-installer)\n\n[MacOSX Python3 Installation Guide](https://realpython.com/installing-python/#step-1-download-the-official-installer)\n\n[Linux Python3 Installation Guide](https://computingforgeeks.com/how-to-install-python-on-ubuntu-linux-system/)\n\n### How to use\n\n#### RECOMMENDED - Use the GUI!\n\nLaunch the GUI by running `skellycam` in a terminal. \n\nThis is currently the most tested method for interacting with the cameras.\n\n\n#### Example 1 - Connecting to a single Camera and showing the video feed\n\n[Example 1 Python Fle](skellycam/examples/example1_single_camera_connection.py)\n\nIn this example, we connect a camera at index 0. Calling `show` allows us to view the cameras frames allowing us\nto see video.\n\n> NOTE - Work in progress, no clean way to kill this window yet\n\n```python\nfrom skellycam import CameraConfig, Camera\n\nif __name__ == \"__main__\":\n cam1 = Camera(CameraConfig(cam_id=0))\n cam1.connect()\n cam1.show()\n```\n\n\n#### Example 2 - Connect to all available cameras and record synchronized videos\n\n> NOTE - Experimental and under development, might be unstable\n \n[Example 2 Python Fle](skellycam/examples/example1_single_camera_connection.py)\n```python\nfrom skellycam.experiments import MultiCameraVideoRecorder\n\nif __name__ == \"__main__\":\n\n synchronized_video_recorder = MultiCameraVideoRecorder()\n synchronized_video_recorder.run()\n\n```\n\n### Contribution Guidelines\n\nPlease read our contribution doc: [CONTRIBUTING.md](CONTRIBUTING.md)\n\n## Maintainers\n\n* [Jon Matthis](https://github.com/jonmatthis)\n* [Endurance Idehen](https://github.com/endurance)\n\n## License\nThis project is licensed under the APGL License - see the [LICENSE](LICENSE) file for details.\n\nIf the AGPL does not work for your needs, we are happy to discuss terms to license this software to you with a different agreement at a price point that increases exponentially as you move [spiritually](https://www.gnu.org/philosophy/open-source-misses-the-point.en.html) away from the `AGPL`\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Top-level package for skellycam.",
"version": "2024.9.1094",
"project_urls": {
"Homepage": "https://github.com/freemocap/skellycam"
},
"split_keywords": [
"camera",
" stream",
" video",
" image",
" opencv",
" skelly",
" freemocap",
" motion capture",
" synchronization",
" computer vision"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "cdba12e6c155f100c82e524a2baf8abc7c62266f09646e0a78ced22afa50c13b",
"md5": "8a42c9801196551195c1405281d828f6",
"sha256": "dac6007d7108b9bb34af16b64c507032822c4868fcbcddf39832f38084a8a692"
},
"downloads": -1,
"filename": "skellycam-2024.9.1094-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8a42c9801196551195c1405281d828f6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.9",
"size": 75505,
"upload_time": "2024-09-04T20:42:19",
"upload_time_iso_8601": "2024-09-04T20:42:19.084378Z",
"url": "https://files.pythonhosted.org/packages/cd/ba/12e6c155f100c82e524a2baf8abc7c62266f09646e0a78ced22afa50c13b/skellycam-2024.9.1094-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "03efc8a6907b31585c0a8a982f034ba1075e746ba20b5f3ce5307dd5d637124d",
"md5": "48f16415c53284811605a8449fd94392",
"sha256": "4011d0e6517e09f917eae75a63d7debf215f89411c1fd1d117032ee74fda6f52"
},
"downloads": -1,
"filename": "skellycam-2024.9.1094.tar.gz",
"has_sig": false,
"md5_digest": "48f16415c53284811605a8449fd94392",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.9",
"size": 1402238,
"upload_time": "2024-09-04T20:42:20",
"upload_time_iso_8601": "2024-09-04T20:42:20.796583Z",
"url": "https://files.pythonhosted.org/packages/03/ef/c8a6907b31585c0a8a982f034ba1075e746ba20b5f3ce5307dd5d637124d/skellycam-2024.9.1094.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-04 20:42:20",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "freemocap",
"github_project": "skellycam",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "skellycam"
}
JSON
