{"id":16589062,"url":"https://github.com/hannesdelbeke/substance-painter-plugin-template","last_synced_at":"2025-10-29T09:31:39.313Z","repository":{"id":203286707,"uuid":"709253462","full_name":"hannesdelbeke/substance-painter-plugin-template","owner":"hannesdelbeke","description":" a template for Substance Painter Python plugins   ","archived":false,"fork":false,"pushed_at":"2024-11-18T10:44:28.000Z","size":63,"stargazers_count":13,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-02T00:31:41.263Z","etag":null,"topics":["painter","pipeline","plugin","python","substance","techart","template","tool"],"latest_commit_sha":null,"homepage":"","language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hannesdelbeke.png","metadata":{"files":{"readme":"README.md","changelog":"HISTORY.md","contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2023-10-24T10:46:57.000Z","updated_at":"2025-01-21T03:04:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"4b71b06b-04c2-4fc5-aafc-882c1e8d8332","html_url":"https://github.com/hannesdelbeke/substance-painter-plugin-template","commit_stats":null,"previous_names":["hannesdelbeke/substance-painter-plugin-template"],"tags_count":0,"template":true,"template_full_name":"rochacbruno/python-project-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hannesdelbeke%2Fsubstance-painter-plugin-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hannesdelbeke%2Fsubstance-painter-plugin-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hannesdelbeke%2Fsubstance-painter-plugin-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hannesdelbeke%2Fsubstance-painter-plugin-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hannesdelbeke","download_url":"https://codeload.github.com/hannesdelbeke/substance-painter-plugin-template/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238803209,"owners_count":19533269,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["painter","pipeline","plugin","python","substance","techart","template","tool"],"created_at":"2024-10-11T23:07:43.666Z","updated_at":"2025-10-29T09:31:38.928Z","avatar_url":"https://github.com/hannesdelbeke.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# Substance Painter plugin template\n\nA Substance Painter plugin template.\n- e.g. used for https://github.com/plugget/plugget-substance-painter-plugin\n\n\n### What is included on this template?\n![image](https://github.com/hannesdelbeke/substance-painter-plugin-template/assets/3758308/f0d6ee12-4c59-4862-b965-038ee3bd8b48)\n\n- a dockable Substance Painter widget\n- 📦 A [pyproject.toml](pyproject.toml) so you can pip install this plugin.  \n- 🤖 A [Makefile](Makefile) with the most useful commands to install, test, lint, format and release your project.\n- 📃 Documentation structure using [mkdocs](http://www.mkdocs.org)\n- 🔄 Continuous integration using [Github Actions](.github/workflows/) with jobs to lint, test and release your project on Linux, Mac and Windows environments.\n   - 💬 Auto generation of change log using **gitchangelog** to keep a HISTORY.md file automatically based on your commit history on every release.\n   - 🧪 Testing structure using [pytest](https://docs.pytest.org/en/latest/)\n   - ✅ Code linting using [flake8](https://flake8.pycqa.org/en/latest/)\n   - 📊 Code coverage reports using [codecov](https://about.codecov.io/sign-up/)\n   - 🛳️ Automatic release to [PyPI](https://pypi.org)\n\n\n### HOW TO USE THIS TEMPLATE\n\n1. Click on **[Use this template](https://github.com/hannesdelbeke/substance-painter-plugin-template/generate)**\n3. Give a name to your project (e.g. `my_awesome_project`, use all lowercase and underscores separation \u003c!-- TODO see if we can swap to my-awesome-project for package \u0026 project name, but my_awesome_project for python module --\u003e \n3. Wait until the first run of CI finishes\n4. For [codecov](https://about.codecov.io/sign-up/) Reports \u0026 Automatic Release to [PyPI](https://pypi.org)  \n   go to `settings-\u003esecrets` add your `PYPI_API_TOKEN` and `CODECOV_TOKEN`\n4. Read the file [CONTRIBUTING.md](CONTRIBUTING.md)\n\u003e ⚠️ **WAIT** until first CI run on github actions before cloning your new project.\n5. Then clone your new project and happy coding!\n6. delete all text above this, and complete the README template below for your project\n7. This template is in the public domain. Choose a LICENSE for your repo\n\n---\n# project_name\n\n[![codecov](https://codecov.io/gh/author_name/project_urlname/branch/main/graph/badge.svg?token=project_urlname_token_here)](https://codecov.io/gh/author_name/project_urlname)\n[![CI](https://github.com/author_name/project_urlname/actions/workflows/main.yml/badge.svg)](https://github.com/author_name/project_urlname/actions/workflows/main.yml)\n\nproject_description\n\n## Install \n#### install plugin\n- Manually copy `project_name.py` to your plugin folder,  \n  e.g. `C:\\Users\\USER\\OneDrive\\Documents\\Adobe\\Adobe Substance 3D Painter\\python\\plugins`\n- or pip install from this repo\n```bash\npip install --no-dependencies https://github.com/author_name/project_urlname/archive/refs/heads/main.zip --target \"C:\\Users\\USER\\OneDrive\\Documents\\Adobe\\Adobe Substance 3D Painter\\python\\plugins\"\n```\n#### install dependencies\ndownload the repo, browse to the folder with the `requirements.txt`\n```bash\npip install -r requirements.txt --target \"C:\\Users\\USER\\OneDrive\\Documents\\Adobe\\Adobe Substance 3D Painter\\python\\modules\"\n```\n\n## Usage\n1. enable the plugin in Substance from the Menu `Python/project_name`\n\n## Development\nRead the [CONTRIBUTING.md](CONTRIBUTING.md) file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhannesdelbeke%2Fsubstance-painter-plugin-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhannesdelbeke%2Fsubstance-painter-plugin-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhannesdelbeke%2Fsubstance-painter-plugin-template/lists"}