{"id":17718043,"url":"https://github.com/daandelange/ofxaddontool","last_synced_at":"2026-05-17T17:40:46.157Z","repository":{"id":148946858,"uuid":"299284417","full_name":"Daandelange/ofxAddonTool","owner":"Daandelange","description":"Standalone bash script to manage your OpenFrameworks addon dependencies using git.","archived":false,"fork":false,"pushed_at":"2021-02-01T18:35:40.000Z","size":108,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2023-03-30T05:26:39.123Z","etag":null,"topics":["git","openframeworks","openframeworks-addon","package-manager"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Daandelange.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","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":"2020-09-28T11:18:38.000Z","updated_at":"2021-02-01T18:35:43.000Z","dependencies_parsed_at":null,"dependency_job_id":"637eead3-16dd-4ec3-94bd-ab7d862a4c2f","html_url":"https://github.com/Daandelange/ofxAddonTool","commit_stats":null,"previous_names":[],"tags_count":3,"template":null,"template_full_name":null,"purl":"pkg:github/Daandelange/ofxAddonTool","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Daandelange%2FofxAddonTool","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Daandelange%2FofxAddonTool/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Daandelange%2FofxAddonTool/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Daandelange%2FofxAddonTool/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Daandelange","download_url":"https://codeload.github.com/Daandelange/ofxAddonTool/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Daandelange%2FofxAddonTool/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267084889,"owners_count":24033590,"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","status":"online","status_checked_at":"2025-07-25T02:00:09.625Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["git","openframeworks","openframeworks-addon","package-manager"],"created_at":"2024-10-25T14:34:24.164Z","updated_at":"2026-05-17T17:40:41.136Z","avatar_url":"https://github.com/Daandelange.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"ofxAddonTool\n============\n![ofxAddonTool](./ofxaddons_thumbnail.png)  \nA simple standalone bash script for managing your OpenFrameworks addon dependencies using git and a project-specific configuration file.  \n![ofxAddonTool Screenshot](./ofxAddonTool_screenshot.png)  \n\nIntroduction\n------------\nWorking with several OpenFrameworks projects, each requiring specific versions of ofxAddons can be a headache. This script aims to simplify dependency installation, verification and updating.  \n\n### How it works\nIt compares a configuration file (`addons.txt`) against the `openframeworks/addons` folder then runs some diagnostic checks and actions on them.\n\nCurrent State\n-------------\nThis tool is still under development (alpha). Basic functionality is there and remains to be tested on a wider set of configurations.  \nAny [feedback, suggestions or contributions](https://github.com/Daandelange/ofxAddonTool/issues) are welcome.\n\nLicense\n-------\nMIT license. [Read license](./LICENSE.md).  \nBy [Daan de Lange](http://daandelange.com/).\n\nInstallation\n------------\nTo install this tool, the easiest way is to add it to your OpenFrameworks project **as a submodule**, so you can easily track updates.  \nYou're free to install it in the root of your project or in any subfolder. The script will assume your project root is the first parent directory containing `addons.txt`.  \n*Please, note that this is not an OpenFrameworks addon, so don't install it in `path/to/of/addons`.*  \n\n\nIn the example below, we will install it to the `scripts` folder.\n````bash\ncd /path/to/of/apps/myApps/exampleApp\nmkdir scripts \u0026\u0026 cd ./scripts\ngit submodule add https://github.com/Daandelange/ofxAddonTool.git\nmv ./scipts/ofxAddonTool/addons.txt ./addons.txt\n````\n\n**Alternatively**, you can also download [`ofxAddonTool.sh`](https://raw.githubusercontent.com/daandelange/ofxAddonTool/master/ofxAddonTool.sh) + [`addons.txt`](https://raw.githubusercontent.com/daandelange/ofxAddonTool/master/addons.txt) and place them in the root of your project directory.  \n````bash\ncd /path/to/of/apps/myApps/exampleApp\ncurl -L -O https://raw.githubusercontent.com/daandelange/ofxAddonTool/master/addons.txt -L -O https://raw.githubusercontent.com/daandelange/ofxAddonTool/master/ofxAddonTool.sh\n````\n\n### Install required dependencies\nFor the use of `realpath`, included in the GNU core utilities :\n- Mac : `brew install coreutils` or `brew install coreutils --build-from-source` (10.12)\n- Linux : Included in most distros.\n\n### Install optional dependencies\nIf you want fancy ASCI art, install `toilet` or `figlet`. (optional)\n- Mac : `brew install figlet`\n- Linux : `apt install figlet`\n\nConfiguration\n-----\nEdit `yourProject/addons.txt` with your favourite text editor to suit the needs of your project.    \nFor each addon, you need to provide the title (folder name), the URL and the branch to checkout.  \nFurther instructions are within that file.  \n\nUsage\n-----\n````bash\ncd /path/to/of/apps/myApps/exampleApp/scripts/ofxAddonTool\n./ofxAddonTool.sh --check\n./ofxAddonTool.sh --help\n````\n\nUpdating\n--------\nTo get the latest version of this script.\n````bash\n# Get updates\ncd /path/to/of/apps/myApps/exampleApp/scripts/ofxAddonTool\ngit checkout master \u0026\u0026 git pull\n\n# Tell your project to use ofxAddonTool's latest commit (repo owners only)\ncd /path/to/of/apps/myApps/exampleApp\ngit add /scripts/ofxAddonTool\ngit commit -m \"Update submodule ofxAddonTool to latest version.\"\ngit push\n\n# Synchronize all submodules of your project (user update method)\ncd /path/to/of/apps/myApps/exampleApp\ngit checkout master \u0026\u0026 git pull\ngit submodule update\n````\n\nCompatibility\n-------------\nThis script is coded in pure Bash script. It runs on Linux and Mac. Windows is untested but should work.  \nAn internet connection is recommended to get the latest remote updates from your git remotes.  \n*Note: This script could easily be adapted as a git addon manager, without anything OpenFrameworks.*\n\n\nVersion history\n---------------\nSee [CHANGELOG.md](./CHANGELOG.md).\n\n\nAlternative\n-----------\n[ofPackageManager](https://github.com/thomasgeissl/ofPackageManager) is a more extended oF package manager which installs as a system-wide tool.  \nCompared to it, ofxAddonTool is a lightweight plug'n'play solution, but it doesn't offer as much features.  \n*(Note: Their configuration files are not compatible [yet?])*\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaandelange%2Fofxaddontool","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdaandelange%2Fofxaddontool","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdaandelange%2Fofxaddontool/lists"}