{"id":13523037,"url":"https://github.com/GafferHQ/gaffer","last_synced_at":"2025-04-01T00:30:59.611Z","repository":{"id":7680178,"uuid":"9043124","full_name":"GafferHQ/gaffer","owner":"GafferHQ","description":"Gaffer is a node-based application for lookdev, lighting and automation","archived":false,"fork":false,"pushed_at":"2024-10-29T09:57:44.000Z","size":80510,"stargazers_count":959,"open_issues_count":338,"forks_count":206,"subscribers_count":100,"default_branch":"main","last_synced_at":"2024-10-29T11:57:41.910Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://www.gafferhq.org","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GafferHQ.png","metadata":{"files":{"readme":"README.md","changelog":"Changes.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2013-03-27T00:04:53.000Z","updated_at":"2024-10-28T12:32:29.000Z","dependencies_parsed_at":"2023-09-27T23:15:34.732Z","dependency_job_id":"e49699d1-0d76-40be-bdec-574d8235f08e","html_url":"https://github.com/GafferHQ/gaffer","commit_stats":{"total_commits":14059,"total_committers":64,"mean_commits":219.671875,"dds":"0.41731275339640084","last_synced_commit":"42429609cc0e01b48e1d866f1a74fa553eab525e"},"previous_names":[],"tags_count":426,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GafferHQ%2Fgaffer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GafferHQ%2Fgaffer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GafferHQ%2Fgaffer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GafferHQ%2Fgaffer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GafferHQ","download_url":"https://codeload.github.com/GafferHQ/gaffer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222688173,"owners_count":17023297,"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":[],"created_at":"2024-08-01T06:00:54.912Z","updated_at":"2024-11-02T07:31:20.505Z","avatar_url":"https://github.com/GafferHQ.png","language":"Python","readme":"![Gaffer Logo](resources/GafferLogo.svg)\n\n# Gaffer #\n\nGaffer is a VFX application that enables look developers, lighters, and compositors to easily build, tweak, iterate, and render scenes. Gaffer supports in-application scripting in Python and [OSL](https://github.com/imageworks/OpenShadingLanguage), so VFX artists and technical directors can design shaders, automate processes, and build production workflows.\n\nAn open-source project, Gaffer also provides an application framework for studios to design and create their own VFX production pipeline tools. Built using the [Cortex](https://github.com/ImageEngine/cortex) libraries, Gaffer ships with a multi-threaded, deferred evaluation engine and a flexible user interface framework.\n\nMore information about Gaffer and its use in studios can be found at [GafferHQ](https://gafferhq.org).\n\nUsers can learn how to use Gaffer through the [documentation](https://gafferhq.org/documentation).\n\nDeveloper notes are available on the [Gaffer developer wiki](https://github.com/GafferHQ/gaffer/wiki).\n\nParticipating in the Gaffer community requires abiding by the project's [Code of Conduct](CODE_OF_CONDUCT.md).\n\n\n## Download ##\n\nCompiled binary releases are available for download from the [releases page](https://github.com/GafferHQ/gaffer/releases).\n\nGaffer is officially supported and tested on **Linux** (CentOS 7) and **macOS** (macOS 10.14).\n\n\n## Building ##\n\n[![CI](https://github.com/GafferHQ/gaffer/workflows/CI/badge.svg)](https://github.com/GafferHQ/gaffer/actions?query=workflow%3ACI)\n\nGaffer targets the [VFX Reference Platform](https://vfxplatform.com). We are currently on **CY2022**. Aside from general platform development packages, we specifically require the following tools that may not be installed by default on your system. Without these, you will not be able to build Gaffer.\n\n\u003e **Note:** From time to time, this list may change. For a complete, accurate, and up-to-date method of installing the prerequisites on CentOS, refer to the [Docker setup](https://github.com/GafferHQ/build/blob/master/Dockerfile) we use for building automatic releases.\n\n### Build requirements ###\n\n\n\u003e **Note:** Specific package names may differ depending on your Linux distribution and repository.\n\n#### Main build requirements ####\n\n\nPackage Name | Version\n------------ |:--------------:\n[`gcc`](https://gcc.gnu.org/index.html) | 6.3.1\n[`scons`](http://www.scons.org) |\n[`inkscape`](http://inkscape.org) |\n\n\n#### Documentation build requirements ####\n\n\u003e **Note:** Building the documentation is optional.\n\nPackage Name | Minimum Version\n------------ |:--------------:\n[`sphinx`](http://www.sphinx-doc.org/) | 1.8\n\nPython Module | Required version\n------------- |:---------------:\n`sphinx_rtd_theme` | 0.4.3\n`recommonmark` | 0.5.0\n`docutils` | 0.12\n\n\n### Build process ###\n\n```bash\ngit clone https://github.com/GafferHQ/gaffer.git\ncd gaffer\n```\n\nGaffer depends on a number of 3rd-party libraries. We recommend using the pre-built dependencies from the [Gaffer dependencies project](https://github.com/GafferHQ/dependencies/releases). These are used in our automated test builds and so are guaranteed to be up-to-date with Gaffer's requirements.\n\nThe dependencies distribution forms the basis of a Gaffer build and the root of the expanded archive becomes the `BUILD_DIRECTORY` we pass to `scons`.\n\nThe easiest way to get the right dependencies version is to use the `config/installDependencies.sh` script included in the Gaffer source tree. This downloads the correct version for the version of Gaffer you are building and unpacks them to a directory of your choice.\n\nIn this example we're going to build gaffer to a `gaffer-build` directory next to our checkout.\n\n\n```bash\n./config/installDependencies.sh ../gaffer-build\n```\n\nYou can then build Gaffer itself:\n\n```bash\nscons build BUILD_DIR=../gaffer-build\n```\n\n\u003e **Note:** If `scons` has any issues finding dependencies or tools, see `SConstruct` for the various options that can be set to specify their location.\n\nWith any luck, you now have a functioning version of Gaffer.\n\n```bash\n../gaffer-build/bin/gaffer\n```\n\n### Building with third-party renderer support\n\nGaffer dependencies ships with Cycles, but to build the modules for one of the other supported third-party renderers, you will need to set appropriate `scons` options pointing to your installation. The options are:\n\n- Arnold: `ARNOLD_ROOT`\n- 3Delight: `DELIGHT_ROOT`\n\nFor example, the following command builds Gaffer with Arnold support:\n\n```bash\nscons build ARNOLD_ROOT=/path/to/arnold/6 BUILD_DIR=...\n````\n\n## Questions and troubleshooting ##\n\nIf you have any questions about using Gaffer, or encounter problems setting it up, feel free to ask on the [Gaffer community group](https://groups.google.com/forum/#!forum/gaffer-dev). Our users and contributors are happy to help.\n\n\n## Requesting features ##\n\nIf there is a feature you would like to see in Gaffer, request it on the [Gaffer community group](https://groups.google.com/forum/#!forum/gaffer-dev). Do not create an Issue for it on GitHub.\n\n\n## Contributions and bugs reports ##\n\nPlease see the project's [contribution guidelines](CONTRIBUTING.md).\n\n\n## Copyright and license ##\n\n© 2011–2020 John Haddon. All rights reserved.\n\n© 2011–2020 Image Engine Design Inc. All rights reserved.\n\n© 2011–2020 Cinesite VFX Ltd. All rights reserved.\n\nDistributed under the [BSD license](LICENSE).\n","funding_links":[],"categories":["Applications","Integrations","Digital Content Creation Software (DCCs)"],"sub_categories":["3D \u0026 Visuals","3D"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGafferHQ%2Fgaffer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FGafferHQ%2Fgaffer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGafferHQ%2Fgaffer/lists"}