# PyTVPaint 🐍 → 🦋
[](https://brunchstudio.github.io/pytvpaint/)
[](https://github.com/brunchstudio/pytvpaint/blob/main/LICENSE.md)
[](https://pypi.org/project/pytvpaint/)
[](https://pepy.tech/project/pytvpaint)
[](https://pypi.org/project/pytvpaint/)
[](https://www.tvpaint.com/doc/tvp11/)
<p align="center">
<img src="https://raw.githubusercontent.com/brunchstudio/pytvpaint/main/docs/assets/pytvpaint_code_banner.png" width=700 />
</p>
**PyTVPaint** is a type-safe Python library that wraps the George programming language commands in order to interact with the 2D animation software TVPaint.
It communicates through WebSocket to a [custom C++ plugin](https://github.com/brunchstudio/tvpaint-rpc) running in an open TVPaint instance.
You can check the [documentation](https://brunchstudio.github.io/pytvpaint/) for more details.
## Installation
### Requirements
- Windows (for now, see [this](https://brunchstudio.github.io/pytvpaint/limitations/#windows-only))
- Python v3.9+
- TVPaint v11.5+
- TVPaint RPC plugin (install instructions [here](https://brunchstudio.github.io/pytvpaint/installation/#tvpaint-plugin-installation))
Install the package with Pip:
```console
pip install pytvpaint
```
## Simple example
```python
from pytvpaint import george
from pytvpaint.project import Project
# Get access to tvp elements
project = Project.load("scene.tvpp", silent=True)
clip = project.current_clip
# Or get the clip by name
clip = project.get_clip(by_name="my_clip")
layer = clip.add_layer("my_new_layer")
# Check out other layers
for layer in clip.layers:
print(layer.name)
# Get access to George functions
george.tv_rect(50, 50, 100, 100)
# Render your file
clip.render("./out.#.png", start=20, end=45)
project.close()
```
## Contributing
Pull requests are welcome. For major changes, please [open an issue](https://github.com/brunchstudio/pytvpaint/issues/new/choose) first
to discuss what you would like to change.
Please make sure to [update tests](https://brunchstudio.github.io/pytvpaint/contributing/developer_setup/#unit-tests) as appropriate.
## Disclaimer
PyTVPaint is a project created at BRUNCH Studio to facilitate our development experience with George. The API is targeted at experienced developers and is by no means a replacement for TVPaint or George but simply builds on it.
We are not affiliated with the TVPaint development team and therefore can't fix any bugs in the software or the George API.
Please direct your issues appropriately; any issues with PyTVPaint should be submitted as [an issue in this repository](https://github.com/brunchstudio/pytvpaint/issues) or the [C++ plugin's repository](https://github.com/brunchstudio/tvpaint-rpc), any issues with TVPaint the software should be addressed to the [tvp support team](https://tvpaint.odoo.com/en_US/contactus).
For any questions on the limitations of our API, please head to [this page](https://brunchstudio.github.io/pytvpaint/limitations/).
## License
[MIT](./LICENSE.md)
<hr>
Made with ❤️ at [BRUNCH Studio](https://brunchstudio.tv/)
Raw data
{
"_id": null,
"home_page": "https://github.com/brunchstudio/pytvpaint",
"name": "pytvpaint",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "tvpaint, brunch, tvp, george",
"author": "Brunch Studio Developers",
"author_email": "dev@brunchstudio.tv",
"download_url": "https://files.pythonhosted.org/packages/52/3c/8ae3af18a592b9014a9691bc0bd1edc05b24b1a27354edba4a63de05c97b/pytvpaint-1.0.0b9.tar.gz",
"platform": null,
"description": "# PyTVPaint \ud83d\udc0d \u2192 \ud83e\udd8b\n\n[](https://brunchstudio.github.io/pytvpaint/)\n[](https://github.com/brunchstudio/pytvpaint/blob/main/LICENSE.md)\n[](https://pypi.org/project/pytvpaint/)\n[](https://pepy.tech/project/pytvpaint)\n[](https://pypi.org/project/pytvpaint/)\n[](https://www.tvpaint.com/doc/tvp11/)\n\n<p align=\"center\">\n <img src=\"https://raw.githubusercontent.com/brunchstudio/pytvpaint/main/docs/assets/pytvpaint_code_banner.png\" width=700 />\n</p>\n\n**PyTVPaint** is a type-safe Python library that wraps the George programming language commands in order to interact with the 2D animation software TVPaint.\n\nIt communicates through WebSocket to a [custom C++ plugin](https://github.com/brunchstudio/tvpaint-rpc) running in an open TVPaint instance.\n\nYou can check the [documentation](https://brunchstudio.github.io/pytvpaint/) for more details.\n\n## Installation\n\n### Requirements\n\n- Windows (for now, see [this](https://brunchstudio.github.io/pytvpaint/limitations/#windows-only))\n- Python v3.9+\n- TVPaint v11.5+\n- TVPaint RPC plugin (install instructions [here](https://brunchstudio.github.io/pytvpaint/installation/#tvpaint-plugin-installation))\n\nInstall the package with Pip:\n\n```console\npip install pytvpaint\n```\n\n## Simple example\n\n```python\nfrom pytvpaint import george\nfrom pytvpaint.project import Project\n\n# Get access to tvp elements\nproject = Project.load(\"scene.tvpp\", silent=True)\n\nclip = project.current_clip\n# Or get the clip by name\nclip = project.get_clip(by_name=\"my_clip\")\n\nlayer = clip.add_layer(\"my_new_layer\")\n\n# Check out other layers\nfor layer in clip.layers:\n print(layer.name)\n\n# Get access to George functions\ngeorge.tv_rect(50, 50, 100, 100)\n\n# Render your file\nclip.render(\"./out.#.png\", start=20, end=45)\n\nproject.close()\n```\n\n## Contributing\n\nPull requests are welcome. For major changes, please [open an issue](https://github.com/brunchstudio/pytvpaint/issues/new/choose) first\nto discuss what you would like to change.\n\nPlease make sure to [update tests](https://brunchstudio.github.io/pytvpaint/contributing/developer_setup/#unit-tests) as appropriate.\n\n## Disclaimer\n\nPyTVPaint is a project created at BRUNCH Studio to facilitate our development experience with George. The API is targeted at experienced developers and is by no means a replacement for TVPaint or George but simply builds on it.\n\nWe are not affiliated with the TVPaint development team and therefore can't fix any bugs in the software or the George API.\n\nPlease direct your issues appropriately; any issues with PyTVPaint should be submitted as [an issue in this repository](https://github.com/brunchstudio/pytvpaint/issues) or the [C++ plugin's repository](https://github.com/brunchstudio/tvpaint-rpc), any issues with TVPaint the software should be addressed to the [tvp support team](https://tvpaint.odoo.com/en_US/contactus).\n\nFor any questions on the limitations of our API, please head to [this page](https://brunchstudio.github.io/pytvpaint/limitations/).\n\n## License\n\n[MIT](./LICENSE.md)\n\n<hr>\n\nMade with \u2764\ufe0f at [BRUNCH Studio](https://brunchstudio.tv/)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python scripting for TVPaint",
"version": "1.0.0b9",
"project_urls": {
"Documentation": "https://brunchstudio.github.io/pytvpaint/",
"Homepage": "https://github.com/brunchstudio/pytvpaint",
"Repository": "https://github.com/brunchstudio/pytvpaint"
},
"split_keywords": [
"tvpaint",
" brunch",
" tvp",
" george"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "385f731e47135c01d5699b467320414a618285f50288ca0f0d57bbeb3d0aa199",
"md5": "1033cb17c8807ec6a8c5092fe94df457",
"sha256": "f911fc34aff56c3cb28d8d5d86f6e413abe567afe2b9799264683ae5767756c3"
},
"downloads": -1,
"filename": "pytvpaint-1.0.0b9-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1033cb17c8807ec6a8c5092fe94df457",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 67191,
"upload_time": "2024-05-28T20:46:54",
"upload_time_iso_8601": "2024-05-28T20:46:54.717291Z",
"url": "https://files.pythonhosted.org/packages/38/5f/731e47135c01d5699b467320414a618285f50288ca0f0d57bbeb3d0aa199/pytvpaint-1.0.0b9-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "523c8ae3af18a592b9014a9691bc0bd1edc05b24b1a27354edba4a63de05c97b",
"md5": "39d57a4f8d31678e8fbff27811a34407",
"sha256": "2dc88d1fbfd1970c2c725692b1052852b6ac44dc040be445f6a69867a78309aa"
},
"downloads": -1,
"filename": "pytvpaint-1.0.0b9.tar.gz",
"has_sig": false,
"md5_digest": "39d57a4f8d31678e8fbff27811a34407",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 58746,
"upload_time": "2024-05-28T20:46:59",
"upload_time_iso_8601": "2024-05-28T20:46:59.536815Z",
"url": "https://files.pythonhosted.org/packages/52/3c/8ae3af18a592b9014a9691bc0bd1edc05b24b1a27354edba4a63de05c97b/pytvpaint-1.0.0b9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-28 20:46:59",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "brunchstudio",
"github_project": "pytvpaint",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "pytvpaint"
}
JSON
