<p align="center">
<img src="https://github.com/freemocap/freemocap/assets/15314521/da1af7fe-f808-43dc-8f59-c579715d6593" height="240" alt="Project Logo">
</p>
<h3 align="center">The FreeMoCap Project</h3>
<h4 align="center"> A free-and-open-source, hardware-and-software-agnostic, minimal-cost, research-grade, motion capture
system and platform for decentralized scientific research, education, and training</h2>
<p align="center">
<a href="https://doi.org/10.5281/zenodo.7233714">
<img src="https://zenodo.org/badge/DOI/10.5281/zenodo.7233714.svg" alt=DOI-via-Zenodo.org>
</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>
<a href="https://github.com/freemocap/freemocap/releases/latest">
<img src="https://img.shields.io/github/release/freemocap/freemocap.svg" alt="Latest Release">
</a>
<a href="https://github.com/freemocap/freemocap/blob/main/LICENSE">
<img src="https://img.shields.io/badge/license-AGPL-blue.svg" alt="AGPLv3">
</a>
<a href="https://github.com/freemocap/freemocap/issues">
<img src="https://img.shields.io/badge/contributions-welcome-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>
<a href="https://discord.gg/SgdnzbHDTG">
<img alt="Discord Community Server" src="https://dcbadge.vercel.app/api/server/SgdnzbHDTG?style=flat">
</a>
</p>
https://user-images.githubusercontent.com/15314521/192062522-2a8d9305-f181-4869-a4b9-1aa068e094c9.mp4
--
## QUICKSTART
#### 0. Create a a Python 3.9 through 3.11 environment (python3.11 recommended)¶
#### 1. Install software via [pip](https://pypi.org/project/freemocap/#description):
```
pip install freemocap
```
#### 2. Launch the GUI by entering the command:
```
freemocap
```
#### 3. A GUI should pop up that looks like this:
<img width="1457" alt="image" src="https://github.com/freemocap/freemocap/assets/15314521/90ef7e7b-48f3-4f46-8d4a-5b5bcc3254b3">
#### 4. Have fun! It might break! Work in Progress lol
#### 5. [Join the Discord and let us know how it went!](https://discord.gg/nxv5dNTfKT)
___
## Install/run from source code (i.e. the code in this repo)
Open an [Anaconda-enabled command prompt](https://www.anaconda.org) (or your preferred method of environmnet management) and enter the following commands:
1) Create a `Python` environment (Recommended version is `python3.11`)
```bash
conda create -n freemocap-env python=3.11
```
2) Activate that newly created environment
```bash
conda activate freemocap-env
```
3) Clone the repository
```bash
git clone https://github.com/freemocap/freemocap
```
4) Navigate into the newly cloned/downloaded `freemocap` folder
```bash
cd freemocap
```
5) Install the package via the `pyproject.toml` file
```bash
pip install -e .
```
6) Launch the GUI (via the `freemocap.__main__.py` entry point)
```bash
python -m freemocap
```
A GUI should pop up!
___
## Documentation
Our documenation is hosted at: https://freemocap.github.io/documentation/index_md.html
That site is built using `writerside` from this repository: https://github.com/freemocap/documentation
___
### Contribution Guidelines
Please read our contribution doc: [CONTRIBUTING.md](CONTRIBUTING.md)
## Related
[//]: # (* [project-name](#) - Project description)
## 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": "freemocap",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.9",
"maintainer_email": null,
"keywords": "camera, stream, video, image, opencv, skelly, freemocap, motion capture, markerless motion capture, mocap, markerless mocap, markerless, kinematic, animation, 3d animation, Blender, Blender3d, synchronization, computer vision",
"author": "Endurance Idehen, Aaron Cherian, Jonathan Samir Matthis",
"author_email": "Skelly FreeMoCap <info@freemocap.org>",
"download_url": "https://files.pythonhosted.org/packages/8f/c0/9932bd87f74bc38c84010ff8edf3fdece40956f281ba17249cbb3e48e9be/freemocap-1.4.7.tar.gz",
"platform": null,
"description": "<p align=\"center\">\n <img src=\"https://github.com/freemocap/freemocap/assets/15314521/da1af7fe-f808-43dc-8f59-c579715d6593\" height=\"240\" alt=\"Project Logo\">\n</p> \n\n\n<h3 align=\"center\">The FreeMoCap Project</h3>\n<h4 align=\"center\"> A free-and-open-source, hardware-and-software-agnostic, minimal-cost, research-grade, motion capture\nsystem and platform for decentralized scientific research, education, and training</h2>\n\n\n<p align=\"center\">\n\n<a href=\"https://doi.org/10.5281/zenodo.7233714\">\n <img src=\"https://zenodo.org/badge/DOI/10.5281/zenodo.7233714.svg\" alt=DOI-via-Zenodo.org>\n </a>\n\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\n<a href=\"https://github.com/freemocap/freemocap/releases/latest\">\n <img src=\"https://img.shields.io/github/release/freemocap/freemocap.svg\" alt=\"Latest Release\">\n </a>\n\n<a href=\"https://github.com/freemocap/freemocap/blob/main/LICENSE\">\n <img src=\"https://img.shields.io/badge/license-AGPL-blue.svg\" alt=\"AGPLv3\">\n </a>\n\n<a href=\"https://github.com/freemocap/freemocap/issues\">\n <img src=\"https://img.shields.io/badge/contributions-welcome-ff69b4.svg\" alt=\"Contributions Welcome\">\n </a>\n\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\n<a href=\"https://discord.gg/SgdnzbHDTG\">\n <img alt=\"Discord Community Server\" src=\"https://dcbadge.vercel.app/api/server/SgdnzbHDTG?style=flat\">\n </a>\n\n\n</p>\n\n\nhttps://user-images.githubusercontent.com/15314521/192062522-2a8d9305-f181-4869-a4b9-1aa068e094c9.mp4\n\n\n\n\n\n--\n## QUICKSTART\n\n#### 0. Create a a Python 3.9 through 3.11 environment (python3.11 recommended)\u00b6\n#### 1. Install software via [pip](https://pypi.org/project/freemocap/#description):\n\n```\npip install freemocap\n```\n\n#### 2. Launch the GUI by entering the command:\n\n```\nfreemocap\n``` \n\n#### 3. A GUI should pop up that looks like this: \n\n <img width=\"1457\" alt=\"image\" src=\"https://github.com/freemocap/freemocap/assets/15314521/90ef7e7b-48f3-4f46-8d4a-5b5bcc3254b3\">\n\n#### 4. Have fun! It might break! Work in Progress lol\n\n#### 5. [Join the Discord and let us know how it went!](https://discord.gg/nxv5dNTfKT)\n\n\n\n___\n## Install/run from source code (i.e. the code in this repo)\n\nOpen an [Anaconda-enabled command prompt](https://www.anaconda.org) (or your preferred method of environmnet management) and enter the following commands:\n\n1) Create a `Python` environment (Recommended version is `python3.11`)\n\n```bash\nconda create -n freemocap-env python=3.11\n```\n\n2) Activate that newly created environment\n\n```bash\nconda activate freemocap-env\n```\n\n3) Clone the repository\n\n```bash\ngit clone https://github.com/freemocap/freemocap\n```\n\n4) Navigate into the newly cloned/downloaded `freemocap` folder\n\n```bash\ncd freemocap\n```\n\n5) Install the package via the `pyproject.toml` file\n\n```bash\npip install -e .\n```\n\n6) Launch the GUI (via the `freemocap.__main__.py` entry point)\n\n```bash\npython -m freemocap\n```\n\nA GUI should pop up!\n\n___\n\n## Documentation \n\nOur documenation is hosted at: https://freemocap.github.io/documentation/index_md.html\n\nThat site is built using `writerside` from this repository: https://github.com/freemocap/documentation\n\n___\n\n\n\n### Contribution Guidelines\n\nPlease read our contribution doc: [CONTRIBUTING.md](CONTRIBUTING.md)\n\n\n## Related\n\n[//]: # (* [project-name](#) - Project description)\n\n## Maintainers\n\n* [Jon Matthis](https://github.com/jonmatthis)\n* [Endurance Idehen](https://github.com/endurance)\n\n## License\n\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\nagreement at a price point that increases exponentially as you\nmove [spiritually](https://www.gnu.org/philosophy/open-source-misses-the-point.en.html) away from the `AGPL`\n\n\n",
"bugtrack_url": null,
"license": null,
"summary": "A free and open source markerless motion capture system for everyone \ud83d\udc80\u2728",
"version": "1.4.7",
"project_urls": {
"Documentation": "https://freemocap.github.io/documentation/",
"Github": "https://github.com/freemocap/freemocap",
"Homepage": "https://freemocap.org"
},
"split_keywords": [
"camera",
" stream",
" video",
" image",
" opencv",
" skelly",
" freemocap",
" motion capture",
" markerless motion capture",
" mocap",
" markerless mocap",
" markerless",
" kinematic",
" animation",
" 3d animation",
" blender",
" blender3d",
" synchronization",
" computer vision"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "6264491e4a115e642348341a1516425b9f72f2c0c7223b3d00b9ec44969b9108",
"md5": "11dacfac7cc0729928b5027025aa298d",
"sha256": "9efe42e24c203860254e023caa2efa34f2a96c028671074623e39b21eb526d4a"
},
"downloads": -1,
"filename": "freemocap-1.4.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "11dacfac7cc0729928b5027025aa298d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.9",
"size": 688876,
"upload_time": "2024-10-10T17:34:53",
"upload_time_iso_8601": "2024-10-10T17:34:53.824963Z",
"url": "https://files.pythonhosted.org/packages/62/64/491e4a115e642348341a1516425b9f72f2c0c7223b3d00b9ec44969b9108/freemocap-1.4.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8fc09932bd87f74bc38c84010ff8edf3fdece40956f281ba17249cbb3e48e9be",
"md5": "a54222a58f571d7e08b17f0771a2fcee",
"sha256": "b2e9acbaf5edd12e6dcbe52bb8f9fafb95fef04885ff8bf0e48b8401654dff8f"
},
"downloads": -1,
"filename": "freemocap-1.4.7.tar.gz",
"has_sig": false,
"md5_digest": "a54222a58f571d7e08b17f0771a2fcee",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.9",
"size": 1049698,
"upload_time": "2024-10-10T17:34:55",
"upload_time_iso_8601": "2024-10-10T17:34:55.788393Z",
"url": "https://files.pythonhosted.org/packages/8f/c0/9932bd87f74bc38c84010ff8edf3fdece40956f281ba17249cbb3e48e9be/freemocap-1.4.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-10 17:34:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "freemocap",
"github_project": "freemocap",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "freemocap"
}
JSON
