{"id":20129277,"url":"https://github.com/openframeworks/projectgenerator","last_synced_at":"2025-04-04T13:13:05.540Z","repository":{"id":25664482,"uuid":"29100153","full_name":"openframeworks/projectGenerator","owner":"openframeworks","description":"repo for centralizing work on a tool to generate OF projects","archived":false,"fork":false,"pushed_at":"2025-03-27T03:44:00.000Z","size":43613,"stargazers_count":85,"open_issues_count":113,"forks_count":75,"subscribers_count":16,"default_branch":"master","last_synced_at":"2025-03-27T04:28:45.617Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"CSS","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/openframeworks.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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,"publiccode":null,"codemeta":null}},"created_at":"2015-01-11T17:49:56.000Z","updated_at":"2025-03-27T03:25:29.000Z","dependencies_parsed_at":"2023-11-05T20:24:55.671Z","dependency_job_id":"b2a855e9-43d6-4b00-8965-72ad861b2112","html_url":"https://github.com/openframeworks/projectGenerator","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openframeworks%2FprojectGenerator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openframeworks%2FprojectGenerator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openframeworks%2FprojectGenerator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/openframeworks%2FprojectGenerator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/openframeworks","download_url":"https://codeload.github.com/openframeworks/projectGenerator/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247182401,"owners_count":20897381,"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-11-13T20:33:15.439Z","updated_at":"2025-04-04T13:13:05.513Z","avatar_url":"https://github.com/openframeworks.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# openFrameworks projectGenerator \n\n[![build-linux](https://github.com/openframeworks/projectGenerator/actions/workflows/build-linux.yml/badge.svg)](https://github.com/openframeworks/projectGenerator/actions/workflows/build-linux.yml) [![build-vs](https://github.com/openframeworks/projectGenerator/actions/workflows/build-vs.yml/badge.svg)](https://github.com/openframeworks/projectGenerator/actions/workflows/build-vs.yml) [![build-macos](https://github.com/openframeworks/projectGenerator/actions/workflows/build-macos.yml/badge.svg)](https://github.com/openframeworks/projectGenerator/actions/workflows/build-macos.yml)\n\n\n# Project Generator\n## Builds the cmdline and GUI project generators for openFrameworks\n\nThe project Generator, also known as _PG_,\nis a utility tool to facilitate the creation of new openFrameworks projects,\nin multiple platforms.\n\n- the commandLine projectGenerator (pure openFrameworks)\n- the projectGenerator GUI app (electron) distributed in releases\n\nThe content in this page is primarily target at developers willing to contribute to the code base.\nIf you are working with openFrameworks and would like to use the Project Generator, check the\ninstructions in [Create in a new project](https://openframeworks.cc/learning/01_basics/create_a_new_project/).\n\n---------------------------------------\n\n\n# Download instructions \nYou can download packaged macOS and Windows builds here ( note Linux needs to be built per platform ):\n- https://github.com/openframeworks/projectGenerator/releases/download/nightly/projectGenerator-osx.zip\n- https://github.com/openframeworks/projectGenerator/releases/download/nightly/projectGenerator-vs-gui.zip \n- https://github.com/openframeworks/projectGenerator/releases/download/nightly/projectGenerator-vs.zip (commmandLine)\n\n---------------------------------------\n\n# Build instructions with Bash Scripts \n\nIn the projectGenerator scripts folder run the scripts in order to setup environment and build\n\n\n## Visual Studio 2022 \n\nprojectGenerator\\scripts\\vs\\setup_environment.sh (first time)\n\n```projectGenerator\\scripts\\vs\\build_cmdline.sh```\n- (build projectGenerator commandLine requires openFrameworks in directories above / or run from correct sub-module location)\n\n```projectGenerator\\scripts\\vs\\build_frontend.sh``` (Builds Electron App GUI Project Generator) \n- requires commandLine.exe in folder. \n- If cannot build commandLine.exe download from releases and run just this\n\nprojectGenerator\\scripts\\vs\\build_dev_frontend.sh \n - (Builds Electron App GUI Project Generator in DEBUG mode / Verbose and will autorun the test build) \n\n## macOS / osx\n\nprojectGenerator\\scripts\\osx\\setup_environment.sh (first time)\n\n```projectGenerator\\scripts\\vs\\build_cmdline.sh```\n- (build projectGenerator commandLine requires openFrameworks in directories above / or run from correct sub-module location)\n\n```projectGenerator\\scripts\\vs\\build_frontend.sh``` (Builds Electron App GUI Project Generator) \n- requires commandLine.exe in folder. \n- If cannot build commandLine.exe download from releases and run just this\n\n## Linux\n\n```projectGenerator\\scripts\\linux\\setup_environment.sh``` (first time)\n```projectGenerator\\scripts\\linux\\build_cmdline.sh```\n```projectGenerator\\scripts\\linux\\build_frontend.sh```\n\n\n## Contributing\n\nThe project generator is available in two flavors:\n\n- A command line utility tool. This option is the most versatile and provides all features.\n  See more information [here](/commandLine/README.md).\n\n- A user-interface, which works for the most typical scenarios. See more information in\nthe [front-end](/frontend/README.md) folder.  \n ![project generator front-end](/frontend/screenshot.png)\n\n\n# LEGAGY BUILD INSTRUCTIONS ----- (more detail)\n---------------------------------------\n\n## Clone OF ( skip if already cloned ) \n```\ngit clone git@github.com:openframeworks/openFrameworks.git --depth=1\n```\n\n## Init / update submodules \n```\ncd openFrameworks\ngit submodule init\ngit submodule update\n```\n\n## Install libs ( replace with platform )\n`./scripts/osx/download_libs.sh`\n\n## Build the projectGenerator ( can also use project file ) \n```\ncd apps/projectGenerator/commandLine/\n\n# for linux do:\nmake Release\ncp bin/projectGenerator ../frontend/app/\n\n# for windows do:\nmsbuild commandLine.vcxproj /p:configuration=release /p:platform=${{ matrix.platform }} /p:PlatformToolset=v143\ncp commandLine.exe ../frontend/app/projectGenerator.exe\n\n# for macos \nxcodebuild -configuration Release -target commandLine CODE_SIGN_IDENTITY=\"\" -project commandLine.xcodeproj\ncp bin/projectGenerator ../frontend/app/\n```\nOn macOS, if you get this error: \n\u003e xcode-select: error: tool 'xcodebuild' requires Xcode, but active developer directory '/Library/Developer/CommandLineTools' is a command line tools instance\n\nIt's probably because your Command Line Tools were installed via Home Brew or some other mechanism. You need to re-select the whole Xcode install by executing:\n```\nsudo xcode-select -s /Applications/Xcode.app/Contents/Developer\n```\n## Build the frontend electron app \nNote: see the more detailed guide include node install in the frontend [ReadMe](frontend/ReadMe.md)\n```\ncd ../frontend\nnpm install \nnpm update\n\n# to run the app without packaging it \nnpm start\n\n# to package the pg app as a standalone\nnpm run build:macos \n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenframeworks%2Fprojectgenerator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenframeworks%2Fprojectgenerator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenframeworks%2Fprojectgenerator/lists"}