{"id":13730626,"url":"https://github.com/sttz/install-unity","last_synced_at":"2025-08-21T03:32:34.898Z","repository":{"id":47988363,"uuid":"48238767","full_name":"sttz/install-unity","owner":"sttz","description":"Script to install Unity 3D versions from the command line on macOS","archived":false,"fork":false,"pushed_at":"2025-05-02T11:57:20.000Z","size":449,"stargazers_count":134,"open_issues_count":5,"forks_count":25,"subscribers_count":13,"default_branch":"next","last_synced_at":"2025-05-02T12:47:07.332Z","etag":null,"topics":["automation","install-script","macos","unity3d"],"latest_commit_sha":null,"homepage":"","language":"C#","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/sttz.png","metadata":{"files":{"readme":"Readme.md","changelog":"Changelog.md","contributing":null,"funding":null,"license":"LICENSE","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-12-18T14:15:18.000Z","updated_at":"2025-05-02T11:57:24.000Z","dependencies_parsed_at":"2024-01-11T14:14:19.558Z","dependency_job_id":"1ed77ce4-ccdc-445a-a5db-29620aa8fb69","html_url":"https://github.com/sttz/install-unity","commit_stats":null,"previous_names":[],"tags_count":42,"template":false,"template_full_name":null,"purl":"pkg:github/sttz/install-unity","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sttz%2Finstall-unity","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sttz%2Finstall-unity/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sttz%2Finstall-unity/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sttz%2Finstall-unity/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sttz","download_url":"https://codeload.github.com/sttz/install-unity/tar.gz/refs/heads/next","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sttz%2Finstall-unity/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271420516,"owners_count":24756580,"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-08-21T02:00:08.990Z","response_time":74,"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":["automation","install-script","macos","unity3d"],"created_at":"2024-08-03T02:01:17.352Z","updated_at":"2025-08-21T03:32:34.892Z","avatar_url":"https://github.com/sttz.png","language":"C#","readme":"# install-unity\n\nA command-line utility to install any recent version of Unity.\n\nCurrently only supports macOS (Intel \u0026 Apple Silicon) but support for Windows/Linux is possible, PRs welcome.\n\n## Table of Contents\n\n* [Introduction](#introduction)\n* [Versions](#versions)\n* [Packages](#packages)\n* [Offline Install](#offline-install)\n* [Run](#run)\n* [Create](#create)\n* [CLI Help](#cli-help)\n* [Changelog](#changelog)\n\n# Introduction\n\n[Download the latest release here](https://github.com/sttz/install-unity/releases). install-unity is a self-contained executable and has no dependencies.\n\nOr you can install via [Homebrew](https://brew.sh) using [sttz/homebrew-tap](https://github.com/sttz/homebrew-tap), see the tap readme for instructions.\n\nInstalling the latest release version of Unity is as simple as:\n\n    install-unity install f\n\n## Versions\n\nMost commands take a version as input, either to select the version to install or to filter the output.\n\nYou can be as specific as you like, `2018.2.2f1`, `2018.2.2`, `2018.2`, `2018`, `f` or `2018.3b` are all valid version inputs.\n\n`install-unity` will scan for the available regular releases as well as the latest betas and alphas.\n\n    install-unity list\n    install-unity list a\n    install-unity list 2019.1\n\nWill show the available versions and the argument acts as a filter. Without an argument, only regular releases are loaded and displayed. Add an argument including `b` or `a` to load and display either beta or both beta and alpha versions as well.\n\nIn case install-unity fails to discover a release, it's also possible to pass a release notes or unity hub url instead of a version to `details` and `install`:\n\n    install-unity details https://unity3d.com/unity/whats-new/unity-2018.3.0\n    install-unity install unityhub://2018.3.0f2/6e9a27477296\n## Packages\n\nThe command above will install the default packages as specified by Unity.\n\n    install-unity details 2018.2\n\nWill show the available packages for a given version. You can then select the packages you want to install with the `-p` or `--packages` option. The option can either be repeated or the names separated by space or comma:\n\n    install-unity install 2018.2 --packages Unity,Documentation\n    install-unity install f -p Unity Linux iOS Android\n    install-unity install 2018.3b -p Unity -p Android -p Linux\n\n## Apple Silicon\n\nBy default, `install-unity` will download and install the Unity editor matching the current platform. \n\nUse `--platform macOSIntel` to download and install the Intel editor on Apple Silicon.\n\nUse `--platform macOSArm` on Intel to download the Apple Silicon editor.\n\n## Offline Install\n\ninstall-unity can be used in a two-step process, first downloading the packages and then later installing them without needing an internet connection.\n\n    install-unity install 2018.2 --packages all --data-path \"~/Desktop/2018.2\" --download\n\nWill download all available packages to `~/Desktop/Downloads` together with the necessary package metadata.\n\n    install-unity install 2018.2 --pacakages all --data-path \"~/Destop/2018.2\" --install\n\nWill install those packages at a later time. Simply copy the folder together with the `install-unity` binary to another computer to do an offline installation there.\n\nYou can download and install only a subset of the available packages.\n\n## Run\n\nTo select a Unity version from all the installed ones, use the run command.\n\n    install-unity run f\n\nWill open the latest version of Unity installed.\n\nYou can also use the path to a Unity project and install-unity will open it with the corresponding Unity version.\n\n    install-unity run ~/Desktop/my-project\n\nIt will only open with the exact version of Unity the project is set to. You can optionally allow it to be opened with a newer patch, minor or any version:\n\n    install-unity run --allow-newer patch ~/Desktop/my-project\n\nYou can pass [command line arguments](https://docs.unity3d.com/Manual/CommandLineArguments.html) along to Unity, e.g. to create a build from the command line (note the `--` to separate install-unity options from the ones passed on the Unity).\n\n    install-unity run ~/Desktop/my-project -- -quit -batchmode -buildOSX64Player ~/Desktop/my-build\n\nBy default, Unity is started as a separate process and install-unity will exit after Unity has been launched. To wait for Unity to quit and forward Unity's log output through install-unity, use the `--child` option:\n\n    install-unity run ~/Desktop/my-project --child -v -- -quit -batchmode -buildOSX64Player ~/Desktop/my-build\n\n## Create\n\nTo start a basic Unity project, use the create command. The version pattern will select an installed Unity version and create a new project using it.\n\n    install-unity create 2020.1 ~/Desktop/my-project\n\nThe project will use Unity's default setup, including packages. Alternatively, you can create a minimal project that will start with an empty ´Packages/manifest.json`:\n\n    install-unity create --type minimal 2020.1 ~/Desktop/my-project\n\n## CLI Help\n\n````\ninstall-unity v2.13.1\n\nUSAGE: install-unity [--help] [--version] [--verbose...] [--yes] [--update] \n                     [--clear-cache] [--data-path \u003cpath\u003e] \n                     [--opt \u003cname\u003e=\u003cvalue\u003e...] \u003caction\u003e \n\nGLOBAL OPTIONS:\n -h, --help       Show this help \n     --version    Print the version of this program \n -v, --verbose    Increase verbosity of output, can be repeated \n -y, --yes        Don't prompt for confirmation (use with care) \n -u, --update     Force an update of the versions cache \n     --clear-cache  Clear the versions cache before running any commands \n     --data-path \u003cpath\u003e  Store all data at the given path, also don't delete \n                  packages after install \n     --opt \u003cname\u003e=\u003cvalue\u003e  Set additional options. Use '--opt list' to show all \n                  options and their default value and '--opt save' to create an \n                  editable JSON config file. \n\n\nACTIONS:\n\n---- INSTALL (default):\n     Download and install a version of Unity \n\nUSAGE: install-unity [options] [install] [--packages \u003cname,name\u003e...] \n                     [--download] [--install] [--upgrade] \n                     [--platform none|mac_os|linux|windows|all] \n                     [--arch none|x86_64|arm64|all] [--redownload] [--yolo] \n                     [\u003cversion\u003e] \n\nOPTIONS:\n \u003cversion\u003e        Pattern to match Unity version or release notes / unity hub \n                  url \n -p, --packages \u003cname,name\u003e  Select packages to download and install ('all' \n                  selects all available, '~NAME' matches substrings) \n     --download   Only download the packages (requires '--data-path') \n     --install    Install previously downloaded packages (requires \n                  '--data-path') \n     --upgrade    Replace existing matching Unity installation after successful \n                  install \n     --platform none|mac_os|linux|windows|all  Platform to download the \n                  packages for (only valid with '--download', default = current \n                  platform) \n     --arch none|x86_64|arm64|all  Architecture to download the packages for \n                  (default = current architecture) \n     --redownload  Force redownloading all files \n     --yolo       Skip size and hash checks of downloaded files \n\n\n---- LIST:\n     Get an overview of available or installed Unity versions \n\nUSAGE: install-unity [options] list [--installed] \n                     [--platform none|mac_os|linux|windows|all] \n                     [--arch none|x86_64|arm64|all] [\u003cversion\u003e] \n\nOPTIONS:\n \u003cversion\u003e        Pattern to match Unity version \n -i, --installed  List installed versions of Unity \n     --platform none|mac_os|linux|windows|all  Platform to list the versions \n                  for (default = current platform) \n     --arch none|x86_64|arm64|all  Architecture to list the versions for \n                  (default = current architecture) \n\n\n---- DETAILS:\n     Show version information and all its available packages \n\nUSAGE: install-unity [options] details \n                     [--platform none|mac_os|linux|windows|all] \n                     [--arch none|x86_64|arm64|all] [\u003cversion\u003e] \n\nOPTIONS:\n \u003cversion\u003e        Pattern to match Unity version or release notes / unity hub \n                  url \n     --platform none|mac_os|linux|windows|all  Platform to show the details for \n                  (default = current platform) \n     --arch none|x86_64|arm64|all  Architecture to show the details for \n                  (default = current architecture) \n\n\n---- UNINSTALL:\n     Remove a previously installed version of Unity \n\nUSAGE: install-unity [options] uninstall [\u003cversion-or-path\u003e] \n\nOPTIONS:\n \u003cversion-or-path\u003e Pattern to match Unity version or path to installation root \n\n\n---- RUN:\n     Execute a version of Unity or a Unity project, matching it to its Unity \n     version \n\nUSAGE: install-unity [options] run [--child] \n                     [--allow-newer none|hash|build|patch|minor|all] \n                     [--upgrade \u003cversion\u003e] \u003cversion-or-path\u003e \n                     [\u003cunity-arguments\u003e...] \n\nOPTIONS:\n \u003cversion-or-path\u003e Pattern to match Unity version or path to a Unity project \n \u003cunity-arguments\u003e Arguments to launch Unity with (put a -- first to avoid \n                  Unity options being parsed as install-unity options) \n -c, --child      Run Unity as a child process and forward its log output (only \n                  errors, use -v to see the full log) \n -a, --allow-newer none|hash|build|patch|minor|all  Allow newer versions of \n                  Unity to open a project \n     --upgrade \u003cversion\u003e  Run the project with the highest installed Unity \n                  version matching the pattern \n\n\n---- CREATE:\n     Create a new empty Unity project \n\nUSAGE: install-unity [options] create [--type \u003cbasic|minimal\u003e] [--open] \n                     \u003cversion\u003e \u003cpath\u003e \n\nOPTIONS:\n \u003cversion\u003e        Pattern to match the Unity version to create the project with \n \u003cpath\u003e           Path to the new Unity project \n     --type \u003cbasic|minimal\u003e  Type of project to create (basic = standard \n                  project, minimal = no packages/modules) \n -o, --open       Open the new project in the editor \n````\n\n# Legacy\n\nThe old Python version of install-unity can be found in the [legacy](https://github.com/sttz/install-unity/tree/next) branch.\n","funding_links":[],"categories":["C#"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsttz%2Finstall-unity","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsttz%2Finstall-unity","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsttz%2Finstall-unity/lists"}