Open a Unity project with the matching Editor version (macOS/Windows)
npm install launch-unitylaunch-unity
=================
Without Unity Hub, launch Unity from the command line.
``bashGlobal install
npm install -g launch-unity
Usage
`bash
Syntax
launch-unity [OPTIONS] [PROJECT_PATH] [-- UNITY_ARGS...]
launch-unity updateArguments
PROJECT_PATH Unity project directory (searches up to 3 levels deep if omitted)
Options
-h, --help Show help
-r, --restart Kill running Unity and restart
-p, --platform
Passed to Unity as -buildTarget (e.g., StandaloneOSX, Android, iOS)
-a, -u, --add-unity-hub, --unity-hub-entry
Register to Unity Hub (does not launch Unity)
-f, --favorite Register to Unity Hub as favorite (does not launch Unity)
Examples
npx launch-unity # Search for project and open
npx launch-unity /path/to/Proj # Open specific project
npx launch-unity -p Android # Specify build target
npx launch-unity /path -p Android # Specify path and build target
npx launch-unity -r # Restart Unity
npx launch-unity -a # Register to Unity Hub only (does not launch Unity)
npx launch-unity -f # Register as favorite (does not launch Unity)
npx launch-unity . -- -batchmode -quit -nographics -logFile - # Pass Unity args
npx launch-unity /path -p Android -- -executeMethod My.Build.EntrySelf update (for npm global install)
launch-unity updateIf you have a project directory named "update", specify it explicitly
launch-unity ./update
`A TypeScript CLI for macOS and Windows that reads the required Unity Editor version from
ProjectSettings/ProjectVersion.txt, launches the matching Unity installed via Unity Hub,
and opens the project.Default Unity paths assumed:
- macOS:
/Applications/Unity/Hub/Editor/
- Windows (searched):
- %PROGRAMFILES%/Unity/Hub/Editor/
- %PROGRAMFILES(X86)%/Unity/Hub/Editor/
- %LOCALAPPDATA%/Unity/Hub/Editor/
- C:\\Program Files\\Unity\\Hub\\Editor\\
Troubleshooting
- Error: ProjectVersion.txt not found
- The provided directory is not a Unity project. Point to the project root.
- Error: Unity
- Install the required version via Unity Hub, or adjust Unity path resolution.
Platform Notes
- macOS, Windows: Supported via Unity Hub default install paths.
- Linux: Not supported yet. Contributions are welcome.
Security
This project implements supply chain attack prevention measures:
- ignore-scripts: Disables automatic script execution during
npm install
- Dependabot: Automated weekly security updates
- Security audit CI: Runs npm audit and lockfile-lint on every PR
- Pinned versions: All dependencies use exact versions (no ^ or ~)License
- MIT. See LICENSE` for details.